本指南适用于将广告元数据与 Google Android 版移动广告 SDK
前提条件
- Google 移动广告 SDK 的最低版本为 17.0.0。
- 完成 激励视频广告。
提取广告元数据
某些应用可能想要详细了解投放的广告。您可以
通过调用
RewardedVideoAd.setAdMetadataListener()
,其中包含以下实现:
AdMetadataListener
。调用 AdMetadataListener.onAdMetadataChanged()
后,
您可以在 RewardedVideo.getAdMetadata()
中检查广告的元数据。
系统会在广告加载后立即调用 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 |
字符串 | 广告的 ID,如果没有,则为空。 |
AdTitle |
字符串 | 标题,如果未指定,则为空。 |
CreativeDurationMs |
整数 | 所选广告素材的持续时间(以毫秒为单位),如果是非线性广告素材,则为 -1。 |
TraffickingParameters |
字符串 | 广告投放管理参数,如果不可用,则为空。 |
DealId |
字符串 | 当前广告的封装容器链中出现的第一个交易 ID, 从顶部开始 - 如果不可用,则为空。 |
AdSystem |
字符串 | 广告的来源广告服务器,如果不可用,则为空。 |
CreativeId |
字符串 | 为广告选择的广告素材的 ID,如果不可用,则为空。 |
MediaURL |
字符串 | 所选媒体的网址。 |
Wrappers |
数组 |
该数组填充的元素是从最内层的封装容器广告开始的
(靠近内嵌广告)移至最外层的封装容器广告。每个
元素是一个字典,其中包含以下键和
值。
|