広告メタデータ

[プラットフォームを選択]: Android（ベータ版） 新規 Android iOS

このガイドは、Google Mobile Ads SDK for Android で広告メタデータを統合するパブリッシャー様を対象としています。

前提条件

広告メタデータを取得する

配信された広告について詳しくは、リワード動画広告の広告メタデータの変更をリッスンしてください。

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 文字列 選択したメディアの URL。
Wrappers 配列 配列には、最も内側のラッパー広告 （インライン広告に近い）から外側のラッパー広告に向かって要素が入力されます。配列内の各 要素は、次のキーと 値を含むディクショナリです。
AdId
文字列。ラッパー広告に使用される広告 ID。利用できない場合は空になります。
AdSystem
文字列。ラッパー広告に使用される広告システム。利用できない場合は空になります。
CreativeId
文字列。ラッパー広告に使用されるクリエイティブ ID。利用できない場合は空になります。