廣告中繼資料

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

必要條件

  • Google Mobile Ads SDK 17.0.0 以上版本。
  • 完成獎勵式影片中的步驟。

正在擷取廣告中繼資料

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

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

擷取中繼資料後，您可以查看套件中的關鍵字，不同類型的廣告可能會與不同的廣告中繼資料鍵相關聯。VAST 影片廣告包含下列鍵：

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