Anúncios intersticiais premiados (Beta)

Selecione a plataforma: Android iOS Unity Flutter Android (legada)

O intersticial premiado é um tipo de formato de anúncio com incentivos que permite oferecer recompensas em anúncios que aparecem automaticamente durante transições naturais do app. Diferentemente dos anúncios premiados, os usuários não precisam ativar a visualização dos intersticiais premiados.

Pré-requisitos

Implementação

Estas são as principais etapas para integrar anúncios intersticiais premiados:

  • Carregar um anúncio
  • Registrar callbacks de eventos em tela cheia
  • Processar o callback de recompensa
  • Mostrar o anúncio
  • Opcional: validar callbacks de SSV

Carregar um anúncio

É possível carregar um anúncio usando o método estático load na classe RewardedInterstitialAd. O método de carregamento requer um contexto, seu ID do bloco de anúncios, um objeto AdRequest e um RewardedInterstitialAdLoadCallback para ser notificado quando o carregamento do anúncio for concluído ou apresentar falha. O objeto RewardedInterstitialAd carregado é fornecido como um parâmetro no callback onRewardedInterstitialAdLoaded.

O exemplo a seguir mostra como carregar um RewardedInterstitialAd no seu MainActivity.

Java

RewardedInterstitialAd.load( MainActivity.this, AD_UNIT_ID, new AdRequest.Builder().build(), new RewardedInterstitialAdLoadCallback() { @Override public void onAdLoaded(RewardedInterstitialAd ad) { Log.d(TAG, "Ad was loaded."); rewardedInterstitialAd = ad; isLoadingAds = false; } @Override public void onAdFailedToLoad(LoadAdError loadAdError) { Log.d(TAG, "onAdFailedToLoad: " + loadAdError.getMessage()); rewardedInterstitialAd = null; isLoadingAds = false; } });

Kotlin

RewardedInterstitialAd.load( this, AD_UNIT_ID, AdRequest.Builder().build(), object : RewardedInterstitialAdLoadCallback() { override fun onAdLoaded(rewardedAd: RewardedInterstitialAd) { Log.d(TAG, "Ad was loaded.") rewardedInterstitialAd = rewardedAd isLoadingAds = false } override fun onAdFailedToLoad(adError: LoadAdError) { Log.d(TAG, "onAdFailedToLoad: ${adError.message}") rewardedInterstitialAd = null isLoadingAds = false } }, )

Substitua AD_UNIT_ID pelo ID do seu bloco de anúncios.

Registrar callbacks

Para receber notificações de eventos de apresentação, transmita um objeto FullScreenContentCallback ao setter no seu anúncio. O objeto FullScreenContentCallback processa callbacks quando o anúncio é apresentado com ou sem sucesso e quando é dispensado. O código a seguir mostra como definir um objeto FullScreenContentCallback anônimo no seu RewardedInterstitialAdLoadCallback:

Java

rewardedInterstitialAd.setFullScreenContentCallback(
    new FullScreenContentCallback() {
      @Override
      public void onAdDismissedFullScreenContent() {
        // Called when fullscreen content is dismissed.
        Log.d(TAG, "The ad was dismissed.");
        // Make sure to set your reference to null so you don't
        // show it a second time.
        rewardedInterstitialAd = null;
        if (googleMobileAdsConsentManager.canRequestAds()) {
          loadRewardedInterstitialAd();
        }
      }

      @Override
      public void onAdFailedToShowFullScreenContent(AdError adError) {
        // Called when fullscreen content failed to show.
        Log.d(TAG, "The ad failed to show.");
        // Make sure to set your reference to null so you don't
        // show it a second time.
        rewardedInterstitialAd = null;
      }

      @Override
      public void onAdShowedFullScreenContent() {
        // Called when fullscreen content is shown.
        Log.d(TAG, "The ad was shown.");
      }

      @Override
      public void onAdImpression() {
        // Called when an impression is recorded for an ad.
        Log.d(TAG, "The ad recorded an impression.");
      }

      @Override
      public void onAdClicked() {
        // Called when ad is clicked.
        Log.d(TAG, "The ad was clicked.");
      }
    });

