Prepararsi per il trasferimento

Questo argomento elenca e descrive i passaggi di configurazione da eseguire prima di poter vendere prodotti nella tua app. A livello generale, questa configurazione include la creazione di un account sviluppatore, la creazione e la configurazione dei prodotti che vuoi vendere e l'attivazione e la configurazione delle API che utilizzi per vendere e gestire i tuoi prodotti. Questo argomento descrive anche come configurare le notifiche per sviluppatori in tempo reale per ricevere una notifica ogni volta che lo stato di un prodotto cambia.

Configurare un account sviluppatore Google Play

Per pubblicare le tue app e i tuoi giochi su Google Play, utilizza Google Play Console. Utilizzi anche Google Play Console per gestire i prodotti e le impostazioni relative alla fatturazione.

Per accedere a Google Play Console, devi configurare un account sviluppatore Google Play.

Per vendere app a pagamento e offrire acquisti in-app su Google Play, devi anche configurare un profilo nel centro pagamenti Google e poi collegarlo al tuo account sviluppatore Google Play. Per scoprire come collegare il tuo profilo al tuo account o come verificare se hai già un account e un profilo collegati, consulta Collegare un account sviluppatore Google Play al profilo pagamenti.

Attivare le funzionalità relative alla fatturazione in Google Play Console

Dopo aver configurato un account sviluppatore, devi pubblicare una versione della tua app che includa la Libreria Fatturazione Google Play. Questo passaggio è obbligatorio per attivare le funzionalità relative alla fatturazione in Google Play Console, ad esempio la configurazione dei prodotti che vuoi vendere.

Aggiungere una dipendenza della libreria

Per integrare il sistema di fatturazione di Google Play, aggiungi innanzitutto una dipendenza alla Libreria Fatturazione Google Play nella tua app. Questa libreria fornisce l'accesso alle API Android che ti connettono a Google Play. Da qui, puoi accedere alle informazioni sugli acquisti, richiedere aggiornamenti sugli acquisti, chiedere a un utente di effettuare nuovi acquisti e altro ancora.

La Libreria Fatturazione Google Play è disponibile nel repository Maven di Google. Aggiungi la dipendenza al file build.gradle della tua app come mostrato di seguito:

dependencies {
    def billing_version = "8.3.0"

    implementation "com.android.billingclient:billing:$billing_version"
}

dependencies {
    val billing_version = "8.3.0"

    implementation("com.android.billingclient:billing:$billing_version")
}

Se utilizzi Kotlin, il modulo Libreria Fatturazione Play KTX contiene estensioni e supporto delle coroutine Kotlin che ti consentono di scrivere Kotlin idiomatico quando utilizzi il sistema di fatturazione di Google Play. Per includere queste estensioni nel progetto, aggiungi la seguente dipendenza al file build.gradle dell'app come mostrato:

dependencies {
    def billing_version = "8.3.0"

    implementation "com.android.billingclient:billing-ktx:$billing_version"
}

dependencies {
    val billing_version = "8.3.0"

    implementation("com.android.billingclient:billing-ktx:$billing_version")
}

Gli esempi di codice Kotlin riportati in questa pagina sfruttano KTX ove possibile.

Caricare l'app

Dopo aver aggiunto la libreria all'app, crea e pubblica l'app. Per questo passaggio, crea l'app e poi pubblicala in qualsiasi canale, incluso il canale di test interno.

Creare e configurare i prodotti

Dopo aver attivato le funzionalità di Fatturazione Google Play per la tua app, devi configurare i prodotti da vendere.

I passaggi per creare prodotti a pagamento singolo e abbonamenti sono simili. Per ogni prodotto, devi fornire un ID prodotto univoco, un titolo, una descrizione e informazioni sui prezzi. Gli abbonamenti hanno informazioni aggiuntive obbligatorie, ad esempio la selezione del tipo di rinnovo per il piano base, ovvero con rinnovo automatico o prepagato.

Google Play Console fornisce un'interfaccia web che puoi utilizzare per gestire i tuoi prodotti.

• Per creare e configurare prodotti a pagamento singolo, consulta Crea un prodotto gestito. Tieni presente che Google Play Console si riferisce ai prodotti a pagamento singolo come prodotti gestiti.

• Per creare e configurare gli abbonamenti, consulta Creare un abbonamento.

