ドキュメントExperience Platformソースコネクタガイド

Google Ads （V2）

最終更新日： 2026年10月23日

作成対象：

  • 開発者
IMPORTANT
Google Ads ソースは、Customer Journey Analytics SKUの一部として利用できます。

Google Ads （V2）は、Google Ads APIからExperience Platformに広告アカウント、キャンペーン、広告グループ、広告、アセット、エクスペリエンス、およびパフォーマンスデータを取り込むAdobe Experience Platform有料メディアソースコネクタです。

コネクターはGoogle Ads データを標準化された有料メディアエクスペリエンスデータモデル （XDM）構造にマッピングし、他の広告ネットワーク、web プロパティ、コマースシステム、顧客アプリケーションからのデータと並行してGoogle Ads データを分析できるようにします。

Google Ads （V2）は、レポート データと広告メタデータを取得するために読み取り専用アクセスを使用します。 Google Ads リソースを作成、変更、削除しません。

ユースケースの例

ユースケース
目標
Google Ads （V2）がどのように役立つか
クロスチャネル広告分析
Google AdsのパフォーマンスをMeta Adsとその他の有料メディアチャネルと比較します。
各エンティティレベルで標準化されたIDを使用して、Google Ads データを一般的な有料メディア XDM構造に取り込みます。
メディアミックスモデリングとアトリビューション
メディアがビジネス成果に与える影響を評価する。
インプレッション数やクリック数、支出、コンバージョン、コンバージョン率など、施策や広告のパフォーマンスデータを提供し、下流工程の分析に活用します。
キャンペーンと予算の最適化
どのキャンペーン、入札戦略、ターゲティング設定が最適な結果をもたらすのかを把握できます。
キャンペーンのメタデータ、予算、入札戦略、チャネルタイプ、ステータス、日付、選択したターゲティング条件を取得します。
Creativeとアセットのパフォーマンス
最もパフォーマンスが高いクリエイティブアセット、広告フォーマット、エクスペリエンスを特定します。
アセットの関連付け、タイプ、パフォーマンスラベルなど、広告レベルのクリエイティブメタデータを取得します。
パフォーマンス最大分析
パフォーマンスの最大アセットグループと関連アセットを分析します。
パフォーマンスの最大アセットグループ データを使用して、Google Adsが従来の広告レベルの構造を公開しないアセットグループのパフォーマンスとエクスペリエンスの関係を表します。
カスタマージャーニー分析
web、コマース、CRMなどの顧客イベントに広告エンゲージメントを関連付ける。
Experience PlatformでGoogle Ads データをダウンストリームの分析およびアクティベーションワークフローで使用できるようにします。

前提条件

Google Ads （V2）をExperience Platformに接続する前に、次の条件を満たしていることを確認してください。

Experience Platformの権限の設定

Experience Platform アカウントで​ ソースの表示 ​と​ ソースの管理 ​の両方の権限を有効にする必要があります。

必要な権限がない場合は、製品管理者にお問い合わせください。 詳しくは、​ アクセス制御UI ガイド ​を参照してください。

Experience Platformは、Google Ads （V2）のOAuth 2.0認証フローを管理します。 Google Cloud プロジェクト、OAuth クライアント、更新トークンは作成しません。

次が必要です。

  • 有効なGoogle Ads開発者トークンです。
  • 取り込むGoogle Ads広告主アカウントへのアクセス。
  • Google AdsまたはGoogle Ads マネージャーアカウントを介して関連する広告主アカウントにアクセスする権限。

マネージャーとアカウントのアクセス

広告主アカウントがGoogle Ads マネージャーアカウントを通じてアクセスされる場合は、適切なマネージャー顧客IDもloginCustomerIdとして提供します。

OAuth承認済みユーザーがターゲット広告主アカウントに直接アクセスでき、マネージャー階層が必要ない場合、loginCustomerIdは必要ありません。

