廣告中繼資料

選取平台： 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，如果沒有則為空白。

注意： 只有 VAST 封裝廣告的廣告中繼資料會包含 Wrappers 鍵。VAST 內嵌廣告不含 Wrappers 中繼資料。