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

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

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