Награжден

Реклама с вознаграждением — это реклама, с которой пользователи могут взаимодействовать в обмен на награды внутри приложения . В этом руководстве показано, как интегрировать рекламу с вознаграждением из Менеджера рекламы в приложение Flutter.

Всегда проверяйте с помощью тестовых объявлений

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

Самый простой способ загрузить тестовую рекламу — использовать наш специальный идентификатор тестового рекламного блока для объявлений с вознаграждением:

• /21775744923/example/rewarded

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

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

В следующем примере загружается объявление с вознаграждением:

RewardedAd.load(
  adUnitId: "_adUnitId",
  request: const AdManagerAdRequest(),
  rewardedAdLoadCallback: RewardedAdLoadCallback(
    onAdLoaded: (RewardedAd ad) {
      // Called when an ad is successfully received.
      debugPrint('Ad was loaded.');
      // Keep a reference to the ad so you can show it later.
      _rewardedAd = ad;
    },
    onAdFailedToLoad: (LoadAdError error) {
      // Called when an ad request failed.
      debugPrint('Ad failed to load with error: $error');
    },
  ),
);
rewarded_ad_snippets.dart

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

События рекламы с вознаграждением

Используя FullScreenContentCallback , вы можете отслеживать события жизненного цикла, например, показ или закрытие рекламы. Установите RewardedAd.fullScreenContentCallback перед показом рекламы, чтобы получать уведомления об этих событиях. В этом примере каждый метод реализуется, и сообщение выводится в консоль:

ad.fullScreenContentCallback = FullScreenContentCallback(
  onAdShowedFullScreenContent: (ad) {
    // Called when the ad showed the full screen content.
    debugPrint('Ad showed full screen content.');
  },
  onAdFailedToShowFullScreenContent: (ad, err) {
    // Called when the ad failed to show full screen content.
    debugPrint('Ad failed to show full screen content with error: $err');
    // Dispose the ad here to free resources.
    ad.dispose();
  },
  onAdDismissedFullScreenContent: (ad) {
    // Called when the ad dismissed full screen content.
    debugPrint('Ad was dismissed.');
    // Dispose the ad here to free resources.
    ad.dispose();
  },
  onAdImpression: (ad) {
    // Called when an impression occurs on the ad.
    debugPrint('Ad recorded an impression.');
  },
  onAdClicked: (ad) {
    // Called when a click is recorded for an ad.
    debugPrint('Ad was clicked.');
  },
);
rewarded_ad_snippets.dart

Показывать рекламу

RewardedAd отображается поверх всего содержимого приложения и размещается статически, поэтому её нельзя добавить в дерево виджетов Flutter. Вы можете выбрать время показа рекламы, вызвав show() . RewardedAd.show() принимает метод OnUserEarnedRewardCallback , который вызывается, когда пользователь получает вознаграждение. Обязательно реализуйте эту функцию и вознаграждайте пользователя за просмотр рекламы.

_rewardedAd?.show(
  onUserEarnedReward:
      (AdWithoutView ad, RewardItem rewardItem) {
        debugPrint(
          'Reward amount: ${rewardItem.amount}',
        );
      },
);
main.dart

После вызова show() отображаемая таким образом Ad не может быть удалена программно и требует действий пользователя. RewardedAd может быть показана только один раз. Последующие вызовы show будут активировать onAdFailedToShowFullScreenContent .

Рекламное объявление должно быть удалено, когда доступ к нему больше не требуется. Оптимальный способ вызова метода dispose() — использовать обратные вызовы FullScreenContentCallback.onAdDismissedFullScreenContent и FullScreenContentCallback.onAdFailedToShowFullScreenContent .

[Необязательно] Проверка обратных вызовов проверки на стороне сервера (SSV)

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

В следующем примере кода показано, как настроить параметры SSV после загрузки вознагражденной рекламы:

RewardedAd.load(
  adUnitId: "_adUnitId",
  request: AdManagerAdRequest(),
  rewardedAdLoadCallback: RewardedAdLoadCallback(
    onAdLoaded: (ad) {
      ServerSideVerificationOptions _options =
          ServerSideVerificationOptions(
              customData: 'SAMPLE_CUSTOM_DATA_STRING');
      ad.setServerSideOptions(_options);
      _rewardedAd = ad;
    },
    onAdFailedToLoad: (error) {},
  ),
);
rewarded_ad_snippets.dart

Замените SAMPLE_CUSTOM_DATA_STRING вашими пользовательскими данными.