Devi testare l'integrazione durante tutto lo sviluppo. Per eseguire test durante la fase di sviluppo, ti consigliamo di utilizzare i tester delle licenze e il Play Billing Lab per eseguire 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 è bloccata per le app che non sono firmate e caricate su Google Play. I tester delle licenze possono ignorare questo controllo, il che significa che puoi eseguire il sideload delle app per i test, anche per le app che utilizzano build di debug con firme di debug senza doverle caricare nella nuova versione della tua app. Tieni presente che il nome del pacchetto deve corrispondere a quello dell'app configurata per Google Play e 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 di prova che evitano di addebitare ai tester denaro reale per gli acquisti. Puoi anche utilizzare metodi di pagamento di test per simulare determinate situazioni, ad esempio quando un pagamento viene rifiutato. La figura 1 mostra questi metodi di pagamento di test così come appaiono nel flusso di acquisto.
- I tester delle licenze possono testare rapidamente le funzionalità di abbonamento.
Ecco alcuni dettagli aggiuntivi sulla procedura di acquisto di test:
- Gli acquisti di test utilizzano lo stesso flusso di acquisto in-app utilizzato per gli acquisti effettivi.
- Le imposte non vengono calcolate per gli acquisti di test.
- Google Play indica un acquisto di test visualizzando una notifica al centro della finestra di dialogo di acquisto.
Puoi confermare l'account che sta effettuando un acquisto espandendo la finestra di dialogo di acquisto. Nota:
- Gli account di test devono trovarsi sul dispositivo Android del tester.
- Se sul dispositivo sono configurati 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 track di test di Google Play per eseguire una convalida aggiuntiva. Ad esempio, puoi utilizzare i canali di test per consentire al tuo team addetto al QA di qualificare una nuova release.
Con i canali di test, gli utenti possono installare la tua app da Google Play e testare una versione non ancora disponibile pubblicamente. Gli utenti possono effettuare acquisti reali utilizzando uno qualsiasi dei loro metodi di pagamento su Google Play.
Per testare l'integrazione di 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 accetti di partecipare al test della tua app. Nell'URL di attivazione del test, i tester vedono una spiegazione di cosa significa essere un tester e un link per l'attivazione.
Puoi testare l'integrazione su qualsiasi dispositivo hardware basato su 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 applicazioni Android, vedi Utilizzo di dispositivi hardware.
Lab Fatturazione Play
Lab Fatturazione Play è un'app per Android che aiuta gli sviluppatori a testare l'integrazione con il sistema di fatturazione di Google Play. Offre agli sviluppatori un modo semplice e comodo per testare le funzionalità di fatturazione, eseguire l'integrazione più rapidamente e lanciare le app con maggiore sicurezza. Puoi scaricare e installare Play Billing Lab dal Play Store.
Play Billing Lab ti consente di eseguire le seguenti operazioni durante i test:
- Modifica il paese di Play in Play Billing Lab e applica le impostazioni al test. In questo modo è possibile testare esperienze utente personalizzate in diversi paesi/regioni indipendentemente da dove si trova fisicamente il tester.
- Testare ripetutamente le prove o le offerte di lancio con lo stesso account
- Testare le variazioni di prezzo degli abbonamenti senza influire sugli altri abbonati attivi
- Accelerare i rinnovi degli abbonamenti per velocizzare i test
- Esegui il test con metodi di pagamento reali per ignorare determinati indicatori di rischio del flusso di acquisto
Testare i prodotti a pagamento singolo
Testare i prodotti di consumo
Quando esegui il test di prodotti di consumo, prova diverse situazioni, tra cui:
- Un acquisto riuscito 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 in cui non è stato possibile addebitare l'importo sul metodo di pagamento e l'utente non deve 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 vengano riconosciuti correttamente come descritto in Elaborazione degli acquisti. Per gli acquisti dei tester delle licenze, un acquisto verrà rimborsato dopo 3 minuti se la tua app non riconosce l'acquisto e riceverai 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.
Testare i prodotti non di consumo
I non consumabili devono essere testati come i consumabili, ma devi verificare che un articolo non possa essere acquistato di nuovo all'interno della tua app. Assicurati di verificare la conferma dell'acquisto sia per i non consumabili che per i consumabili (se applicabile), poiché la logica di elaborazione di ciascuno dei due tipi di acquisto varia.
Testare gli acquisti in attesa
Testa un acquisto in attesa in cui l'articolo deve essere concesso quando
lo stato dell'acquisto diventa PURCHASED. I tester delle licenze hanno accesso a due
strumenti di test per le forme di pagamento differite in cui il pagamento viene completato
o annullato automaticamente dopo un paio di minuti.
Effettua un acquisto con una forma di pagamento ritardata Carta di prova lenta, rifiuta dopo qualche minuto, 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 prova lenta rifiutata. Effettua un acquisto con una forma di pagamento ritardata Carta di prova lenta, approva dopo qualche minuto, come mostrato nella figura 4. Attendi qualche minuto, verifica che l'acquisto sia stato concesso.
Figura 4. Testa un acquisto con una carta di prova lenta approvata.
Per saperne di più, consulta la sezione Gestione delle transazioni in sospeso.
Testare le funzionalità specifiche dell'abbonamento
I flussi di acquisto per prodotti una tantum e abbonamenti sono simili, ma gli abbonamenti hanno scenari aggiuntivi, come i rinnovi riusciti o rifiutati. Per testare i rinnovi, puoi utilizzare i metodi di pagamento Scheda di verifica, approva sempre e Scheda di verifica, rifiuta sempre disponibili per i tester delle licenze, come mostrato nella figura 1. Utilizza questi strumenti di pagamento per testare scenari diversi da quello di abbonamento riuscito.
Come per i prodotti a pagamento singolo, verifica che gli acquisti siano riconosciuti correttamente come descritto in Elaborazione degli acquisti. Per gli acquisti dei tester delle licenze, un acquisto viene rimborsato dopo 3 minuti se la tua app non riconosce 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 test vengono rinnovati più rapidamente rispetto agli abbonamenti effettivi e possono essere rinnovati un massimo di sei volte, senza contare le prove senza costi e i periodi introduttivi.
La tabella seguente elenca 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 la variazione, chiama l'API per visualizzare lo stato attuale dopo ogni data di scadenza dell'abbonamento.
| Periodo di abbonamento alla produzione | Testa 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à di abbonamento basate sul tempo, come le prove senza costi, vengono ridotte per i test. La tabella seguente identifica i periodi di test associati alle funzionalità di abbonamento basate sul tempo:
| Funzionalità | Periodo di prova |
| Conferma di acquisto | 5 minuti |
| Prova gratuita | 3 minuti |
| Periodo del prezzo di lancio | Uguale al periodo di prova dell'abbonamento |
| Periodo di tolleranza | 5 minuti |
| Sospensione dell'account | 10 minuti |
| Pausa (1 mese) | 5 minuti |
| Pausa (2 mesi) | 10 minuti |
| Pausa (3 mesi) | 15 minuti |
Accelerazione del rinnovo
Puoi anche utilizzare Play Billing Lab e i tester delle licenze per accelerare i periodi di rinnovo degli abbonamenti di test 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 test devono essere confermati prima di utilizzare la funzionalità Rinnovo accelerato, altrimenti verranno annullati.
- L'esecuzione della procedura di rinnovo potrebbe richiedere alcuni secondi.
- Il pulsante Rinnova ora non è disponibile quando è in vigore una variazione di prezzo.
- La funzionalità di modifica del prezzo dell'abbonamento non è disponibile durante il rinnovo dell'abbonamento.
Offerte di prova
Con la funzionalità di test delle offerte di prova di Play Billing Lab, un tester delle licenze può testare e utilizzare le offerte di prova senza costi o di lancio un numero illimitato di volte selezionando la casella di controllo Testa la prova senza costi o l'offerta di lancio e applicando la modifica. In questo modo non è più necessario creare più account per testare un'offerta di prova disponibile solo per i nuovi abbonati.
Modifiche dei prezzi
Puoi anche utilizzare Play Billing Lab e i tester delle licenze per testare le variazioni di prezzo degli abbonamenti senza influire sugli altri abbonati attivi seguendo questi passaggi:
- 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 Rinuncia dell'utente in base ai requisiti del test.
- Fai clic su Applica.
Dopo aver applicato le modifiche, il prezzo viene aggiornato a partire dal successivo rinnovo solo per il tester. Gli altri abbonati attivi non saranno interessati. Tutte le regole per i tester delle licenze si applicano all'abbonamento di test. Il tester può quindi testare la propria app per i processi downstream attivati dalla variazione di prezzo, ad esempio le notifiche di variazione di prezzo.
Tieni presente le seguenti considerazioni durante la pianificazione dei periodi di test:
- A causa della breve durata del rinnovo per i tester delle licenze, è possibile che una migrazione dei prezzi effettuata dalla console non venga registrata per i tester delle licenze. Per assicurarsi che le notifiche e le email relative alle variazioni di prezzo possano essere testate, gli sviluppatori devono posticipare la fatturazione di almeno un'ora dopo aver attivato una variazione di prezzo.
- Le riduzioni di prezzo non prevedono un periodo di notifica. Agli utenti viene inviata una notifica di riduzione di prezzo poco dopo la migrazione della coorte. Questo valore rimane invariato durante il test.
- Per gli aumenti di prezzo, i tempi di notifica di test vengono calcolati come per gli aumenti effettivi:
- All'utente viene addebitato il costo al primo anniversario di fatturazione successivo a un periodo di notifica obbligatorio.
- I tempi di notifica vengono calcolati a ritroso a partire dalla data del primo addebito.
- L'ultima notifica viene inviata sempre 1 minuto prima dell'addebito, indipendentemente dal periodo di fatturazione.
La seguente tabella mostra i periodi di fatturazione e notifica di test per diversi periodi di fatturazione effettivi:
| Periodo di fatturazione effettivo del piano base | Periodo di fatturazione di prova | Periodo di notifica del test (regioni di attivazione e disattivazione con preavviso di 30 giorni) | Periodo di notifica di test (regioni di 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 visualizzare gli scenari di test che devi utilizzare per verificare l'integrazione degli abbonamenti.
Transazioni di test in attesa
Devi verificare che le transazioni in attesa vengano gestite correttamente e che i diritti vengano
aggiornati di conseguenza quando lo stato dell'acquisto diventa PURCHASED. I tester delle licenze
hanno accesso a due strumenti di test per le forme di pagamento differite in cui il
pagamento viene completato o annullato automaticamente dopo un paio di minuti.
Effettua un acquisto con una forma di pagamento ritardata Scheda di verifica lenta, rifiuta dopo qualche minuto, 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 prova lenta rifiutata. Effettua un acquisto con una forma di pagamento ritardata Carta di prova lenta, approva dopo qualche minuto, come mostrato nella figura 9. Attendi qualche minuto, verifica che l'acquisto sia stato concesso.
Figura 9. Testa un acquisto con una carta di prova 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 per trimestre su tutti i prodotti gestiti in un'app.
Devi testare i seguenti scenari di utilizzo dei codici promozionali:
- Quando il codice promozionale viene inserito nella finestra di dialogo di acquisto avviata 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 utilizzando il pulsante Riscatta nel riquadro di navigazione a sinistra.
In questi scenari, devi testare il riscatto dei codici in quanti più modi possibili. Esegui almeno i seguenti test:
- Utilizzo prima dell'installazione dell'app.
- Utilizzo mentre l'app è in esecuzione in primo piano. Tieni presente che per questo test devi utilizzare un altro dispositivo per eseguire il test utilizzando l'app Google Play Store. Assicurati di testare i riscatti da diverse schermate dell'app.
- Utilizzo con la modalità multi-finestra, in cui vengono visualizzate contemporaneamente sia la tua app sia l'app Google Play Store.
Per ogni test, assicurati che l'articolo venga rilevato correttamente e che l'utente riceva una notifica.
Testare l'esperienza di acquisto in diverse regioni
Puoi testare l'esperienza di acquisto con o senza Play Billing Lab:
Testa con
L'app per Android Play Billing Lab ti consente di testare il flusso di acquisto in qualsiasi regione. Tuttavia, per utilizzare Play Billing Lab, devi essere un tester delle licenze. Per eseguire il test, segui questi passaggi:
- Registra l'utente di fatturazione dell'app come tester delle licenze.
- Accedi all'app Lab Fatturazione Play con lo stesso utente.
- Seleziona il paese che preferisci e applica la modifica in Play Billing Lab.
- Avvia il flusso di acquisto nell'app in fase di test.
Test senza
Puoi anche testare il flusso di acquisto in qualsiasi regione senza utilizzare Play Billing Lab. Per eseguire il test:
- Crea un nuovo account Gmail. L'account può essere creato in qualsiasi paese.
- (Facoltativo) Puoi configurare l'utente come tester delle licenze.
- VPN nel paese che vuoi testare.
- Avvia il flusso di acquisto.
Puoi cancellare i dati e svuotare la cache del Play Store, quindi ripetere i passaggi 3 e 4 con qualsiasi paese che vuoi testare. Dopo aver cambiato paese, devi cancellare i dati del Google Play Store per rimuovere i dati relativi al paese precedente.
Entrambi i metodi per testare gli acquisti ti consentono di testare l'idoneità regionale delle offerte e l'esperienza utente in qualsiasi regione, indipendentemente da dove esegui fisicamente il test.
Testare 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 Lab Fatturazione Play.
Per testare i metodi di pagamento reali:
- Registra l'utente dell'Account Google come tester delle licenze.
- Accedi all'app Lab Fatturazione Play con lo stesso utente.
- Attiva i metodi di pagamento reali nell'app Lab Fatturazione Play.
- Riavvia e avvia il flusso di acquisto nell'app in fase di test.