プレースメントで広告データをセグメント化する

プラットフォームを選択: Android（ベータ版） New-selected Android iOS

広告のパフォーマンス レポートのデータをセグメント化するには、広告プレースメント機能を使用します。プレースメントを使うと、追加の広告ユニットを使用せずに、レポートのインプレッション データをセグメント化できます。プレースメント機能を使用するには、プレースメント ID が必要です。プレースメントについて詳しくは、プレースメントとはをご覧ください。

このガイドでは、GMA Next-Gen SDK でプレースメント ID を設定し、広告のパフォーマンス レポートを表示する方法について説明します。

前提条件

続行する前に、次のことを実施してください。

  • GMA Next-Gen SDK の設定を完了します。
  • GMA Next-Gen SDK バージョン 以降を実装します。
  • プレースメント ID 機能へのアクセス権を取得します。アクセス権をリクエストするには、アカウント マネージャーにお問い合わせください。
  • アプリのプレースメント ID を作成します。

プレースメント ID を設定する

広告のパフォーマンス データをセグメント化するには、次のいずれかのタイミングでプレースメント ID を設定します。

  • 広告を読み込むとき。
  • 広告を表示する前。

プレースメント ID は必要に応じて更新できます。GMA Next-Gen SDK が広告インプレッションを記録する際は、最新のプレースメント ID が使用されます。

読み込み時にプレースメント ID を設定する

このセクションでは、読み込み時にプレースメント ID を設定する方法について説明します。このワークフローは、すべての広告フォーマットに適用されます。

次の例では、読み込み時にインタースティシャル広告のプレースメント ID を設定しています。

Kotlin

private fun loadInterstitial() {
  val adRequest = AdRequest.Builder("AD_UNIT_ID").setPlacementId(PLACEMENT_ID).build()
  InterstitialAd.load(
    adRequest,
    object : AdLoadCallback<InterstitialAd> {
      override fun onAdLoaded(ad: InterstitialAd) {
        Log.d(TAG, "Placement ID: " + ad.placementId)
      }
    },
  )
}

AdPlacementsSnippets.kt

Java

private void loadInterstitial() {
  AdRequest adRequest = new AdRequest.Builder("AD_UNIT_ID").setPlacementId(PLACEMENT_ID).build();
  InterstitialAd.load(
      adRequest,
      new AdLoadCallback<>() {
        @Override
        public void onAdLoaded(InterstitialAd ad) {
          Log.d(TAG, "Placement ID: " + ad.getPlacementId());
        }
      });
}

AdPlacementsSnippets.java

次の値を置き換えます。

  • AD_UNIT_ID は、実際の広告ユニット ID に置き換えます。
  • PLACEMENT_ID を実際のプレースメント ID に置換。

表示時にプレースメント ID を設定する

このセクションでは、すべての広告フォーマットについて、表示時にプレースメント ID を設定する方法について説明します。次のセクションから、ご希望の広告フォーマットを選択します。

バナー広告の場合、広告ビューをビュー階層に配置する前にプレースメント ID を設定します。次の例では、表示時にバナー広告のプレースメント ID を設定しています。

Kotlin

private fun showBannerView(ad: BannerAd, parentView: ViewGroup, activity: Activity) {
  ad.placementId = PLACEMENT_ID
  parentView.addView(ad.getView(activity))
}

AdPlacementsSnippets.kt

Java

private void showBannerView(BannerAd ad, ViewGroup parentView, Activity activity) {
  ad.setPlacementId(PLACEMENT_ID);
  parentView.addView(ad.getView(activity));
}

AdPlacementsSnippets.java

フルスクリーン広告

フルスクリーン広告フォーマットの場合、広告を表示する前にプレースメント ID を設定します。このワークフローは、次のフォーマットに適用されます。

次の例では、表示時にインタースティシャル広告のプレースメント ID を設定しています。

Kotlin

private fun showAd(activity: Activity, ad: InterstitialAd) {
  ad.placementId = PLACEMENT_ID
  ad.show(activity)
}

AdPlacementsSnippets.kt

Java

private void showAd(Activity activity, InterstitialAd ad) {
  ad.setPlacementId(PLACEMENT_ID);
  ad.show(activity);
}

AdPlacementsSnippets.java

ネイティブ広告

ネイティブ広告の場合、ネイティブ広告を読み込んだ後、かつ広告を広告ビューに登録する前に、プレースメント ID を設定します。

次の例では、表示時にネイティブ広告のプレースメント ID を設定しています。

Kotlin

private fun showNativeAd(nativeAdView: NativeAdView, nativeAd: NativeAd, mediaView: MediaView) {
  nativeAd.placementId = PLACEMENT_ID
  nativeAdView.registerNativeAd(nativeAd, mediaView)
}

AdPlacementsSnippets.kt

Java

private void showNativeAd(NativeAdView nativeAdView, NativeAd nativeAd, MediaView mediaView) {
  nativeAd.setPlacementId(PLACEMENT_ID);
  nativeAdView.registerNativeAd(nativeAd, mediaView);
}

AdPlacementsSnippets.java

プレースメント レポートを表示する

プレースメント ID を設定すると、AdMob の管理画面にプレースメント ID ディメンションのレポートが表示されます。レポートを確認するには、プレースメントを確認するの手順に沿って操作します。