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

[Beta]{class="badge informative"}

Flow Service APIを使用してGoogle AdsをExperience Platformに接続します

最終更新日： 2025年10月16日

作成対象：

  • Developer
NOTE
Google Ads ソースは現在ベータ版で、1回限りの取り込みのみをサポートしています。 ベータ版のソースの使用について詳しくは、​ ソースの概要を参照してください。

ベース接続は、ソースとAdobe Experience Platform間の認証済み接続を表します。 このチュートリアルでは、Flow Service APIを使用してGoogle Ads アカウントをExperience Platformに接続する方法を説明します。

Google Ads ベース接続は、Google Ads APIへのアクセスに必要な認証の詳細を保存し、後の手順でソース設定を調べてデータフローを作成するために使用する接続IDを作成します。

基本を学ぶ

このガイドは、Adobe Experience Platform の次のコンポーネントを実際に利用および理解しているユーザーを対象としています。

  • ​ ソース ​: Experience Platformを使用すると、様々なソースからデータを取り込むことができますが、Experience Platform サービスを使用して着信データを構造化、ラベル付け、強化することができます。
  • ​ サンドボックス ​: Experience Platformは、1つのExperience Platform インスタンスを個別のバーチャル環境に分割して、デジタルエクスペリエンスアプリケーションの開発と進化に役立つバーチャルサンドボックスを提供します。

次の節では、Flow Service APIを使用してGoogle Adsに正常に接続するために知っておく必要がある追加情報を示します。

Experience Platform APIの使用

Experience Platform APIの呼び出しを正常に行う方法について詳しくは、Experience Platform APIの概要に関するガイドを参照してください。

必須ヘッダーの値の収集

Experience Platform APIを呼び出すには、まず認証チュートリアルを完了する必要があります。 認証チュートリアル ​を完了すると、以下に示すように、すべてのExperience Platform API呼び出しで必要な各ヘッダーの値が提供されます。

Authorization: Bearer {ACCESS_TOKEN}
x-api-key: {API_KEY}
x-gw-ims-org-id: {ORG_ID}
x-sandbox-name: {SANDBOX_NAME}
Content-Type: application/json

Experience Platform のすべてのリソースは、特定の仮想サンドボックスに分離されています。 Experience Platform APIへのすべてのリクエストには、操作を実行するサンドボックスの名前を指定するヘッダーが必要です。

必要な資格情報の収集

認証について詳しくは、Google Ads ソースの概要を参照してください。

ベース接続の作成

ベース接続は、ソースの認証情報、接続の現在の状態、一意のベース接続IDなど、ソースとExperience Platform間の情報を保持します。

ベース接続IDを作成するには、リクエストパラメーターの一部としてGoogle Ads認証情報を提供しながら、/connections エンドポイントにPOST リクエストを行います。

API 形式

POST /connections

リクエスト

次のリクエストは、Google Adsのベース接続を作成します。

curl -X POST \
  'https://platform.adobe.io/data/foundation/flowservice/connections' \
  -H 'Authorization: Bearer {ACCESS_TOKEN}' \
  -H 'x-api-key: {API_KEY}' \
  -H 'x-gw-ims-org-id: {ORG_ID}' \
  -H 'x-sandbox-name: {SANDBOX_NAME}' \
  -H 'Content-Type: application/json'
  -d '{
      "name": "Google Ads base connection",
      "description": "Google Ads base connection",
      "auth": {
          "specName": "Basic Authentication",
          "params": {
              "clientCustomerID": "{CLIENT_CUSTOMER_ID}",
              "loginCustomerID": "{LOGIN_CUSTOMER_ID}",
              "developerToken": "{DEVELOPER_TOKEN}",
              "refreshToken": "{REFRESH_TOKEN}",
              "clientId": "{CLIENT_ID}",
              "clientSecret": "{CLIENT_SECRET}",
              "googleAdsApiVersion": "v19"

          }
      },
      "connectionSpec": {
          "id": "d771e9c1-4f26-40dc-8617-ce58c4b53702",
          "version": "1.0"
      }
  }'

ターゲット広告主アカウントに直接アクセスでき、マネージャーとアカウントのルーティングが必要ない場合は、auth.params オブジェクトからloginCustomerIDを省略できます。

プロパティ
説明
name
ベース接続の名前。 後でGoogle Adsの連携を識別しやすいわかりやすい名前を使用します。
description
接続に関する追加のコンテキストを保存するために使用できるオプションの説明。
auth.specName
コネクタで使用される認証タイプ。
auth.params.clientCustomerID
Google Ads アカウントのクライアント顧客ID。
auth.params.loginCustomerID
Google Ads マネージャーアカウントに対応するログイン顧客ID。
auth.params.developerToken
Google Ads アカウントの開発者トークン。
auth.params.refreshToken
Google Ads アカウントの更新トークン。
auth.params.clientID
Google Ads アカウントのクライアント ID。
auth.params.clientSecret
Google Ads アカウントのクライアント秘密鍵。
auth.params.googleAdsApiVersion
使用しているGoogle Ads API バージョン。 Experience Platformは現在、バージョン v19以降をサポートしています。 互換性を確保するために、サポートされているバージョンのいずれかを使用していることを確認してください。
connectionSpec.id
Google Ads接続仕様ID: d771e9c1-4f26-40dc-8617-ce58c4b53702。

応答

リクエストが成功した場合は、一意の ID（id）を含め、新しく作成されたベース接続の詳細が返されます。 この ID は、次の手順でソース接続を作成する際に必要になります。

{
    "id": "2484f2df-c057-4ab5-84f2-dfc0577ab592",
    "etag": "\"10033e77-0000-0200-0000-5e96785b0000\""
}

接続の詳細を確認する

ベース接続を作成した後、続行する前に以下を検証します。

  • ベース接続は意図したサンドボックスで作成され，
  • clientCustomerIdは、意図した広告主アカウントを指しています，
  • 広告主アカウントがMCCを通じてアクセスされている場合、loginCustomerIdは正しいです。
  • Google Ads API バージョンは、Experience Platformでサポートされるものです。

認証に成功してもダウンストリーム データ アクセスが失敗した場合、最も一般的な原因は正しくないか、不要なloginCustomerIdです。

次の手順

このチュートリアルでは、Flow Service APIを使用してGoogle Ads ベース接続を作成しました。

次のチュートリアルに進むことができます。

トラブルシューティング

子広告主アカウントの認証エラー

子広告主アカウントにアクセスしようとしたときにリクエストが失敗した場合は、loginCustomerIdが正しいマネージャーアカウントに設定されていることを確認してください。 これは、アクセスがMCC階層を介して仲介される場合に必要です。

無効または失効した更新トークン

コネクターがアクセストークンを更新できない場合は、新しい更新トークンを生成するようにGoogle Ads アカウントを再認証します。

サポートされていないAPI バージョン

バージョンが一致しないためにリクエストが失敗した場合は、googleAdsApiVersionがExperience Platformでサポートされているバージョンに設定されていることを確認してください。

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