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

Выберите платформу: Android (бета-версия)Новый Android iOS

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

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

Получение метаданных рекламы

Чтобы приложение могло получать больше информации о показываемой рекламе, назначьте для объявления собственный 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
Строка . Идентификатор креатива, используемый для рекламного объявления-обертки; пустое значение, если недоступен.