Annunci con premio

Gli annunci con premio ti consentono di premiare con articoli in-app gli utenti che hanno interagito con gli annunci video, gli annunci demo e i sondaggi.

Prerequisiti

  • Completa la Guida introduttiva.

    • Esegui sempre i test con gli annunci di prova

    Quando crei e testi le tue app, assicurati di utilizzare annunci di prova anziché annunci di produzione live. In caso contrario, il tuo account potrebbe essere sospeso.

    Il modo più semplice per caricare gli annunci di test è utilizzare il nostro ID unità pubblicitaria di test dedicato per gli annunci con premio per Android:

    ca-app-pub-3940256099942544/5224354917

    È stato configurato appositamente per restituire annunci di test per ogni richiesta e puoi utilizzarlo liberamente nelle tue app durante la codifica, i test e il debug. Assicurati solo di sostituirlo con il tuo ID unità pubblicitaria prima di pubblicare l'app.

    Per ulteriori informazioni sul funzionamento degli annunci di test dell'SDK Google Mobile Ads (beta), consulta Annunci di test.

    Caricare un annuncio

    Per caricare un annuncio con premio, chiama il metodo statico RewardedAd load() e trasmetti un AdLoadCallback<RewardedAd> per ricevere l'annuncio caricato o eventuali errori.

    Kotlin

    import com.google.android.libraries.ads.mobile.sdk.common.AdLoadCallback
import com.google.android.libraries.ads.mobile.sdk.common.AdRequest
import com.google.android.libraries.ads.mobile.sdk.common.FullScreenContentError
import com.google.android.libraries.ads.mobile.sdk.common.LoadAdError
import com.google.android.libraries.ads.mobile.sdk.rewarded.RewardedAd
import com.google.android.libraries.ads.mobile.sdk.rewarded.RewardedAdEventCallback
import com.google.android.libraries.ads.mobile.sdk.MobileAds

class RewardedActivity : Activity() {
  private var rewardedAd: RewardedAd? = null

  override fun onCreate(savedInstanceState: Bundle?) {
    super.onCreate(savedInstanceState)

    // Load ads after you inititalize Google Mobile Ads SDK (beta).
    RewardedAd.load(
      AdRequest.Builder(AD_UNIT_ID).build(),
      object : AdLoadCallback<RewardedAd> {
        override fun onAdLoaded(ad: RewardedAd) {
          // Rewarded ad loaded.
          rewardedAd = ad
        }

        override fun onAdFailedToLoad(adError: LoadAdError) {
          // Rewarded ad failed to load.
          rewardedAd = null
        }
      },
    )
  }

  companion object {
    // Sample rewarded ad unit ID.
    const val AD_UNIT_ID = "ca-app-pub-3940256099942544/5224354917"
  }
}

    Java

    import com.google.android.libraries.ads.mobile.sdk.common.AdLoadCallback;
import com.google.android.libraries.ads.mobile.sdk.common.AdRequest;
import com.google.android.libraries.ads.mobile.sdk.common.FullScreenContentError;
import com.google.android.libraries.ads.mobile.sdk.common.LoadAdError;
import com.google.android.libraries.ads.mobile.sdk.rewarded.RewardedAd;
import com.google.android.libraries.ads.mobile.sdk.rewarded.RewardedAdEventCallback;
import com.google.android.libraries.ads.mobile.sdk.MobileAds;

class RewardedActivity extends Activity {
  // Sample rewarded ad unit ID.
  private static final String AD_UNIT_ID = "ca-app-pub-3940256099942544/5224354917";
  private RewardedAd rewardedAd;

  @Override
  protected void onCreate(Bundle savedInstanceState) {
    super.onCreate(savedInstanceState);

    // Load ads after you initialize Google Mobile Ads SDK (beta).
    RewardedAd.load(
        new AdRequest.Builder(AD_UNIT_ID).build(),
        new AdLoadCallback<RewardedAd>() {
          @Override
          public void onAdLoaded(@NonNull RewardedAd rewardedAd) {
            // Rewarded ad loaded.
            AdLoadCallback.super.onAdLoaded(rewardedAd);
            RewardedActivity.this.rewardedAd = rewardedAd;
          }

          @Override
          public void onAdFailedToLoad(@NonNull LoadAdError adError) {
            // Rewarded ad failed to load.
            AdLoadCallback.super.onAdFailedToLoad(adError);
            rewardedAd = null;
          }
        }
    );
  }
}

    Imposta RewardedAdEventCallback

    RewardedAdEventCallback gestisce gli eventi relativi alla visualizzazione di RewardedAd. Prima di mostrare l'annuncio con premio, assicurati di impostare il callback:

    Kotlin

    // Listen for ad events.
