廣告中繼資料

選取平台： Android iOS

如果發布商有意採用 Android 適用的 Google Mobile Ads SDK 整合廣告中繼資料，歡迎參閱本指南。

必要條件

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