API Recensioni in-app di Google Play

L'API In-App Review di Google Play ti consente di chiedere agli utenti di inviare valutazioni e recensioni sul Play Store senza dover uscire dalla tua app o dal tuo 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 un uso improprio dell'API, esistono linee guida rigorose che la tua app deve seguire su quando richiedere recensioni in-app e sul design della richiesta di recensione.

Flusso di lavoro della revisione in-app per un utente

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 superiore su cui è installato il Google Play Store.
  • Dispositivi ChromeOS su cui è installato il Google Play Store.

Requisiti della libreria Play Core

Per integrare le recensioni in-app nella tua app, devi utilizzare la versione 1.8.0 o successiva della libreria Play Core.

Quando richiedere una recensione in-app

Segui queste linee guida per decidere quando richiedere agli utenti di recensire l'app:

  • Attiva il flusso di recensione in-app dopo che un utente ha utilizzato la tua app o il tuo gioco per un tempo sufficiente a fornire un feedback utile.
  • Non chiedere eccessivamente all'utente di scrivere una recensione. Questo approccio contribuisce a minimizzare la frustrazione degli utenti e a limitare l'utilizzo dell'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 "Darei 5 stelle a questa app").

Linee guida per il design

Segui queste linee guida per decidere come integrare le recensioni in-app nella tua app:

  • Mostrare la carta così com'è, senza manomettere o modificare il design esistente in alcun modo, incluse dimensioni, opacità, forma o altre proprietà.
  • Non aggiungere elementi sovrapposti sulla carta o intorno alla carta.
  • La scheda e il relativo sfondo devono trovarsi nel livello più alto. Una volta visualizzata la scheda, non rimuoverla tramite programmazione. 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 limitata nel tempo alla frequenza con cui a un utente può essere mostrata la finestra di dialogo di revisione. A causa di questa quota, l'eventuale chiamata del metodo launchReviewFlow più di una volta in un breve periodo di tempo (ad esempio meno di un mese) potrebbe non comportare sempre la visualizzazione di una finestra di dialogo.

Poiché la quota è soggetta a modifiche, è importante applicare la tua logica e scegliere come target il momento migliore per richiedere una revisione. Ad esempio, non deve essere presente un'opzione di invito all'azione (ad esempio un pulsante) per attivare l'API, poiché un utente potrebbe aver già raggiunto la propria quota e il flusso non verrà mostrato, presentando un'esperienza inaccessibile all'utente. Per questo caso d'uso, reindirizza l'utente al Play Store.

Integrare 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 di recensioni in-app di Play 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 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 le proprie procedure, che includono la gestione dei dati ai sensi dei Termini di servizio di Google Play. Le seguenti informazioni descrivono in che modo le librerie Play Core gestiscono i dati per elaborare richieste specifiche della tua app.

Recensioni in-app

Dati raccolti sull'utilizzo Dati inseriti dall'utente (valutazione e recensione in 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 revisione pubblica sul Play Store o, se l'app è in un canale di test chiuso, vengono condivisi in privato con lo sviluppatore dell'app.
Eliminazione dei dati Gli utenti possono eliminare le proprie recensioni nel proprio account Google Play Store o nel proprio Account Google.

Cerchiamo di essere il più trasparenti possibili, ma sei l'unico responsabile della decisione su come rispondere al modulo della sezione Sicurezza dei dati di Google Play per quanto riguarda le modalità di raccolta, condivisione e sicurezza dei dati utente della tua app.