API di fatturazione alternativa

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:

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:

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.
UI simulata, a scopo illustrativo, soggetta a modifiche.

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:

  1. Icona dell'app.
  2. Nome app.
  3. Asset immagine che include i metodi di pagamento offerti dallo sviluppatore.
  4. 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:

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
UI simulata, a scopo illustrativo, soggetta a modifiche.

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.