# Google Customer Match Export Integration

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

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

## 関連インテグレーション

TD Consoleは、Customer MatchデータをGoogleプラットフォームにアップロードするためのいくつかのインテグレーションオプションを提供しています:

- [Google Ads V2](/ja/int/google-ads-v2-export-integration): Google AdsのAPI機能を使用してオーディエンスデータを更新します。現在、名、姓、国コード、郵便番号を含む郵送先住所はサポートされていないという制限があります
- [Google Display & Video 360 API](/ja/int/google-display-and-video-360-api-export-integration): DV360のAPI機能を使用してオーディエンスデータを更新します。現在、コネクタはユーザーのオプトアウトをまだサポートしていません
- このインテグレーションは、Treasure DataがGoogleの公式データパートナーとして実装されており、上記のすべての制限を解決します


## 前提条件

- Treasure Data™の基本知識
- [Customer Match](https://support.google.com/google-ads/answer/6379332?hl=en&ref_topic=10551292&sjid=7513164071054933331-AP)トピックの基本知識
- ユーザーのOAuthが対象のGoogle AdsまたはDV360アカウントへの直接管理者アクセス権を持っていること


## 要件と制限事項

### 制限事項

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


### 要件

Customer Matchに関するGoogleの[ポリシー](https://support.google.com/adspolicy/answer/6299717?hl=en)に従うことが推奨されます。特に以下の点に注意してください:

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


## TD Consoleの使用

### 新しいConnectionの作成

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

1. **TD Console**を開きます
2. **Integrations Hub > Catalog**に移動します
3. **Google Customer Match**を検索して選択します
4. **Create Authentication**を選択し、以下に説明されているインテグレーションの認証情報を入力します
5. **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からデータをエクスポートするには、以下の手順に従ってください

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


![](/assets/screenshot-2024-05-27-at-13.08.60.c660e2874c5efd5898076c87205c9c1c3579e1232c32206db66443388b0163ee.9c1a955f.png)

1. 既存のauthenticationを選択するか、上記のセクションに従って新しいものを作成します
2. 以下の[設定パラメータ](/ja/int/google-customer-match-export-integration#h2_2111705584)に記載されているエクスポートパラメータを設定し、**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](https://en.wikipedia.org/wiki/E.164)標準が適用されます |  |
| first_name | Mailing address - 名 |  |
| last_name | Mailing address - 姓 |  |
| country_code | Mailing address - 国コード（[ISO-3166-1 alpha-2](https://en.wikipedia.org/wiki/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 データをターゲットプラットフォームに送信することもできます。

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


![](/assets/ouput.b2c7f1d909c4f98ed10f5300df858a4b19f71a3b0834df952f5fb24018a5ea78.8ebdf569.png)

- 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 番号。


1. **Schedule** を設定します。


![](/assets/snippet-output-connector-on-audience-studio-2024-08-28.a99525173709da1eb537f839019fa7876ffae95045154c8f2941b030022f792c.8ebdf569.png)

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


1. **Create** を選択します。


batch journey の activation を作成する必要がある場合は、[Creating a Batch Journey Activation](/products/customer-data-platform/journey-orchestration/batch/creating-a-batch-journey-activation) を参照してください。

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

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

詳細については、[Using Workflows to Export Data with the TD Toolbelt](https://api-docs.treasuredata.com/en/tools/cli/api/#workflow-commands)を参照してください。


```yaml
_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
```


```yaml
_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
```