Configure a verificação de compras para seu aplicativo
Para começar a trabalhar com a Verificação de compra, você precisa garantir que configurou corretamente o SDK da Adjust em seu aplicativo e forneceu à Adjust as credenciais necessárias para autorizar compras na loja relevante.
Antes de começar
A Verificação de compra está disponível como uma solução do Adjust Growth. 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 Administrador, Editor ou Editor personalizado na Adjust
- Para criar e gerenciar credenciais da App Store:
- Google Cloud: função
Service Account Key Admin
na conta do projeto ou de serviço. - App Store Connect: direitos de
Admin
- Google Cloud: função
O que você precisa saber
- A Verificação de compra destina-se apenas a compras in-app feitas por meio da Google Play Store ou da Apple App Store. Ela não funciona para a compra de itens físicos.
- Disponível para aplicativos iOS, Android e Unity.
1. Configure o SDK da Adjust
Para integrar a Verificação de compra da Adjust em seu aplicativo, certifique-se de ter a versão mínima necessária do SDK instalada e conclua as etapas de implementação necessárias para enviar eventos de receita de compras.
2. Encontre as credenciais da App Store
Para verificar as compras em uma loja, você precisa fornecer à Adjust determinadas credenciais que nos permitam fazer a correspondência com sua conta.
Android:
Parâmetro Auth | Definição | Exemplo |
---|---|---|
Chave JSON | Sua chave JSON, baixada da página Service accounts (Contas de serviço) no console do Google Cloud. | example_key_file |
iOS:
Parâmetro Auth | Definição | Exemplo |
---|---|---|
ID do Emissor | Seu ID do emissor da aba Integrations (Integrações) no App Store Connect. | 57246542-96fe-1a63-e053-0824d011072a |
ID da chave | Seu ID da chave privada da aba Integrations (Integrações) no App Store Connect. | 2X9R4HXF34 |
Chave da API de compras in-app | Sua chave da API P8, baixada da App Store Connect. Ela autoriza o acesso aos dados do seu aplicativo pela API do servidor da App Store. | -----BEGIN PRIVATE KEY----- MIGTAgEAMBMGByqGSM49AgEGCCqGSM49AwEHBHkwdwIBAQQgNxUqm0R2vt4IrLAQr9gfDPixwSxH9wJZ6NV3X0ax4eWgCgYIKoZIzj0DAQehasda2ANCAAQx53AlofI4Of54lbR04A6D2QMbe0mt8+JtRHkJJCEUesUfySoZsm2jeh3qodLE0pZ2Rayv26qFMKuKEwemB2Op -----END PRIVATE KEY----- |
Siga as instruções da plataforma de sua loja para encontrar as credenciais necessárias.
Para Android
Para criar uma chave de conta de serviço para um projeto ou conta de serviço, sua conta de usuário deve ter a função Service Account Key Admin.
Habilite a API Android Developer do Google Play
- No console do Google Play, navegue até APIs & Services.
- Selecione + Enable APIs and Services (Habilitar APIs e serviços).
- Na área
Mobile
, selecione Google Play Android Developer API. - Selecione Enable.
- Defina as credenciais da API necessárias.
- Na área Enabled APIs & Services (APIs e serviços habilitados), selecione Google Play Android Developer API.
- Selecione Create Credentials (Criar credenciais).
- Em
Select an API
, selecione Google Play Android Developer API. - Em
What data will you be accessing?
, selecione Application data (Dados de aplicativos). - Selecione Next (Próximo).
Crie uma conta de serviço
No Google Cloud, acesse Create service account (Criar conta de serviço).
Selecione seu projeto do Google Cloud.
Insira um nome para a conta de serviço.
- Um ID de conta de serviço é gerado automaticamente.
Opcional: forneça uma descrição da conta de serviço.
Selecione Create and Continue (Criar e continuar).
Conceda à conta de serviço acesso a um projeto
- Atribua à conta de serviço a função Pub/Sub Admin.
- Selecione + Add another role.
- Atribua a função Monitoring Viewer à conta de serviço.
- Selecione Continue.
- Opcional: conceda aos usuários acesso a essa conta de serviço.
- Selecione Done.
Crie uma nova chave de API
- No Google Cloud, acesse IAM & Admin.
- Selecione Service Accounts para visualizar as contas de serviço do seu projeto.
- Para a conta de serviço que você criou, selecione Actions (ícone de três pontos).
- Selecione Manage keys ou Gerenciar chaves.
- Selecione Add Key > Create new key.
- Em Key type (Tipo de chave), selecione JSON.
- A chave privada é baixada automaticamente.
Para iOS
Você precisa ter direitos de Administrador no App Store Connect para criar e gerenciar chaves de API.
Encontre o ID do emissor
- No App Store Connect, selecione o ícone de Users and Access (Usuários e acesso).
- Selecione a aba Integrations.
- No menu Key Type à esquerda, selecione In-App Purchase.
- Na página superior da página, próximo ao ID do emissor, selecione Copy (Copiar).
Gere uma nova chave da API
Recomendamos que você gere uma chave de API dedicada à verificação da receita in-app da Adjust.
Selecione Gerar chave da API (Generate API Key) ou o ícone de + para criar uma nova chave.
- Se ainda não tiver requisitado o acesso à API na sua conta da App Store Connect account, complete a requisição.
No campo Name (Nome), insira um nome para a chave.
Selecione Generate (Gerar).
Sua nova chave da API aparecerá na lista de chaves ativas com seu ID;
Na chave gerada, passe o mouse por cima do valor na coluna Key ID (ID da chave). Selecione o link Copy Key ID (Copiar ID da chave).
Selecione Download In-App Purchase Key (Baixar chave de compra in-app).
Selecione Download para seguir.
Copie toda a chave de API do arquivo baixado.
3. Para iOS: conectar a Adjust ao App Store Connect
Siga estas etapas para adicionar as credenciais do App Store Connect no painel da Adjust:
- Na Adjust, navegue até DataWorks > Conexões .
- Selecione + Nova conexão .
- Na lista, selecione App Store Connect (Compra no aplicativo) .
- Em Serviços, selecione Verificação de compra.
- Insira seu ID do emissor.
- Insira seu ID de chave.
- Abra o arquivo .p8 em um editor de texto e copie toda a chave privada. Cole isso no campo Chave privada.
4. Adicione a verificação de compra ao seu aplicativo
Agora, aplique a verificação de compra para seu aplicativo:
Na Adjust, navegue até o AppView e selecione seu aplicativo.
Navegue até a guia Proteção .
Em Verificação de compra , selecione Editar ().
Ative a Verificação de compra.
Forneça informações específicas da plataforma:
- Para aplicativos iOS: se você tiver um aplicativo iOS, precisará selecionar a conta do App Store Connect a ser usada.
- Para aplicativos Android: carregue o arquivo de chave JSON que você baixou anteriormente.
Selecione Salvar .
E é isso, está tudo pronto!
Compartilhar dados de receita verificados com parceiros
A solução Verificação de compra da Adjust garante que somente os dados de receita verificados sejam compartilhados com seus parceiros. Isso significa que você pode confiar nos dados compartilhados e no seu uso para otimização de campanhas.
Se você já tiver configurado o compartilhamento de receita in-app com parceiros no painel da Adjust, não precisará fazer nenhuma alteração. A Adjust encaminha automaticamente apenas os dados de receita que contêm o status verified passed
.
Para configurar um novo parceiro e habilitar o compartilhamento de receita in-app verificada, siga as instruções para a configuração da rede de anúncios no Campaign Lab. Quando chegar à etapa de escolha das opções de compartilhamento de dados, selecione receita in-app.
É importante garantir que a configuração esteja correta, pois qualquer credencial incorreta inserida, codificação dupla ou outros problemas de configuração impedirão que os eventos sejam aprovados na verificação.