Kotlin

rewardedInterstitialAd?.fullScreenContentCallback =
  object : FullScreenContentCallback() {
    override fun onAdDismissedFullScreenContent() {
      // Called when fullscreen content is dismissed.
      Log.d(TAG, "Ad was dismissed.")
      // Don't forget to set the ad reference to null so you
      // don't show the ad a second time.
      rewardedInterstitialAd = null
    }

    override fun onAdFailedToShowFullScreenContent(adError: AdError) {
      // Called when fullscreen content failed to show.
      Log.d(TAG, "Ad failed to show.")
      // Don't forget to set the ad reference to null so you
      // don't show the ad a second time.
      rewardedInterstitialAd = null
    }

    override fun onAdShowedFullScreenContent() {
      // Called when fullscreen content is shown.
      Log.d(TAG, "Ad showed fullscreen content.")
    }

    override fun onAdImpression() {
      // Called when an impression is recorded for an ad.
      Log.d(TAG, "Ad recorded an impression.")
    }

    override fun onAdClicked() {
      // Called when an ad is clicked.
      Log.d(TAG, "Ad was clicked.")
    }
  }

Veicular o anúncio

Ao mostrar um anúncio intersticial premiado, transmita um objeto OnUserEarnedRewardListener para processar eventos premiados:

Java

rewardedInterstitialAd.show(
    MainActivity.this,
    new OnUserEarnedRewardListener() {
      @Override
      public void onUserEarnedReward(@NonNull RewardItem rewardItem) {
        Log.d(TAG, "The user earned the reward.");
        // Handle the reward.
        int rewardAmount = rewardItem.getAmount();
        String rewardType = rewardItem.getType();
      }
    });

Kotlin

rewardedInterstitialAd?.show(this) { rewardItem ->
  Log.d(TAG, "User earned the reward.")
  // Handle the reward.
  val rewardAmount = rewardItem.amount
  val rewardType = rewardItem.type
}

[Opcional] Validar callbacks de verificação do lado do servidor (SSV)

Se você precisar de dados extras em callbacks de verificação do lado do servidor, use o recurso de dados personalizados dos anúncios premiados. Qualquer valor de string definido em um objeto de anúncio premiado é transmitido ao parâmetro de consulta custom_data do callback de SSV. Se nenhum valor de dados personalizado for definido, o valor do parâmetro de consulta custom_data não estará presente no callback de SSV.

O exemplo de código a seguir demonstra como definir dados personalizados em um objeto de anúncio intersticial premiado antes de solicitar um anúncio.

Java

RewardedInterstitialAd.load( context, AD_UNIT_ID, new AdRequest.Builder().build(), new RewardedInterstitialAdLoadCallback() { @Override public void onAdLoaded(RewardedInterstitialAd ad) { rewardedInterstitialAd = ad; ServerSideVerificationOptions options = new ServerSideVerificationOptions.Builder() .setCustomData(SAMPLE_CUSTOM_DATA_STRING) .build(); rewardedInterstitialAd.setServerSideVerificationOptions(options); } });

Kotlin

RewardedInterstitialAd.load( context, AD_UNIT_ID, AdRequest.Builder().build(), object : RewardedInterstitialAdLoadCallback() { override fun onAdLoaded(ad: RewardedInterstitialAd) { rewardedInterstitialAd = ad val options = ServerSideVerificationOptions.Builder().setCustomData(SAMPLE_CUSTOM_DATA_STRING).build() rewardedInterstitialAd?.setServerSideVerificationOptions(options) } }, )

Substitua SAMPLE_CUSTOM_DATA_STRING pelos seus dados personalizados.

Se quiser definir a string de recompensa personalizada, faça isso antes de mostrar o anúncio.

Exemplos no GitHub

  • Exemplo de anúncios intersticiais premiados: Java | Kotlin

Próximas etapas

Confira os seguintes tópicos: