Integração Direta com a Google Play Store para Android

Notificações em Tempo Real para Desenvolvedores

As Notificações em Tempo Real para Desenvolvedores RTDN são necessárias para permitir que o Insert Affiliate rastreie eventos de compra.

1. Defina o Método de Verificação de Compra do Insert Affiliate

Nas configurações do Insert Affiliate, defina seu In-App Purchase Verification Method como "I don't use a Receipt Validatior (Native App Store / Google Play Integration)."

  • Após alterar essa configuração, uma nova seção chamada "Google Play Store Pub/Sub Endpoint URL" aparecerá, contendo uma URL — você precisará dela mais tarde.

2. Habilite o Google Cloud Pub/Sub para o Seu Projeto

  1. Acesse o Google Cloud Console, fazendo login com a conta Google associada ao seu app.
  2. Crie um novo projeto ou selecione um projeto existente.
  3. Habilite a Cloud Pub/Sub API, que pode ser encontrada aqui

3. Crie um Tópico Pub/Sub

  1. Crie um novo tópico aqui, definindo o Topic ID como insert-affiliate.
  2. Deixe as configurações padrão e clique em Create.

4. Crie uma Conta de Serviço

  1. Acesse a página Service Accounts no Google Cloud Console.
  2. Clique em Create Service Account, informe um nome (ex.: insert-affiliate) e clique em Create.
  3. Copie o endereço de e-mail da conta de serviço que você acabou de criar.

5. Crie uma Chave para a Conta de Serviço

  1. Clique na conta de serviço que você acabou de criar.
  2. Clique em Add Key > Create new key.
  3. Selecione JSON e clique em Create.
  4. Faça o upload da Service Key que foi baixada na página de configurações do Insert Affiliate, em Google Service Account Key.
  5. Clique em Save.

5.1 Atribua Funções IAM à Conta de Serviço

Antes de prosseguir, você precisa conceder as permissões corretas à conta de serviço no Google Cloud IAM.

  1. Acesse o Google Cloud IAM & Admin.
  2. Encontre a Service Account que você acabou de criar; se ela não existir, selecione Grant Access e defina o New Principal como o endereço de e-mail da conta de serviço criada no passo 4.
  3. Clique em Edit Permissions.
  4. Atribua as seguintes funções:
  • Pub/Sub Admin (para lidar com notificações da Google Play)
  1. Clique em Save para aplicar as alterações.

Agora, sua conta de serviço tem as permissões necessárias para interagir com

6. Configure as Permissões do Pub/Sub

  1. Acesse a seção Topics no Google Cloud Console, selecionando o tópico insert-affiliate que você acabou de criar.
  2. Em Topic Settings, clique em Add Principal.
  3. Cole o endereço de e-mail da conta de serviço que você criou no passo 4.
  4. No dropdown Role, selecione Pub/Sub Publisher e clique em Save.

7. Adicione a Conta de Notificações da Google Play ao Tópico Pub/Sub

  1. Acesse a seção Topics no Google Cloud Console, selecionando o tópico insert-affiliate que você acabou de criar.
  2. Em Topic Settings, clique em Add Principal.
  3. Cole o endereço de e-mail google-play-developer-notifications@system.gserviceaccount.com
  4. No dropdown Role, selecione Pub/Sub Publisher e clique em Save.

8. Crie uma Assinatura

  1. Acesse a seção Subscriptions no Google Cloud Console.
  2. Selecione o tópico insert-affiliate.
  3. Clique em Edit.
  4. Altere o Delivery Type para Push.
  5. Cole a Google Play Store Pub/Sub Endpoint URL das configurações do Insert Affiliate, obtida no Passo 1, no campo Push Endpoint.
  6. Clique em Update para salvar as alterações.

9. Habilite a Google Play Android Developer API

Antes de conceder permissões, certifique-se de que a Google Play Android Developer API está habilitada:

  1. Acesse a página da Google Play Android Developer API no Google Cloud Console.
  2. Clique em Enable API.

10. Conceda Permissões no Google Play Console

  1. Acesse Users and Permissions no Google Play Console.
  2. Clique em Invite new users.
  3. Insira o endereço de e-mail da conta de serviço que você criou no passo 4.
  4. Selecione o app para o qual deseja conceder permissões
  • Conceda a permissão Financial Data: View Financial Data and Manage Orders and Subsciprtions.
  1. Pressione Apply para salvar as alterações.

10.1 Atualize as Assinaturas Ativas

Se você usava anteriormente um método diferente de validação de recibos, talvez precise desativar e reativar suas assinaturas na Google Play para garantir que sejam reconhecidas corretamente pelo Insert Affiliate.

  1. Acesse o Google Play Console.
  2. Selecione seu app.
  3. Navegue até Monetise with Play > Subscriptions.
  4. Selecione cada assinatura ativa e desative-a temporariamente.
  5. Após alguns instantes, reative as assinaturas.
  6. Isso força a Google Play a reconhecer a nova integração com o Insert Affiliate.

11. Habilite as RTDN no Seu App no Google Play Console

  1. Acesse o Google Play Console.
  2. Selecione seu app.
  3. Na navegação à esquerda, selecione Monetise with Play > Monetisation Setup.
  4. Habilite a caixa de seleção *Real-time developer notifications.
  5. Adicione o Topic Name como projects/{{ProjectID}}/topics/{{TopicID}} (substitua {{ProjectId}} e {{TopicID}} pelos IDs do Google Cloud Project e do Topic definidos anteriormente). Para o exemplo acima, o Topic Name seria projects/insert-affiliate/topics/insert-affiliate.
  • Você pode encontrar o ID do seu Google Cloud Project aqui.
  • Você pode encontrar o ID do seu Google Cloud Topic aqui.
  1. O conteúdo da notificação deve ser definido como Subscriptions, voided purchases and all one-time products.
  2. Clique em Save.

12. Se Você Anteriormente Não Validava Recibos

Se você anteriormente não validava recibos, talvez precise desativar e reativar suas assinaturas na Google Play para garantir que sejam reconhecidas corretamente pelo Insert Affiliate.

  1. Acesse o Google Play Console.
  2. Selecione seu app.
  3. Navegue até Monetise with Play > Subscriptions.
  4. Selecione cada assinatura ativa e desative-a temporariamente.
  5. Após alguns instantes, reative as assinaturas.
  6. Isso força a Google Play a reconhecer a nova integração com o Insert Affiliate.

Integre o SDK do Insert Affiliate

Para concluir a integração, siga os passos finais de integração detalhados no SDK do Insert Affiliate para a sua plataforma específica: