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

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

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

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

前提条件

先に進む前に、以下を行ってください。

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

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

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

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

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

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

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

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

Kotlin 

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

AdPlacementsSnippets.kt

Java 

public void loadInterstitial(Context context) {
  AdRequest adRequest = new AdRequest.Builder().setPlacementId(PLACEMENT_ID).build();
  InterstitialAd.load(
      context,
      "AD_UNIT_ID",
      adRequest,
      new InterstitialAdLoadCallback() {
        @Override
        public void onAdLoaded(@NonNull 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(adView: AdView, parentView: ViewGroup) {
  adView.placementId = PLACEMENT_ID
  parentView.addView(adView)
}

AdPlacementsSnippets.kt

Java 

public void showBannerView(AdView adView, ViewGroup parentView) {
  adView.setPlacementId(PLACEMENT_ID);
  parentView.addView(adView);
}

AdPlacementsSnippets.java

フルスクリーン広告

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

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

Kotlin 

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

AdPlacementsSnippets.kt

Java 

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

AdPlacementsSnippets.java

ネイティブ広告

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

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

Kotlin 

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

AdPlacementsSnippets.kt

Java 

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

AdPlacementsSnippets.java

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

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