Prepararsi per il trasferimento

Questo argomento elenca e descrive i passaggi di configurazione da completare per 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 da vendere e l'attivazione e configurazione delle API che utilizzi per vendere e gestire i tuoi prodotti. Questo argomento descrive inoltre come configurare le notifiche in tempo reale per lo sviluppatore in modo da ricevere una notifica ogni volta che lo stato di un prodotto cambia.

Configurare un account sviluppatore Google Play

Per pubblicare app e giochi su Google Play, utilizza Google Play Console. Puoi utilizzare Google Play Console anche per gestire le impostazioni e i prodotti relativi alla fatturazione.

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

Per vendere app a pagamento e acquisti in-app su Google Play, devi anche configurare un profilo nel Centro pagamenti Google e collegarlo al tuo account sviluppatore Google Play. Per scoprire come collegare il tuo profilo al tuo account o per verificare se hai già un account e un profilo collegati, consulta l'articolo 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 Libreria Fatturazione Google Play. Questo passaggio è necessario per abilitare le funzionalità relative alla fatturazione in Google Play Console, ad esempio per configurare i prodotti che vuoi vendere.

Aggiungi dipendenza libreria

Per integrare il sistema di fatturazione di Google Play, devi prima aggiungere una dipendenza alla Libreria Fatturazione Google Play nell'app. Questa libreria fornisce 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.

Libreria Fatturazione Google Play è disponibile nel Repository Maven di Google. Aggiungi la dipendenza al file build.gradle dell'app come mostrato:

Trendy

dependencies {
    def billing_version = "6.1.0"

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

Kotlin

dependencies {
    val billing_version = "6.1.0"

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

Se usi Kotlin, il modulo KTX della Libreria Fatturazione Play contiene il supporto di estensioni Kotlin e coroutine 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:

Trendy

dependencies {
    def billing_version = "6.1.0"

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

Kotlin

dependencies {
    val billing_version = "6.1.0"

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

Gli esempi di codice di Kotlin presenti in questa pagina utilizzano KTX ove possibile.

Carica la tua app

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

Creare e configurare i prodotti

Dopo aver abilitato le funzionalità 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 contengono ulteriori informazioni richieste, ad esempio è necessario selezionare se si tratta di un tipo di rinnovo automatico o prepagato per il piano base.

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

  • Per creare e configurare prodotti monouso, vedi Creare un prodotto gestito. Tieni presente che Google Play Console fa riferimento ai prodotti a pagamento singolo come prodotti gestiti.

  • Per creare e configurare le sottoscrizioni, vedi Creare un abbonamento.

In alternativa all'interfaccia web, puoi anche gestire i tuoi prodotti 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.

Configura l'API Google Play Developer

L'API Google Play Developer è un'API server-to-server che integra la 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 gli 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 le istruzioni, consulta la Guida introduttiva all'API Google Play Developer.

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 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 che consente di ricevere notifiche da Google ogni volta che viene modificato il diritto di un utente all'interno della tua app. RTDN sfrutta l'utilizzo di Google Cloud Pub/Sub, che ti consente di ricevere i dati che vengono inviati a un URL impostato da te o sottoposti a sondaggi tramite 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 inefficiente dell'API Google Play Developer può portare a limitazioni delle quote 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 usa Cloud Pub/Sub per pubblicare notifiche push sugli argomenti a cui ti abboni.

Per ricevere le notifiche, devi creare un server di backend per utilizzare i messaggi inviati all'argomento. Il server può quindi consumare questi messaggi rispondendo alle richieste HTTPS a un endpoint registrato o utilizzando le librerie client di Cloud Pub/Sub. Queste librerie sono disponibili in una varietà di linguaggi. Ulteriori informazioni sono disponibili anche nella sezione Creare una sottoscrizione Pub/Sub in questo argomento.

Determina prezzi e quote

Per maggiori dettagli su prezzi e quote, consulta la pagina relativa ai prezzi e alle quote.

Stima l'utilizzo dei dati

La parte relativa ai dati della notifica di abbonamento corrisponde a 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 mensili dipende dal tuo ciclo di fatturazione e dal comportamento degli utenti. Dovresti ricevere almeno una notifica per ogni utente durante un ciclo di fatturazione.

Configura Cloud Pub/Sub

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

Per utilizzare Cloud Pub/Sub, devi avere un progetto Google Cloud con l'API Cloud Pub/Sub abilitata. Se non hai dimestichezza con GCP e Cloud Pub/Sub, consulta la guida rapida.

Creare un argomento

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

Crea una sottoscrizione Pub/Sub

Per ricevere i messaggi pubblicati in un argomento, devi creare una sottoscrizione 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 in Aggiungere un abbonamento per crearne uno.

Concedi i diritti di pubblicazione sull'argomento

Cloud Pub/Sub richiede la concessione dei privilegi Google Play per pubblicare notifiche sul tuo argomento.

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

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

    accesso alla configurazione per l'argomento delle autorizzazioni
    Figura 1. Accesso alla configurazione per l'argomento Autorizzazioni.

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

    aggiunta di un account di servizio Google Play come publisher Pub/Sub
    Figura 2. Aggiunta dell'account di servizio Google Play come publisher Pub/Sub.

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

    un argomento configurato
    Figura 3. Un argomento configurato.

Attiva 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 Monetizza > Configurazione della monetizzazione.

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

    Sezione delle notifiche in tempo reale per lo sviluppatore
    Figura 4. Sezione Notifiche in tempo reale per lo sviluppatore.

  5. 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 progetto e topic_name è il nome dell'argomento creato in precedenza.

  6. Fai clic su Invia messaggio di prova per inviare un messaggio di prova. L'esecuzione di una pubblicazione di prova aiuta a garantire che ogni elemento 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 una sottoscrizione per questo argomento, dovresti ricevere il messaggio di test.

    Per una sottoscrizione pull, vai alla sottoscrizione in Cloud Console, fai clic su Visualizza messaggi e procedi con il pull dei messaggi. Devi confermare qualsiasi messaggio di cui hai eseguito il pull per evitare la consegna ripetuta da parte di Cloud Pub/Sub. Per una abbonamento push, controlla se il messaggio di test viene recapitato all'endpoint push. Un codice di risposta riuscita fungerà da accettazione del messaggio.

    Se la pubblicazione non va a buon fine, viene visualizzato un errore. Assicurati che il nome dell'argomento sia corretto e che l'account di servizio google-play-developer-notifications@system.gserviceaccount.com disponga dell'accesso Publisher Pub/Sub all'argomento.

  7. Fai clic su Salva modifiche.

Verifica della configurazione

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

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

Passaggi successivi