In alternativa all'interfaccia web, puoi gestire i tuoi prodotti anche utilizzando la risorsa REST inappproducts per i prodotti in-app e la risorsa REST monetization.subscriptions per i prodotti in abbonamento nell'API Google Play Developer.

Configurare l'API Google Play Developer

L'API Google Play Developer è un'API server-to-server che integra l'API Libreria Fatturazione Google Play su Android. Questa API fornisce funzionalità non disponibili nella libreria Fatturazione Google Play, ad esempio la verifica sicura degli acquisti e l'emissione di rimborsi per i tuoi utenti.

Nell'ambito dell'integrazione del sistema di fatturazione di Google Play nella tua app, devi configurare l'accesso all'API Google Play Developer tramite Google Play Console. Per istruzioni, consulta la pagina API Google Play Developer - Guida introduttiva.

Dopo aver configurato l'accesso all'API Google Play Developer, assicurati di aver concesso l'autorizzazione Visualizzazione di dati finanziari, necessaria per accedere alle funzionalità relative alla fatturazione. Per informazioni sulle best practice e per ulteriori informazioni sulla configurazione delle autorizzazioni, consulta Aggiungere utenti all'account sviluppatore e gestire le autorizzazioni.

Configurare le Notifiche in tempo reale per lo sviluppatore

Le notifiche in tempo reale per lo sviluppatore (RTDN) sono un meccanismo per ricevere notifiche da Google ogni volta che si verifica una modifica ai diritti di un utente all'interno della tua app. Le RTDN sfruttano l'utilizzo di Google Cloud Pub/Sub, che ti consente di ricevere dati inviati a un URL che hai impostato o sottoposti a polling utilizzando una libreria client. Queste notifiche ti consentono di reagire immediatamente alle modifiche dello stato dell'abbonamento, evitando di dover chiamare l'API Google Play Developer. Tieni presente che un uso non efficiente dell'API Google Play Developer può portare a restrizioni della quota API.

Cloud Pub/Sub è un servizio di messaggistica in tempo reale completamente gestito che puoi utilizzare per inviare e ricevere messaggi tra applicazioni indipendenti. Google Play utilizza Cloud Pub/Sub per pubblicare notifiche push sugli argomenti a cui ti iscrivi.

Per ricevere notifiche, devi creare un server di backend per utilizzare i messaggi inviati al tuo argomento. Il server può quindi utilizzare questi messaggi rispondendo a richieste HTTPS a un endpoint registrato o utilizzando le librerie client Cloud Pub/Sub. Queste librerie sono disponibili in diverse lingue. Per ulteriori informazioni, consulta anche la sezione Creare una sottoscrizione Pub/Sub in questo argomento.

Determinare prezzi e quote

Per informazioni dettagliate su prezzi e quote, consulta le pagine Prezzi e Quote.

Stimare l'utilizzo dei dati

La parte di dati della notifica di abbonamento è di circa 1 KB di dati per richiesta. Ogni pubblicazione e pull richiede una richiesta separata o circa 2 KB di dati per notifica. Il numero di notifiche al mese dipende dal ciclo di fatturazione e dal comportamento degli utenti. Durante un ciclo di fatturazione, dovresti aspettarti almeno una notifica per ogni utente.

Configurare Cloud Pub/Sub

Per attivare le notifiche in tempo reale per lo sviluppatore, devi prima configurare Cloud Pub/Sub utilizzando il tuo progetto Google Cloud Platform (GCP) e poi attivare le notifiche per la tua app.

Per utilizzare Cloud Pub/Sub, devi disporre di un progetto GCP con l'API Cloud Pub/Sub abilitata. Se non hai familiarità con GCP e Cloud Pub/Sub, consulta la guida rapida.

Crea un argomento

Per iniziare a ricevere le notifiche, devi creare un argomento in cui Google Play deve pubblicare le notifiche. Per creare un argomento, segui le istruzioni riportate in Creare l'argomento.

Crea una sottoscrizione Pub/Sub

Per ricevere i messaggi pubblicati in un argomento, devi creare un abbonamento Pub/Sub per quell'argomento. Per creare una sottoscrizione Pub/Sub, segui questi passaggi:

1. Leggi la guida per i sottoscrittori a Cloud Pub/Sub per determinare se configurare la sottoscrizione come sottoscrizione push o sottoscrizione pull.
   • Una sottoscrizione push consente a Cloud Pub/Sub di inviare notifiche al tuo backend sicuro inviando richieste HTTPS.
   • Una sottoscrizione pull richiede che il server di backend sicuro avvii richieste al server Cloud Pub/Sub per recuperare i messaggi.
