Estamos sempre publicando atualizações em nossa documentação, mas pode ser que elas ainda não estejam disponíveis em seu idioma. Para ter acesso às informações mais atualizadas, use a ​​versão em inglês.

Configuração de assinaturas para aplicativos Android

Para a Adjust se comunicar com o Google, você precisa fornecer um conjunto de credenciais de serviço. Neste artigo, aprenda como vincular seu projeto do Google Cloud ao Play Console e autorizá-lo usando uma conta de serviço.

  1. Configure notificações do desenvolvedor em tempo real para Android na sua conta do Google Play. Quando você configura as notificações do servidor, a Google Play Store notifica a Adjust sobre as atualizações nas assinaturas do seu aplicativo. Isso permite que a Adjust acione eventos de assinatura em tempo hábil.
  2. Crie a chave pública JSON para sua conta de serviço do Google. Você precisa da chave JSON para conectar sua conta de serviço do Google à Adjust.
  3. Conceda acesso financeiro à sua conta de serviço.
  4. Conecte sua conta de serviço do Google à Adjust.

Antes de começar

O que você precisa saber antes de começar.

Solução para crescimento:

Assinaturas está disponível como uma das soluções para crescimento da Adjust. Fale com seu representante da Adjust ou entre em contato pelo e-mail sales@adjust.com para que isso seja adicionado ao seu pacote.

Requisitos

  • Permissões de Account owner no Google Play Console
  • Permissões para criar tópicos, assinaturas e atribuir funções no Google Cloud Console.
  • Permissões de Administrador, Editor ou Editor personalizado na Adjust para conectar suas credenciais da conta de serviço do Google à Adjust.

Configurar notificações de desenvolvedor em tempo real

Crie uma assinatura push

  1. Abra Topics no Google Cloud console.

  2. Selecione seu projeto.

  3. Selecione Create topic (Criar tópico).

  4. Forneça um ID de tópico e selecione Create (Criar).

  5. Agora, no painel de navegação à esquerda, em Pub/Sub, selecione Subscriptions (Assinaturas).

  6. Selecione Create subscription (Criar assinatura).

  7. Forneça um ID de assinatura.

  8. Na lista Select a Cloud Pub/Sub topic (Selecione um tópico do Pub/Sub do Cloud), selecione o tópico que você criou no passo 4.

  9. Em Delivery type (Tipo de entrega), selecione Push.

  10. No campo Endpoint URL (URL do endpoint), insira https://subscription.adjust.com/v3/playstore.

  11. Em Retry policy (Política de nova tentativa), selecione Retry after exponential backoff delay (Tentar novamente após atraso na espera exponencial) e insira:

    • Tempo mínimo de espera: 10
    • Tempo máximo de espera: 600

  12. Selecione Create (Criar).

Adicione um principal à sua assinatura

  1. Selecione a assinatura criada e, em seguida, Add prinicipal (Adicionar principal).
  2. No campo New principals (Novos principais), insira google-play-developer-notifications@system.gserviceaccount.com.
  3. Na lista Assign roles (Atribuir funções), selecione Pub/Sub Publisher.
  4. Selecione Save (Salvar).

Copie o valor do nome do tópico

  1. Abra Topics no Google Cloud console.
  2. Selecione o tópico que você adicionou ao criar uma assinatura push e copie o valor do nome do tópico.
    • Você pode ter que selecionar (ícone de seta para baixo) para ver o nome completo do tópico. Depois, selecione (ícone de Copiar) para copiar o valor do nome do tópico.

Você precisará desse valor na próxima etapa.

Habilite as notificações do desenvolvedor em tempo real para seus aplicativos

  1. Abra o Google Play Console.
  2. Selecione seu aplicativo.
  3. Em Monetize (Monetizar), selecione Monetization setup (Configuração de monetização).
  4. Role para baixo até a seção Google Play Billing (Faturamento do Google Play).
  5. Para Manage notifications (Gerenciar notificações), selecione Enable real-time notifications (Habilitar notificações em tempo real).
  6. No campo Topic name (Nome do tópico), cole o nome do tópico que você copiou na etapa anterior.
  7. Selecione Save changes (Salvar alterações).

Repita os passos 2 a 7 para todo aplicativo para o qual você deseja configurar assinaturas.

Criar a chave pública JSON

