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

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

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

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

前提条件

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

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

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

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

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

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

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

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

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

Swift

private func loadInterstitial() async {
  do {
    let interstitial = try await InterstitialAd.load(
      with: "adUnitID", request: Request())
    interstitial.placementID = adPlacementID
    print("Placement ID set to: \(interstitial.placementID)")
  } catch {
    print("Failed to load interstitial ad with error: \(error.localizedDescription)")
  }
}
AdPlacementsSnippets.swift

Objective-C

- (void)loadInterstitial {
  GADRequest *request = [GADRequest request];
  request.placementID = adPlacementID;
  [GADInterstitialAd loadWithAdUnitID:"adUnitID"
                              request:request
                    completionHandler:^(GADInterstitialAd *ad, NSError *error) {
                      if (!error) {
                        NSLog(@"Placement ID: %lld", ad.placementID);
                        return;
                      }
                    }];
}
AdPlacementsSnippets.m

次の値を置き換えます。

  • adUnitID を実際の広告ユニット ID に置換。
  • adPlacementID を実際のプレースメント ID に置換。

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

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

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

Swift

private func showBanner(_ bannerView: BannerView) {
  bannerView.placementID = adPlacementID
  view.addSubview(bannerView)
}
AdPlacementsSnippets.swift

Objective-C

- (void)showBannerView:(GADBannerView *)bannerView {
  bannerView.placementID = adPlacementID;
  [self.view addSubview:bannerView];
}
AdPlacementsSnippets.m

フルスクリーン広告

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

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

Swift

private func showInterstitial(_ ad: InterstitialAd) {
  ad.placementID = adPlacementID
  ad.present(from: self)
}
AdPlacementsSnippets.swift

Objective-C

- (void)showAd:(GADInterstitialAd *)ad {
  ad.placementID = adPlacementID;
  [ad presentFromRootViewController:self];
}
AdPlacementsSnippets.m

ネイティブ広告

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

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

Swift

private func configureView(_ nativeAdView: NativeAdView, withAd nativeAd: NativeAd) {
  nativeAd.placementID = adPlacementID
  nativeAdView.nativeAd = nativeAd
}
AdPlacementsSnippets.swift

Objective-C

- (void)configureView:(GADNativeAdView *)nativeAdView withNativeAd:(GADNativeAd *)nativeAd {
  nativeAd.placementID = adPlacementID;
  nativeAdView.nativeAd = nativeAd;
}
AdPlacementsSnippets.m

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

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