Como conectar o App Store Connect ao AdMate

O App Store Connect reúne várias famílias de dados: metadados dos apps, avaliações, análises, vendas, proventos estimados e relatórios financeiros finais. O AdMate pode trazer essas informações para o mesmo app usado com o AdMob e o RevenueCat, mas a conexão precisa ter os identificadores e as permissões corretos.

A configuração usa uma chave de API do App Store Connect. Trate a chave privada como uma senha: importe-a somente na tela de credenciais e nunca a anexe a um pedido de suporte.

AdMate

Todos os seus ganhos num único painel

Acompanhe AdMob, AdSense, RevenueCat e App Store Connect em várias contas com filtros por app, plataforma e país

Monitorize ganhos, cliques, eCPM, subscrições, instalações e pagamentos no iPhone, iPad, Mac e Apple Watch

O que você precisa do App Store Connect

Prepare os valores exibidos pela Apple na área Usuários e Acesso para a chave de API:

Key ID, que identifica a chave de API;
Issuer ID, que identifica o emissor da API do App Store Connect;
o conteúdo ou o arquivo da chave privada .p8;
um apelido claro para a conta no AdMate;
o número de fornecedor quando o relatório de vendas ou financeiro solicitado exigir.

A função atribuída à chave controla o que a Apple retorna. Uma chave que consegue listar apps pode não ter acesso a dados de vendas ou financeiros. Use a função adequada mais restrita, mas garanta que ela cubra os relatórios que você realmente pretende consultar.

Normalmente, a Apple permite baixar o arquivo da chave privada só uma vez. Guarde o original com segurança, fora do repositório e fora de capturas de tela. Se o arquivo for perdido ou exposto, revogue a chave e crie outra, em vez de pedir que alguém a envie por chat.

Adicione a conta no AdMate

Abra Configurações e o gerenciamento de contas.
Escolha adicionar uma conta App Store Connect.
Digite um nome de exibição fácil de reconhecer.
Adicione o Key ID e o Issuer ID exatamente como a Apple os fornece.
Importe ou cole a chave privada pela tela de credenciais.
Adicione o número de fornecedor quando os relatórios financeiros ou de vendas precisarem dele.
Salve a conta e deixe o AdMate validar as credenciais.
Abra o resumo da conta e confirme que os apps esperados aparecem.

Evite editar manualmente o cabeçalho ou o rodapé da chave .p8. Texto extra, quebras de linha faltando ou uma chave de outro emissor impedem a criação do token.

Verifique cada área de dados separadamente

Um resumo todo verde não prova que todos os endpoints do App Store Connect estejam disponíveis. Confira as áreas que você pretende usar:

Apps e metadados

Confirme que os apps e ícones esperados aparecem. Um app ausente pode indicar que a chave pertence a outra organização de fornecedor ou que a função dela é restrita.

Avaliações

Abra a tela de avaliações e confira um app conhecido. As avaliações são dados por loja e território; um estado vazio válido pode apenas significar que não há avaliações correspondentes.

Análises

Escolha um período completo e considere o prazo de disponibilidade dos relatórios da Apple. Alguns relatórios de análise não são instantâneos e têm granularidade e atraso próprios.

Vendas e proventos

Identifique separadamente as vendas aos clientes e os proventos do desenvolvedor. Não são o mesmo valor, e nenhum deles deve ser confundido com um pagamento bancário.

Relatórios financeiros

Os relatórios financeiros usam os períodos fechados da Apple e podem exigir o número de fornecedor e a função corretos. Use-os para conciliação, em vez de esperar que o dia atual apareça.

Resolva problemas de conexão

Chave ou assinatura inválida

Confira de novo o Key ID, o Issuer ID e a chave privada como um conjunto. Uma chave válida com o emissor errado continua falhando. Se houver risco de exposição, revogue a chave antes de continuar testando.

Os apps carregam, mas os relatórios financeiros não

Verifique a função da chave de API, o número de fornecedor e o período financeiro solicitado. O acesso aos metadados, por si só, não garante acesso às finanças.

As análises não mostram dados

Use um intervalo histórico compatível, verifique se o relatório já está disponível e confirme que o app selecionado gerou a métrica solicitada.

Aparecem apps de outra organização

Remova a conta e adicione a chave do fornecedor correto. Não junte totais de duas organizações só porque os apps delas seguem a mesma convenção de nomes de bundle.

Várias contas do App Store Connect

O AdMate oferece suporte a mais de uma conta. Use apelidos que identifiquem a organização, e não a pessoa que criou a chave. Quando uma chave for trocada, substitua-a na conta correta e teste apps, análises e finanças separadamente.

Para comparações com as análises de assinaturas, leia por que os totais do App Store Connect e do RevenueCat são diferentes.

Perguntas frequentes

O AdMate precisa da senha do meu ID Apple?

Não. A conexão usa uma chave de API do App Store Connect, o emissor e os identificadores relacionados. Nunca digite nem compartilhe a senha do ID Apple para essa configuração.

Por que os apps carregam, mas os proventos não?

A chave pode ter permissão suficiente para os metadados dos apps, mas não para vendas ou finanças, ou podem estar faltando o número de fornecedor e o período do relatório.

Posso reutilizar uma chave em vários dispositivos com o AdMate?

Tecnicamente, a mesma credencial pode funcionar, mas cada cópia extra aumenta a exposição. Siga a política de gestão de chaves da sua organização e revogue as chaves dos dispositivos que não devem mais ter acesso.

As estimativas do App Store Connect são valores contábeis definitivos?

Não. Para a contabilidade, use relatórios financeiros fechados e pagamentos efetivamente recebidos.