rewardedAd?.adEventCallback =
  object : RewardedAdEventCallback {
    override fun onAdShowedFullScreenContent() {
      // Rewarded ad did show.
    }

    override fun onAdDismissedFullScreenContent() {
      // Rewarded ad did dismiss.
      rewardedAd = null
    }

    override fun onAdFailedToShowFullScreenContent(
      fullScreenContentError: FullScreenContentError
    ) {
      // Rewarded ad failed to show.
      rewardedAd = null
    }

    override fun onAdImpression() {
      // Rewarded ad did record an impression.
    }

    override fun onAdClicked() {
      // Rewarded ad did record a click.
    }
  }

    Java

    // Listen for ad events.
rewardedAd.setAdEventCallback(
    new RewardedAdEventCallback() {
      @Override
      public void onAdShowedFullScreenContent() {
        // Rewarded ad did show.
        RewardedAdEventCallback.super.onAdShowedFullScreenContent();
      }

      @Override
      public void onAdDismissedFullScreenContent() {
        // Rewarded ad did dismiss.
        RewardedAdEventCallback.super.onAdDismissedFullScreenContent();
        rewardedAd = null;
      }

      @Override
      public void onAdFailedToShowFullScreenContent(
          @NonNull FullScreenContentError fullScreenContentError) {
        // Rewarded ad failed to show.
        RewardedAdEventCallback.super.onAdFailedToShowFullScreenContent(
            fullScreenContentError);
        rewardedAd = null;
      }

      @Override
      public void onAdImpression() {
        // Rewarded ad did record an impression.
        RewardedAdEventCallback.super.onAdImpression();
      }

      @Override
      public void onAdClicked() {
        // Rewarded ad did record a click.
        RewardedAdEventCallback.super.onAdClicked();
      }
    }
);

    Mostra l'annuncio

    Per mostrare un annuncio con premio, utilizza il metodo show(). Utilizza un oggetto OnUserEarnedRewardListener per gestire gli eventi premio.

    Kotlin

    // Show the ad.
rewardedAd?.show(
  this@RewardedActivity,
  object : OnUserEarnedRewardListener {
    override fun onUserEarnedReward(rewardItem: RewardItem) {
      // User earned the reward.
      val rewardAmount = rewardItem.amount
      val rewardType = rewardItem.type
    }
  },
)

    Java

    // Show the ad.
rewardedAd.show(
    RewardedActivity.this,
    new OnUserEarnedRewardListener() {
      @Override
      public void onUserEarnedReward(@NonNull RewardItem rewardItem) {
        // User earned the reward.
        int rewardAmount = rewardItem.getAmount();
        String rewardType = rewardItem.getType();
    }
});

    Domande frequenti

    Esiste un timeout per la chiamata di inizializzazione?
    Dopo 10 secondi, l'SDK Google Mobile Ads (beta) richiama il OnInitializationCompleteListener anche se una rete di mediazione non ha ancora completato l'inizializzazione.
    Cosa succede se alcune reti di mediazione non sono pronte quando ricevo il callback di inizializzazione?

    Ti consigliamo di caricare un annuncio all'interno del callback di OnInitializationCompleteListener. Anche se una rete di mediazione non è pronta, l'SDK Google Mobile Ads (beta) chiede comunque un annuncio a quella rete. Pertanto, se una rete di mediazione termina l'inizializzazione dopo il timeout, può comunque servire le richieste di annunci future nella sessione.

    Puoi continuare a eseguire il polling dello stato di inizializzazione di tutti gli adattatori durante la sessione dell'app chiamando MobileAds.getInitializationStatus().

    Come faccio a sapere perché una determinata rete di mediazione non è pronta?

    AdapterStatus.getDescription() descrive perché un adattatore non è pronto a gestire le richieste di annunci.

    La richiamata onUserEarnedReward() viene sempre chiamata prima della richiamata onAdDismissedFullScreenContent()?

    Per gli annunci Google, tutte le chiamate onUserEarnedReward() si verificano prima di onAdDismissedFullScreenContent(). Per gli annunci pubblicati tramite mediazione, l'implementazione dell'SDK della rete pubblicitaria di terze parti determina l'ordine di callback. Per gli SDK delle reti pubblicitarie che forniscono un singolo callback di chiusura con informazioni sul premio, l'adattatore di mediazione richiama onUserEarnedReward() prima di onAdDismissedFullScreenContent().

    Esempio

    Scarica ed esegui l'app di esempio che mostra l'utilizzo dell'SDK Google Mobile Ads (beta).