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 Serverに直接書き込み、コンバージョン測定の精度を向上させることができます。既存のコンバージョンでのみ機能し、Webサイトコンバージョンのみをサポートします。

前提条件

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

要件と制限事項

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

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 accountのいずれかを選択できます。
6. Authentication ドロップダウンからOAuthを選択した場合は、Sign in with Googleをクリックして接続を承認します。AuthenticationドロップダウンからCustom Appを選択した場合は、表示されたフィールドに認証情報を入力します。Continueを選択します。
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のインテグレーションパラメータ

クエリ例

カスタムオブジェクトクエリ

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

認証方法: 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