Ti consigliamo di testare l'integrazione durante tutto lo sviluppo. Per eseguire i test durante la fase di sviluppo, ti consigliamo di utilizzare i tester delle licenze e il Play Billing Lab per esaminare gli scenari descritti in questa sezione.
Tester delle licenze
Per configurare i tester delle licenze, vedi Testare la fatturazione in-app con le licenze dell'applicazione.
L'utilizzo dei tester delle licenze offre i seguenti vantaggi:
- In genere, la Libreria Fatturazione Google Play viene bloccata per le app non firmate e caricate su Google Play. I tester delle licenze possono bypassare questo controllo, quindi puoi eseguire il sideload delle app per i test, anche per le app che utilizzano build di debug con firme di debug senza dover caricare i dati nella nuova versione dell'app. Tieni presente che il nome del pacchetto deve corrispondere a quello dell'app configurata per Google Play e che l'Account Google deve essere un tester delle licenze per l'account Google Play Console.
- I tester delle licenze hanno accesso a metodi di pagamento dei test che evitano di addebitare ai tester un importo reale per gli acquisti. Puoi anche utilizzare metodi di pagamento di prova per simulare determinate situazioni, come il rifiuto di un pagamento. La figura 1 mostra queste forme di pagamento di prova così come vengono visualizzate nel flusso di acquisto.
- I tester delle licenze possono testare rapidamente le funzionalità degli abbonamenti.
Di seguito sono riportati alcuni dettagli aggiuntivi sulla procedura di acquisto di prova:
- Gli acquisti di prova utilizzano lo stesso flusso di acquisto dell'app utilizzato dagli acquisti effettivi.
- Le imposte non vengono calcolate per gli acquisti di prova.
- Google Play indica un acquisto di prova visualizzando un avviso al centro della finestra di dialogo per l'acquisto.
Puoi confermare l'account che sta effettuando un acquisto espandendo la finestra di dialogo di acquisto. Nota:
- Gli account di prova devono essere presenti sul dispositivo Android del tester.
- Se il dispositivo dispone di più account, l'acquisto viene effettuato con l'account che ha scaricato l'app.
- Se nessuno degli account ha scaricato l'app, l'acquisto viene effettuato con il primo account.
Prima di distribuire la tua app, puoi utilizzare i canali di test di Google Play per eseguire un'ulteriore convalida. Ad esempio, puoi sfruttare i canali di test per far qualificare il team addetto al QA per una nuova release.
Con i canali di test, gli utenti possono installare la tua app da Google Play e testare una versione dell'app non ancora disponibile pubblicamente. Gli utenti possono effettuare acquisti reali utilizzando uno qualsiasi dei loro metodi di pagamento in Google Play.
Per testare l'integrazione della Libreria Fatturazione Google Play utilizzando i canali di test:
- Pubblica la tua app in un canale di test. Tieni presente che, dopo aver pubblicato un'app in un canale di test, potrebbero essere necessarie alcune ore prima che l'app sia disponibile per i tester.
- Assicurati che ogni tester attivi il test della tua app. Nell'URL di attivazione del test, i tester visualizzano una spiegazione che spiega che cosa significa essere un tester insieme a un link per l'attivazione.
Puoi testare l'integrazione su qualsiasi dispositivo hardware Android con Android 1.6 o versioni successive. Sul dispositivo deve essere installata la versione più recente dell'applicazione Google Play. Per informazioni generali su come configurare un dispositivo per l'utilizzo nello sviluppo di app Android, consulta Utilizzo di dispositivi hardware.
Lab Fatturazione Play
Play Billing Lab è un'app per Android che aiuta gli sviluppatori a testare la loro integrazione con il sistema di fatturazione di Google Play. Offre agli sviluppatori un modo semplice e pratico per testare le funzionalità di fatturazione, eseguire un'integrazione più rapida e lanciare con maggiore sicurezza. Puoi scaricare e installare Play Billing Lab dal Play Store.
Il lab di fatturazione di Play ti consente di svolgere le seguenti attività durante i test:
- Modifica il paese in Google Play da Google Play Billing Lab e applica le impostazioni al tuo test. In questo modo è possibile testare esperienze utente personalizzate in paesi/regioni diversi indipendentemente da dove il tester esegue fisicamente i test
- Testare le offerte di prova o di lancio ripetutamente con lo stesso account.
- Testa le modifiche ai prezzi degli abbonamenti senza influire sugli altri abbonati attivi
- Accelera il rinnovo dell'abbonamento per velocizzare i test
- Eseguire test con metodi di pagamento reali per aggirare determinati indicatori di rischio del flusso di acquisto
Testa i prodotti a pagamento singolo
Testa i prodotti di consumo
Durante i test di prodotti di consumo, testa una serie di situazioni, tra cui:
- Un acquisto effettuato correttamente in cui l'utente riceve un articolo. Con un tester delle licenze, puoi utilizzare il metodo di pagamento Strumento di test, approva sempre.
- Un acquisto per cui non è stato possibile addebitare l'importo sul metodo di pagamento e l'utente non dovrebbe ricevere l'articolo. Con un tester delle licenze puoi utilizzare il metodo di pagamento Strumento di test, rifiuta sempre.
- Assicurati che gli articoli possano essere acquistati più volte.
Verifica che gli acquisti siano correttamente riconosciuti come descritto nella sezione Elaborazione degli acquisti. Per gli acquisti effettuati dai tester delle licenze, l'acquisto verrà rimborsato dopo 3 minuti se la tua app non conferma l'acquisto e riceverai un'email relativa all'annullamento. Puoi anche controllare la scheda Ordini in Google Play Console per verificare se un ordine è stato rimborsato dopo tre minuti.
Testa i prodotti non consumabili
I prodotti non di consumo devono essere testati come i beni di consumo, ma devi verificare che un articolo non possa essere acquistato di nuovo all'interno della tua app. Assicurati di verificare l'accettazione dell'acquisto sia per i prodotti non di consumo che per i consumabili (se applicabile), poiché la logica di elaborazione di entrambi i tipi di acquisti varia.
Testare gli acquisti in attesa
Testa un acquisto in attesa in cui l'articolo deve essere concesso quando
lo stato acquisto diventa PURCHASED. I tester delle licenze hanno accesso a due
strumenti di test per le forme di pagamento in ritardo, in cui il pagamento viene completato
o annullato automaticamente dopo un paio di minuti.
Effettua un acquisto con una forma di pagamento in ritardo Carta di prova lenta, rifiuta dopo pochi minuti, come mostrato nella figura 3. Riavvia l'app, verifica che l'acquisto non sia stato concesso.
Figura 3. Testa un acquisto con una carta di test lenta rifiutata. Effettua un acquisto con una forma di pagamento in ritardo Carta di prova lenta, approva dopo pochi minuti, come mostrato nella figura 4. Attendi qualche minuto, verifica che l'acquisto sia stato concesso.
Figura 4. Testa un acquisto con una scheda di test lenta approvata.
Per saperne di più, consulta Gestione delle transazioni in attesa.
Testare le funzionalità specifiche dell'abbonamento
I flussi di acquisto per i prodotti a pagamento singolo e gli abbonamenti sono simili, ma gli abbonamenti presentano scenari aggiuntivi, come rinnovi dell'abbonamento riusciti o rifiutati. Per testare i rinnovi, puoi utilizzare i metodi di pagamento Scheda di test, approva sempre e Scheda di test, rifiuta sempre, disponibili per i tester delle licenze, come mostrato nella Figura 1. Utilizza questi strumenti di pagamento per testare scenari diversi da quello dell'abbonamento riuscito.
Come per i prodotti a pagamento singolo, verifica che gli acquisti siano correttamente confermati come descritto nella sezione Elaborazione degli acquisti. Per gli acquisti effettuati dai tester delle licenze, viene rimborsato un acquisto dopo 3 minuti se la tua app non conferma l'acquisto e ricevi un'email relativa all'annullamento. Puoi anche controllare la scheda Ordini in Google Play Console per vedere se un ordine è stato rimborsato dopo 3 minuti.
Periodi di rinnovo
Gli abbonamenti di prova si rinnovano più rapidamente rispetto a quelli effettivi e possono essere rinnovati per un massimo di sei volte, esclusi le prove senza costi e i periodi di lancio.
Nella tabella seguente sono elencati i tempi di rinnovo dei test per gli abbonamenti di varie durate. Questi tempi sono approssimativi. Potresti notare piccole variazioni nell'ora esatta di un evento. Per compensare le variazioni, chiama l'API per visualizzare lo stato attuale dopo ogni data di scadenza dell'abbonamento.
| Periodo di abbonamento alla produzione | Eseguire il test per il rinnovo dell'abbonamento |
| 1 settimana | 5 minuti |
| 1 mese | 5 minuti |
| 3 mesi | 10 minuti |
| 6 mesi | 15 minuti |
| 1 anno | 30 minuti |
Anche le funzionalità basate su abbonamento a tempo, come le prove senza costi, vengono abbreviate per i test. La seguente tabella identifica i periodi di tempo di test associati alle funzionalità di abbonamento basate sul tempo:
| Funzionalità | Periodo di test |
| Conferma di acquisto | 5 minuti |
| Prova gratuita | 3 minuti |
| Periodo di prezzo di lancio | Uguale al periodo di prova dell'abbonamento |
| Periodo di tolleranza | 5 minuti |
| Sospensione dell'account | 10 minuti |
| In pausa (1 mese) | 5 minuti |
| In pausa (2 mesi) | 10 minuti |
| In pausa (3 mesi) | 15 minuti |
Accelerazione del rinnovo
Puoi anche utilizzare Play Billing Lab e tester delle licenze per accelerare i periodi di rinnovo degli abbonamenti di prova seguendo questi passaggi:
- Fai clic su Gestisci nella scheda Impostazioni abbonamenti della Dashboard.
- Scegli l'abbonamento attivo che vuoi testare.
- Fai clic su Rinnova ora.
Dopo aver fatto clic sul pulsante Rinnova ora, l'abbonamento di prova verrà rinnovato poco dopo.
Tieni presente che:
- Gli abbonamenti di prova devono essere confermati prima di utilizzare la funzionalità di rinnovo accelerato, altrimenti l'abbonamento verrà annullato.
- L'esecuzione del processo di rinnovo potrebbe richiedere alcuni secondi.
- Il pulsante Rinnova ora non è disponibile quando è in vigore la variazione di prezzo.
- Quando l'abbonamento viene rinnovato, la funzionalità di modifica del prezzo dell'abbonamento non è disponibile.
Offerte di prova
Con la funzionalità di test dell'offerta di prova di Play Billing Lab, un tester delle licenze può eseguire test e utilizzare la prova senza costi o le offerte introduttive un numero illimitato di volte selezionando la casella di controllo Prova la prova senza costi o l'offerta di lancio e applicando la modifica. In questo modo non dovrai creare più account per testare un'offerta di prova disponibile solo per i nuovi abbonati.
Modifiche dei prezzi
Puoi anche usare Play Billing Lab e tester delle licenze per testare le modifiche ai prezzi dell'abbonamento senza influire su altri abbonati attivi seguendo questa procedura:
- Fai clic su Gestisci nella scheda Impostazioni abbonamenti della Dashboard.
- Scegli l'abbonamento attivo che vuoi testare.
- Inserisci il nuovo prezzo.
- Seleziona o deseleziona la casella di controllo Disattivazione utente in base ai tuoi requisiti del test.
- Fai clic su Applica.
Dopo l'applicazione delle modifiche, il prezzo viene aggiornato a partire dal successivo rinnovo solo per il tester. Gli altri abbonati attivi non saranno interessati. All'abbonamento di test si applicano tutte le regole dei tester delle licenze. Il tester può quindi testare la propria app per i processi downstream attivati dalla variazione di prezzo, come le notifiche di variazione di prezzo.
Quando pianifichi i periodi di test, tieni presente quanto segue:
- A causa di una breve durata di rinnovo per i tester delle licenze, è possibile che una migrazione dei prezzi effettuata dalla console non venga registrata per i tester delle licenze. Per garantire che le notifiche e le email relative alla variazione di prezzo possano essere testate, gli sviluppatori devono posticipare la fatturazione di almeno un'ora dopo l'attivazione di una variazione di prezzo.
- Le riduzioni di prezzo non hanno un periodo di notifica. Gli utenti vengono informati di una riduzione del prezzo subito dopo la migrazione della coorte. Questo valore non è stato modificato durante il test.
- Per gli aumenti di prezzo, i tempi di notifica dei test vengono calcolati come per gli aumenti effettivi:
- Il primo addebito viene effettuato all'utente al primo anniversario della fatturazione successivo a un periodo di notifica obbligatorio.
- I tempi di notifica vengono calcolati a partire dalla data del primo addebito.
- La notifica finale è sempre un minuto prima dell'addebito, indipendentemente dal periodo di fatturazione.
La seguente tabella mostra i periodi di fatturazione di prova e di notifica per diversi periodi di fatturazione effettivi:
| Periodo di fatturazione effettivo del piano base | Prova il periodo di fatturazione | Periodo di notifica del test (regioni di attivazione e disattivazione con preavviso di 30 giorni) | Periodo di notifica del test (regioni con disattivazione con preavviso di 60 giorni) |
| 1 settimana | 5 minuti | 5 minuti | 10 minuti |
| 1 mese | 5 minuti | 5 minuti | 10 minuti |
| 3 mesi | 10 minuti | 3 minuti | 6 minuti |
| 6 mesi | 15 minuti | 2 minuti | 4 minuti |
| 1 anno | 30 minuti | 3 minuti | 6 minuti |
Scenari di test
Espandi la sezione seguente facendo clic su Mostra/Nascondi per mostrare gli scenari di test da utilizzare per verificare l'integrazione dell'abbonamento.
Testare le transazioni in sospeso
Ti consigliamo di verificare che le transazioni in sospeso vengano gestite correttamente e che i diritti vengano
aggiornati di conseguenza quando lo stato di acquisto diventa PURCHASED. I tester delle licenze hanno accesso a due strumenti di test per le forme di pagamento in ritardo, dove il pagamento viene completato o annullato automaticamente dopo un paio di minuti.
Effettua un acquisto con una forma di pagamento in ritardo Carta di prova lenta, rifiuta dopo alcuni minuti, come mostrato nella Figura 8. Riavvia l'app, verifica che l'acquisto non sia stato concesso.
Figura 8. Testa un acquisto con una carta di test lenta rifiutata. Effettuare un acquisto con una forma di pagamento in ritardo Carta di prova lenta, approva dopo pochi minuti, come mostrato nella Figura 9. Attendi qualche minuto, verifica che l'acquisto sia stato concesso.
Figura 9. Testa un acquisto con una scheda di test lenta approvata.
Testare i codici promozionali
Puoi utilizzare Google Play Console per creare codici per i tuoi test. Tieni presente che puoi creare solo 500 codici promozionali a trimestre per tutti i prodotti gestiti in un'app.
Ti consigliamo di testare i seguenti scenari di utilizzo dei codici promozionali:
- Dopo aver inserito il codice promozionale nella finestra di dialogo di acquisto aperta all'interno dell'app.
- Quando il codice promozionale viene utilizzato nell'app Google Play Store.
- Quando il codice promozionale viene utilizzato all'indirizzo https://play.google.com/store, usa il pulsante Utilizza nel menu di navigazione a sinistra.
In questi scenari, ti consigliamo di testare l'utilizzo dei codici nel maggior numero possibile di codici. Esegui almeno i seguenti test:
- Utilizza l'offerta prima dell'installazione dell'app.
- Utilizzo mentre l'app è in esecuzione in primo piano. Tieni presente che, per questo test, ti serve un altro dispositivo con l'app Google Play Store. Assicurati di testare gli utilizzi da schermate diverse dell'app.
- Utilizzo con la modalità multi-finestra, in cui la tua app e l'app Google Play Store vengono visualizzate contemporaneamente.
Per ogni test, assicurati che l'elemento venga rilevato correttamente e che l'utente riceva una notifica.
Testare l'esperienza di acquisto in regioni diverse
Puoi testare l'esperienza di acquisto con o senza il Lab di fatturazione di Play:
Esegui il test con
L'app per Android Play Billing Lab consente di testare il flusso di acquisto in qualsiasi regione. Tuttavia, per utilizzare il Lab di fatturazione di Play, devi essere un tester delle licenze. Segui questi passaggi per eseguire il test:
- Registra l'utente con fatturazione app come tester delle licenze.
- Accedi all'app Play Billing Lab con lo stesso utente.
- Seleziona il paese che ti interessa e applica la modifica nel Lab di fatturazione di Play.
- Lancia il flusso di acquisto nell'app in fase di test.
Test senza
Puoi anche testare il flusso di acquisto in qualsiasi regione senza utilizzare il lab di fatturazione di Play. Per eseguire il test:
- Creare un nuovo account Gmail. L'account può essere creato in qualsiasi paese.
- Se vuoi, puoi impostare l'utente come tester delle licenze.
- VPN nel paese desiderato da testare.
- Avvia il flusso di acquisto.
Puoi svuotare la cache e cancellare i dati del Play Store, quindi ripetere i passaggi 3 e 4 per ogni paese che vuoi testare. Dopo essere passato a un nuovo paese, dovrai cancellare i dati per consentire al Google Play Store di rimuovere i dati relativi al paese precedente.
Entrambi questi metodi per testare gli acquisti ti consentono di testare l'idoneità a livello regionale e l'esperienza utente in qualsiasi regione, indipendentemente da dove stai testando fisicamente.
Testa l'esperienza di acquisto utilizzando metodi di pagamento reali
Puoi testare l'esperienza di acquisto con metodi di pagamento reali con l'app per Android Play Billing Lab.
Per testare i metodi di pagamento reali:
- Registra l'utente dell'Account Google come tester delle licenze.
- Accedi all'app di Play Billing Lab con lo stesso utente.
- Attiva metodi di pagamento reali nell'app Play Billing Lab.
- Riavvia e avvia il flusso di acquisto nell'app in fase di test.