Aggiungere funzionalità specifiche dei prodotti premio

Un metodo per sbloccare i prodotti in-app e i vantaggi per gli utenti consiste nel creare prodotti con premio, ovvero elementi che gli utenti ricevono dopo aver guardato un video pubblicitario. Fornendo prodotti premio, consenti agli utenti di ottenere premi e vantaggi in-app senza dover effettuare acquisti diretti.

Questo documento spiega come implementare funzionalità specifiche per i prodotti premio. La sezione Diagramma del flusso di lavoro di questa pagina illustra il processo.

Identificare i prodotti premio della tua app

I prodotti premio hanno un valore SkuType pari a INAPP. Per fare in modo che gli utenti possano guardare più annunci e ricevere più premi, è necessario consumare i prodotti.

Prima di poter offrire un prodotto premio a un utente, devi ottenere il SkuDetails per il prodotto. Per farlo, chiama querySkuDetailsAsync() con SkuType.INAPP come tipo di prodotto.

Dichiarare annunci adatti all'età

Per facilitare il rispetto degli obblighi di legge nei confronti dei bambini e degli utenti minorenni, tra cui il Children's Online Privacy Protection Act (COPPA) e il Regolamento generale sulla protezione dei dati (GDPR), la tua app deve dichiarare quali annunci devono essere trattati come destinati ai minori negli Stati Uniti e quali annunci sono rivolti agli utenti che non hanno l'età del consenso digitale applicabile nel loro paese. Il Centro assistenza AdMob spiega quando è necessario codificare le richieste di annunci per il trattamento per siti o servizi destinati ai minori e quando è opportuno applicarle per il trattamento per utenti sotto l'età del consenso, nonché i relativi effetti.

Quando crei il client di fatturazione della tua app, valuta se le richieste di annunci con premio devono essere trattate come rivolte ai minori o se devono essere indirizzate a utenti di età inferiore a quella del consenso digitale. Se le richieste di annunci devono avere queste restrizioni in atto, chiama i metodi setChildDirected() e setUnderAgeOfConsent(), trasmettendo i valori appropriati a ciascun metodo.

Il seguente snippet di codice mostra come dichiarare che gli annunci video devono essere adatti ai bambini o agli utenti di età inferiore a quella del consenso digitale:

Kotlin

val billingClient = BillingClient.newBuilder(context)
        .setListener(this)
        .setChildDirected(ChildDirected.CHILD_DIRECTED)
        .setUnderAgeOfConsent(UnderAgeOfConsent.UNDER_AGE_OF_CONSENT)
        .build()

Java

BillingClient billingClient =
    BillingClient.newBuilder(context)
        .setListener(this)
        .setChildDirected(ChildDirected.CHILD_DIRECTED)
        .setUnderAgeOfConsent(UnderAgeOfConsent.UNDER_AGE_OF_CONSENT)
        .build();

Carica annunci video

Prima di mostrare all'utente la possibilità di guardare un annuncio video per ricevere un prodotto con premio, devi caricare il video. Per farlo, crea un oggetto RewardLoadParams associandolo all'oggetto SkuDetails che rappresenta il prodotto premio. Quindi, chiama il metodo loadRewardedSku() del tuo cliente di fatturazione, passando l'oggetto RewardLoadParams e un oggetto RewardResponseListener.

Il listener RewardResponseListener viene avvisato al termine del caricamento del video. Il listener riceve una notifica anche se il video non è disponibile o se si verifica un altro errore, come un timeout del server.

