Объявления с вознаграждением

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

Объявления с вознаграждением позволяют предлагать пользователям контент в приложении за взаимодействие с видеорекламой и интерактивной рекламой игр, а также за прохождение опросов.

Подготовка

Прежде чем продолжить, сделайте следующее:

• Настройте Google Mobile Ads SDK (Legacy).
• Используйте идентификатор тестового рекламного блока для объявлений с вознаграждением ca-app-pub-3940256099942544/5224354917.
  • При создании и тестировании приложений используйте тестовые объявления, а не реальные. Если вы не будете использовать идентификатор тестового рекламного блока, Google может заблокировать ваш аккаунт.
  • Перед публикацией приложения замените этот идентификатор на идентификатор своего рекламного блока.
  • Подробнее о тестовых объявлениях Google Mobile Ads SDK (Legacy) рассказывается в статье Как включить тестовые объявления.

Загрузите объект объявления с вознаграждением

Примечание. Все вызовы Google Mobile Ads SDK (Legacy) должны выполняться в основном потоке.

Объявления с вознаграждением загружаются путем вызова статического метода load в классе RewardedAd и передачи RewardedAdLoadCallback. Обычно это делается в методе onCreate класса Activity. Обратите внимание, что, как и в случае с другими обратными вызовами загрузки форматов, RewardedAdLoadCallback использует LoadAdError для предоставления более точных сведений об ошибках.

Java

RewardedAd.load(
    this,
    "AD_UNIT_ID",
    new AdRequest.Builder().build(),
    new RewardedAdLoadCallback() {
      @Override
      public void onAdLoaded(@NonNull RewardedAd rewardedAd) {
        Log.d(TAG, "Ad was loaded.");
        MainActivity.this.rewardedAd = rewardedAd;
      }

      @Override
      public void onAdFailedToLoad(@NonNull LoadAdError loadAdError) {
        Log.d(TAG, loadAdError.getMessage());
        rewardedAd = null;
      }
    });
MainActivity.java

Kotlin

RewardedAd.load(
  this,
  "AD_UNIT_ID",
  AdRequest.Builder().build(),
  object : RewardedAdLoadCallback() {
    override fun onAdLoaded(ad: RewardedAd) {
      Log.d(TAG, "Ad was loaded.")
      rewardedAd = ad
    }

    override fun onAdFailedToLoad(adError: LoadAdError) {
      Log.d(TAG, adError.message)
      rewardedAd = null
    }
  },
)
MainActivity.kt

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

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

Настройте FullScreenContentCallback

FullScreenContentCallback обрабатывает события, связанные с показом RewardedAd. Прежде чем показывать RewardedAd, настройте обратный вызов следующим образом:

Java

rewardedAd.setFullScreenContentCallback(
    new FullScreenContentCallback() {
      @Override
      public void 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.
        rewardedAd = null;
      }

      @Override
      public void 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.
        rewardedAd = null;
      }

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

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

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

Kotlin

rewardedAd?.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.
      rewardedAd = 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.
      rewardedAd = 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

rewardedAd.show(
    MainActivity.this,
    new OnUserEarnedRewardListener() {
      @Override
      public void onUserEarnedReward(@NonNull RewardItem rewardItem) {
        Log.d(TAG, "User earned the reward.");
        // Handle the reward.
      }
    });
MainActivity.java

Kotlin

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

Для объявлений, которые показывает Google, Google Mobile Ads SDK (Legacy) вызывает метод onUserEarnedReward перед методом onAdDismissedFullScreenContent. Для объявлений, которые показываются с помощью медиации AdMob, порядок обратных вызовов определяется сторонним источником объявлений. Для источников объявлений, которые предоставляют один обратный вызов закрытия с информацией о вознаграждении, адаптер медиации вызывает метод onUserEarnedReward перед методом onAdDismissedFullScreenContent. Подробнее о том, как настроить медиацию AdMob…

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

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

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

Java

RewardedAd.load(
    context,
    AD_UNIT_ID,
    new AdRequest.Builder().build(),
    new RewardedAdLoadCallback() {
      @Override
      public void onAdLoaded(RewardedAd ad) {
        rewardedAd = ad;
        ServerSideVerificationOptions options =
            new ServerSideVerificationOptions.Builder()
                .setCustomData("SAMPLE_CUSTOM_DATA_STRING")
                .build();
        rewardedAd.setServerSideVerificationOptions(options);
      }
    });
RewardedAdSnippets.java

Kotlin

RewardedAd.load(
  context,
  AD_UNIT_ID,
  AdRequest.Builder().build(),
  object : RewardedAdLoadCallback() {
    override fun onAdLoaded(ad: RewardedAd) {
      rewardedAd = ad
      val options =
        ServerSideVerificationOptions.Builder().setCustomData("SAMPLE_CUSTOM_DATA_STRING").build()
      rewardedAd?.setServerSideVerificationOptions(options)
    }
  },
)
RewardedAdSnippets.kt

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

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

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

Примеры на GitHub

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

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

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

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