Google Enhanced Conversion Export Integration

Copy

• Copy for LLM

  Copy page as Markdown for LLMs
• View as Markdown

  Open this page as Markdown
• Open in ChatGPT

  Get insights from ChatGPT
• Open in Claude

  Get insights from Claude
• Cursorに接続

  CursorにMCPサーバーをインストール
• VS Codeに接続

  VS CodeにMCPサーバーをインストール

この統合により、Treasure Data のジョブ結果を Google Ads サーバーに直接書き込み、コンバージョン測定の精度を向上させることができます。既存のコンバージョンでのみ機能し、ウェブサイトコンバージョンのみをサポートします。

前提条件

• TD Toolbelt を含む Treasure Data の基本知識。
• ドキュメント:Google Enhanced Conversions Setup Guideline、Google Enhanced Conversions API doc
• Google Ads アカウント。
• Treasure Data の Google OAuth アプリに Google Ads アカウントへのアクセスを承認する。または、カスタムアプリ情報を提供する。

要件と制限事項

正確な列名(大文字小文字を区別)とデータ型で列を指定する必要があります。

Treasure Data Integration の静的 IP アドレス

セキュリティポリシーで IP ホワイトリストが必要な場合は、接続を成功させるために Treasure Data の IP アドレスを許可リストに追加する必要があります。

リージョンごとに整理された静的 IP アドレスの完全なリストは、次のリンクにあります: https://api-docs.treasuredata.com/en/overview/ip-addresses-integrations-result-workers/

TD Console を使用して接続を作成する

Google Enhanced Conversion Export Integration に接続する方法は2つあります。Treasure Data の Google OAuth アプリを承認するか、カスタムアプリ情報を提供することができます。

新しい接続を作成する

クエリを実行する前に、Treasure Data でデータ接続を作成して設定する必要があります。データ接続の一部として、統合にアクセスするための認証を提供します。

1. TD Console を開きます。

2. Integrations Hub > Catalog に移動します。

3. Google Enhanced Conversion を検索して選択します。

4. Create Authentication を選択します。

5. Data Provider を選択します。Treasure Data または User アカウントのいずれかを選択できます。Authentication ドロップダウンから OAuth を選択した場合は、Sign in with Google をクリックして接続を承認します。Authentication ドロップダウンから Custom App を選択した場合は、表示されるフィールドに認証情報を入力します。Continue を選択します。

6. 認証の名前を作成します。

7. Done を選択します。

クエリを定義する

クエリには以下を含める必要があります:

• 必須列 -
  • email または address(address には列 [first_name, last_name, street_address, city, region, postcode, country] が含まれます)、または両方。
  • label または conversion_type、または両方。
  • conversion_time、conversion_tracking_id、oid。
• オプション列 - phone_number、value、currency_code、user_agent、gclid、pcc_game。
• その他の列は無視されます。

必須列は null または空の値を受け付けません(それ以外の場合、レコードは無効と見なされてスキップされるか、エラーがスローされます)。

Email の値は、パターン \S+@\S+.\S+ に従う必要があります。

電話番号(ある場合)は、パターン +\d{11,15} に従う必要があります。

異なる列名のデータ型を以下に示します:

• String - mail、first_name、last_name、street_address、city、region、postcode、country、label、conversion_type、oid、phone_number、value、currency_code、user_agent、gclid。
• Long - conversion_time、conversion_tracking_id、pcc_game。

注意:列名は大文字小文字を区別し、重複することはできません。

Google Enhanced Conversion の統合パラメータ

クエリの例

custom object query

SELECT
  email,
  label,
  conversion_time,
  conversion_tracking_id,
  oid
FROM your_table;

(オプション) Query Export ジョブをスケジュールする

Scheduled Jobs と Result Export を使用して、指定したターゲット宛先に出力結果を定期的に書き込むことができます。

Treasure Data のスケジューラー機能は、高可用性を実現するために定期的なクエリ実行をサポートしています。

2 つの仕様が競合するスケジュール仕様を提供する場合、より頻繁に実行するよう要求する仕様が優先され、もう一方のスケジュール仕様は無視されます。

例えば、cron スケジュールが '0 0 1 * 1' の場合、「月の日」の仕様と「週の曜日」が矛盾します。前者の仕様は毎月 1 日の午前 0 時 (00:00) に実行することを要求し、後者の仕様は毎週月曜日の午前 0 時 (00:00) に実行することを要求するためです。後者の仕様が優先されます。

TD Console を使用してジョブをスケジュールする

1. Data Workbench > Queries に移動します

2. 新しいクエリを作成するか、既存のクエリを選択します。

3. Schedule の横にある None を選択します。

4. ドロップダウンで、次のスケジュールオプションのいずれかを選択します:

   ドロップダウン値	説明
   Custom cron...	Custom cron... の詳細を参照してください。
   @daily (midnight)	指定されたタイムゾーンで 1 日 1 回午前 0 時 (00:00 am) に実行します。
   @hourly (:00)	毎時 00 分に実行します。
   None	スケジュールなし。

Custom cron... の詳細

 *    *    *    *    *
 -    -    -    -    -
 |    |    |    |    |
 |    |    |    |    +----- day of week (0 - 6) (Sunday=0)
 |    |    |    +---------- month (1 - 12)
 |    |    +--------------- day of month (1 - 31)
 |    +-------------------- hour (0 - 23)
 +------------------------- min (0 - 59)

次の名前付きエントリを使用できます:

• Day of Week: sun, mon, tue, wed, thu, fri, sat.
• Month: jan, feb, mar, apr, may, jun, jul, aug, sep, oct, nov, dec.

各フィールド間には単一のスペースが必要です。各フィールドの値は、次のもので構成できます:

1. (オプション) Delay execution を有効にすることで、クエリの開始時刻を遅延させることができます。

クエリを実行する

クエリに名前を付けて保存して実行するか、単にクエリを実行します。クエリが正常に完了すると、クエリ結果は指定された宛先に自動的にエクスポートされます。

(オプション) Delay execution を有効にすることで、クエリの開始時刻を遅延させることができます。

オプションで Workflow でエクスポート結果を設定する

Treasure Workflow 内で、データコネクタを使用してデータをエクスポートするように指定できます。

詳細については、Using Workflows to Export Data with the TD Toolbelt を参照してください。

認証方法: OAuth の場合

_export:
  td:
    database: google_enhanced_conversion_db

+google_enhanced_conversion_export_task:
  td>: export.sql
  database: ${td.database}
  result_connection: new_created_google_enhanced_conversion_auth
  result_settings:
    type: google_enhanced_conversion
    skip_invalid_records: true

認証方法: Custom App の場合

_export:
  td:
    database: google_enhanced_conversion_db

+google_enhanced_conversion_export_task:
  td>: export.sql
  database: ${td.database}
  result_settings:
    type: google_enhanced_conversion
    client_id: "************************"
    client_secret: "************************"
    refresh_token: "************************"
    skip_invalid_records: true