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