Gli sviluppatori idonei possono offrire agli utenti di determinati paesi un sistema di fatturazione alternativo nella propria app e segnalare le transazioni risultanti a Google. A seconda di dove distribuisci l'app e dell'idoneità, un'app può creare due versioni della fatturazione alternativa:
- Fatturazione alternativa con scelta dell'utente: la tua app offre una fatturazione alternativa oltre al sistema di fatturazione di Google Play.
- Solo fatturazione alternativa (senza scelta dell'utente): la tua app offre un sistema di fatturazione alternativo senza la presenza della Fatturazione Google Play come opzione.
Questa guida illustra le API che devono essere utilizzate per entrambe le offerte. Prima di utilizzare queste API, ti consigliamo di consultare le pagine del programma e di registrarti ai programmi pertinenti.
Glossario dei termini
Convenzioni sui termini seguite da questa guida:
- API di fatturazione alternativa: API utilizzate per mostrare agli utenti eventuali schermate applicabili e consentono agli sviluppatori di segnalare le transazioni completate sul sistema di fatturazione alternativo dello sviluppatore.
- Sistema di fatturazione alternativo: il sistema di fatturazione alternativo di uno sviluppatore che può essere offerto insieme al sistema di fatturazione di Google Play o da solo (soggetto a requisiti di idoneità).
- Transazione esterna: una transazione che avviene al di fuori del sistema di fatturazione di Google Play.
- Token transazione esterna: un token fornito allo sviluppatore tramite la Libreria Fatturazione Play affinché lo sviluppatore possa utilizzare quando l'utente completa un sistema di fatturazione alternativo. Questo token viene utilizzato per informare Google Play che un acquisto è andato a buon fine.
- ID transazione esterno: un identificatore univoco generato dallo sviluppatore per identificare una transazione.
Offerta di fatturazione alternativa con Scelta dell'utente
Questa sezione descrive come offrire agli utenti la fatturazione alternativa con la possibilità di utilizzare il sistema di fatturazione di Google Play. Prima di utilizzare queste API, verifica quanto segue:
- Esamina i requisiti di idoneità per i programmi pertinenti e completa i passaggi di onboarding descritti nella sezione Informazioni sulla fatturazione scelta dall'utente su Google Play.
- Integra la Libreria Fatturazione Play 5.2 o versioni successive.
Gli altri moduli consigliati per l'integrazione di Fatturazione Google Play sono gli stessi che gli sviluppatori già avranno per l'integrazione attuale.
Ti consigliamo inoltre di avere a disposizione una configurazione dell'integrazione dell'API Google Play Developer perché verrà utilizzata dall'integrazione del backend.
Configurazione in Play Console
Gli sviluppatori che hanno completato la registrazione al programma di fatturazione alternativa con il programma di scelta dell'utente corrispondente e sono integrati con API di fatturazione alternativa possono gestire le loro impostazioni di fatturazione alternativa tramite Play Console:
- Per ciascuna delle tue app idonee, puoi scegliere se offrire o meno un sistema di fatturazione alternativo.
- Carica i loghi dei metodi di pagamento in conformità con le linee guida, seguendo tutte le specifiche del formato. Le immagini non conformi a queste linee guida non verranno visualizzate per il tuo sistema di fatturazione alternativo nella schermata di scelta dell'utente. Nota: l'inclusione dei loghi dei metodi di pagamento è facoltativa, anche se vivamente consigliata.
- Se proponi abbonamenti, fornisci il link per la gestione degli abbonamenti richiesto.
![](https://developer.android.google.cn/static/images/google/play/billing/alternative/alt-bill-settings.png?authuser=5&hl=it)
Esperienza utente
Le API lato client abilitano le seguenti funzionalità:
- Google Play mostra e gestisce le informazioni applicabili e le schermate di scelta dell'utente
- Se l'utente sceglie di utilizzare il sistema di fatturazione di Google Play, il flusso di fatturazione continua utilizzando l'interfaccia standard di fatturazione di Google Play.
![]() App sviluppatore. |
![]() Schermata di scelta della fatturazione. |
Esempio solo a scopo illustrativo.
Schermata Scelta dell'utente
La schermata della scelta dell'utente offre agli utenti la possibilità di utilizzare il sistema di fatturazione alternativo dello sviluppatore o il sistema di fatturazione di Google Play.
Struttura di un'opzione di fatturazione alternativa
L'opzione di fatturazione alternativa nella schermata Scelta dell'utente include i seguenti elementi UI:
- Icona dell'app.
- Nome app.
- Asset immagine che include i metodi di pagamento offerti dallo sviluppatore.
- Indicatore aggiuntivo (e altro elemento UI non fa parte dell'asset immagine).
Asset immagine per i metodi di pagamento
Il singolo asset immagine è costituito da più schede di metodi di pagamento e deve seguire le specifiche definite in queste linee guida.
Dimensioni |
192 dp x 20 dp |
Spaziatura scheda |
8dp |
Formato file |
PNG, sfondo trasparente |
Variazioni del metodo di pagamento
Gli sviluppatori possono scegliere il numero di icone dei metodi di pagamento disponibili che vogliono includere nell'asset immagine, fino a un massimo di 5.
L'immagine non deve includere altre immagini o altri testi.
Specifiche della scheda
Le schede dei metodi di pagamento incluse nell'asset immagine devono seguire le seguenti linee guida per dimensioni, spaziatura e stile.
Dimensioni della scheda | 32 dp x 20 dp |
Spaziatura interna interna | 3dp |
Abbozzo | 1dp (corsa interna inclusa nelle dimensioni), Raggio 2dp, #E0E0E0 |
Sfondo della scheda | Colore a tinta unita (preferibilmente bianco) |
Passaggi successivi
Per iniziare a integrare le API di fatturazione alternativa con la scelta dell'utente, segui le guide approfondite per l'integrazione in-app e l'integrazione del backend.
Offerta solo di fatturazione alternativa
Questa sezione descrive come offrire agli utenti la fatturazione alternativa senza la possibilità di scegliere di utilizzare il sistema di fatturazione di Google Play. Prima di utilizzare queste API, verifica quanto segue:
- Esamina i requisiti e registrati al programma di sola fatturazione alternativa seguendo le istruzioni riportate nell'articolo Offrire un sistema di fatturazione alternativo agli utenti nello Spazio economico europeo (SEE) per la fatturazione alternativa.
- Integra la Libreria Fatturazione Play 6.2.1 o versioni successive.
Ti consigliamo di tenere a portata di mano una configurazione dell'integrazione dell'API Google Play Developer perché verrà utilizzata dall'integrazione del backend.
Configurazione in Play Console
Gli sviluppatori che hanno completato la registrazione e hanno integrato le API di fatturazione alternativa possono gestire le proprie impostazioni di fatturazione alternativa tramite Play Console:
- Per ciascuna delle tue app idonee, attiva o disattiva l'offerta della sola fatturazione alternativa (senza scelta dell'utente) in ogni paese disponibile
![](https://developer.android.google.cn/static/images/google/play/billing/alternative/alt-bill-settings.png?authuser=5&hl=it)
Schermata delle informazioni per gli utenti
La schermata informativa aiuta gli utenti a capire che all'interno dell'app idonea viene offerto solo un sistema di fatturazione alternativo. La schermata informativa verrà mostrata agli utenti all'inizio del loro primo acquisto nell'app, dopo l'attivazione della fatturazione alternativa. Questo messaggio non verrà visualizzato per gli acquisti successivi effettuati dallo stesso utente nella tua app sullo stesso dispositivo. Tieni presente che a volte la finestra di dialogo viene mostrata di nuovo a un utente, ad esempio se l'utente svuota la cache sul proprio dispositivo.
Passaggi successivi
Per iniziare a integrare le API di fatturazione alternativa, segui le guide approfondite per l'integrazione in-app e l'integrazione del backend.