Devi testare l'integrazione durante lo sviluppo. Per eseguire test durante la fase di sviluppo, ti consigliamo di utilizzare tester delle licenze e Play Billing Lab per eseguire gli scenari descritti in questa sezione.
Tester delle licenze
Per configurare i tester delle licenze, consulta 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 bypassare 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 dover caricare la nuova versione della 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 di prova che evitano di addebitare loro denaro reale per gli acquisti. Puoi anche utilizzare metodi di pagamento di prova per simulare determinate situazioni, ad esempio quando un pagamento viene rifiutato. 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 in-app utilizzato per gli acquisti effettivi.
- Le imposte non vengono calcolate per gli acquisti di prova.
- Google Play indica un acquisto di prova mostrando 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 il dispositivo ha più di un 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 l'app, puoi utilizzare i canali di test di Google Play per eseguire una convalida aggiuntiva. Ad esempio, puoi utilizzare i canali di test per chiedere al team di QA di convalidare 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 in Google Play.
Per testare l'integrazione di Libreria Fatturazione Google Play utilizzando i canali di test, svolgi i seguenti passaggi:
- Pubblica la tua app in un canale di test. Tieni presente che dopo aver pubblicato un'app in un canale di test, possono 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 del ruolo di tester e 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ù aggiornata dell'applicazione Google Play. Per informazioni generali su come configurare un dispositivo da utilizzare per lo sviluppo di applicazioni Android, consulta Utilizzare i 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 comodo per testare le funzionalità di fatturazione, eseguire l'integrazione più velocemente e lanciare i prodotti 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 Paese Google Play da Play Billing Lab e applica le impostazioni al test. In questo modo, è possibile testare esperienze utente personalizzate in paesi/regioni diversi, indipendentemente da dove il tester esegue fisicamente il test.
- Eseguire test di offerte di prova o promozionali ripetutamente con lo stesso account
- Testare le variazioni di prezzo degli abbonamenti senza influire sugli altri abbonati attivi
- Accelera i rinnovi dell'abbonamento per velocizzare i test
Testare i prodotti a pagamento singolo
Testare i prodotti di consumo
Quando testi i prodotti di consumo, valuta una serie di 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 per 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 confermati correttamente come descritto nella sezione Elaborare gli acquisti. Per gli acquisti effettuati dai tester della licenza, un acquisto verrà rimborsato dopo 3 minuti se la tua app non lo riconosce 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
Gli articoli non consumabili devono essere testati come quelli consumabili, ma devi verificare che un articolo non possa essere acquistato di nuovo all'interno della tua app. Assicurati di verificare il riconoscimento dell'acquisto sia per gli articoli non consumabili che per quelli consumabili (se applicabile), poiché la logica di elaborazione di ciascuno dei due tipi di acquisti 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 Scheda di verifica lenta, rifiuta dopo qualche minuto, come mostrato nella figura 3. Riavvia l'app, verifica che l'acquisto non sia stato concesso.
Figura 3. Prova a effettuare un acquisto con una carta di test lenta rifiutata. Effettua un acquisto con una forma di pagamento ritardata Scheda di verifica lenta, approva dopo qualche minuto, come mostrato nella figura 4. Attendi qualche minuto, verifica che l'acquisto sia stato concesso.
Figura 4. Prova un acquisto con una carta di prova lenta approvata.
Puoi trovare ulteriori informazioni nella sezione Gestire le transazioni in sospeso.
Testare le funzionalità specifiche dell'abbonamento
I flussi di acquisto per i prodotti una tantum e gli abbonamenti sono simili, ma gli abbonamenti prevedono scenari aggiuntivi, come i rinnovi riusciti o rifiutati. Per testare i rinnovi, puoi utilizzare i metodi di pagamento Scheda di prova, approva sempre e Scheda di prova, 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 stati confermati correttamente come descritto nella sezione sull'elaborazione degli acquisti. Per gli acquisti effettuati dai tester delle licenze, un acquisto viene rimborsato dopo 3 minuti se la tua app non lo riconosce e ricevi un'email relativa all'annullamento. Puoi anche controllare la scheda Ordini in Google Play Console per verificare se un ordine è stato rimborsato dopo 3 minuti.
Periodi di rinnovo
Gli abbonamenti di prova si rinnovano più rapidamente di quelli effettivi e possono essere rinnovati al massimo 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 corrente dopo ogni data di scadenza dell'abbonamento.
| Periodo di abbonamento alla produzione | Testare 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 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 del prezzo di lancio | Uguale al periodo di prova dell'abbonamento |
| Periodo di tolleranza (sia di 3 che di 7 giorni) | 5 minuti |
| Sospensione dell'account | 10 minuti |
| In pausa (1 mese) | 5 minuti |
| Mettere in pausa (2 mesi) | 10 minuti |
| Mettere in 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 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 della procedura 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 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 l'offerta di prova senza costi o 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 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 per gli utenti 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. All'abbonamento di prova si applicano tutte le regole per i tester delle licenze. Il tester può quindi verificare la presenza di processi downstream attivati dalla variazione di prezzo nella sua app, ad esempio le notifiche relative alla 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 eseguita dalla console non venga registrata per i tester delle licenze. Per assicurarsi 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 aver attivato una variazione di prezzo.
- Le riduzioni di prezzo non hanno un periodo di notifica. Gli utenti vengono informati della 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 del test vengono calcolati come per gli aumenti effettivi:
- La prima fatturazione all'utente viene effettuata al primo anniversario della fatturazione successivo a un periodo di notifica obbligatorio.
- Le date di notifica vengono calcolate a ritroso dalla data del primo addebito.
- La notifica finale viene sempre inviata 1 minuto prima dell'addebito, indipendentemente dal periodo di fatturazione.
La tabella seguente mostra i periodi di fatturazione e di notifica di prova per diversi periodi di fatturazione effettivi:
| Periodo di fatturazione effettivo del piano base | Periodo di fatturazione del test | Periodo di notifica del test (regioni di attivazione e disattivazione con preavviso di 30 giorni) | Periodo di notifica del test (regioni in cui è possibile disattivare la funzionalità con un 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 da utilizzare per verificare l'integrazione dell'abbonamento.
Testare le transazioni 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. Prova a effettuare un acquisto con una carta di test lenta rifiutata. Effettua un acquisto con una forma di pagamento ritardata Scheda di verifica lenta, approva dopo qualche minuto, come mostrato nella figura 9. Attendi qualche minuto, verifica che l'acquisto sia stato concesso.
Figura 9. Prova 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.
Dovresti testare i seguenti scenari di utilizzo dei codici promozionali:
- Quando il codice promozionale viene inserito nella finestra di dialogo di acquisto avviata all'interno della tua 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 l'utilizzo dei codici in quante più modalità 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, hai bisogno di un altro dispositivo per testare l'utilizzo dell'app Google Play Store. Assicurati di testare i riscatti da schermate diverse nella tua app.
- Utilizzo con la modalità multifinestra, in cui sia la tua app sia l'app Google Play Store vengono visualizzate contemporaneamente.
Per ogni test, assicurati che l'articolo 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 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 della licenza.
- Accedi all'app Play Billing Lab con lo stesso utente.
- Seleziona il paese desiderato e applica la modifica in Play Billing Lab.
- Avvia il flusso di acquisto nell'app in fase di test.
Eseguire il 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.
- Se vuoi, puoi configurare l'utente come utente di prova della licenza.
- Connettiti in VPN al paese che vuoi testare.
- Avvia il flusso di acquisto.
Puoi svuotare la cache e cancellare i dati del Play Store, quindi ripetere i passaggi 3 e 4 con qualsiasi paese che vuoi testare. Dopo aver cambiato paese, dovrai cancellare i dati del Google Play Store per rimuovere i dati relativi al paese precedente.
Entrambi questi metodi per testare gli acquisti ti consentono di verificare l'idoneità regionale delle offerte e l'esperienza utente in qualsiasi regione, indipendentemente da dove esegui il test.