Google Data Manager エクスポート連携

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サーバーをインストール

このTDエクスポート連携により、単一の呼び出しでGoogle Adwords、Display Video Partner、Display Video Advertiserなどの複数のGoogle広告プロダクトにオーディエンスデータを送信できます。

前提条件

• Treasure Data™の基礎知識
• ユーザーOAuthが対象のGoogle AdsまたはDisplay Video PartnerまたはDisplay Video Advertiserアカウントへの直接管理者アクセス権を持つこと

要件と制限事項

制限事項

• ユーザーリストのサイズは、最低1,000人のメンバーに達するまでゼロとして表示されます。このしきい値を超えると、サイズは有効数字2桁に丸められます
• リストにメンバーが入力されるまでに最大24時間かかる場合があります
• オーディエンスデータは1日1回ユーザーリストに追加することを推奨します
• 同じユーザーリストの複数のアップロードジョブの実行は避けてください

要件

特に以下の点で、Googleのポリシーに従うことをCustomer Matchでは推奨しています:

• ポリシー遵守の良好な履歴
• 良好な支払い履歴
• ファーストパーティコンテキストで収集した顧客情報のみをアップロードすること
• 機密カテゴリに関する制限

新しい接続を作成する

TD Consoleでは、クエリを実行する前にデータ接続を作成して設定する必要があります。データ接続の一部として、以下の手順に従って連携にアクセスするための認証情報を提供します。

1. TD Consoleを開きます
2. Integrations Hub > Catalogに移動します
3. Google Data Managerを検索して選択します
4. Create Authenticationを選択し、以下に説明する連携の認証情報を入力します
5. Continueを選択し、認証の名前を入力して、Doneを選択します

認証フィールド

• OAuth Connection: 対象のGoogle AdsまたはDisplay Video PartnerまたはDisplay Video AdvertiserアカウントへのADMINアクセス権を持つアカウントから承認します

エクスポート用のクエリ結果を設定する

TD Consoleは、データをエクスポートする複数の方法をサポートしています。Data Workbenchからデータをエクスポートするには、以下の手順に従ってください。

1. Data Workbench > Queriesに移動します
2. New Queryを選択し、クエリを定義します
3. Export Resultsを選択して、データエクスポートを設定します

1. 既存の認証を選択するか、上記のセクションに従って新しい認証を作成します
2. 以下の設定パラメータで説明されているエクスポートパラメータを設定し、Doneを選択します

クエリを定義する

クエリには、対象の識別子タイプに必要な列を含める必要があります。その他の列は無視されます。必須列にはnullまたは空の値を指定できません(それ以外の場合、レコードは無効と見なされ、スキップされます)。

データ要件:

• 正規化: すべてのプレーンテキストデータは小文字にし、前後の余分なスペースを削除する必要があります
• SHA-256ハッシュ化: email、phone、first name、last nameはSHA-256アルゴリズムを使用してハッシュ化する必要があります。そうでない場合は、コネクタによって自動的にハッシュ化されます

設定パラメータ

Audience Studioでセグメントをアクティベートする

Audience Studioでアクティベーションを作成することで、対象プラットフォームにセグメントデータを送信することもできます。

1. Audience Studioに移動します
2. 親セグメントを選択します
3. 対象セグメントを開き、右クリックして、Create Activationを選択します
4. Detailsパネルでアクティベーション名を入力し、前のセクションの設定パラメータに従ってアクティベーションを設定します
5. Output Mappingパネルでアクティベーション出力をカスタマイズします。

• Attribute Columns
  • Export All Columnsを選択すると、変更を加えずにすべての列をエクスポートします。
  • + Add Columnsを選択すると、エクスポートする特定の列を追加できます。Output Column Nameには、Source列名と同じ名前が事前入力されます。Output Column Nameは更新できます。+ Add Columnsを選択し続けて、アクティベーション出力用の新しい列を追加します。
• String Builder
  • + Add stringを選択して、エクスポート用の文字列を作成します。以下の値から選択します。
    • String: 任意の値を選択します。テキストを使用してカスタム値を作成します。
    • Timestamp: エクスポートの日時。
    • Segment Id: セグメントID番号。
    • Segment Name: セグメント名。
    • Audience Id: 親セグメント番号。

1. Scheduleを設定します。

• スケジュールを定義する値を選択し、オプションでメール通知を含めます。

1. Createを選択します。

(オプション) ワークフローを使用したエクスポート統合

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

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

_export:  td:    database: google_data_manager+google_data_manager_export_task:  td>: export.sql  database: ${td.database}  result_connection: new_created_google_data_manager  result_settings:             type: google_data_manager    product: GOOGLE_ADS    mode: add    advertiser_id: 123456789     list_name: test    list_description: desc    list_type: mobile_data    app_id: app_id    membership_life_span: 100    terms_of_service: ACCEPTED    ad_user_data: CONSENT_GRANTED    ad_personalization: CONSENT_GRANTED    skip_invalid_records:true
_export:  td:    database: google_data_manager+google_data_manager_export_task:  td>: export.sql  database: ${td.database}  result_connection: new_created_google_data_manager  result_settings:             type: google_data_manager    product: GOOGLE_ADS    mode: remove    advertiser_id: 123456789     list_name: test    list_type: user_data    skip_invalid_records:true

(オプション) CLIを使用したエクスポート統合

CLI(Toolbelt)を使用して、結果をGoogle Platformにエクスポートすることもできます。

td queryコマンドの*--result オプションを使用して、Googleアカウントへのエクスポート情報を指定する必要があります。td query*コマンドの詳細については、こちらの記事を参照してください。

オプションの形式はJSONで、一般的な構造は次のとおりです。

モバイルデータを追加

    type: google_data_manager    product: GOOGLE_ADS    mode: add    advertiser_id: 123456789     list_name: test    list_description: desc    list_type: mobile_data    app_id: app_id    membership_life_span: 100    terms_of_service: ACCEPTED    ad_user_data: CONSENT_GRANTED    ad_personalization: CONSENT_GRANTED    skip_invalid_records:true

ユーザーデータを追加

    type: google_data_manager    product: GOOGLE_ADS    mode: add    advertiser_id: 123456789     list_name: test    list_description: desc    list_type: user_data    membership_life_span: 100    terms_of_service: ACCEPTED    ad_user_data: CONSENT_GRANTED    ad_personalization: CONSENT_GRANTED    skip_invalid_records:true

ユーザーデータ/モバイルデータを削除

    type: google_data_manager    product: GOOGLE_ADS    mode: remove    advertiser_id: 123456789     list_name: test    list_type: user_data    skip_invalid_records:true

パラメータ

使用例

OAuth認証

$ td query --result '{"type":"google_data_manager","oauth_credentials_id":"xxx","product":"GOOGLE_ADS","mode":"add","advertiser_id":"xxx","list_name":"xxx","list_description":"xxx","list_type":"user_data","membership_life_span":540,"terms_of_service":"ACCEPTED","ad_user_data":"CONSENT_GRANTED","ad_personalization":"CONSENT_GRANTED","skip_invalid_records":true}' -d sample_datasets "select ........ from ........" -T presto

その他

• Scheduled JobとResult Exportを使用して、定期的にターゲット宛先にデータをアップロードできます