Conectar a App Store da Apple
Crie uma chave de API do App Store Connect com o papel certo, adicione-a e escolha seus apps.
A Apple não usa janela de login para relatórios. Você cria uma chave de API no App Store Connect, baixa uma única vez e cola os dados dela no Revenue Sensor. No console, essa fonte se chama Apple IAP.
Antes de começar
- Acesso de Account Holder ou Admin ao App Store Connect, para poder criar chaves.
- Seu Vendor Number, em App Store Connect → Reports → Payments and Financial Reports. Ele aparece no canto superior esquerdo, abaixo do nome da sua conta.
Crie sua chave de API
- 1
Abra a página de chaves em Integrations
App Store Connect → Users and Access → Integrations → App Store Connect API.
- 2
Gere uma chave
Clique no + ao lado de Active e dê à chave um nome que você vá reconhecer, como “Revenue Sensor”.
- 3
Dê a ela um papel de relatórios
Em Access, escolha Sales, Finance ou Admin. Qualquer um deles consegue ler os relatórios Sales and Trends que o Revenue Sensor importa. Admin é o único que também dá os números exatos do App Store Connect (veja abaixo). Uma chave só com acesso Developer ou App Manager não consegue ler receita.
- 4
Baixe o arquivo .p8
A Apple deixa você baixar a chave privada exatamente uma vez. Guarde-a em um lugar seguro antes de sair da página. Se perdê-la, gere uma nova chave e use o novo Key ID e o novo arquivo .p8.
A falha mais comum de todas
Se a receita voltar vazia, ou a conta mostrar “Your API key needs the Sales role”, a causa quase sempre é o papel da chave: dê a ela o papel Sales ou Finance no App Store Connect e reconecte. Confira também se o Vendor Number pertence à mesma conta do App Store Connect que a chave.
Adicione suas credenciais
- Issuer ID: aparece no topo da página de chaves de API do App Store Connect. É o mesmo para todas as chaves.
- Key ID: aparece na linha da chave que você criou.
- Chave privada: o arquivo .p8 que você baixou. Envie-o ou arraste-o. Ele é guardado criptografado e nunca mais é exibido.
- Vendor Number: em Payments and Financial Reports.
Escolha seus apps
O Revenue Sensor lista os apps publicados que a chave enxerga. Selecione os que você quer acompanhar. Só os apps selecionados são sincronizados.
O que é importado
A receita é unidades vezes Developer Proceeds do relatório diário Sales summary da Apple. Proceeds são o que a Apple paga a você, após a comissão dela e qualquer imposto que ela recolha, então Payout é a única base de receita para essa fonte. Um reembolso chega como uma linha com unidades negativas, então é subtraído no dia em que a Apple o processou. Downloads e reembolsos são importados do mesmo relatório.
Atraso nos relatórios
A Apple publica o relatório de vendas de cada dia depois que o dia termina, então o dia de hoje ainda não aparece. Os dias recentes podem mudar um pouco conforme a Apple os reprocessa; cada sincronização relê os últimos 14 dias.