L'API Google Play In-App Review ti consente di chiedere agli utenti di inviare valutazioni e recensioni del Play Store senza il fastidio di dover uscire dall'app o dal gioco.
In genere, il flusso di recensione in-app (vedi figura 1) può essere attivato in qualsiasi momento durante il percorso dell'utente nella tua app. Durante il flusso, l'utente ha la possibilità di valutare la tua app utilizzando il sistema da 1 a 5 stelle e di aggiungere un commento facoltativo. Una volta inviata, la recensione viene inviata al Play Store e alla fine viene visualizzata.
Per proteggere la privacy degli utenti ed evitare l'uso improprio dell'API, esistono linee guida rigorose che la tua app deve seguire in merito a quando richiedere le recensioni in-app e alla progettazione del prompt di recensione.
Figura 1. Flusso di revisione in-app per un utente
Requisiti del dispositivo
Le recensioni in-app funzionano solo sui seguenti dispositivi:
- Dispositivi Android (smartphone e tablet) con Android 5.0 (livello API 21) o versioni successive con Google Play Store installato.
- Dispositivi ChromeOS su cui è installato il Google Play Store.
Requisiti della libreria Play Core
Per integrare le recensioni in-app nella tua app, quest'ultima deve utilizzare la versione 1.8.0 o successiva della libreria Play Core.
Quando richiedere una revisione in-app
Segui queste linee guida per decidere quando richiedere recensioni in-app agli utenti:
- Attiva il flusso di recensione in-app dopo che un utente ha utilizzato a sufficienza la tua app o il tuo gioco per fornire un feedback utile.
- Non chiedere all'utente di lasciare una recensione in modo eccessivo. Questo approccio contribuisce a ridurre al minimo la frustrazione degli utenti e a limitare l'utilizzo dell'API (vedi la sezione sulle quote).
- La tua app non deve porre domande all'utente prima o durante la presentazione del pulsante o della scheda di valutazione, incluse domande sulla sua opinione (ad esempio "Ti piace l'app?") o domande predittive (ad esempio "Valuteresti questa app con 5 stelle?").
Linee guida per il design
Segui queste linee guida per determinare come integrare le recensioni in-app nella tua app:
- Mostra la scheda così com'è, senza manomettere o modificare in alcun modo il design esistente, incluse dimensioni, opacità, forma o altre proprietà.
- Non aggiungere overlay sopra o intorno alla carta.
- La scheda e il relativo sfondo devono trovarsi nel livello più alto. Una volta visualizzata la carta, non rimuoverla a livello di programmazione. La carta viene rimossa automaticamente in base all'azione esplicita dell'utente o a un meccanismo interno del Play Store.
Quote
Per offrire un'ottima esperienza utente, Google Play applica una quota a tempo
sulla frequenza con cui un utente può visualizzare la finestra di dialogo di recensione. A causa di questa quota, chiamare
il metodo launchReviewFlow più di una volta in un breve periodo di tempo (ad esempio, meno di un mese) potrebbe non sempre visualizzare una finestra di dialogo.
Poiché la quota è soggetta a modifiche, è importante applicare la tua logica e scegliere il momento migliore possibile per richiedere una revisione. Ad esempio, non devi avere un'opzione di invito all'azione (ad esempio un pulsante) per attivare l'API, in quanto un utente potrebbe aver già raggiunto la quota e il flusso non verrà mostrato, offrendo un'esperienza non funzionante. Per questo caso d'uso, reindirizza l'utente al Play Store.
Integra le recensioni in-app nella tua app
Scopri come integrare le recensioni in-app nella tua app, a seconda dell'ambiente di sviluppo:
Termini di servizio e sicurezza dei dati
Se accedi alla libreria Play In-App Reviews o la utilizzi, accetti i Termini di servizio del kit di sviluppo software Play Core. Leggi e comprendi tutti i termini e le norme applicabili prima di accedere alla raccolta.
Sicurezza dei dati
Le librerie di base Play sono l'interfaccia di runtime della tua app con il Google Play Store. Pertanto, quando utilizzi Play Core nella tua app, il Play Store esegue i propri processi, che includono la gestione dei dati regolata dai Termini di servizio di Google Play. Le seguenti informazioni descrivono come le librerie Play Core gestiscono i dati per elaborare richieste specifiche dalla tua app.
Recensioni in-app
| Dati raccolti sull'utilizzo | Dati inseriti dall'utente (valutazione e recensione in formato libero) |
| Scopo della raccolta dei dati | I dati raccolti vengono utilizzati per lasciare una recensione sul Play Store. |
| Crittografia dei dati | I dati sono criptati. |
| Condivisione dei dati | I dati raccolti vengono utilizzati in una recensione pubblica sul Play Store o, se l'app si trova in un canale di test chiuso, vengono condivisi privatamente con lo sviluppatore dell'app. |
| Eliminazione dei dati | Gli utenti possono eliminare le proprie recensioni nel loro account Google Play Store o Account Google. |
Sebbene il nostro obiettivo sia la massima trasparenza, sei l'unico responsabile della decisione su come rispondere al modulo della sezione Sicurezza dei dati di Google Play in merito alle pratiche di raccolta, condivisione e sicurezza dei dati utente della tua app.