Данное руководство предназначено для издателей, интегрирующих метаданные рекламы с SDK Google Mobile Ads для iOS.
Предварительные требования
- Минимальная версия Google Mobile Ads SDK — 7.41.0.
- Выполните действия, описанные в одном из приведенных ниже руководств:
Получение метаданных рекламы
Чтобы приложение могло получать больше информации о показываемой рекламе, назначьте для объявления собственный 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 | Множество | Массив заполняется элементами, начиная с самого внутреннего рекламного блока (расположенного ближе к встроенному рекламному блоку) и двигаясь к самому внешнему рекламному блоку. Каждый элемент массива представляет собой словарь, содержащий следующие ключи и значения.
|