As ferramentas e os recursos abaixo ajudarão você a aproveitar ao máximo a API Play Integrity como parte da sua estratégia antiabuso.
Monitorar o status da API Play Integrity
O painel de status do Google Play mostra o status da API Play Integrity. Publicaremos informações sobre o status do serviço, incluindo interrupções e falhas temporárias. Se você tiver um problema que não está listado na página, entre em contato com o suporte ao desenvolvedor do Google Play.
Testar diferentes respostas da API Play Integrity no app
É possível criar testes para avaliar como a API Play Integrity interage com o app. Você pode selecionar os vereditos de integridade ou código de erro que endereços de e-mail especificados vão receber dos servidores do Google Play no app. Assim, você testa como o app reage a todas as respostas e erros possíveis.
Você pode configurar um teste no Play Console. Acesse Protegido com o Google Play no menu à esquerda. Ao lado de API Play Integrity, clique em Gerenciar e encontre Teste para começar. Para instruções detalhadas, consulte a Central de Ajuda do Play Console.
Para respostas de teste, um campo testingDetails extra aparece no
payload retornado.
"testingDetails": { "isTestingResponse": true }
Analisar as respostas da API Play Integrity que seu app está recebendo
Você pode acessar os relatórios da API Play Integrity no Play Console para entender as respostas que seu app está recebendo e identificar possíveis problemas. Para ver seu relatório, acesse Protegido com o Google Play e clique no ícone de seta para a direita na seção Monitorar a API Play Integrity.
O relatório mostra:
- O volume de solicitações padrão e clássicas que o app está fazendo.
- Um detalhamento de cada resposta de veredito para detalhes de dispositivo, app e conta. Os vereditos opcionais ainda não aparecem no relatório.
- Os códigos de erro mais comuns encontrados pelo seu app.
- Os certificados mais comuns de versões de apps não reconhecidas.
É possível filtrar o relatório por versão do app, país e versão do SO Android para ter uma visão mais detalhada dos veredictos de integridade. Os dados não são mostrados quando o volume de solicitações é baixo para proteger a privacidade do usuário.
Verificar o veredito de integridade de qualquer dispositivo
Se você precisar verificar qual veredito de integridade a API Play Integrity retorna para o app em um dispositivo específico, como ao depurar ou resolver um problema relatado pelo usuário, você pode usar o app da Play Store para gerar um veredito da API Play Integrity para o dispositivo.
Primeiro, ative as opções do desenvolvedor da Play Store no dispositivo. Toque no ícone do seu perfil e em Configurações. Abra o menu Sobre e toque na linha Versão da Play Store sete vezes para ativar o modo de desenvolvedor.
Para gerar um veredito em um dispositivo Android, abra o app da Play Store. Toque no ícone do perfil e em Configurações. Abra o menu Geral e toque em Opções do desenvolvedor. Nas configurações da Play Integrity, toque em Verificar integridade para gerar um veredito.
Ajudar os usuários a corrigir problemas de integridade
A API Play Integrity oferece várias caixas de diálogo de correção do Google Play que podem ser acionadas no seu app para ajudar os usuários a resolver problemas específicos de veredito.
Para orientar os usuários a resolver problemas de integridade do dispositivo, direcione-os ao recurso de solução de problemas no app Google Play Store. Para corrigir os problemas de integridade do dispositivo, instrua o usuário a seguir estas etapas:
- Abra o app Google Play Store.
- No canto superior direito, toque no ícone do perfil.
- Toque em Configurações > Sobre > Certificação do Play Protect.
- Toque em Corrigir problema. Esse botão só fica visível para usuários cujos dispositivos não passam nas verificações de integridade do dispositivo do Google Play. Em seguida, o usuário vai receber uma série de comandos que vão ajudar a resolver e, se possível, corrigir o problema do dispositivo.
Considere soluções completas contra fraude empresarial
Clientes empresariais que procuram uma solução completa de gerenciamento de fraudes e bots podem adquirir o reCAPTCHA Enterprise para dispositivos móveis, que conta com SDKs para Android com pontuações de risco de fraude. O reCAPTCHA Enterprise inclui automaticamente os indicadores da API Play Integrity e os combina com a rede reCAPTCHA e indicadores de aplicativos para clientes, fornecendo uma solução de gerenciamento de fraudes simples e descomplicada. Ele também pode fornecer proteção para apps Android em que a API Play Integrity não está disponível.
Receber suporte
Para informar um veredito inesperado da API Play Integrity, envie um problema com todas as informações pedidas.
Para fazer perguntas ou enviar feedback sobre a API Play Integrity, você pode:
- Entrar em contato com o suporte ao desenvolvedor do Google Play diretamente pelo Play Console.
- Preencha este formulário na Central de Ajuda do Play Console.
Se você estiver pedindo para aumentar o número de solicitações diárias que seu app faz, o processo pode levar até uma semana. Recomendamos monitorar o uso da API Play Integrity no Google Play Console ou no console do Google Cloud, em que também é possível configurar alertas de cotas para evitar interrupções no serviço.