Testare l'integrazione della Libreria Fatturazione Google Play

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:

1. 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.
2. 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 di fatturazione di 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 lanciarle 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

Testa prodotti a pagamento singolo

Testa i prodotti di consumo

Durante i test dei prodotti di consumo, ti consigliamo di eseguire test in 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 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.

Devi inoltre verificare 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

Devi testare un acquisto in attesa in cui l'articolo deve essere concesso 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, in cui il pagamento viene completato o annullato automaticamente dopo un paio di minuti.

1. Effettua un acquisto con una forma di pagamento ritardata "Carta di prova lenta, rifiuta dopo pochi minuti", come mostrato nella Figura 2. Riavvia l'app, verifica che l'acquisto non sia stato concesso.

   

2. Effettuare un acquisto con una forma di pagamento ritardata "Carta di prova lenta, approva dopo pochi minuti", come mostrato nella Figura 3. Attendi qualche minuto, verifica che l'acquisto sia stato concesso.

   

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 Strumento di test, approva sempre e Strumento di test, rifiuta sempre i metodi di pagamento 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, devi anche verificare che gli acquisti siano correttamente confermati, 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 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.

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:

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 ai 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:

1. Fai clic su Gestisci nella scheda Impostazioni abbonamenti della Dashboard.
2. Scegli l'abbonamento attivo che vuoi testare.
3. Inserisci il nuovo prezzo.
4. Seleziona o deseleziona la casella di controllo Disattivazione utente in base ai tuoi requisiti del test.
5. Fai clic su Applica.

Dopo l'applicazione delle modifiche, il prezzo verrà aggiornato a partire dal successivo rinnovo solo per il tester. Gli altri abbonati attivi non saranno interessati. Tutte le regole dei tester delle licenze verranno applicate all'abbonamento di test. 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 della 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:

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.

1. Effettua un acquisto con una forma di pagamento ritardata "Carta di prova lenta, rifiuta dopo pochi minuti", come mostrato nella Figura 2. Riavvia l'app, verifica che l'acquisto non sia stato concesso.

   

2. Effettuare un acquisto con una forma di pagamento ritardata "Carta di prova lenta, approva dopo pochi minuti", come mostrato nella Figura 3. Attendi qualche minuto, verifica che l'acquisto sia stato concesso.

   

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. Ti consigliamo di eseguire 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 diverse regioni

Il lab di Fatturazione Play e i tester delle licenze ti consentono inoltre di testare il flusso di acquisto in qualsiasi regione senza bisogno di un metodo di pagamento reale per il paese in questione. Segui questi passaggi per eseguire il test:

1. Registra l'utente con accesso fatturazione app come tester delle licenze.
2. Accedi al Lab di fatturazione di Play con lo stesso utente.
3. Seleziona il paese che ti interessa e applica la modifica nel Lab di fatturazione di Play.
4. Lancia il flusso di acquisto nell'app in fase di test.

Questo metodo per testare gli acquisti ti consente di testare l'idoneità a livello di regione dell'offerta e l'esperienza utente in qualsiasi regione, indipendentemente da dove stai testando fisicamente.