RevGlanceDocumentação

App Store

Conecte o App Store Connect com uma chave de API para ler os relatórios diários de Sales and Trends de iOS e Mac.

O RevGlance lê os relatórios diários de Sales and Trends da Apple pela App Store Connect API. O resumo SALES traz apps pagos e compras no app; o relatório SUBSCRIBER traz cada cobrança de assinatura, teste gratuito e reembolso.

Conectar

  1. No App Store Connect, abra Users and Access › Integrations › App Store Connect API e gere uma chave de equipe com a função Finance ou Sales.
  2. Anote o Issuer ID acima da lista de chaves e o Key ID da chave, depois baixe o arquivo .p8. A Apple permite baixá-lo uma única vez.
  3. Encontre seu vendor number em Payments and Financial Reports (no canto superior esquerdo).
  4. Preencha os quatro campos, colando o arquivo .p8 inteiro, incluindo as linhas -----BEGIN PRIVATE KEY-----, e escolha Conectar App Store.

O que o formulário pede

CampoFormato
ID do emissor57246542-96fe-1a63-e053-0824d011072a
ID da chave2X9R4HXF34
Número do fornecedor85012345
Chave privada (conteúdo do .p8)Armazenado criptografado-----BEGIN PRIVATE KEY-----

Adicione o webhook

Os relatórios chegam com cerca de um dia de atraso. As App Store Server Notifications avisam o RevGlance no momento em que algo muda, para que o próximo relatório seja buscado assim que existir.

  1. No RevGlance, abra Configurações › Fontes, abra o menu da fonte App Store e escolha Webhook.
  2. Invente um segredo longo e aleatório, cole-o em Segredo de assinatura e salve.
  3. Copie o URL do webhook e adicione ?token= e o seu segredo ao final.
  4. No App Store Connect, abra a App Information do seu app e, em App Store Server Notifications, defina esse endereço como URL de produção, versão 2.

O RevGlance verifica o segredo no URL e a assinatura da própria Apple, uma cadeia de certificados até a Apple Root CA G3.

O que esperar

  • Clientes anônimos. A Apple não identifica compradores. Cada assinante vira um cliente com um Subscriber ID anônimo, e códigos de oferta, upgrades entre grupos de assinaturas e redefinições de ID podem parecer assinaturas novas.
  • Um ano de histórico. Os relatórios diários voltam um ano, e cada dia chega com cerca de um dia de atraso.
  • Cancelamentos aparecem tarde. A Apple não informa cancelamentos: uma assinatura termina quando a renovação está três dias atrasada.

Como a App Store é contada

  • O preço ao cliente conta como receita e a taxa é o preço ao cliente menos seus rendimentos, então impostos em preços com impostos inclusos aparecem como taxa.
  • O MRR é o preço ao cliente mais recente, então inclui impostos onde os preços incluem: os relatórios da Apple não separam os impostos. Uma oferta introdutória conta pelo preço da oferta, e o preço normal depois aparece como uma expansão.
  • Um reembolso vem do relatório da Apple com preço negativo. Quando a Apple reverte um reembolso, o RevGlance remove o reembolso mais recente daquele assinante e daquela assinatura. A Apple não diz qual reembolso foi revertido, então, com vários reembolsos em uma assinatura, o errado pode sair.
  • Reembolsos pedidos depois que a Apple redefine o ID de um assinante (180 dias) são mantidos, mas sem cliente.
  • Créditos de pacotes de apps (CMB-C) não são reembolsos e ficam de fora.
  • A Apple não mostra cancelamentos: uma assinatura termina quando uma renovação está três dias atrasada.
  • Cobranças com falha não são informadas, então esse número fica em zero.