Данное руководство предназначено для издателей, интегрирующих метаданные рекламы с SDK Google Mobile Ads для Android.
Предварительные требования
- Минимальная версия 17.0.0 Google Mobile Ads SDK.
- Выполните все шаги, описанные в разделе «Видео, за которое начисляются награды» .
Получение метаданных рекламы
Чтобы узнать больше о показываемой рекламе, следите за изменениями метаданных в видеорекламе с вознаграждением.
onAdMetadataChanged() вызывается сразу после загрузки объявления или при асинхронном изменении его метаданных после загрузки. Нет гарантии, что метаданные объявления будут доступны в момент его загрузки, поэтому мы рекомендуем дождаться этого вызова, прежде чем обращаться к метаданным объявления.
Вот пример кода, демонстрирующий, как получить метаданные объявления:
Java
RewardedAd.load(this, "/21775744923/example/rewarded", new AdManagerAdRequest.Builder().build(), new RewardedAdLoadCallback() { @Override public void onAdLoaded(@NonNull RewardedAd rewardedAd) { mRewardedAd = rewardedAd; rewardedAd.setOnAdMetadataChangedListener(new OnAdMetadataChangedListener() { @Override public void onAdMetadataChanged() { Bundle metadata = rewardedAd.getAdMetadata(); String adId = metadata.getString("AdId"); } }); } });
Котлин
RewardedAd.load(this, "/21775744923/example/rewarded", AdManagerAdRequest.Builder().build(), object : RewardedAdLoadCallback() { override fun onAdLoaded(rewardedAd: RewardedAd) { mRewardedAd = rewardedAd rewardedAd.onAdMetadataChangedListener = OnAdMetadataChangedListener { val metadata = rewardedAd.adMetadata val adId = metadata.getString("AdId") } } })
После получения метаданных вы можете проверить пакет на наличие интересующих вас ключей. Разные типы рекламы могут иметь разные ключи метаданных. Видеореклама VAST имеет следующие ключи:
Key | Тип | Описание |
|---|---|---|
AdId | Нить | Идентификатор объявления (если недоступен, поле пустое). |
AdTitle | Нить | Заголовок (необходимо указать название, если не указано иное). |
CreativeDurationMs | Целое число | Выбранная длительность творческого процесса в миллисекундах, -1, если длительность нелинейная. |
TraffickingParameters | Нить | Параметры трафика (пустое поле, если параметры недоступны). |
DealId | Нить | Первый идентификатор сделки, присутствующий в цепочке оболочек для текущей рекламы, начиная сверху — пустое значение, если он недоступен. |
AdSystem | Нить | Исходный рекламный сервер, с которого размещено объявление; если поле пустое, значит он недоступен. |
CreativeId | Нить | Идентификатор выбранного креатива для объявления; если он недоступен, поле пустое. |
MediaURL | Нить | URL выбранного медиафайла. |
Wrappers | Множество | Массив заполняется элементами, начиная с самого внутреннего рекламного блока (расположенного ближе к встроенному рекламному блоку) и двигаясь к самому внешнему рекламному блоку. Каждый элемент массива представляет собой словарь, содержащий следующие ключи и значения.
|