# The Trade Desk Import Integration

世界をリードする独立系デマンドサイドプラットフォームで、あらゆる場所のオーディエンスにリーチします。

The Trade DeskからAdvertiser、Campaign、Data Group、Tracking TagsをTreasure Dataにインポートできます。

世界中のどこからでも、世界中のオーディエンスに広告を配信できます。

## 前提条件

- [TD Toolbelt](https://toolbelt.treasuredata.com/)を含むTreasure Dataの基本的な知識
- The Trade Deskログインアカウント
- 承認されたTreasure アカウントアクセス


## Treasure コンソールを使用して接続を作成する

### 新しい接続を作成する

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

1. **Treasure コンソール**を開きます。
2. **Integrations Hub** > **Catalog**に移動します。
3. **Trade Desk Input**を検索して選択します。


![](/assets/image2021-4-29_13-44-51.0b81d7494a9e91e0cb8e1e817784f1c5e19038ad513b39fe7c01bc2344782aeb.2c0cc023.png)

1. Trade DeskのAPIエンドポイントのユーザー名とAPIエンドポイントのパスワードを入力します。その情報はThe Trade Deskチームから入手できます。[https://api.thetradedesk.com/v3/portal/api/doc/Authentication](https://api.thetradedesk.com/v3/portal/api/doc/Authentication) > Account Managerから提供されるプラットフォームAPI認証情報。


![](/assets/image2021-4-29_13-46-20.ff1ab8143d8cd62a80c88d27dbba9cc12eae61ced937995c96a799730b95bbd4.2c0cc023.png)

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


### データをTreasure Dataに転送する

認証された接続を作成すると、自動的にAuthenticationsに移動します。

インポートするデータを指定します：

- Advertiser
- Campaign
- Data Group
- Tracking Tags


1. 作成した接続を検索します。
2. **New Source**を選択します。
3. Data Transfer フィールドに**Source**の名前を入力します。


**Next**を選択します。

Source Tableダイアログが開きます。![](/assets/image2021-4-29_14-6-14.a84ae510ce6d0b245d7b711b9aa47fa13513e232bb48636f8c47913a147beec0.2c0cc023.png)

次のパラメータを編集します：

| Data Type | Additional Parameter | Description |
|  --- | --- | --- |
| Advertiser |  |  |
| Campaign | Advertiser ID | Advertiser IDはThe Trade Deskダッシュボードから入手でき、Account ManagerがAdvertiser Secret Keyを提供できます。 |
| Data Group | Advertiser ID | Advertiser IDはThe Trade Deskダッシュボードから入手でき、Account ManagerがAdvertiser Secret Keyを提供できます。 |
| Tracking Tags | Advertiser ID | Advertiser IDはThe Trade Deskダッシュボードから入手でき、Account ManagerがAdvertiser Secret Keyを提供できます。 |


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


Data Settingsページは必要に応じて変更できます。またはこのページをスキップできます。

![](/assets/image2021-4-29_15-7-3.894147f52008fb3cbed31314a7aefb185f28e53503eec33d6ee22035bb4c0bcb.2c0cc023.png)

1. 必要に応じて、次のパラメータを編集します：


| Parameter | Description |
|  --- | --- |
| Max retry count per API Call | API呼び出しごとの最大再試行回数 |
| Initial retry interval per API call | API呼び出しごとの初期再試行間隔（ミリ秒） |
| Max retry interval per API call | API呼び出しごとの最大再試行間隔（ミリ秒） |


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


### Data Preview

インポートを実行する前に、Generate Preview を選択してデータの[プレビュー](/products/customer-data-platform/integration-hub/batch/import/previewing-your-source-data)を表示できます。Data preview はオプションであり、選択した場合はダイアログの次のページに安全にスキップできます。

1. **Next** を選択します。Data Preview ページが開きます。
2. データをプレビューする場合は、**Generate Preview** を選択します。
3. データを確認します。


### Data Placement

データの配置について、データを配置したいターゲット database と table を選択し、インポートを実行する頻度を指定します。

1. **Next** を選択します。Storage の下で、インポートされたデータを配置する新しい database を作成するか、既存の database を選択し、新しい table を作成するか、既存の table を選択します。
2. **Database** を選択 > **Select an existing** または **Create New Database** を選択します。
3. オプションで、database 名を入力します。
4. **Table** を選択 > **Select an existing** または **Create New Table** を選択します。
5. オプションで、table 名を入力します。
6. データをインポートする方法を選択します。
  - **Append** (デフォルト) - データインポートの結果は table に追加されます。
table が存在しない場合は作成されます。
  - **Always Replace** - 既存の table の全体の内容をクエリの結果出力で置き換えます。table が存在しない場合は、新しい table が作成されます。
  - **Replace on New Data** - 新しいデータがある場合のみ、既存の table の全体の内容をクエリの結果出力で置き換えます。
7. **Timestamp-based Partition Key** 列を選択します。
デフォルトキーとは異なるパーティションキーシードを設定したい場合は、long または timestamp 列をパーティショニング時刻として指定できます。デフォルトの時刻列として、add_time フィルターで upload_time を使用します。
8. データストレージの **Timezone** を選択します。
9. **Schedule** の下で、このクエリを実行するタイミングと頻度を選択できます。


#### 一度だけ実行

1. **Off** を選択します。
2. **Scheduling Timezone** を選択します。
3. **Create & Run Now** を選択します。


#### 定期的に繰り返す

1. **On** を選択します。
2. **Schedule** を選択します。UI では、*@hourly*、*@daily*、*@monthly*、またはカスタム *cron* の 4 つのオプションが提供されます。
3. **Delay Transfer** を選択して、実行時間の遅延を追加することもできます。
4. **Scheduling Timezone** を選択します。
5. **Create & Run Now** を選択します。


転送が実行された後、**Data Workbench** > **Databases** で転送の結果を確認できます。