[Beta]{class="badge informative"}
Google Ads
Google Adsは、検索、YouTube、マップ、パートナーのweb サイトをまたいで潜在顧客にリーチできる、Googleのオンライン広告プラットフォームです。 適切なオーディエンスをターゲティングし、予算を管理して、結果を追跡することで、認知度、リード、売上を向上できます。
Google Ads ソースを使用してGoogle Ads APIに対する認証を行い、広告主アカウントまたはマネージャーとアカウントの階層を接続し、ダウンストリームの分析ワークフローとアクティベーション ワークフローのためにレポートデータをExperience Platformに取り込みます。
前提条件
Google Ads アカウントをExperience Platformに接続する前に、次の要件を満たしていることを確認してください。
IP アドレスの許可リスト
ソースをExperience Platformに接続する前に、リージョン固有のIP アドレスをードに追加する必要があります。 詳しくは、Experience PlatformへのIP アドレスの許可リストに加えるに関するガイドを参照してください。
Experience Platformの権限の設定
Google Ads アカウントをExperience Platformに接続するには、ソースの表示と ソースの管理 の両方の権限をアカウントに対して有効にする必要があります。 必要な権限を取得するには、製品の管理者にお問い合わせください。 詳しくは、 アクセス制御UI ガイド を参照してください。
Google Adsのアクセス要件
有効なGoogle Ads API資格情報があり、読み取り元のGoogle Ads アカウントにアクセスできる必要があります。 ターゲット広告主アカウントが Google Adsマネージャーアカウント （MCC） を通じて管理されている場合、適切なマネージャー階層を通じてリクエストをルーティングできるように、接続に正しいログイン顧客IDも含める必要があります。
実際には：
- ターゲット広告主アカウントがOAuth承認済みユーザーから直接アクセスできる場合、
loginCustomerIdは必要ない場合があります。 - 広告主アカウントがMCC階層を通じてのみアクセスできる場合、
loginCustomerIdはその子アカウントへのアクセスに使用されるマネージャーアカウントを特定する必要があります。 loginCustomerIdが正しくないか見つからない場合、管理対象の子アカウントを照会しようとすると、認証エラーが発生する可能性があります。
必要な資格情報の収集
Google AdsをExperience Platformに接続するには、次の接続プロパティの値を指定する必要があります。
clientCustomerId123-456-7890に従います。loginCustomerIddeveloperTokenrefreshTokenclientIdclientSecretgoogleAdsApiVersionv19以降をサポートしています。connectionSpec.idd771e9c1-4f26-40dc-8617-ce58c4b53702。loginCustomerId について
loginCustomerId値は、Google Ads ソースの最も重要な設定フィールドの1つです。
次の場合にloginCustomerIdを使用：
- OAuth承認済みユーザーは、マネージャーアカウント，
- ターゲット広告主アカウントは、MCCの下の子アカウントであり，
- アカウントは、トップレベルのアクセス可能なアカウントとして直接返されません。
直接アクセス可能な広告主アカウントにloginCustomerIdを不必要に設定しないでください。 可能であれば、最初にアカウントに直接アクセスできるかどうかを検証し、アクセスがその階層に本当に依存する場合にのみマネージャーIDを指定します。
認証と接続動作
Google Ads ソースはOAuth 2.0を使用して、Google Ads APIへのリクエストを認証します。 Experience Platformは、接続の詳細をベース接続に保存し、指定された資格情報を使用して、お客様の代理でGoogle Ads API呼び出しを認証します。
マネージャーとアカウントのシナリオの場合、コネクターは、ターゲット広告主アカウントに正常にアクセスするために、適切なマネージャー階層を解決する必要がある場合があります。 内部的には、通常、次のことが行われます。
- アクセシブルなアカウントの列挙，
- アカウントがマネージャーアカウントかどうかを判断し，
- マネージャー以外のリーフアカウントの特定，
- ターゲットアカウントがMCC階層を介してのみ到達できる場合に、正しいloginCustomerIdを解決する。
この動作は、単一のマネージャーアカウント構造から複数の広告主アカウントを管理する顧客にとって特に重要です。
データの選択とレポート動作
Google Ads データの選択は、Google Adsクエリ言語（GAQL）に基づいています。 設定時に、取り込むために取得する属性、セグメント、指標を指定します。
大規模なレポート取得の場合、Google Adsは標準検索とストリーミング取得の両方のパターンをサポートしています。 内部的には、ストリーミング取得は、ページごとにバッファリングするのではなく、レポート行を段階的に消費できるため、より大きな結果セットに適しています。
Experience Platform UIでデータ選択を構成する場合は、Google AdsQuery Builderを使用して、取り込むリソースタイプとフィールドを選択し、クエリを検証してから、必要な属性をソースワークフローにコピーします。
サポートされている接続パス
APIまたはユーザーインターフェイスを使用して、Google AdsをExperience Platformに接続できます。
API の使用
プログラム設定、反復可能な設定、または増分取り込みのサポートが必要な場合は、 Flow Service APIを使用します。 API ワークフローには、大まかに言えば次のものが含まれます。
- ベース接続を作成するには，
- ソース設定の詳細，
- ソースとターゲットの接続の作成，
- 取り込み用のデータフローの作成
UI の使用
UIを介してGoogle Adsを接続する場合は、ガイド付き設定にExperience Platform ソース ワークスペース を使用します。 UI フローでは、資格情報の入力、属性の選択、プレビュー、データフローの作成がサポートされています。 現在のところ、UI パスはベータ版のままであり、1回限りの取り込みのみをサポートしています。
既知の制限事項と注意事項
- UIのGoogle Ads ソースは現在ベータ版です。
- UIは現在、1回限りの取り込みのみをサポートしています。
- 増分取り込みにAPI ベースのパスを使用します。
- Experience Platformは現在、Google Ads API バージョン
v19以降をサポートしています。 - マネージャーとアカウントの階層では、
loginCustomerIdを慎重に処理する必要があります。誤った値は、子広告主アカウントへのアクセスを妨げる可能性があります。
次の手順
資格情報を収集し、アカウントアクセスパターンを確認したら、次のいずれかの設定パスで続行します。