Межстраничные объявления с вознаграждением (бета)

Выберите платформу: Android iOS Unity Flutter Android (устаревшая версия)

Межстраничные объявления с вознаграждением – это формат рекламы с поощрением, которая показывается при переходах внутри приложения и позволяет предлагать пользователям награды за взаимодействие с ней. В отличие от обычных объявлений с вознаграждением, для показа межстраничных объявлений с вознаграждением не требуется согласие пользователя.

Требования

• Настройте Google Mobile Ads SDK (Legacy).
• Включите тестовые объявления.

Реализация

Чтобы интегрировать межстраничные объявления с вознаграждением, выполните следующие действия:

• Загрузка объявления
• Регистрация обратных вызовов для событий полноэкранных объявлений
• Обработка обратного вызова для вознаграждения
• Показ объявления
• Как проверить обратные вызовы SSV (необязательно)

Загрузка объявления

Объявление загружается с помощью статического метода load класса RewardedInterstitialAd. Для метода load требуется Context, идентификатор рекламного блока, объект AdRequest и RewardedInterstitialAdLoadCallback, чтобы получать уведомления об успешной или неудавшейся загрузке объявления. Загруженный объект RewardedInterstitialAd передается в качестве параметра в обратный вызов onRewardedInterstitialAdLoaded.

В примере ниже показано, как загрузить RewardedInterstitialAd в 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; } });

MainActivity.java

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 } }, )

MainActivity.kt

Замените AD_UNIT_ID идентификатором своего рекламного блока.

Совет. Вы можете использовать вызовы загрузки объявлений, чтобы создать кеш предварительно загруженных объявлений, которые будут показываться без задержки. Поскольку срок действия объявлений истекает через час, вам следует очищать этот кеш и загружать новые объявления каждый час.

Регистрация обратных вызовов

Чтобы получать уведомления о событиях показа, необходимо передать объект FullScreenContentCallback в сеттер объявления. Объект FullScreenContentCallback обрабатывает обратные вызовы, когда объявление показывается успешно или неуспешно, а также когда оно закрывается. В приведенном ниже коде показано, как задать анонимный объект FullScreenContentCallback в 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.");
      }
    });
MainActivity.java

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.")
    }
  }
MainActivity.kt

Покажите объявление

Важно! Перед показом межстраничного объявления с вознаграждением пользователь увидит предложение вознаграждения, которое содержит понятное сообщение с информацией о вознаграждении и позволяет пропустить объявление до его начала. Подробнее…

При показе межстраничного объявления с вознаграждением передайте объект OnUserEarnedRewardListener, чтобы обрабатывать события получения вознаграждения:

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();
      }
    });
MainActivity.java

Kotlin

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

Как проверить обратные вызовы при проверке на стороне сервера (необязательно)

Если вам нужны дополнительные данные в обратных вызовах для проверки на стороне сервера, используйте функцию специальных данных в объявлениях с вознаграждением. Любое строковое значение, заданное в объекте объявления с вознаграждением, передается в параметр запроса custom_data обратного вызова для проверки на стороне сервера. Если значение данных клиентов не задано, то значение параметра запроса custom_data не будет представлено в обратном вызове для проверки на стороне сервера.

В примере кода ниже показано, как задать пользовательские данные в объекте межстраничного объявления с вознаграждением перед запросом объявления.

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);
      }
    });
RewardedInterstitialAdSnippets.java

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)
    }
  },
)
RewardedInterstitialAdSnippets.kt

Замените SAMPLE_CUSTOM_DATA_STRING своими данными.

Если вы хотите задать собственную строку вознаграждения, это нужно сделать до показа объявления.

Важно! Строка специального вознаграждения экранируется с помощью процента и может требовать декодирования при обработке из обратного вызова для проверки на стороне сервера.

Примеры на GitHub

• Пример межстраничного объявления с вознаграждением: Java | Kotlin

Дальнейшие действия

Ознакомьтесь со следующими темами:

• Конфиденциальность пользователей
• Оптимизированная инициализация SDK и загрузка объявлений (бета)