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

Выберите платформу: Android iOS Unity Flutter

Вознагражденные объявления — это объявления, с которыми пользователи могут взаимодействовать в обмен на вознаграждения в приложении . Это руководство покажет вам, как интегрировать вознагражденные объявления из AdMob в приложение iOS. Прочитайте несколько историй успеха клиентов: пример 1 , пример 2 .

Предпосылки

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

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

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

ca-app-pub-3940256099942544/1712485313

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

Дополнительную информацию о том, как работают тестовые объявления Mobile Ads SDK, см. в разделе Тестовые объявления .

Выполнение

Основные шаги по интеграции объявлений с вознаграждением следующие:

  • Загрузить объявление
  • [Необязательно] Проверка обратных вызовов SSV
  • Зарегистрируйтесь для обратных звонков
  • Показ рекламы и обработка события вознаграждения

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

Загрузка рекламы выполняется с помощью метода load(adUnitID:request) класса GADRewardedAd .

Быстрый 

import GoogleMobileAds
import UIKit

class ViewController: UIViewController {

  private var rewardedAd: RewardedAd?

  func loadRewardedAd() async {
    do {
      rewardedAd = try await RewardedAd.load(
        with: "ca-app-pub-3940256099942544/1712485313", request: Request())
    } catch {
      print("Rewarded ad failed to load with error: \(error.localizedDescription)")
    }
  }
}

SwiftUI 

import GoogleMobileAds

class RewardedViewModel: NSObject, ObservableObject, FullScreenContentDelegate {
  @Published var coins = 0
  private var rewardedAd: RewardedAd?

  func loadAd() async {
    do {
      rewardedAd = try await RewardedAd.load(
        with: "ca-app-pub-3940256099942544/1712485313", request: Request())
      rewardedAd?.fullScreenContentDelegate = self
    } catch {
      print("Failed to load rewarded ad with error: \(error.localizedDescription)")
    }
  }
RewardedViewModel.swift

Objective-C 

@import GoogleMobileAds;
@import UIKit;

@interface ViewController ()

@property(nonatomic, strong) GADRewardedAd *rewardedAd;

@end

@implementation ViewController
- (void)loadRewardedAd {
  GADRequest *request = [GADRequest request];
  [GADRewardedAd
      loadWithAdUnitID:@"ca-app-pub-3940256099942544/1712485313"
                request:request
      completionHandler:^(GADRewardedAd *ad, NSError *error) {
        if (error) {
          NSLog(@"Rewarded ad failed to load with error: %@", [error localizedDescription]);
          return;
        }
        self.rewardedAd = ad;
        NSLog(@"Rewarded ad loaded.");
      }];
}

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

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

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

Быстрый 

do {
  rewardedAd = try await RewardedAd.load(
    with: "ca-app-pub-3940256099942544/1712485313", request: Request())
  let options = ServerSideVerificationOptions()
  options.customRewardText = "SAMPLE_CUSTOM_DATA_STRING"
  rewardedAd.serverSideVerificationOptions = options
} catch {
  print("Rewarded ad failed to load with error: \(error.localizedDescription)")
}

Objective-C 

[GADRewardedAd
     loadWithAdUnitID:@"ca-app-pub-3940256099942544/1712485313"
              request:[GADRequest request];
    completionHandler:^(GADRewardedAd *ad, NSError *error) {
      if (error) {
        // Handle Error
        return;
      }
      self.rewardedAd = ad;
      GADServerSideVerificationOptions *options =
          [[GADServerSideVerificationOptions alloc] init];
      options.customRewardString = @"SAMPLE_CUSTOM_DATA_STRING";
      ad.serverSideVerificationOptions = options;
    }];

Зарегистрируйтесь для обратных звонков

Чтобы получать уведомления о событиях показа, необходимо реализовать протокол GADFullScreenContentDelegate и назначить его свойству fullScreenContentDelegate возвращаемой рекламы. Протокол GADFullScreenContentDelegate обрабатывает обратные вызовы для случаев успешного или неудачного показа рекламы, а также для случаев ее закрытия. Следующий код показывает, как реализовать протокол и назначить его рекламе:

Быстрый 

import GoogleMobileAds
import UIKit

class ViewController: UIViewController, FullScreenContentDelegate {

