廣告中繼資料

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

必要條件

擷取廣告中繼資料

部分應用程式可能會想進一步瞭解已放送的廣告。您可以呼叫 RewardedVideoAd.setAdMetadataListener() 並導入 AdMetadataListener，藉此監聽獎勵影片廣告的廣告中繼資料變更。呼叫 AdMetadataListener.onAdMetadataChanged() 後，您可以檢查 RewardedVideo.getAdMetadata() 中的廣告中繼資料。

廣告載入後，或在載入後非同步變更中繼資料時，系統就會呼叫 onAdMetadataChanged()。我們無法保證廣告載入時即會提供廣告的中繼資料，因此建議您在存取廣告的中繼資料之前，先等候這個回呼。

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

Java

RewardedAd.load(this, "/6499/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, "/6499/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")
        }
      }
    })

擷取中繼資料後，您可以針對關注的鍵檢查套裝組合。不同類型的廣告可能有不同的廣告中繼資料鍵。VAST 影片廣告包含下列鍵：

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