# Google Ad Manager Via Audience Partner API Export Integration

[Google Ad Manager](https://www.google.com/ads/publisher/#?modal_active=none)とTreasure Dataを連携して、データリソースを最大限に活用できます。

Treasure Dataに保持されているデータを使用して、Google Ad Managerでオーディエンスリストを作成できます。以下の手順に従って、Cookieやモバイル広告識別子をGoogle Ad Manager内の新規または既存のオーディエンスリストに移動します。

![](/assets/image2021-6-9_11-56-20.84240b4e9c12f5f98153ceafa16874a7a4579eecf054672635eaa15ad4ca7fb4.3cdd588e.png)

## 前提条件

- Treasure Dataの基本的な知識
- DFPアカウント
- Google Ad ManagerアカウントへのTreasure Data DMPアクセス権限
- Treasure Data上での事前設定


## Google Ad Manager via Audience Partner APIの制限事項

- オーディエンスリストの更新がAd Managerで表示されるまでに最大24時間かかる場合があります。クエリ完了からAd Managerに変更が反映されるまで、最大24時間お待ちください。
- Google Data Platform Policy（[Identifying Users and Obtaining User Consent](https://www.google.com/doubleclick/dataplatform/policies.md)）では、各セグメントが最低100人のユーザーを識別する必要があります。


## Treasure Dataへのアクセス権限付与

Treasure Dataのデータコネクタには、Google Ad Managerアカウントでオーディエンスセグメントを作成する権限が必要です。Google Contact Usフォームを使用してGoogle Ad Managerサポートチームに連絡し、Treasure DataにGoogle Ad Managerアカウントへのアクセス権を付与するようリクエストしてください。フォームに以下の情報を記載してください。

- リクエスト: Treasure Dataに権限を付与
- Google Ad Managerアカウント ID（GoogleではAudience Link IDと呼ばれます）
- Treasure Data DMP:
  - Customer ID: 140-996-0635
  - NID: treasuredata_dmp


[Audience link IDの確認方法](https://support.google.com/dfp_premium/answer/2710459?hl=en):

1. Google Ad Managerを開きます。
2. **Admin** > **Global settings** > **All network settings**を選択します。
3. Audience link IDを確認します。


この情報を送信することで、GoogleがTreasure Dataを認識し、Google Ad ManagerアカウントとTreasure Dataを接続します。

データをエクスポートするには、接続を作成または既存の接続を選択し、クエリを作成または再利用してから、クエリを実行してオーディエンスリストをエクスポートします。

## Google IDの設定

TD環境内で特定の設定を行う必要があります。この設定には特定の構成が必要なため、このインテグレーションを初めて設定する場合は、担当のカスタマーサクセスマネージャーにご相談ください。

## TD Consoleを使用した接続の作成

### 新しい接続の作成

クエリを実行する前に、Treasure Dataでデータ接続を作成および設定する必要があります。データ接続の一部として、インテグレーションにアクセスするための認証情報を提供します。

1. TD Consoleを開きます。
2. **Integrations Hub** > **Catalog**に移動します。
3. Google Ad Manager via Audience Partner APIを検索して選択します。


![](/assets/image2021-6-9_11-56-20.84240b4e9c12f5f98153ceafa16874a7a4579eecf054672635eaa15ad4ca7fb4.3cdd588e.png)

1. Create Authenticationを選択します。
2. 認証のための認証情報を入力します。
3. **Audience Link ID**フィールドに、DFPで使用するIDを入力します。


![](/assets/screen-shot-2020-02-22-at-3.02.01-pm.5975e6ed2ac9d8e2165101445dfccde0fc76be16bca57a3d930c08c3c748f914.3cdd588e.png)

1. 接続の名前を入力します。
2. **Done**を選択します。


### クエリの定義

場合によっては、クエリを記述する前にカラムマッピングを定義する必要があります。

オーディエンスリスト（セグメントとも呼ばれます）がGoogle AdWordsに反映される必要がある時間の少なくとも24時間前にデータを転送する計画を立ててください。

#### カラムマッピング

Google Ad Managerは、カラムごとにデータソーステーブルを読み取り、以下のカラム名マッピングを使用して各行データを処理します。

- **cookie**: Google Ad ManagerがIDマッチングに使用する暗号化されたGoogle IDまたはモバイル広告識別子。このカラムには、ユーザーのCookieハッシュまたはモバイル識別子が含まれます。
- **list_name**: このカラムには、Google Ad Managerオーディエンスで作成するオーディエンスリスト（セグメント）の名前が含まれます。Google Ad Managerにリスト名が存在しない場合は、新しいリストが作成されます。リスト名が存在する場合は、既存のインベントリが更新されます。
- **timestamp**（オプション）: タイムスタンプ（EPOCHからの秒数）。このカラムが存在しないか欠落している場合、Google Display and Video 360側で自動的に追加されます。値に依存する場合は、カラムを明示的に指定することを強く推奨します。
- **delete**（オプション）: このカラムには、指定されたオーディエンスセグメントにCookieを追加するか削除するかを示すブール値（*false*または*true*）または数値（*0*または*1*）が含まれます。値が空白のままになっているか、カラムが提供されていない場合、デフォルトでは値はfalseになります。
- **process_consent（EU地域では必須）:** このカラムには文字列値（*false*または*true*）が含まれます。その他の値は空の文字列に変換されます。空の文字列を推奨します。詳細については、https://support.google.com/admanager/answer/4349785?hl=en をご覧ください。


#### ソースカラム名マッピングの定義（オプション）

1. Google Ad Managerのカラム名とクエリで指定する出力カラム名の間のマッピングを定義します。
2. ターゲットカラムを指定します。
3. ソースカラムを指定します。


たとえば、google_cookieがTDデータソースの識別子カラムである場合、マッピングをcookie:google_cookieとして定義する必要があります。マッピングのソースカラムが欠落している場合は、ターゲットカラム名が使用されます。たとえば、cookieはcookie:cookieマッピングと同じです。

### インテグレーションパラメータ

![](/assets/google-ad-manager-via-audience-partner-api-export-integration-2024-01-23.bb65569776e0115234eeaabc8903a0f8cecdf934d5b12ec325a164784fab5a3f.3cdd588e.png)

#### Cookieまたはモバイル識別子カラムヘッダー

ユーザーCookieまたはモバイル識別子のソースを指定します。

以下のオプションのいずれかを選択する必要があります。

- **cookie_encrypted**: 暗号化された識別子（例: Web）、user-idのCookieハッシュ
- **cookie_idfa**: iOS広告識別子
- **cookie_adid**: Android広告識別子
- **cookie_epid:** Cookie外部提供ID
- **ppid**: パブリッシャー提供識別子


**PPID（パブリッシャー提供識別子）は、Google Ad Manager 360でのみ利用可能です**。

### クエリ例


```sql
SELECT
  DISTINCT "cookie", "list_name", "time", "process_consent"
FROM
  "google_dfp_ddp"
```

### (オプション) 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)をご覧ください。