  private var rewardedAd: RewardedAd?

  func loadRewardedAd() async {
    do {
      rewardedAd = try await RewardedAd.load(
        with: "ca-app-pub-3940256099942544/1712485313", request: Request())
      rewardedAd?.fullScreenContentDelegate = self
    } catch {
      print("Rewarded ad failed to load with error: \(error.localizedDescription)")
    }
  }

  /// Tells the delegate that the ad failed to present full screen content.
  func ad(_ ad: FullScreenPresentingAd, didFailToPresentFullScreenContentWithError error: Error) {
    print("Ad did fail to present full screen content.")
  }

  /// Tells the delegate that the ad will present full screen content.
  func adWillPresentFullScreenContent(_ ad: FullScreenPresentingAd) {
    print("Ad will present full screen content.")
  }

  /// Tells the delegate that the ad dismissed full screen content.
  func adDidDismissFullScreenContent(_ ad: FullScreenPresentingAd) {
    print("Ad did dismiss full screen content.")
  }
}

SwiftUI

Назначьте свойство fullScreenContentDelegate возвращаемому объявлению:

rewardedAd?.fullScreenContentDelegate = self
RewardedViewModel.swift

Реализуйте протокол:

func adDidRecordImpression(_ ad: FullScreenPresentingAd) {
  print("\(#function) called")
}

func adDidRecordClick(_ ad: FullScreenPresentingAd) {
  print("\(#function) called")
}

func ad(
  _ ad: FullScreenPresentingAd,
  didFailToPresentFullScreenContentWithError error: Error
) {
  print("\(#function) called")
}

func adWillPresentFullScreenContent(_ ad: FullScreenPresentingAd) {
  print("\(#function) called")
}

func adWillDismissFullScreenContent(_ ad: FullScreenPresentingAd) {
  print("\(#function) called")
}

func adDidDismissFullScreenContent(_ ad: FullScreenPresentingAd) {
  print("\(#function) called")
  // Clear the rewarded ad.
  rewardedAd = nil
}
RewardedViewModel.swift

Objective-C 

@interface ViewController () <GADFullScreenContentDelegate>

@property(nonatomic, strong) GADRewardedAd *rewardedAd;

@end

@implementation ViewController
- (void)loadRewardedAd {
  GADRequest *request = [GADRequest request];
  [GADRewardedAd
      loadWithAdUnitID:@"ca-app-pub-3940256099942544/4806952744"
                request:request
      completionHandler:^(GADRewardedAd *ad, NSError *error) {
        if (error) {
          NSLog(@"Rewarded ad failed to load with error: %@", [error localizedDescription]);
          return;
        }
        self.rewardedAd = ad;
        NSLog(@"Rewarded ad loaded.");
        self.rewardedAd.fullScreenContentDelegate = self;
      }];
}

/// Tells the delegate that the ad failed to present full screen content.
- (void)ad:(nonnull id<GADFullScreenPresentingAd>)ad
    didFailToPresentFullScreenContentWithError:(nonnull NSError *)error {
    NSLog(@"Ad did fail to present full screen content.");
}

/// Tells the delegate that the ad will present full screen content.
- (void)adWillPresentFullScreenContent:(nonnull id<GADFullScreenPresentingAd>)ad {
    NSLog(@"Ad will present full screen content.");
}

/// Tells the delegate that the ad dismissed full screen content.
- (void)adDidDismissFullScreenContent:(nonnull id<GADFullScreenPresentingAd>)ad {
    NSLog(@"Ad did dismiss full screen content.");
}

GADRewardedAd — это одноразовый объект. Это означает, что после показа вознагражденной рекламы ее нельзя будет показать снова. Лучше всего загрузить другую вознагражденную рекламу в методе adDidDismissFullScreenContent: на GADFullScreenContentDelegate , чтобы следующая вознагражденная реклама начала загружаться сразу после закрытия предыдущей.

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

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

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

Следующий код представляет собой наилучший метод отображения вознагражденной рекламы.

Быстрый 

func show() {
  guard let rewardedAd = rewardedAd else {
    return print("Ad wasn't ready.")
  }

  // The UIViewController parameter is an optional.
  ad.present(from: nil) {
    let reward = ad.adReward
    print("Reward received with currency \(reward.amount), amount \(reward.amount.doubleValue)")
    // TODO: Reward the user.
  }
}

SwiftUI

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

var body: some View {
  VStack(spacing: 20) {
      Button("Watch video for additional 10 coins") {
        viewModel.showAd()
        showWatchVideoButton = false
      }
RewardedContentView.swift

Представьте вознаграждение за рекламу из модели представления: 

func showAd() {
  guard let rewardedAd = rewardedAd else {
    return print("Ad wasn't ready.")
  }

  rewardedAd.present(from: nil) {
    let reward = rewardedAd.adReward
    print("Reward amount: \(reward.amount)")
    self.addCoins(reward.amount.intValue)
  }
}
RewardedViewModel.swift

Objective-C 

- (void)show {
  if (self.rewardedAd) {
    // The UIViewController parameter is nullable.
    [self.rewardedAd presentFromRootViewController:nil
                                  userDidEarnRewardHandler:^{
                                  GADAdReward *reward =
                                      self.rewardedAd.adReward;
                                  // TODO: Reward the user!
                                }];
  } else {
    NSLog(@"Ad wasn't ready");
  }
}

Часто задаваемые вопросы

Могу ли я получить подробную информацию о вознаграждении за GADRewardedAd ?
Да, если вам нужна сумма вознаграждения до срабатывания обратного вызова userDidEarnReward , у GADRewardedAd есть свойство adReward , которое вы можете проверить, чтобы проверить сумму вознаграждения после загрузки объявления.
Есть ли тайм-аут для вызова инициализации?
Через 10 секунд Google Mobile Ads SDK вызывает GADInitializationCompletionHandler , предоставленный методу startWithCompletionHandler: даже если сеть-посредник все еще не завершила инициализацию.
Что делать, если некоторые сети-посредники не готовы, когда я получаю обратный вызов инициализации?

Мы рекомендуем загружать рекламу внутри GADInitializationCompletionHandler . Даже если сеть посредничества не готова, Google Mobile Ads SDK все равно запрашивает у этой сети рекламу. Поэтому, если сеть посредничества завершает инициализацию после тайм-аута, она все равно может обслуживать будущие запросы рекламы в этом сеансе.

Вы можете продолжить опрашивать состояние инициализации всех адаптеров в течение всего сеанса приложения, вызвав GADMobileAds.initializationStatus .

Как узнать, почему конкретная посредническая сеть не готова?

Свойство description объекта GADAdapterStatus описывает, почему адаптер не готов обслуживать запросы рекламы.

Всегда ли обработчик завершения userDidEarnRewardHandler вызывается перед методом делегирования adDidDismissFullScreenContent: :?

Для объявлений Google все вызовы userDidEarnRewardHandler происходят до adDidDismissFullScreenContent: . Для объявлений, обслуживаемых через посредничество , реализация SDK сторонних рекламных сетей определяет порядок обратного вызова. Для SDK рекламных сетей, которые предоставляют один метод делегата с информацией о вознаграждении, адаптер посредничества вызывает userDidEarnRewardHandler до adDidDismissFullScreenContent: .

Примеры на GitHub

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

Следующие шаги

Узнайте больше о конфиденциальности пользователей .