Это руководство предназначено для издателей, которые интегрируют метаданные объявлений с Google Mobile Ads SDK для Android.
Требования
- Минимальная версия Google Mobile Ads SDK – 17.0.0.
- Выполните инструкции из раздела Видео с вознаграждением.
Получение метаданных объявлений
Чтобы узнать больше о показанных объявлениях, отслеживайте изменения метаданных объявлений в видео с вознаграждением.
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"); } }); } });
Kotlin
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") } } })
После получения метаданных вы можете проверить Bundle на наличие нужных ключей. Разные типы объявлений могут быть связаны с разными ключами метаданных. Видеообъявления VAST содержат следующие ключи:
Key |
Тип | Описание |
|---|---|---|
AdId |
Строка | Идентификатор объявления. Если он недоступен, поле будет пустым. |
AdTitle |
Строка | Название (если не указано, будет пустым). |
CreativeDurationMs |
Целое число | Длительность выбранного креатива в миллисекундах. Если креатив нелинейный, то значение будет равно -1. |
TraffickingParameters |
Строка | Параметры размещения объявлений. Если они недоступны, поле будет пустым. |
DealId |
Строка | Первый идентификатор сделки, найденный в цепочке обертки для текущего объявления, начиная с верхнего уровня. Если идентификатор недоступен, возвращается пустое значение. |
AdSystem |
Строка | Исходный сервер объявлений, на котором размещено объявление. Если данные недоступны, поле будет пустым. |
CreativeId |
Строка | Идентификатор выбранного креатива для объявления. Если он недоступен, поле будет пустым. |
MediaURL |
Строка | URL выбранного медиафайла. |
Wrappers |
Массив |
Массив заполняется элементами, начиная с самого внутреннего объявления-контейнера (ближайшего к встроенному объявлению) и заканчивая самым внешним объявлением-контейнером. Каждый элемент массива представляет собой словарь, содержащий следующие ключи и значения.
|