Метаданные объявления

Это руководство предназначено для издателей, интегрирующих метаданные объявлений с Google Mobile Ads iOS SDK.

Предварительные условия

Получение метаданных объявления

Чтобы приложение знало больше о показываемой рекламе, установите для объявления собственное значение GADAdMetadataDelegate . Затем вы можете отслеживать изменения метаданных объявления, реализовав метод adMetadataDidChange: в GADAdMetadataDelegate . После вызова этого делегата проверьте свойство adMetadata объявления.

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

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

@interface ViewController () <GADFullScreenContentDelegate, GADAdMetadataDelegate>

@end

@implementation ViewController
- (void)loadRewardedAd {
   *request = [ 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;
        self.rewardedAd.fullScreenContentDelegate = self;

        /// Set the ad to be the delegate of its ad metadata.
        self.rewardedAd.adMetadataDelegate = self;

        NSLog(@"Rewarded ad loaded.");
      }];
}

/#pragma mark GADAdMetadataDelegate implementation

- (void)adMetadataDidChange:(id<GADAdMetadataProvider>)ad {
  NSDictionary<NSString*, id> *adMetadata = _rewardedAd.adMetadata;
  NSString *adId = adMetadata[@"AdId"];
}

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

Ключ Тип Описание
AdId Нить Идентификатор объявления или пустая строка, если она недоступна.
AdTitle Нить Заголовок, пустой, если не указан.
CreativeDurationMs Целое число Продолжительность выбранного объявления в миллисекундах, -1 , если оно нелинейное.
TraffickingParameters Нить Параметры трафика или пустая строка, если она недоступна.
DealId Нить Идентификатор первой сделки, присутствующий в цепочке-оболочке текущего объявления, начиная сверху, или пустая строка, если эта информация недоступна.
AdSystem Нить Исходный рекламный сервер объявления. Если он недоступен, пусто.
CreativeId Нить Идентификатор выбранного креатива для объявления. Если он недоступен, пусто.
MediaURL Нить URL-адрес выбранного носителя.
Wrappers Множество Массив заполняется элементами, начиная с самого внутреннего объявления-обертки (рядом со встроенным объявлением) и перемещаясь к самому внешнему объявлению-оболочке. Каждый элемент массива представляет собой словарь, содержащий следующие ключи и значения.
AdId
Нить . Идентификатор объявления, используемый для объявления-контейнера. Если он недоступен, пусто.
AdSystem
Нить . Рекламная система, используемая для объявления-обертки. Если недоступна, пустая.
CreativeId
Нить . Идентификатор объявления, используемый для объявления-контейнера. Если он недоступен, пусто.