API In-App Review di Google Play: regole e limiti

L'API permette agli utenti di valutare la tua app senza uscire dall'app. Google la descrive come un modo per "prompt users to submit Play Store ratings and reviews without the inconvenience of leaving your app or game" (chiedere agli utenti di inviare valutazioni e recensioni del Play Store senza il disagio di uscire dalla tua app o dal tuo gioco). L'utente sceglie da 1 a 5 stelle e può aggiungere un commento; una volta inviata, la recensione va al Play Store.

Perché la finestra potrebbe non apparire

• Esiste una quota. Google dice che l'API "enforces a time-bound quota on how often a user can be shown the review dialog" (applica una quota a tempo su quante volte si può mostrare la finestra di recensione a un utente). Chiamare launchReviewFlow più di una volta in un breve periodo (ad esempio meno di un mese) "might not always display a dialog" (potrebbe non mostrare sempre una finestra). La quota "can be changed by Google Play without any notice" (può essere modificata da Google Play senza preavviso).
• Non ricevi alcun risultato. La guida Kotlin/Java dice che l'API "does not indicate whether the user reviewed or not, or even whether the review dialog was shown" (non indica se l'utente ha recensito o meno, né se la finestra è stata mostrata). Continua il tuo flusso normale in ogni caso, e non mostrare alcun errore all'utente se il flusso non va a buon fine.
• Requisiti. Android 5.0 (API 21) o superiore con il Play Store installato, e Play Core 1.8.0 o superiore, secondo la panoramica al momento del recupero.

Regole per come la usi

• Attiva l'API dopo che l'utente ha usato l'app abbastanza da dare un feedback utile, e non chiedere in modo eccessivo.
• Non fare domande prima o durante la visualizzazione della scheda, incluso "Ti piace l'app?".
• Mostra la scheda così com'è: nessuna modifica di dimensione, opacità o forma, nessun overlay, e non rimuoverla via codice.
• Non offrire un pulsante che attiva l'API. In quel caso reindirizza al Play Store.
• Richiedi l'oggetto ReviewInfo in anticipo solo quando sei sicuro di avviare il flusso; scade.

Sui premi: le pagine che ho letto non trattano gli incentivi. Le valutazioni premiate non sono un'opzione; vedi acquistare recensioni per app per la policy di Play.

Progettare intorno alla quota

1. Scegli uno o due momenti di alto valore (dopo un compito completato) e fermati lì.
2. Non costruire mai logica che dipenda dal fatto che la finestra sia stata mostrata.
3. Per una voce nelle impostazioni, collega la tua scheda su Play.
4. Raccogli il feedback privato separatamente: chiedi feedback, non recensioni.

Test

Google dice che puoi testare senza pubblicare in produzione usando una traccia di test interna o la condivisione interna dell'app. Le limitazioni di quota non si applicano alle app scaricate dalla traccia di test interna. Con la condivisione interna dell'app, le recensioni non possono essere inviate. Le condizioni (account nella traccia, account principale del Play Store, nessuna recensione esistente) sono nella pagina di test di Google. Vedi anche perché le recensioni dei tester restano private.

Google può cambiare tutto questo. Ricontrolla le pagine sopra prima di ogni rilascio. Non è consulenza legale.

Inizia gratis.

Correlati: guida, perché le recensioni dei tester restano private, recensioni pubblicate dallo sviluppatore, design del prompt.