Награжден

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

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

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

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

ca-app-pub-3940256099942544/5224354917 

ca-app-pub-3940256099942544/1712485313 

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

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

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

RewardedAd.load(   adUnitId: "_adUnitId",   request: const AdRequest(),   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: AdRequest(),   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 вашими пользовательскими данными.

Полный пример на GitHub

Награжден