Per mantenere le prestazioni del dispositivo quando carichi i video associati ai prodotti premio della tua app, tieni presente le seguenti best practice:

  • Carica al massimo tre SKU di prodotti premio alla volta.
  • Tenta di caricare i video ogni volta che l'utente accede alla tua app. Questo passaggio ti aiuta a verificare se i video sono ancora caricati e disponibili.
  • Quando decidi quando caricare i video, scegli l'equilibrio tra l'utilizzo della larghezza di banda e la reattività dell'app più adatto al tuo caso d'uso:

    • Al più presto, carica i video dopo aver chiamato getSkuDetails() per il prodotto premio associato. La tua app continua a essere molto reattiva, ma potresti sprecare dati di rete caricando un video che l'utente non guarda mai.
    • Al più tardi, carica il video quando l'utente passa alla pagina in cui deve essere visualizzato. In questo caso raramente la tua app spreca larghezza di banda, ma l'utente potrebbe dover attendere qualche istante prima che il pulsante per guardare il video diventi cliccabile.

Il seguente snippet di codice illustra la procedura per caricare un annuncio video che viene riprodotto prima che l'utente riceva il prodotto premio:

Kotlin

if (skuDetails.isRewarded()) {
    val params = RewardLoadParams.Builder()
            .setSkuDetails(skuDetails)
            .build()
    mBillingClient.loadRewardedSku(params.build(),
            object : RewardResponseListener {
        override fun onRewardResponse(@BillingResponse responseCode : Int) {
            if (responseCode == BillingResponse.OK) {
                // Enable the reward product, or make
                // any necessary updates to the UI.
            }
        }
    })
}

Java

if (skuDetails.isRewarded()) {
    RewardLoadParams.Builder params = RewardLoadParams.newBuilder();
    params.setSkuDetails(skuDetails);
    mBillingClient.loadRewardedSku(params.build(),
        new RewardResponseListener() {
            @Override
            public void onRewardResponse(int responseCode) {
                if (responseCode == BillingResponse.OK) {
                      // Enable the reward product, or make
                      // any necessary updates to the UI.
                  }
            }
        });
}

Offrire acquisti con premio agli utenti

Se la Libreria Fatturazione Google Play carica correttamente il video associato a un prodotto premio, ovvero se l'RewardResponseListener riceve un responseCode di BillingResponse.OK, puoi avviare il flusso di fatturazione.

Inizi a riprodurre gli annunci per un prodotto premio chiamando launchBillingFlow(), come fai per tutti gli altri tipi di prodotti in-app. Anche se l'utente non effettua un acquisto diretto per ricevere un prodotto premio, devi comunque abilitare il flusso di fatturazione in modo che l'utente possa ottenere e utilizzare il prodotto.

Completare l'acquisto

Per notificare al cliente di fatturazione che un utente ha ricevuto e utilizzato un prodotto premio, gestisci l'acquisto nel metodo onPurchasesUpdated() del tuo cliente di fatturazione. Tieni presente che gli acquisti con premio devono essere consumati.

Testa i tuoi prodotti premio

Per verificare come la tua app carica gli annunci video e fornisce prodotti premio agli utenti, ricorri ai tester autorizzati, che per impostazione predefinita ricevono annunci di prova anziché annunci reali. Per scoprire come configurare gli account per questi tester, consulta l'articolo Testare un'app di Fatturazione Google Play.

Un altro metodo di verifica prevede l'utilizzo dell'ID prodotto android.test.reward. Questo prodotto specifico è un nome riservato in Fatturazione Google Play, quindi non è necessario aggiungerlo all'elenco di prodotti in-app in Play Console.

Attenzione: quando testi i prodotti premio della tua app, non utilizzare prodotti reali, altrimenti il tuo account potrebbe essere segnalato come spam o fraudolento.

Al termine dei test, tuttavia, assicurati di sostituire android.test.reward con gli ID prodotto dei prodotti premio effettivi prima di eseguire il deployment dell'app di produzione per gli utenti finali.

Diagramma del flusso di lavoro dei prodotti premio

Il seguente diagramma di sequenza mostra in che modo l'utente, la tua app e la Libreria Fatturazione Google Play interagiscono per mostrare un annuncio video e concedere all'utente l'accesso a un prodotto premio:

Diagramma della sequenza che mostra il protocollo dei prodotti premio
Figura 1. Passaggi per completare l'acquisto di un prodotto premio utilizzando il servizio Fatturazione Google Play