L'API Google Play In-App Review ti consente di chiedere agli utenti di inviare valutazioni e recensioni del Play Store senza l'inconveniente di uscire dall'app o dal gioco.
In genere, il flusso di revisione in-app (vedi figura 1) può essere attivato in qualsiasi momento durante il percorso dell'utente all'interno dell'app. Durante la procedura, l'utente può valutare la tua app utilizzando il sistema da 1 a 5 stelle e aggiungere un commento facoltativo. Una volta inviata, la recensione viene inviata al Play Store e infine visualizzata.
Per proteggere la privacy degli utenti ed evitare l'uso improprio delle API, la tua app deve seguire linee guida rigorose in merito a quando richiedere le revisioni in-app e alla progettazione della richiesta di revisione.
Figura 1. Flusso di revisione in-app di 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 su cui è installato Google Play Store.
- Dispositivi ChromeOS su cui è installato il Google Play Store.
Requisiti della libreria di base di Play
Per integrare le recensioni in-app nella tua app, questa deve utilizzare la versione 1.8.0 o successive della raccolta di Play Core.
Quando richiedere una revisione in-app
Segui queste linee guida per decidere quando richiedere revisioni in-app agli utenti:
- Attiva il flusso di revisione in-app dopo che un utente ha sperimentato una quantità sufficiente della tua app o del tuo gioco da fornire feedback utili.
- Non chiedere eccessivamente all'utente di scrivere una recensione. Questo approccio aiuta a ridurre al minimo la frustrazione degli utenti e a limitare l'utilizzo delle API (consulta la sezione sulle quote).
- L'app non deve porre all'utente domande 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 "Valutare questa app 5 stelle").
Linee guida per la progettazione
Segui queste linee guida per stabilire 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 sulla parte superiore o intorno alla scheda.
- La carta e lo sfondo devono trovarsi sul livello più alto. Una volta visualizzata la carta, non rimuoverla in modo programmatico. La scheda viene rimossa automaticamente in base all'azione esplicita dell'utente o a un meccanismo interno del Play Store.
Quote
Per offrire un'esperienza utente ottimale, Google Play applica una quota vincolata al tempo per determinare la frequenza con cui a un utente può essere mostrata la finestra di dialogo della recensione. A causa di questa quota, se chiami il metodo launchReviewFlow più di una volta in un breve periodo di tempo (ad esempio meno di un mese), potrebbe non essere sempre visualizzata una finestra di dialogo.
Poiché la quota è soggetta a modifiche, è importante applicare la propria logica e scegliere il momento migliore possibile per richiedere una revisione. Ad esempio, non dovresti avere un'opzione di invito all'azione (come un pulsante) per attivare l'API, perché un utente potrebbe aver già raggiunto la quota e il flusso non verrà visualizzato, causando un'esperienza non funzionante all'utente. 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 del tuo ambiente di sviluppo:
Termini di servizio e sicurezza dei dati
Se accedi alla libreria recensioni in-app o la usi, accetti i Termini di servizio del kit di sviluppo software principale di Play. Leggi e comprendi tutti i termini e le norme applicabili prima di accedere alla libreria.
Sicurezza dei dati
Le librerie Play Core 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, tra cui la gestione dei dati ai sensi dei Termini di servizio di Google Play. Le informazioni di seguito descrivono il modo in cui 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 revisione a testo 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 oppure, se l'app si trova in un canale di test chiuso, i dati raccolti vengono condivisi privatamente con lo sviluppatore dell'app. |
| Eliminazione dei dati | Gli utenti possono eliminare le recensioni nell'account Google Play Store o nell'Account Google. |
Cerchiamo di essere il più trasparenti possibile, ma sei l'unico responsabile nel decidere come rispondere al modulo della sezione Sicurezza dei dati di Google Play in merito alle misure di raccolta, condivisione e sicurezza dei dati utente della tua app.