RevGlanceDocumentação

Google Play

Conecte o Google Play com uma service account que lê os relatórios do Play Console e a Play Developer API.

O RevGlance lê os relatórios mensais de sales e earnings no bucket do Cloud Storage do seu Play Console e consulta a Play Developer API sobre períodos de cobrança, reembolsos e, com notificações em tempo real, testes e cancelamentos.

Conectar

  1. No Google Cloud, crie uma service account em um projeto, adicione uma chave JSON e baixe-a. Ative a Google Play Android Developer API no projeto.
  2. No Play Console, abra Users and permissions, convide o e-mail da service account e dê a ela View financial data para o seu app.
  3. Copie o bucket dos seus relatórios em Download reports › Financial: a parte pubsite_prod_rev_… do URI do Cloud Storage.
  4. Preencha o bucket, o nome do pacote do seu app (com.example.app) e a chave JSON inteira, e escolha Conectar Google Play. Um convite novo pode levar até um dia para chegar aos relatórios.

O que o formulário pede

CampoFormato
Bucket de relatóriospubsite_prod_rev_01234567890987654321
Nome do pacotecom.example.app
JSON da conta de serviçoArmazenado criptografado{ "type": "service_account", … }

A service account entra com acesso somente leitura ao Cloud Storage (devstorage.read_only) e à Android Publisher API.

Adicione o webhook

Sem as notificações, os testes ficam invisíveis e um cancelamento só aparece quando uma renovação está três dias atrasada. Com elas, o RevGlance descobre o token de compra de cada assinatura e pergunta ao Play o estado atual dela.

  1. No RevGlance, abra Configurações › Fontes, abra o menu da fonte Google Play e escolha Webhook. Salve um segredo longo e aleatório em Segredo de assinatura.
  2. No Google Cloud, crie um tópico do Pub/Sub e permita que o Google Play publique nele, como explica a página Monetization setup do Play Console.
  3. Adicione uma assinatura push ao tópico. O endpoint dela é o URL do webhook com ?token= e o seu segredo no final.
  4. No Play Console, abra Monetization setup, informe o tópico e envie uma notificação de teste. O RevGlance confirma testes e notificações de outros apps sem agir sobre eles.

O que esperar

  • Os relatórios chegam tarde. O Google os publica de três a sete dias após a venda. As vendas vêm primeiro; os ganhos as substituem depois com o que o Google pagou a você.
  • Clientes anônimos. O Play não identifica compradores. Os pedidos de uma mesma assinatura compartilham uma raiz de ID (GPA.1234…), que vira um cliente anônimo. Compras únicas não têm cliente.
  • Reembolsos pela API voltam 30 dias. Reembolsos mais antigos chegam com o relatório de ganhos.

Como o Google Play é contado

  • O Google publica os relatórios com três a sete dias de atraso. As vendas vêm primeiro; os ganhos depois as substituem pelo que o Google pagou a você, após a taxa dele. As cobranças contam antes de impostos.
  • Cada linha de reembolso é mantida, inclusive as parciais. Dois reembolsos parciais de um pedido distribuídos em dois relatórios mensais podem colidir, e um pode ficar de fora. O Google não diz se os reembolsos são negativos nos relatórios, então eles são lidos como valores reembolsados.
  • Reembolsos pela Play API voltam só 30 dias. Os mais antigos chegam com o relatório de ganhos.
  • Sem notificações em tempo real, um cancelamento só aparece como uma renovação três dias atrasada, contada quando os relatórios cobrirem aquele dia.
  • Compras de teste ficam de fora. Uma assinatura suspensa continua contando; uma pausada conta como churn até ser retomada.
  • O MRR é o pedido mais recente, antes de impostos. Uma oferta introdutória conta pelo preço da oferta, e o preço normal depois aparece como uma expansão.
  • Cobranças com falha não são informadas, então esse número fica em zero.