廣告中繼資料

本指南適用於透過 Android 適用的 Google Mobile Ads SDK 整合廣告中繼資料的發布商。

必要條件

  • Google Mobile Ads SDK 最低版本為 17.0.0。
  • 完成「插頁式影片」一文中的步驟。

正在擷取廣告中繼資料

如要進一步瞭解放送的廣告，請監聽獎勵影片廣告的廣告中繼資料變更。

廣告載入後或載入後中繼資料非同步變更時，系統會呼叫 onAdMetadataChanged()。無法保證廣告載入時，廣告的中繼資料會一併提供，因此建議您等待這個回呼，再存取廣告的中繼資料。

以下程式碼範例說明如何擷取廣告中繼資料：

Kotlin

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")
      }
    }
  }
})

Java

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獎勵廣告。

擷取中繼資料後，您可以檢查 Bundle 中您感興趣的鍵。不同類型的廣告可能會有不同的相關廣告中繼資料鍵。VAST 影片廣告具有下列鍵：

Key 類型 說明
AdId 字串 廣告的 ID，如果沒有則為空白。
AdTitle 字串 標題 (如未指定，則為空白)。
CreativeDurationMs 整數 所選廣告素材的時間長度 (以毫秒為單位)，如果是非線性廣告素材，則為 -1。
TraffickingParameters 字串 放送參數，如果沒有則為空白。
DealId 字串 目前廣告包裝函式鏈中的第一個交易 ID，從頂端開始，如果沒有則為空白。
AdSystem 字串 廣告的來源廣告伺服器，如果無法使用則為空白。
CreativeId 字串 所選廣告素材的廣告 ID，如果沒有則為空白。
MediaURL 字串 所選媒體的網址。
Wrappers 陣列 這個陣列會填入元素，從最內層的 Wrapper 廣告 (靠近內嵌廣告) 開始，向外移動到最外層的 Wrapper 廣告。陣列中的每個元素都是字典，包含下列鍵和值。
AdId
「字串」。用於包裝廣告的廣告 ID，如果沒有則為空白。
AdSystem
「字串」。用於包裝廣告的廣告系統，如果沒有則為空白。
CreativeId
「字串」。包裝函式廣告使用的廣告素材 ID，如果沒有則為空白。