廣告中繼資料

選取平台： Android iOS Android (舊版)

本指南適用於透過 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 陣列 這個陣列會填入元素，從最內層的包裝函式廣告 (靠近內嵌廣告) 開始，向外移動至最外層的包裝函式廣告。陣列中的每個元素都是字典，包含下列鍵和值。
AdId
「字串」。用於包裝廣告的廣告 ID，如果沒有則為空白。
AdSystem
「字串」。用於包裝廣告的廣告系統，如果沒有則為空白。
CreativeId
「字串」。用於包裝廣告的廣告素材 ID，如果沒有則為空白。