# Dotdigital Import Integration

Dotdigital Engagement Cloudは、電子メール、SMS、ソーシャルメディア、プッシュ通知などのチャネルを通じてデータトリガー型キャンペーンを送信するためのオムニチャネルマーケティングソリューションです。Dotdigitalからのデータを直接Treasure Dataにインポートすることができます。

## 前提条件

- [TD Toolbelt](https://toolbelt.treasuredata.com/)を含むTreasure Dataの基本知識。
- Dotdigitalのアカウント。
- DotdigitalのAPIアカウント。


## APIアカウントの取得

1. DotDigitalにログインします。[https://login.dotdigital.com/login.aspx?ReturnUrl=/](https://login.dotdigital.com/login.aspx?ReturnUrl=/)に移動します。
2. [https://r1-app.dotdigital.com/access/api](https://r1-app.dotdigital.com/access/api)に移動し、**API users**タブに移動します。


![](/assets/screen-shot-2020-08-25-at-9.59.48-pm.ab8ae1140f18c142aa9706cd87d4c0926610da1d2c6422b78d310ac782d5b7ec.3a5b66e1.png)
3. **New user**を選択します。DotDigitalがメールアドレスを提供します。パスワードを追加して確認してフォームを完成させます。説明はオプションです。

![](/assets/screen-shot-2020-08-25-at-10.04.11-pm.c5b80b12d82e096dd55327a4ed2cdc22f47867d8679a81211ed4aec33d81432e.3a5b66e1.png)
4. **Save**を選択します。

## Treasure コンソールによるDotdigitalからのインポート

### Treasure コンソールで新しい接続を作成する

データ接続を構成する際、統合にアクセスするための認証を提供します。Treasure Dataでは、認証を構成し、ソース情報を指定します。

1. Treasure コンソールを開きます。
2. **Integrations Hub > Catalog**に移動します。
3. カタログ画面の右端にある検索アイコンを選択し、**dotdigital**と入力します。
4. dotdigitalコネクタにカーソルを合わせ、**Create Authentication**を選択します。


新しい認証ダイアログが開きます。

![](/assets/screen-shot-2020-09-15-at-4.22.13-pm.4c757f85087d3a4b4b60f7ee08ef5115ae43cf499b1649292ae00cb05197cbd0.3a5b66e1.png)

1. 地域を選択します。API User NameとAPI User Passwordフィールドが自動入力されます。
2. **Continue**を選択します。
3. 接続の名前を入力します。
4. **Done**を選択します。


### DotdigitalアカウントデータをTreasure Dataに転送する

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

1. 作成した接続を検索します。
2. **New Source**を選択します。
3. **Data Transfer Name**フィールドにソースの名前を入力します。
4. **Next**を選択します。Source Tableダイアログが開きます。


### ソーステーブルを作成する

![](/assets/dotdigital-import-integration-2024-10-29-2.0f7b25496146fe194946fd28102dde31b93aa2d08b4390a0849e445c39876b62.3a5b66e1.png)

目的に基づいてSource Tableのパラメータを編集します。

| パラメータ | 説明 |
|  --- | --- |
| Data Type | - **All Campaigns Since Date**。キャンペーンデータを取得します。
- **Contacts - Since Date**。連絡先データを取得します。
- **Contacts - Address Book**。アドレス帳から連絡先を取得します。

 |
| Statistics Type
 | **All Campaigns - Since Date**
- **Activities Since Date**。特定の日付に基づいてキャンペーンアクティビティを取得します。
- **Clicks Since Date**。特定の日付に基づいてキャンペーンクリックを取得します。
- **Open Since Date**。特定の日付に基づいて開封されたキャンペーンを取得します。
- **Page Views Since Date**。特定の日付に基づいてキャンペーンのページビューを取得します。
- **ROI Activity Since Date**。特定の日付に基づいてキャンペーンのROIアクティビティを取得します。

**Contacts - Since Date**
- **Created Since Date**。特定の日付に基づいて作成された連絡先を取得します。
- **Modified Since Date**。特定の日付に基づいて変更された連絡先を取得します。
- **Suppressed Since Date**。特定の日付に基づいて抑制された連絡先を取得します。
- **Unsubscribed Since Date**。特定の日付に基づいて配信停止された連絡先を取得します。
- **Unsubscribed from Address Book Since Date**。特定の日付に基づいてアドレス帳から配信停止された連絡先を取得します。

**Contacts - Address Book**
- **All**。1つ以上のアドレス帳から現在のすべての連絡先を取得します。
- **Modified Since Date**。1つ以上のアドレス帳から特定の日付以降に変更されたすべての連絡先を取得します。
- **Unsubscribed Since Date**。1つ以上のアドレス帳から特定の日付以降に配信停止されたすべての連絡先を取得します。

 |
| **Number of Records Per Page** | Dotdigital APIからデータを取得する際のページサイズ。デフォルト1000、最小1、最大2000 |
| **Start Time** (必須) | RFC3339 UTC "Zulu"形式のタイムスタンプで、ナノ秒まで正確です。例：`"2014-10-02T15:01:23Z"` |
| **Address Book Id List (オプション)** | 連絡先を取り込むアドレス帳のみをフィルタリングするための、カンマ区切りのアドレス帳IDリスト |
| **Address Book Name Filter (オプション)** | 連絡先を取り込むアドレス帳のみをフィルタリングするための正規表現文字列 |
| **Address Book Visibility** | 次の中から選択します：- **All**。すべてのアドレス帳から読み取ります。
- **Public**。公開アドレス帳からのみ読み取ります。
- **Private**。非公開アドレス帳からのみ読み取ります。

 |
| **With Full Data** | 連絡先レコードからすべてのdataFieldsを読み込むには、このオプションを有効にします。 |
| **Incremental Loading** | 新しいStart Timeの自動計算によるインクリメンタルレポート読み込みを有効にします。例えば、**Start Time** = `2014-10-02T15:01:23Z`から`2014-10-03T15:01:23Z`でインクリメンタル読み込みを開始した場合、次のジョブ実行時の新しい**Start Time**は`2014-10-03T15:01:23`になります。 |
| **Skip Filter By Incremental Field**
 | falseの場合、コネクタはDotDigital APIを取得した後に追加のフィルタリングを実行します：
- **All Campaigns - Since Date**: インクリメンタル列でフィルタリング
- **Contacts - Since Date**: インクリメンタル列でフィルタリング
- **Contacts - Address Book**: インクリメンタルがfalseの場合、インクリメンタル列でフィルタリング

trueの場合、コネクタはこの追加フィルタリングを無効にします。
 |


1. **Next**を選択します。Data Settings画面が開きます。


### データ設定の定義（オプション）

データ設定を編集するか、このセクションをスキップします。

![](/assets/screen-shot-2020-09-15-at-5.03.10-pm.c5a287eb59de65e1704ca874753e77593ae8dbcaa10150376ae7619edf4d17a4.3a5b66e1.png)

### データのプレビュー（オプション）

データプレビューはオプションです。ダイアログの次のセクションにスキップできます。

データプレビューに表示されるデータはソースから近似されたものであり、インポートされる実際のデータではありません。

1. **Next**を選択します。
2. データをプレビューするには、**Generate Preview**を選択します。オプションで、**Next**を選択して次のセクションにスキップすることもできます。
3. データが期待通りであることを確認します。


![](/assets/screen-shot-2020-09-15-at-5.04.37-pm.6a485701082937975eb1472a444d3f1e324dc2084a55d62f77669a766b3a8f0e.3a5b66e1.png)
4. **Next**を選択します。

### データ配置の定義

データの配置場所を指定し、このインポートを実行する頻度をスケジュールします。

![](/assets/image-20200615-153436.ab0982b2e01dc0eaff9b732ea3686b98771af3b92b56da23db3d0243df2d9525.3a5b66e1.png)

**Schedule**セクションでは、このクエリをいつ、どのくらいの頻度で実行するかを選択できます。

1回だけ実行する場合：

- **Off**を選択します。
- **Scheduling Timezone**を選択します。
- **Create & Run Now**を選択します。


クエリを繰り返す場合：

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


転送が完了すると、**Data Workbench** > **Databases**で転送結果を確認できます。