# Google Enhanced Conversion Export Integration

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

**警告!** デジタル市場法(DMA)規制により、**2024年3月**までにコンバージョンをアップロードする際に同意シグナルの送信を開始し、**EUユーザー同意ポリシー**に準拠し、欧州経済領域(EEA)のコンバージョンデータを引き続き使用する必要があります。**2024年3月6日**以降、Google Ads は有効な同意なしにEUユーザーのCustomer Match、コンバージョン、店舗販売データのアップロードを受け付けなくなります。これは、EUユーザーからの同意がないオーディエンスは処理されないことを意味します。EU以外の地域に対するこの同意設定は、データアップロードに即座の影響を与えることはありません。ただし、Google Ads は将来的にこの情報をターゲティングとパーソナライゼーション機能の向上に使用する可能性があります。

## 前提条件

- [TD Toolbelt](https://toolbelt.treasuredata.com/) を含む Treasure Data の基本知識。
- ドキュメント:[Google Enhanced Conversions Setup Guideline](https://support.google.com/google-ads/answer/11062876)、[Google Enhanced Conversions API doc](https://developers.google.com/google-ads/api/docs/conversions/enhance-conversions)
- 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/](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** を選択します。


![](/assets/image2022-8-30_22-16-21.2453076ca3b1539612e10217234f686fd4845fcc3aae0cfce896ef06332f00a0.a37daa01.png)

1. 認証の名前を作成します。
2. **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。


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

| **Field Name (Output Schema)** | **Description** | **Data Type** | **Required?** | **Support hashed data input (SHA-256)?** |
|  --- | --- | --- | --- | --- |
| email | コンバージョン時点のユーザーメールアドレス | String | first_name、last_name、street_address、city、region、postcode、country が存在しない場合は必須 | Yes |
| phone_number | [E.164 形式](https://en.wikipedia.org/wiki/E.164)でのコンバージョン時点のユーザー電話番号 | String - **ユーザーがこのフィールドのフォーマットに責任を持ちます** | No | Yes |
| first_name | ユーザーの名 | String | email が設定されていない場合は必須 | Yes |
| last_name | ユーザーの姓 | String | email が設定されていない場合は必須 | Yes |
| street_address | ユーザーの住所 | String | email が設定されていない場合は必須 | Yes |
| city | ユーザーの都市名 | String | email が設定されていない場合は必須 |  |
| region | ユーザーの都道府県、州、地域 | String | email が設定されていない場合は必須 |  |
| postcode | ユーザーの郵便番号 | String | email が設定されていない場合は必須 |  |
| country | ユーザーの国コード | String | email が設定されていない場合は必須 |  |
| conversion_time | コンバージョン時刻(エポックからの Unix 時刻、**マイクロ秒**単位) | Long | Yes |  |
| conversion_tracking_id | コンバージョントラッキング ID - 広告主アカウントを一意に識別するトラッキング ID | Long | Yes |  |
| label | コンバージョンラベル - エンコードされたコンバージョントラッキング ID とコンバージョンタイプ | String | Yes |  |
| conversion_type | コンバージョンタイプ - コンバージョンのタイプ これは広告主として label にアクセスできない場合にのみ使用されます。 | String | No |  |
| oid | トランザクション ID - 広告主として生成した、コンバージョンイベントを一意に識別する ID。 これは異なるチャネルからのコンバージョンの重複排除に使用されます。 | String | No |  |
| value | コンバージョン値 - コンバージョンの金額 | String | No |  |
| currency_code | 通貨コード - 値の通貨 | String | No |  |
| user_agent | User agent - コンバージョンした**ユーザーの** User agent(広告主がそのようなデータを保持している場合) | String | No |  |
| gclid | ユーザーコンバージョンにつながった広告クリックの Google クリック識別子(利用可能な場合) | String | No |  |
| pcc_game | Performance PC and Console Gaming Ads | String | No |  |


### Google Enhanced Conversion の統合パラメータ

![](/assets/image2022-8-30_22-47-1.8a30a7dd60a933c2049c74b14405326e87f651d6a85da41eec2a284319304fb4.a37daa01.png)

| **Parameters** | **Description** |
|  --- | --- |
| Skip Invalid Records | データ行が識別するエラーをチェックする場合、エクスポートジョブは続行され成功します。それ以外の場合、ジョブは失敗します。 |


### クエリの例

custom object query


```SQL
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 を選択します。
![](/assets/image2021-1-15_17-28-51.f1b242f6ecc7666a0097fdf37edd1682786ec11ef80eff68c66f091bc405c371.0f87d8d4.png)
4. ドロップダウンで、次のスケジュールオプションのいずれかを選択します:
![](/assets/image2021-1-15_17-29-47.45289a1c99256f125f4d887e501e204ed61f02223fde0927af5f425a89ace0c0.0f87d8d4.png)
| ドロップダウン値 | 説明 |
|  --- | --- |
| Custom cron... | [Custom cron... の詳細](#custom-cron-details)を参照してください。 |
| @daily (midnight) | 指定されたタイムゾーンで 1 日 1 回午前 0 時 (00:00 am) に実行します。 |
| @hourly (:00) | 毎時 00 分に実行します。 |
| None | スケジュールなし。 |


#### Custom cron... の詳細

![](/assets/image2021-1-15_17-30-23.0f94a8aa5f75ea03e3fec0c25b0640cd59ee48d1804a83701e5f2372deae466c.0f87d8d4.png)

| **Cron 値** | **説明** |
|  --- | --- |
| `0 * * * *` | 1 時間に 1 回実行します。 |
| `0 0 * * *` | 1 日 1 回午前 0 時に実行します。 |
| `0 0 1 * *` | 毎月 1 日の午前 0 時に 1 回実行します。 |
| "" | スケジュールされた実行時刻のないジョブを作成します。 |



```
 *    *    *    *    *
 -    -    -    -    -
 |    |    |    |    |
 |    |    |    |    +----- 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.


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

| フィールド値  | 例  | 例の説明  |
|  --- | --- | --- |
| 各フィールドに対して上記で表示された制限内の単一の値。 |  |  |
| フィールドに基づく制限がないことを示すワイルドカード
`'*'`。 | `'0 0 1 * *'` | 毎月 1 日の午前 0 時 (00:00) に実行するようにスケジュールを設定します。 |
| 範囲 `'2-5'`
フィールドの許可される値の範囲を示します。 | `'0 0 1-10 * *'` | 毎月 1 日から 10 日までの午前 0 時 (00:00) に実行するようにスケジュールを設定します。 |
| カンマ区切りの値のリスト `'2,3,4,5'`
フィールドの許可される値のリストを示します。 | `0 0 1,11,21 * *'` | 毎月 1 日、11 日、21 日の午前 0 時 (00:00) に実行するようにスケジュールを設定します。 |
| 周期性インジケータ `'*/5'`
フィールドの有効な値の範囲に基づいて、
スケジュールが実行を許可される頻度を表現します。 | `'30 */2 1 * *'` | 毎月 1 日、00:30 から 2 時間ごとに実行するようにスケジュールを設定します。
`'0 0 */5 * *'` は、毎月 5 日から 5 日ごとに午前 0 時 (00:00) に実行するようにスケジュールを設定します。 |
| `'*'`
ワイルドカードを除く上記の
いずれかのカンマ区切りリストもサポートされています
`'2,*/5,8-10'` | `'0 0 5,*/10,25 * *'` | 毎月 5 日、10 日、20 日、25 日の午前 0 時 (00:00) に実行するようにスケジュールを設定します。 |


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


### クエリを実行する

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

設定エラーにより継続的に失敗するスケジュールジョブは、複数回通知された後、システム側で無効化される場合があります。

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

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

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

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

認証方法: OAuth の場合


```yaml
_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 の場合


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