Google Customer Match Export Integration
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サーバーをインストール

Customer Matchは、企業が所有し同意を得た顧客データをGoogleの広範な顧客データベースとマッチングすることを可能にし、Search、ショッピングタブ、Gmail、YouTube、Displayなどの様々なGoogleプラットフォームを通じて顧客とのエンゲージメントを実現します。

このTD exportインテグレーションは、ユーザーのメールアドレスや電話番号などのCustomer Matchデータを、Google AdsまたはGoogle Display & Video 360（DV360）プラットフォームに直接アップロードすることを可能にします。

前提条件

Treasure Data™の基本知識
Customer Matchトピックの基本知識
ユーザーのOAuthが対象のGoogle AdsまたはDV360アカウントへの直接管理者アクセス権を持っていること

要件と制限事項

制限事項

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

要件

Customer Matchに関するGoogleのポリシーに従うことが推奨されます。特に以下の点に注意してください:

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

TD Consoleの使用

新しいConnectionの作成

TD Consoleでは、クエリを実行する前にデータコネクションを作成して設定する必要があります。データコネクションの一部として、以下の手順に従ってインテグレーションにアクセスするための認証を提供します

TD Consoleを開きます
Integrations Hub > Catalogに移動します
Google Customer Matchを検索して選択します
Create Authenticationを選択し、以下に説明されているインテグレーションの認証情報を入力します
Continueを選択し、Authenticationの名前を入力してDoneを選択します

認証フィールド

Field Name	Type	Description
Platform (Required)	string	オーディエンスデータをアップロードする対象プラットフォーム、Google AdsまたはGoogle Display & Video 360
OAuth Connection (Required)	OAuth	対象のGoogle Ads（またはDV360）アカウントへのADMINアクセス権を持つアカウントから承認します

クエリ結果のExport設定

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

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

既存のauthenticationを選択するか、上記のセクションに従って新しいものを作成します
以下の設定パラメータに記載されているエクスポートパラメータを設定し、Doneを選択します

クエリの定義

クエリには、対象の識別子タイプに必要なカラムを含める必要があり、その他のカラムは無視されます。必須カラムはnullまたは空の値を受け入れません（そうでない場合、レコードは無効と見なされてスキップされます）。

データ要件:

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

Column name	Description	Required
email	マッチングプロセスではGoogleメールのみが考慮されます。	`Contact information`識別子タイプには、少なくともemailまたはphoneまたはmailing addressが必要です。mailing addressには4つのカラム[first_name, last_name, country_code, postal_code]すべてが含まれている必要があります。PhoneはE.164形式に従う必要があります。詳細はhttps://en.wikipedia.org/wiki/E.164をご覧ください。Country codeはhttps://en.wikipedia.org/wiki/ISO_3166-1_alpha-2に従う必要があります
phone	E.164標準が適用されます
first_name	Mailing address - 名
last_name	Mailing address - 姓
country_code	Mailing address - 国コード（ISO-3166-1 alpha-2の2文字コード）
postal_code	Mailing address - 郵便番号
mobile_id	Identifier for Advertising（IDFA）またはGoogle Advertising ID（AAID）モバイルデバイスID	`Mobile Advertising ID`識別子タイプに必須です

設定パラメータ

Parameter Name	Type	Description
Advertiser ID (Required)	string	対象のGoogle AdsアカウントまたはDV360アカウントのID（ダッシュあり、またはなし）
List name (REQUIRED)	string	ユーザーリストの名前
Mode (REQUIRED)	string	操作モード - Add（デフォルト）: クエリ結果が既存のユーザーリストに追加されるか、指定されたList nameで存在しない場合は新しいユーザーリストが作成されます。 - Remove: クエリ結果が既存のユーザーリストから削除されます。
Identifier type (REQUIRED)	string	サポートされるユーザー識別子には2つのタイプがあります - Contact information: email、phone、またはmailing addressを使用してユーザープロファイルをマッチングします - Mobile advertising ID: IDFAまたはAAIDをアップロードしてモバイルアプリケーションのユーザーをマッチングします。選択した場合、Application IDは必須です
Application ID (OPTIONAL)	string	モバイルアプリケーションのID。Identifier typeがMobile advertising IDの場合は必須です
Membership days (REQUIRED)	number	ユーザーの連絡先情報がユーザーリストに保持される日数（0から540の間の値が指定された場合）。デフォルト値: 10000 - 有効期限なし
Ad consent (OPTIONAL)	string	欧州経済領域などの必須地域からのユーザーのデータをアップロードするには、明示的な広告同意の宣言が必要です
Ad personalize consent (OPTIONAL)	string	広告のパーソナライゼーションに対する同意フラグ

Audience Studio で Segment をアクティベートする

Audience Studio で activation を作成することで、segment データをターゲットプラットフォームに送信することもできます。

Audience Studio に移動します。
parent segment を選択します。
ターゲット segment を開き、右クリックして、Create Activation を選択します。
Details パネルで、Activation 名を入力し、前述の Configuration Parameters のセクションに従って activation を設定します。
Output Mapping パネルで activation 出力をカスタマイズします。

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

Schedule を設定します。

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

Create を選択します。

batch journey の activation を作成する必要がある場合は、Creating a Batch Journey Activation を参照してください。

（オプション）workflowを使用したエクスポートインテグレーション

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

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

_export:
  td:
    database: google_customer_match

+google_customer_match_export_task:
  td>: export.sql
  database: ${td.database}
  result_connection: new_created_google_customer_match
  result_settings:
    type: google_customer_match
    advertiser_id: 123456789
    list_name: test
    identifier_type: contact_info
    membership_life_span: 100
    mode: add
    ad_user_data_consent: granted
    ad_personalization_consent: granted

_export:
  td:
    database: google_customer_match

+google_customer_match_export_task:
  td>: export.sql
  database: ${td.database}
  result_connection: new_created_google_customer_match
  result_settings:
    type: google_customer_match
    advertiser_id: 123456789
    list_name: test
    identifier_type: mobile_advertising_id
    app_id: test
    membership_life_span: 100
    mode: remove
    ad_user_data_consent: granted
    ad_personalization_consent: granted

関連インテグレーション