# Google Ads Via Audience Partner Api Export Integration

**DMP Activationに関する通知**  Google Display AdsのDMP activationは一時停止されています。Googleはこの機能に関する新規アカウントのホワイトリスト登録を停止しており、そのため新規アカウントは利用できません。つまり、新規顧客はこのコネクタをリターゲティングに使用できません。Googleの変更は、既にホワイトリストに登録されているアカウントには影響しません。既存のアカウントは引き続きこの機能を使用できます。現在このコネクタを使用している顧客は、Googleが完全にサポートを終了するまで、引き続きこのコネクタを使用できます。

**コネクタ名称変更に関する通知**  GoogleはGoogle AdWordsをGoogle Adsにリブランディングし、DoubleClickはGoogle Ad Managerに統合されました。そのため、このコネクタはGoogle AdWords on the Doubleclick Data PlatformからGoogle Ads via Audience Partner APIに名称変更されました。この名称変更は、GoogleがGoogle AdWordsをGoogle Adsにリブランディングした後に行われました。

[Google Ads](https://adwords.google.com/)を使用してマーケティングキャンペーンを実行する際に、Treasure Dataのデータを活用できます。

Treasure Dataに保持されているデータを使用して、Google Ads - DFPでオーディエンスリストを作成できます。次の手順に従って、Cookie、IDFA、ADIDを新規または既存のGoogle Ads内のオーディエンスリストに移動します。

以下のトピックに進んでください:

## Prerequisites

- Treasure Dataの基礎知識（[TD Toolbelt](https://toolbelt.treasuredata.com/)を含む）
- Google Adsアカウント
- Google AdsアカウントへのTreasure Data DMPアクセスの承認


## Limitations from Google Ads

オーディエンスリストの更新がGoogle Adsに表示されるまでに、最大24時間かかる場合があります。クエリ完了時点から変更がGoogle Adsに反映されるまで、最大24時間待つ必要があります。

## Grant Access for Treasure Data

Treasure Data Google Ads via Audience Partner APIコネクタには、Google Adsアカウントでオーディエンスセグメントを作成するための権限が必要です。Treasure DataにGoogle Adsアカウントへのアクセスを許可するため、Google Ads Supportにメールを送信してください。メールには以下の情報を記載してください:

- Request: Treasure Dataに権限を付与
- Treasure Data DMP:
  - Customer-ID: **140-996-0635**
  - NID: **treasuredata_dmp**


この情報を送信することで、GoogleがTreasure Dataを認識し、TDアカウントとGoogle Adsアカウントを関連付けます。

## Usage

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

### Create or Reuse a Query

- Query Editorに移動します。クエリ言語を選択してクエリを記述できます。
- データベースとテーブルを選択します。
- データのエクスポートに使用する予定のクエリにアクセスします。以下はサンプルクエリです:



```SQL
SELECT DISTINCT "cookie", "list_name", "time", "process_consent" FROM "google_adwords_ddp"
```

### Create or Select an Existing Google Ads via Audience Partner API Connection

| **Option** | **Task Steps** | **Tip** |
|  --- | --- | --- |
| コネクタを作成 | Integrations Hub > Catalogに移動し、*Google Ads via Audience Partner API*を検索して選択します。 - 最初のペインで必須フィールドを入力します。 - *AdWords Customer ID*フィールドに、Google Adsで使用するIDを入力します。 Configurationフィールドを入力します。 | クエリを記述する前に、列マッピングを定義する必要がある場合があります。 |
| コネクタを選択 | - TD Consoleに移動します。 - Query Editorに移動します。 - データのエクスポートに使用する予定のクエリにアクセスします。 - *Output results*をクリックします。*Choose Saved Connection*ダイアログが開きます。 - 検索ボックスに接続名を入力してフィルタリングし、使用したい接続をクリックします。 Configurationフィールドを入力します。 | *Create New Connection*をクリックすることで、ここから新しい接続を作成することもできます。 |


新しい接続の作成:

![](/assets/image-20191203-212718.5d8d983e34449f8c976ff5e163738974e24f821ae0a7660071c8a9715020e817.23feced5.png)

既存の接続の選択:

![](/assets/image-20191203-212729.cd5567ef5c47fdb8637df84b328589ddcb2eb49f46420e026ad2c7c88bc93ed1.23feced5.png)

### Configure the Connection by Specifying the Parameters

*Google Ads via Audience Partner API*接続を選択すると、*Configuration*ダイアログペインが表示されます:

![](/assets/google-ads-via-audience-partner-api-export-integration-2024-02-10.c4fa89c0d0b65e6011e309859a8a841d19c94555ab750fd4622f706c1bdf0f19.23feced5.png)

Google APIからの移行により、*Use Audience Partner APIs*オプションを選択することを推奨します。

#### Source Column Name Mappings (Optional)

Google DDP列名とクエリで指定した出力列名の間のマッピングを定義します。ターゲット列を選択してから、ソース列を選択します。例えば、*google_cookie*がTDデータソースの識別子列である場合、マッピングを*cookie:google_cookie*として定義する必要があります。マッピングにソース列が欠落している場合は、ターゲット列名が使用されます。例えば、*cookie*は*cookie:cookie*マッピングと同じです。

サポートされている列名と使用方法の詳細については、[追加のコネクタ設定情報](https://docs.treasuredata.com/smart/project-product-documentation/naming-requirements-and-restrictions-for-treasure-data-entities)を参照してください。

### Cookie or Mobile Identifier Column Header

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

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

- **cookie_encrypted** : 暗号化された識別子（例: Web）、ユーザーIDのCookieハッシュ
- **cookie_idfa** : iOS Advertising Identifier
- **cookie_adid** : Android Advertising Identifier
- **cookie_epid** Cookie externally provided id


識別子名の処理方法の詳細については、[追加のコネクタ設定情報](http://docs.treasuredata.com/pages/viewpage.action?pageId=329142#GoogleAdWordsontheDoubleclickDataPlatformExportIntegration(Deprecated)-AdditionalConnectorConfigurationInformation)を参照してください。

### (オプション) 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 を有効にすることで、クエリの開始時刻を遅延させることができます。

クエリに名前を付けて保存してから実行するか、そのまま実行します。クエリが正常に完了すると、結果は自動的に処理されます。オーディエンスリスト（セグメントとも呼ばれる）がGoogle Adsに反映されるように、少なくとも24時間前にデータを転送するように計画してください。

## 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) を参照してください。

## Additional Connector Configuration Information

TreasureDataからのデータをGoogleがどのように処理するかは、コネクタの設定方法に影響します。

### Column Mappings

Google Ads via Audience Partner APIは、列ごとにデータソーステーブルを読み取り、以下の列名マッピングを使用して各行データを処理します:

| Column Name | Description |
|  --- | --- |
| **cookie** | DDPは暗号化されたGoogle IDまたはMobile Advertising IdentifierをIDマッチングに使用します。この列には、ユーザーのCookieハッシュまたはモバイル識別子が含まれます。 |
| **list_name** | この列には、Google Adsオーディエンスで作成したいオーディエンスリスト（セグメント）の名前が含まれます。リスト名がGoogle Adsに存在しない場合は、新しいリストが作成されます。リスト名が存在する場合は、既存のリストが更新されます。 |
| **timestamp (optional)** | タイムスタンプ（EPOCHからの秒数）。この列が存在しないか欠落している場合は、現在のタイムスタンプが使用されます。 |
| **delete (optional)** | この列にはブール値（falseまたはtrue）または数値（0または1）が含まれ、指定されたオーディエンスセグメントからCookieを追加するか削除するかを示します。デフォルトでは、値が空白のままになっている場合、または列が提供されていない場合、値はfalseになります。 |
| **process_consent (required for EU region)** | この列には文字列値（*false*または*true*）が含まれます。その他の値は空の文字列に変換されます。空の文字列を推奨します。詳細については、https://support.google.com/admanager/answer/4349785?hl=enを参照してください。 |


## Cookie or Mobile Identifier Name

アップロードプロセスは複数の異なる識別子をサポートしており、これらの識別子が正しいアップロードファイル形式を使用してセグメントにアップロードされることが重要です。一般的に、識別子は2つのカテゴリのいずれかに分類されます: 暗号化された識別子（Googleシステムから取得されたもの）と生の識別子（外部システムまたはソースから取得されたもの）。暗号化された識別子は*cookie_encrypted*または*cookie_epid*ファイル形式を使用してアップロードされ、生の識別子はMobile Advertising Identifierなどの型固有のアップロードファイル形式（例: *cookie_idfa*または*cookie_adid*）でアップロードされます。

サポートされているCookieタイプは、*cookie_encrypted、cookie_epid*、*cookie_idfa*、および*cookie_adid*です。