Google Ads （V2）は、アクセス可能なアカウントを列挙し、マネージャーアカウントを特定し、マネージャーとアカウントの階層を移動し、取り込みに使用できる広告主アカウントを解決します。

必要な資格情報の収集

Google Ads （V2）をExperience Platformに接続するには、次の値を指定します。

資格情報
説明
developerToken
API リクエストの承認に使用されるGoogle Ads開発者トークン。
loginCustomerId
広告主アカウントへのアクセスに使用されるマネージャーアカウントの顧客IDの数値。 この資格情報は、マネージャーアカウントのアクセスに必要です。

認証とアカウントの発見

Google Ads （V2）は、OAuth 2.0を使用してGoogle Ads APIへのアクセスを承認します。 Experience Platformは認証フローを管理するので、Google Ads側でOAuth スコープまたは権限を設定しないでください。

アカウントを認証すると、Experience Platformは開発者トークンを使用してGoogle Ads個のレポートリソースにアクセスします。 マネージャーとアカウントの設定の場合、コネクタはアカウント階層を解決し、取り込みに使用できる広告主アカウントを識別します。

アカウント検出ワークフローには、次の操作が含まれます。

  1. 承認済みユーザーがアクセスできるアカウントを列挙します。
  2. アクセス可能なアカウントがマネージャーアカウントであるかどうかを判断します。
  3. マネージャー/アカウント階層をトラバースします。
  4. マネージャー以外の広告主アカウントの特定：
  5. マネージャーとアカウントの階層を通じてリクエストがルーティングされる場合は、適切なloginCustomerIdを使用します。
  6. アカウント ID、アカウント名、通貨、タイムゾーンなどのアカウントメタデータを取得します。

Google Ads （V2）は読み取り専用のAPI操作を実行します。 Google Ads リソースに対して変更、作成、更新、削除の要求を発行しません。

データの選択と取り込み

Google Ads （V2）は、Google Ads クエリ言語（GAQL）を使用して、アカウント メタデータ、キャンペーン メタデータ、レポート データを取得します。

コネクターは、リソース固有のクエリを使用して、各エンティティに必要な属性、セグメント、指標を取得します。 コネクタは、増分行処理が有益なレポートリソースと大規模な結果セットにSearchStreamを使用します。

サポートされるクエリインベントリには、次のようなリソースが含まれます。

  • customer
  • customer_client
  • campaign
  • campaign_budget
  • campaign_criterion
  • geo_target_constant
  • ad_group
  • ad_group_criterion
  • ad_group_ad
  • ad_group_ad_asset_view
  • ad_group_ad_asset_combination_view
  • asset
  • asset_group
  • asset_group_asset
  • change_status

パフォーマンス指標は、segments.dateなどの日付ベースのセグメントを使用して取得されます。

スキーマ設定

Google Ads （V2）は、ソースデータを標準化された有料メディア XDM構造にマッピングします。 コネクターは、エンティティレベルごとにデータを整理し、アカウント、キャンペーン、広告グループ、広告、アセット、エクスペリエンスレコードをまたいでメタデータとパフォーマンス指標を結合できるようにします。

エンティティ
プライマリ Google Adsのリソース
表示されるデータ
アカウント
customer, customer_client
アカウント ID、アカウント名、通貨、タイムゾーン、マネージャーステータス、アカウントメタデータ。
キャンペーン
campaign, campaign_budget, campaign_criterion
キャンペーン名、ステータス、広告チャネル、サブタイプ、目的、予算、入札戦略、日付、URL トラッキング、ターゲティング設定。
広告グループ
ad_group, ad_group_criterion
広告グループ ID、名前、ステータス、入札、ターゲティング、キーワード、プレースメント、キャンペーンの関係性。
広告
ad_group_ad
広告ID、広告タイプ、クリエイティブコンテンツ、宛先URL、配信ステータス、ポリシーおよびレビュー情報、キャンペーン/広告グループの関係。
アセット
asset, ad_group_ad_asset_view, asset_group_asset
アセット ID、アセットタイプ、テキスト、画像や動画のメタデータ、ディメンション、利用状況、パフォーマンスラベル、関連する広告やキャンペーン。
エクスペリエンス
ad_group_ad_asset_combination_view, asset_group, asset_group_asset
派生クリエイティブ構成、配信されたアセット、見出し、説明、CTA、ランディングページ URL、エクスペリエンス関係。
概要指標
リソース固有のmetrics.* フィールドとsegments.date
日付レベルのインプレッション数、クリック数、支出、コンバージョン数、コンバージョン数、CTR、CPC、CPM、動画指標、その他サポートされているパフォーマンス指標。

