Dovresti 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 Play Billing Lab per esaminare gli scenari descritti in questa sezione.
Tester delle licenze
Per configurare i tester delle licenze, consulta Testa 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 con licenza 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 dell'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 con licenza per l'account Google Play Console.
- I tester con licenza hanno accesso a metodi di pagamento di prova che evitano l'addebito di denaro reale per gli acquisti. Puoi anche utilizzare i 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 di licenza 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 dagli acquisti effettivi.
- Le imposte non vengono calcolate per gli acquisti di prova.
- Google Play indica un acquisto di prova mostrando un avviso al centro della finestra di dialogo di acquisto.
Puoi confermare l'account che sta effettuando un acquisto espandendo la finestra di dialogo di acquisto. Tieni presente quanto segue:
- Gli account di prova devono essere presenti sul dispositivo Android del tester.
- Se sul dispositivo sono presenti 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.
Utilizza i canali di test di Google Play per la convalida pre-distribuzione, ad esempio per consentire al tuo team addetto al QA di qualificare le nuove release. Con i canali di test, i tester con licenza possono installare e valutare le versioni non rilasciate della tua app da Google Play. Gli utenti normali possono effettuare acquisti reali utilizzando i metodi di pagamento standard.
Per testare l'integrazione di Libreria Fatturazione Google Play utilizzando i canali di test, procedi come segue:
- Pubblica l'app in un canale di test. Tieni presente che, dopo aver pubblicato un'app su un canale di test, potrebbero essere necessarie alcune ore prima che l'app sia disponibile per i tester.
- Assicurati che ogni tester esegua l'attivazione per il test della tua app. Nell'URL di attivazione del test, i tester vedono una spiegazione sul 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ù recente dell'applicazione Google Play. Per informazioni generali su come configurare un dispositivo da utilizzare per lo sviluppo di app per 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 pratico per testare le funzionalità di fatturazione, integrarle più velocemente e lanciarle 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 Google Play da Play Billing Lab e applica le impostazioni al test. In questo modo è possibile testare esperienze utente personalizzate in diversi paesi/regioni, indipendentemente da dove il tester esegue fisicamente i test.
- Testare ripetutamente le offerte di prova o di lancio con lo stesso account
- Testa le variazioni di prezzo degli abbonamenti senza influire sugli altri abbonati attivi
- Accelerare la transizione dello stato dell'abbonamento per accelerare i rinnovi degli abbonamenti o spostare l'abbonamento di prova nello stato di periodo di tolleranza o di sospensione dell'account con un solo clic per velocizzare i test
- Esegui il test con metodi di pagamento reali per bypassare determinati indicatori di rischio del flusso di acquisto
- Testa gli acquisti esterni all'app per assicurarti che il tuo backend possa gestirli
Testa i prodotti a pagamento singolo
Testa i prodotti di consumo
Quando testi i prodotti di consumo, testa una serie di situazioni, tra cui:
- Un acquisto andato a buon fine in cui l'utente riceve un articolo. Con un tester di 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 dovrebbe ricevere l'articolo. Con un tester di 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 Elaborazione degli acquisti. Per gli acquisti effettuati dai tester delle licenze, l'acquisto verrà rimborsato dopo 3 minuti se la tua app non lo conferma 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 3 minuti.
Testa i prodotti non consumabili
I prodotti non di consumo devono essere testati allo stesso modo di quelli di consumo, ma devi verificare che un articolo non possa essere acquistato di nuovo all'interno della tua app. Assicurati di verificare la conferma di acquisto sia per i prodotti non di consumo sia per quelli di consumo (se applicabile), poiché la logica per elaborare i due tipi di acquisti varia.
Testa 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 con licenza hanno accesso a due strumenti di test per le forme di pagamento ritardate, 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 e 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 e verifica che l'acquisto sia stato concesso.
Figura 4. Testa un acquisto con una carta di prova lenta approvata.
Puoi trovare ulteriori informazioni nella pagina Gestione delle transazioni in attesa.
Testare gli storni di addebito avviati dagli utenti
I tester delle licenze hanno accesso a uno strumento di test che consente loro di simulare uno storno di addebito avviato dall'utente.
Effettua un acquisto con lo strumento di test Testa la carta, approva e poi storna, come mostrato nella Figura 5. Poco dopo, il tuo sistema dovrebbe essere informato della consegna e dello storno di addebito dell'acquisto di prova tramite le piattaforme applicabili. Ad esempio, dovresti ricevere una PendingRefundReviewNotification pochi istanti dopo aver effettuato l'acquisto.
Figura 5. Testa un acquisto con una carta di prova che approva e poi storna.
Testa le funzionalità specifiche degli abbonamenti
I flussi di acquisto per i prodotti a pagamento singolo e gli abbonamenti sono simili, ma gli abbonamenti prevedono scenari aggiuntivi, come i rinnovi degli abbonamenti riusciti o rifiutati. Per testare i rinnovi, puoi utilizzare i metodi di pagamento Carta di prova, approva sempre e Carta 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 dell'abbonamento riuscito.
Come per i prodotti a pagamento singolo, verifica che gli acquisti vengano confermati correttamente come descritto nella sezione Elaborazione degli acquisti. Per gli acquisti effettuati dai tester delle licenze, un acquisto viene rimborsato dopo 3 minuti se l'app non lo conferma 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 agli abbonamenti 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 attuale dopo ogni data di scadenza dell'abbonamento.
| Periodo di abbonamento di 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à degli abbonamenti basate sul tempo, come le prove senza costi, vengono abbreviate per i test. La tabella seguente identifica i periodi di tempo di test associati alle funzionalità degli abbonamenti basati sul tempo:
| Funzionalità | Periodo di test |
| Sospensione dell'account | 10 minuti |
| Prova senza costi | 3 minuti |
| Periodo di tolleranza | 5 minuti |
| Periodo del prezzo di lancio | Uguale al periodo di prova dell'abbonamento |
| Metti in pausa (1 mese) | 5 minuti |
| Metti in pausa (2 mesi) | 10 minuti |
| Metti in pausa (3 mesi) | 15 minuti |
| Periodo di consenso per l'aumento di prezzo (applicabile solo per la regione della Corea del Sud (KR)) |
3 minuti |
| Conferma di acquisto | 5 minuti |
Accelerare la transizione dello stato dell'abbonamento
Puoi anche utilizzare Play Billing Lab e i tester delle licenze per accelerare i periodi di rinnovo degli abbonamenti di prova per velocizzare i test degli abbonamenti o spostare l'abbonamento di prova nello stato di periodo di tolleranza o sospensione dell'account per testare gli scenari di rifiuto dei pagamenti con i seguenti passaggi:
- Fai clic su Gestisci nella scheda Impostazioni abbonamento della Dashboard.
- Scegli l'abbonamento attivo che vuoi testare.
- Fai clic sul menu a discesa Stato dell'abbonamento.
- Fai clic sullo stato di destinazione per aggiornare lo stato della sottoscrizione.
Dopo aver selezionato lo stato dell'abbonamento target nel menu a discesa, lo stato dell'abbonamento di test verrà aggiornato poco dopo.
Ricorda:
- Gli abbonamenti di prova devono essere confermati prima di utilizzare la funzionalità di accelerazione della transizione di stato dell'abbonamento.
- Il tuo metodo di pagamento verrà automaticamente rifiutato quando sposti l'abbonamento di test nello stato di periodo di tolleranza o sospensione dell'account. Quando ripristini l'abbonamento di test, il tuo metodo di pagamento verrà ripristinato all'approvazione automatica.
- L'esecuzione del processo di transizione dello stato dell'abbonamento potrebbe richiedere alcuni secondi.
- Quando la transizione dello stato dell'abbonamento è in corso, la funzionalità di modifica del prezzo dell'abbonamento non è disponibile.
- Se rinnovi l'abbonamento di test quando è in vigore una variazione di prezzo, Play applica il nuovo prezzo se l'utente lo ha accettato. Tuttavia, se il nuovo prezzo richiede l'accettazione da parte dell'utente e quest'ultimo non l'ha ancora accettato, Play annulla l'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 con prezzo di lancio un numero illimitato di volte selezionando la casella di controllo Testa l'offerta di prova senza costi o con prezzo di lancio e applicando la modifica. In questo modo non è necessario creare più account per testare un'offerta di prova disponibile solo per i nuovi abbonati.
Modifiche ai 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 abbonamento della Dashboard.
- Scegli l'abbonamento attivo che vuoi testare.
- Inserisci il nuovo prezzo.
- Seleziona o deseleziona la casella di controllo Disattivazione da parte dell'utente in base ai requisiti del test.
- Fai clic su Applica.
Dopo aver applicato le modifiche, il prezzo viene aggiornato a partire dal rinnovo successivo solo per il tester. Gli altri abbonati attivi non saranno interessati. Tutte le regole dei tester delle licenze si applicano all'abbonamento di prova. Il tester può quindi testare la sua app per i processi downstream attivati dalla variazione di prezzo, ad esempio le notifiche di variazione di prezzo.
Tieni presente le seguenti considerazioni quando pianifichi i 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 garantire 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 l'attivazione di una variazione di prezzo.
- Le riduzioni di prezzo non hanno un periodo di preavviso. Gli utenti ricevono una notifica di una riduzione del prezzo subito dopo la migrazione della coorte. Questo non cambia durante i test.
- Per gli aumenti di prezzo, i tempi di notifica di test vengono calcolati allo stesso modo degli aumenti effettivi:
- All'utente viene addebitato il primo importo 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.
- 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 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 con 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 |
Consenso all'aumento del prezzo
Le informazioni relative a un aumento di prezzo che richiede il consenso dell'utente saranno disponibili nell'API purchases.subscriptionsv2.get.
Google Play invia due notifiche push e via email relative all'aumento di prezzo agli utenti interessati (inclusi i tester delle licenze) prima che l'aumento venga applicato. Il periodo di preavviso per i test è il seguente:
| Programmazione delle notifiche | Periodo di notifica del test |
| Prima notifica | 3 minuti |
| Seconda (e ultima) notifica | 1 minuto |
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.
Testa 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 di licenza hanno accesso a due strumenti di test per le forme di pagamento ritardate 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 9. Riavvia l'app e verifica che l'acquisto non sia stato concesso.
Figura 9. 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 10. Attendi qualche minuto e verifica che l'acquisto sia stato concesso.
Figura 10. Testa un acquisto con una carta di prova lenta approvata.
Testa 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.
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 della tua app.
- Quando il codice promozionale viene utilizzato nell'app Google Play Store.
- Quando il codice promozionale viene utilizzato su https://play.google.com/store tramite il pulsante Utilizza nel menu di navigazione a sinistra.
In questi scenari, devi testare l'utilizzo dei codici nel maggior numero di modi possibile. 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 gli utilizzi da schermate diverse della tua 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'elemento venga rilevato correttamente e che l'utente riceva una notifica.
Testa l'esperienza di acquisto in diverse regioni
Puoi testare l'esperienza di acquisto in diverse regioni con l'app Play Billing Lab. Per utilizzare Play Billing Lab, devi essere un tester delle licenze. Per eseguire il test, segui questi passaggi:
- Registra l'utente della fatturazione dell'app come tester autorizzato.
- Accedi all'app Play Billing Lab con lo stesso utente.
- Seleziona il paese richiesto e applica la modifica in Play Billing Lab.
Avvia il flusso di acquisto nell'app in fase di test.
Figura 11. Testa l'esperienza di acquisto in diverse regioni.
Play Billing Lab ti consente di testare l'idoneità regionale dell'offerta e l'esperienza utente in qualsiasi regione, indipendentemente da dove stai eseguendo i test 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 autorizzato.
- Accedi all'app Play Billing Lab con lo stesso utente.
- Attiva i metodi di pagamento reali nell'app Play Billing Lab.
- Riavvia e avvia il flusso di acquisto nell'app in fase di test.
Limiti di spesa per le app non pubblicate
Le app in fase di bozza o pubblicate nel canale di test interno sono soggette a limiti di spesa.
Google Play applica limiti ai seguenti elementi:
- Transazioni giornaliere:il numero di transazioni che un utente può effettuare al giorno in tutte le app non pubblicate.
- Valore per ordine:l'importo massimo per una singola transazione.
- Spesa giornaliera totale:la spesa giornaliera cumulativa di un utente per tutte le app non pubblicate.
Questi limiti vengono reimpostati ogni 24 ore.
Se un utente supera uno di questi limiti durante il test della tua app, vedrà un messaggio di errore nel carrello degli acquisti e la transazione verrà bloccata.
Testa gli acquisti esterni all'app
Puoi utilizzare l'app Play Billing Lab per testare l'esperienza end-to-end per i diritti acquisiti al di fuori della tua app. Per utilizzare Play Billing Lab, devi essere un tester delle licenze per l'app che stai testando.
Passaggio 1: configura il test
- Registra l'utente della fatturazione dell'app come tester autorizzato.
- Apri il Play Store e accedi con lo stesso utente.
- Apri l'app Play Billing Lab e accedi con lo stesso utente.
- Seleziona la carta di test Acquisti esterni all'app.
- (Facoltativo) Seleziona il paese di test e applica la modifica in Play Billing Lab.
- Se non selezioni un paese, Play Billing Lab utilizza il paese di Google Play per il tuo account di test con licenza.
- Inserisci le informazioni sull'app e sul prodotto (SKU) che vuoi testare.
- Seleziona l'opzione di acquisto, il piano base o l'offerta che vuoi testare.
- Fai clic su Avvia test.
Passaggio 2: acquisisci il prodotto esterno all'app
- Prodotti in evidenza
- Consigli di acquisto (dopo aver abbandonato un acquisto)
- Premi di Play Games
Passaggio 3: gestisci e fornisci il diritto
La tua app deve rilevare l'acquisto esterno all'app e poi consegnare l'articolo al rispettivo utente. Per la procedura completa, consulta la sezione Elaborazione degli acquisti.
Prodotti in primo piano
- Apri il Play Store e accedi con lo stesso account del tester con licenza che hai utilizzato per configurare il test in Play Billing Lab.
- Se il Play Store era già aperto, chiudilo e riavvialo.
- Vai alla pagina dei dettagli dell'app.
- L'elemento viene mostrato in questa pagina.
- Seleziona l'articolo e completa l'acquisto.
Consigli di acquisto
Dopo l'abbandono del carrello:
- Riavvia l'app.
- Avvia un flusso di acquisto per un prodotto a pagamento singolo nella tua app.
- Ignorare o abbandonare la finestra di dialogo del carrello degli acquisti senza completare la transazione.
- Verifica la presenza del consiglio di acquisto per il carrello abbandonato.
- Accetta il suggerimento e completa l'acquisto.
Premi di Play Games
Fai clic su Concedi premio per simulare la concessione del premio all'utente da parte di Google Play. I premi esistenti devono essere elaborati prima che possano essere concessi premi aggiuntivi.