Habilite a API Android Developer do Google Play

  1. Abra o Google Play Console.
  2. Selecione um projeto existente ou crie um novo.
  3. Abra APIs & Services > Enabled APIs and services (APIs e serviços > APIs e serviços habilitados).
  4. Selecione + Enable APIs and Services (Habilitar APIs e serviços).
  5. Busque e selecione a Google Play Android Developer API e, em seguida, clique em Enable (Habilitar).
  6. Selecione Create Credentials (Criar credenciais).
  7. Em Which API are you using? (Que API você está usando?), selecione Google Play Android Developer API.
  8. Em What data will you be accessing? (Quais dados você vai acessar?), selecione Application data (Dados do aplicativo) e, em seguida, clique em Next (Próximo).
Importante:

Pode levar até 36 horas para suas credenciais funcionarem de forma adequada com a API do Google Play Developer.

Crie uma conta de serviço

Você adicionou seu produto ao Play Console antes de criar uma conta de serviço?

Importante

Para criar uma conta de serviço, siga estes passos:

  1. Abra o Google Cloud Console.

  2. Selecione o mesmo projeto que você escolheu na etapa anterior.

  3. Abra IAM & Admin > Service Accounts (IAM e admin > Contas de serviço).

  4. Selecione Create Service Account (Criar conta de serviço).

  5. Em Service account details (Detalhes da conta de serviço), forneça um nome para sua conta de serviço.

    • Isso preencherá o campo Service account ID (ID da conta de serviço). Esse é o e-mail da conta de serviço.

  6. Selecione Create and Continue (Criar e continuar).

  7. Em Grant this service account access to project (optional) (Conceder a essa conta de serviço acesso ao projeto – opcional), escolha as funções a seguir e clique em Continue (Continuar).

    • Service Account Key Admin: permite criar e gerenciar chaves de contas de serviço.
    • Pub/Sub Admin: habilita notificações do servidor da plataforma.
    • Monitoring Viewer: permite o monitoramento da fila de notificações.

  8. Selecione Done (Concluído) para voltar à página de contas de serviço.

No Google Cloud Console, selecione Create Service Account.

1/2

Gere as credenciais da sua chave pública

Para gerar as credenciais da sua chave pública, siga estes passos:

  1. Abra o Google Cloud Console.
  2. Selecione o mesmo projeto que você escolheu na etapa anterior.
  3. Abra IAM & Admin > Service Accounts (IAM e admin > Contas de serviço).
  4. Para a conta de serviço que você criou, em Actions (Ações), selecione Manage keys (Gerenciar chaves).
  5. Selecione Add Key > Create new key (Adicionar chave > Criar nova chave).
  6. Selecione Key type (Tipo de chave) como JSON e depois Create (Criar).

Para sua conta de serviço, selecione Manage keys.

1/3

Conceder acesso financeiro

Para conceder acesso financeiro à sua conta de serviço, siga estes passos.

No Google Cloud Console

  1. No Google Cloud Console, selecione o mesmo projeto que você escolheu na etapa anterior.
  2. Abra IAM & Admin > Service Accounts (IAM e admin > Contas de serviço).
  3. Copie o valor de Email da conta de serviço que você criou.
    • Você precisará desse e-mail na próxima etapa.

No Google Play Console

  1. Abra o Google Play Console.

  2. Selecione Users and permissions > Invite new users (Usuários e permissões > Convidar novos usuários).

  3. Insira o endereço de e-mail da conta de serviço que você obteve na etapa anterior.

  4. Em App permissions (Permissões do aplicativo), adicione o seu aplicativo.

  5. Em Account permissions (Permissões da conta), selecione as seguintes permissões:

    • View app information (read-only) (Ver informações do aplicativo –somente leitura);
    • View financial data (Ver dados financeiros);
    • Manage orders and subscriptions (Gerenciar pedidos e assinaturas).

  6. Selecione Invite user (Convidar usuário) e, em seguida, clique em Send invite (Enviar convite).

No Google Play Console, em API access, selecione Grant access para conceder o acesso.

1/3

Se essas opções não estiverem disponíveis, talvez você não tenha as permissões de conta corretas. Contate o Proprietário da Conta ou Administrador.

Conectar a conta de serviço do Google à Adjust

Siga estes passos para adicionar suas credenciais da conta de serviço do Google à Adjust.

  1. Em DataWorks, selecione Conexões.
  2. Selecione + Nova conexão .
  3. Em Parceiro, selecione Conta de serviço do Google.
  4. Em Serviços, selecione Assinatura.
  5. No campo Arquivo de credenciais, carregue o arquivo JSON que você baixou na etapa Gerar credenciais da sua chave pública.
  6. Selecione Conectar.

➡️ A seguir: Habilite Assinaturas para seu aplicativo no sistema da Adjust.