2. Segui le istruzioni riportate nell'articolo Aggiungere un abbonamento per creare un abbonamento.

Concedere i diritti di pubblicazione sull'argomento

Cloud Pub/Sub richiede che tu conceda a Google Play i privilegi per pubblicare notifiche nel tuo argomento.

1. Apri la console Google Cloud.
2. Seleziona il tuo progetto, quindi fai clic su Pub/Sub nel menu di navigazione a sinistra.

3. Trova l'argomento e apri i dettagli delle autorizzazioni.

   

4. Aggiungi il service account google-play-developer-notifications@system.gserviceaccount.com e concedigli il ruolo di Publisher Pub/Sub.

   

5. Fai clic su Salva per completare la configurazione dell'argomento.

   

Attivare le notifiche in tempo reale per lo sviluppatore per la tua app

Per attivare le notifiche in tempo reale per lo sviluppatore per la tua app:

1. Apri Google Play Console.
2. Seleziona l'app.
3. Vai a Monetizzazione > Configurazione della monetizzazione.

4. Scorri fino alla sezione Notifiche in tempo reale per lo sviluppatore nella parte superiore della pagina.

   

5. Seleziona Attiva notifiche in tempo reale.

6. Nel campo Nome argomento, inserisci il nome completo dell'argomento Cloud Pub/Sub che hai configurato in precedenza. Il nome dell'argomento deve essere nel formato projects/{project_id}/topics/{topic_name}, dove project_id è l'identificatore univoco del tuo progetto e topic_name è il nome dell'argomento creato in precedenza.

7. Fai clic su Invia messaggio di prova per inviare un messaggio di prova. L'esecuzione di un test di pubblicazione consente di assicurarsi che tutto sia configurato correttamente. Se la pubblicazione di prova ha esito positivo, viene visualizzato un messaggio che indica che la pubblicazione di prova è riuscita. Se hai allegato un abbonamento a questo argomento, dovresti ricevere il messaggio di test.

   Per una sottoscrizione pull, vai alla sottoscrizione in console Cloud, fai clic su Visualizza messaggi e procedi con l'esecuzione del pull dei messaggi. Devi confermare la ricezione di tutti i messaggi che hai recuperato per evitare la consegna ripetuta da parte di Cloud Pub/Sub. Per una sottoscrizione push, controlla se il messaggio di test viene recapitato all'endpoint push. Un codice di risposta positivo fungerà da conferma di ricezione del messaggio.

   Se la pubblicazione non riesce, viene visualizzato un errore. Assicurati che il nome dell'argomento sia corretto e che il service account google-play-developer-notifications@system.gserviceaccount.com abbia l'accesso Publisher Pub/Sub all'argomento.

8. Scegli i tipi di notifiche che vuoi ricevere.

   • Ricevi notifiche relative agli abbonamenti e a tutti gli acquisti annullati: ricevi notifiche in tempo reale per lo sviluppatore relative ad abbonamenti e acquisti annullati. Non riceverai notifiche per gli acquisti di prodotti a pagamento singolo.
   • Ricevi tutte le notifiche per gli abbonamenti e i prodotti a pagamento singolo: ricevi notifiche per tutti gli eventi relativi ad abbonamenti e acquisti annullati. Riceverai anche eventi di acquisto di prodotti a pagamento singolo, ad esempio ONE_TIME_PRODUCT_PURCHASED e ONE_TIME_PRODUCT_CANCELED. Consulta Ciclo di vita dell'acquisto una tantum per scoprire di più su questi eventi di acquisto.

9. Fai clic su Salva modifiche.

Verifica della configurazione

Per ricevere le notifiche in tempo reale per lo sviluppatore, devi creare un server di backend sicuro per utilizzare i messaggi inviati all'argomento Cloud Pub/Sub.

Puoi testare la configurazione utilizzando il pulsante Invia messaggio di test in Google Play Console, come descritto nella sezione precedente. Se non hai configurato un server di backend per utilizzare le notifiche, puoi utilizzare lo strumento a riga di comando gcloud per verificare la configurazione. Per istruzioni sull'elaborazione dei messaggi utilizzando gcloud, vedi Esegui il pull del messaggio dalla sottoscrizione.

Passaggi successivi

• Integrare la libreria nell'app