識別子の規則

V2 マッピングは、有料メディアエンティティに対するプラットフォーム修飾識別子を定義します。 次に例を示します。

  • コネクタは、Google Adsの顧客IDからアカウント IDを取得します。
  • キャンペーン IDは、Google Adsの顧客IDとキャンペーン IDを組み合わせたものです。
  • 広告グループと広告の識別子には、親階層が含まれます。
  • アセット IDは、Google Adsの顧客IDとアセット IDを組み合わせたものです。
  • コネクターは、クリエイティブの組み合わせまたはアセットグループのコンテキストからエクスペリエンス IDを導き出します。
  • 階層パスは、アカウント、キャンペーン、広告グループ、広告、エクスペリエンス、アセットエンティティ間の関係を表します。

Performance Max データ

Performance Max キャンペーンは、従来のキャンペーンタイプと同じエンティティ関係を常に公開するとは限りません。

Performance Max データの場合：

  • asset_groupは、アセットのプライマリグループを表します。
  • asset_group_assetは、アセット間の関係を表します。
  • アセットグループ指標は、アセットのパフォーマンスを分析するために必要なコンテキストを提供します。
  • ネイティブのエクスペリエンスエンティティが利用できない場合、アセットグループはエクスペリエンスプロキシとして機能します。

データの制限事項と考慮事項

Google Ads （V2）実装を計画する際には、次の制限を考慮してください。

リソース固有の指標のサポート

Google Adsは、各リソースのすべての指標を公開しません。 例えば、一部のリソースは指標やセグメントをサポートしていませんが、一部のリソースは一部の指標のみをサポートしています。

指標の利用可能性は、広告、アセット、エクスペリエンス、キャンペーン、パフォーマンス最大のクエリでも異なります。

派生エクスペリエンスレコード

Google Adsは、有料メディア XDM スキーマで使用されるエクスペリエンスモデルと同等の単一のユニバーサルエクスペリエンスエンティティを提供しません。

コネクターは、利用可能な広告、アセットの組み合わせ、アセットグループのデータからエクスペリエンスレコードを導き出します。

ビデオメタデータ

Google Ads APIは、ビデオ IDと関連アセット参照を提供します。 ただし、ビデオのデュレーション、コーデック、ビットレート、フレームレート、オーディオプレゼンスなどの一部のメディアプロパティは、Google Ads APIを通じて直接使用できません。

承認されたエンリッチメントサービスが追加されない限り、これらのフィールドはnullです。

アセットの可用性

アセットのメタデータとパフォーマンスのサポートは、アセットの種類によって異なります。 例えば、画像やテキストのメタデータは直接利用できますが、動画のプロパティによっては、さらにエンリッチメントが必要になることもあります。

Google固有のフィールド

直接有料メディア XDMに相当しないGoogle Ads個の概念は、承認されたマッピングに従って、additionalDetailsを使用して表されるか、nullに設定されます。

列挙マッピング

コネクターは、完全一致、セマンティック一致、または承認済みのフォールバック値を使用して、Google Ads個のAPI列挙値をXDM値にマッピングします。 サポートされていない値、不明な値、非推奨の値、または指定されていない値はスキップされるか、nullに設定されます。

次の手順

Google Adsの資格情報とアカウントアクセスモデルを確認したら、Experience Platform UIを使用して Google Ads への接続を作成します。

recommendation-more-help
experience-platform-help-sources