I seguenti strumenti e risorse ti aiuteranno a utilizzare al meglio l'API Play Integrity nell'ambito della tua strategia anti-abuso.
Monitorare lo stato dell'API Play Integrity
La dashboard dello stato di Google Play mostra le informazioni sullo stato dell'API Play Integrity. Verranno pubblicate informazioni sullo stato del servizio, incluse eventuali interruzioni e problemi. Se stai riscontrando un problema non elencato nella pagina, contatta l'assistenza per gli sviluppatori Google Play.
Testare diverse risposte dell'API Play Integrity all'interno dell'app
Puoi creare test per valutare l'interazione dell'API Play Integrity con la tua app. Per gli indirizzi email specificati, puoi selezionare gli esiti dell'integrità o il codice di errore che devono ricevere nella tua app dai server di Google Play. In questo modo puoi testare la reazione della tua app a tutte le possibili risposte ed errori.
Puoi configurare un test in Play Console. Vai a Protetto con Play dal menu a sinistra. Accanto ad API Play Integrity, fai clic su Gestisci e trova Test per iniziare. Per istruzioni dettagliate, consulta il Centro assistenza Play Console.
Tieni presente che per le risposte di test viene visualizzato un campo testingDetails aggiuntivo nel
payload restituito.
"testingDetails": { "isTestingResponse": true }
Analizzare le risposte dell'API Play Integrity che riceve la tua app
Puoi accedere ai report per l'API Play Integrity in Play Console per comprendere le risposte che riceve la tua app e identificare potenziali problemi. Per visualizzare il report, vai a Protetto con Google Play e fai clic sull'icona della freccia destra nella sezione Monitora l'API Play Integrity.
Il report mostra:
- Il volume di richieste standard e classiche effettuate dalla tua app.
- Una suddivisione di ogni risposta del verdetto per i dettagli di dispositivo, app e account. Gli esiti facoltativi non vengono ancora visualizzati nel report.
- I codici di errore più comuni riscontrati dalla tua app.
- I certificati più comuni delle versioni dell'app non riconosciute.
Puoi filtrare il report in base alla versione dell'app, al paese e alla versione del sistema operativo Android per ottenere una visualizzazione più dettagliata dei verdetti di integrità. I dati non vengono mostrati quando il volume di richieste è basso per proteggere la privacy degli utenti.
Controllare l'esito relativo all'integrità del dispositivo da qualsiasi dispositivo
Se devi verificare quale esito relativo all'integrità restituisce l'API Play Integrity per la tua app su un determinato dispositivo, ad esempio durante il debug o la risoluzione dei problemi di un problema segnalato dall'utente, puoi utilizzare l'app Play Store per generare un esito dell'API Play Integrity per quel dispositivo.
Innanzitutto, attiva le opzioni sviluppatore del Play Store sul dispositivo. Tocca l'icona del tuo profilo e poi tocca Impostazioni. Apri il menu Informazioni e tocca sette volte la riga con l'etichetta Versione del Play Store per sbloccare la modalità sviluppatore.
Poi, per generare un verdetto da un dispositivo Android, apri l'app Play Store. Tocca l'icona del tuo profilo, quindi Impostazioni. Apri il menu Generali, quindi tocca Opzioni sviluppatore. Nelle impostazioni di Play Integrity, tocca Verifica l'integrità per generare un esito.
Controllare l'integrità su un dispositivo remoto
Puoi anche avviare un controllo dell'integrità su un dispositivo Wear OS, Android Automotive OS o dispositivo Android TV connesso direttamente dal tuo smartphone principale. In questo modo, puoi ottenere esiti integrità del dispositivo su questi fattori di forma.
Per eseguire un controllo dell'integrità remoto:
- Assicurati che sia lo smartphone principale sia il dispositivo di destinazione, ad esempio uno smartwatch, un'auto o una TV, siano connessi allo stesso Account Google.
- Sul tuo smartphone principale, apri l'app Play Store e vai a Impostazioni > Generali > Opzioni sviluppatore.
- Nella sezione Play Integrity, tocca la freccia di espansione sul pulsante diviso Controlla l'integrità per visualizzare i dispositivi connessi.
- Seleziona il dispositivo di destinazione dall'elenco a discesa.
Lo smartphone attiva il controllo sul dispositivo remoto e mostra il risultato una volta completata l'operazione.
Aiutare gli utenti a risolvere i problemi di integrità
L'API Play Integrity fornisce varie finestre di dialogo di correzione di Google Play che puoi attivare all'interno della tua app per aiutare gli utenti a risolvere problemi specifici relativi agli esiti.
Per guidare gli utenti nella risoluzione dei problemi di integrità del dispositivo, puoi indirizzarli alla funzionalità di risoluzione dei problemi all'interno dell'app Play Store. Per risolvere i problemi di integrità del dispositivo, chiedi all'utente di svolgere i seguenti passaggi:
- Apri l'app Google Play Store.
- In alto a destra, tocca l'icona del profilo.
- Tocca Impostazioni > Informazioni > Certificazione Play Protect.
- Tocca Risolvi problema dispositivo. Questo pulsante è visibile solo agli utenti i cui dispositivi non superano i controlli di integrità del dispositivo Play. L'utente vedrà quindi una serie di prompt che lo aiuteranno a risolvere il problema e, se possibile, a riparare il dispositivo.
Prendi in considerazione soluzioni aziendali end-to-end per la prevenzione delle frodi
I clienti aziendali che cercano una soluzione completa di gestione di frodi e bot possono acquistare reCAPTCHA Enterprise per il mobile, che include SDK per Android che forniscono agli sviluppatori punteggi di rischio di frode. reCAPTCHA Enterprise include automaticamente gli indicatori dell'API Play Integrity e li combina con gli indicatori di rete e delle applicazioni reCAPTCHA per i clienti, fornendo una soluzione di gestione delle frodi invisibile e senza problemi pronta all'uso. Può anche fornire protezione per le app per Android in cui l'API Play Integrity non è disponibile.
Ricevi assistenza
Per segnalare un esito imprevisto dell'API Play Integrity, invia un problema con tutte le informazioni richieste.
Per porre domande o fornire feedback sull'API Play Integrity, puoi:
- Contatta l'assistenza per gli sviluppatori di Google Play direttamente da Play Console.
- Compila questo modulo nel Centro assistenza Play Console.
Se richiedi di aumentare il numero di richieste giornaliere effettuate dalla tua app, potrebbero essere necessari fino a una settimana. Ti consigliamo vivamente di monitorare l'utilizzo dell'API Play Integrity in Google Play Console o in console Google Cloud, dove puoi anche configurare avvisi quota, per evitare interruzioni del servizio.