# Customer.io Export Integration

Customer.io Export Connector を使用すると、Treasure Data CDP のクエリ結果を Customer.io にプッシュして、各ワークフロー実行後にプロファイルとセグメントを同期し続けることができます。手動エクスポートステップなしで、高価値セグメントや行動属性などの CDP 統合カスタマーデータを Customer.io キャンペーンでアクティブ化する必要がある場合に使用します。このコネクターは、Tracking V2 API を介してプロファイルのアップサートおよび削除操作をサポートし、自動セグメント作成機能付きでセグメントからのカスタマーの追加または削除が可能です。

- **プロファイル操作** - Tracking V2 API を通じてカスタマープロファイルの作成、更新、または削除。
- **セグメント管理** - 自動セグメント作成機能付きでセグメントからのカスタマーの追加または削除。
- **複数の識別子** - カスタマー識別子として `id`、`cio_id`、`email` をサポート。
- **自動リージョン解決** - Customer.io の Track Region API による動的エンドポイント検出。
- **バッチ処理** - 設定可能なエラーハンドリングによる効率的な一括操作。


## 前提条件

- Treasure AI の基礎知識
- API アクセス付きの Customer.io アカウント
- 有効な Customer.io App API Key、Site ID、および API Key
- 認証済みの Treasure AI アカウントアクセス


## 要件、制限事項、および動作

- 各レコードには少なくとも1つの識別子（`cio_id`、`id`、または `email`）が必要です
- 識別子として `email` を使用するには、Customer.io ワークスペース設定でメール識別を有効にする必要があります
- `cio_relationships` フィールドは属性マッピングから自動的に除外されます
- セグメント操作を使用する場合、存在しないセグメントは自動的に作成されます
- Customer.io はレート制限を実装しています。コネクターは指数バックオフによる再試行を処理します


## Treasure Data Integration の静的 IP アドレス

セキュリティポリシーで IP ホワイトリストが必要な場合は、接続を成功させるために Treasure Data の IP アドレスを許可リストに追加する必要があります。

リージョンごとに整理された静的 IP アドレスの完全なリストは、次のリンクにあります:
[IP Addresses for Integrations](/apis/endpoints/ip-addresses-integrations-result-workers)

## Treasure Console を使用して接続を作成する

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

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

1. **Treasure Console** を開きます。
2. **Integrations Hub** > **Catalog** に移動します。
![Hub Catalog](/assets/integrations-hub-catalog.39c5b3552b09bdc6ec9cfa10bc5f1c221f3ae989c21f29dea2c3dbf851975ff9.6e125f75.webp)
3. **Customer.io** を検索して選択します。**Create Authentication** を選択します。
![Authentication](/assets/create-authentication.8cd86a9f23ac421ee5793d859638d670461231b0eb0256b4945cf364a2a039d8.6e125f75.webp)
4. 次のダイアログが開きます。パラメータを編集します。**続行** を選択します。


| パラメータ | 説明 |
|  --- | --- |
| **App API Key** | Customer.io App API Key（必須）。セグメント管理操作に使用されます。Customer.io アカウントの API クレデンシャルセクションから生成します。 |
| **Site ID** | Customer.io Site ID（必須）。Tracking API 認証のユーザー名として使用されます。Customer.io ワークスペース設定で確認できます。 |
| **API Key** | Customer.io API Key（必須）。Tracking API 認証のパスワードとして使用されます。Customer.io アカウントの API クレデンシャルセクションから生成します。 |


1. 接続の名前を入力します。
2. 認証を他のユーザーと共有するかどうかを選択します。
3. **完了** を選択します。


### データ接続でのエクスポート結果の設定

このステップでは、クエリを作成または再利用します。クエリで、データ接続を設定します。

### パラメータを指定して接続を設定する

1. Treasure Console を開きます。
2. **Data Workbench** > **Queries** に移動します。
3. データをエクスポートするために使用する予定のクエリを選択します。
4. クエリエディターの上部にある **Export Results** を選択します。Choose Integration ダイアログが開きます。


結果をエクスポートするために使用する接続を選択する場合、既存の接続を使用するか新しい接続を作成するかの2つのオプションがあります。

#### 既存の接続を使用する

1. 検索ボックスに接続名を入力してフィルタリングします。
2. 接続を選択します。
3. Export Results ダイアログが開きます。
4. 以下のパラメータを設定して **Done** を選択します。


![Export Result Config](/assets/export_result_config.f78338c84a920bf6cb057c3d70d9f57014eb1942bfbb2ba6c931220e573fe377.6e125f75.webp)

| **パラメータ** | **説明** |
|  --- | --- |
| **データタイプ** | ターゲットデータタイプ：`PROFILES`（プロファイル操作）または `SEGMENTS`（セグメントメンバーシップ操作） |
| **操作モード（プロファイル）** | プロファイル操作モード：`UPSERT`（作成/更新）または `REMOVE`（削除）。データタイプが `PROFILES` の場合のみ使用 |
| **操作モード（セグメント）** | セグメント操作モード：`ADD`（セグメントに追加）または `REMOVE`（セグメントから削除）。データタイプが `SEGMENTS` の場合のみ使用 |
| **セグメント名** | ターゲットセグメント名（データタイプが `SEGMENTS` の場合必須）。存在しない場合、セグメントが作成されます |
| **ID タイプ** | 識別子のタイプ：`id`、`cio_id`、または `email`。注：`email` を使用するには、Customer.io ワークスペース設定でメール識別を有効にする必要があります |
| **無効なレコードをスキップ** | ジョブを中止する代わりに、検証に失敗したレコードをスキップします |
| **エラーバッチをスキップ** | ジョブを失敗させる代わりに、API バッチエラー時に処理を続行します |


#### 新しい Customer.io 接続を作成する

1. **New Integration** を選択し、**Type** ドロップダウンから Customer.io を選択します。
2. Create Integration ダイアログが開きます。
3. **Catalog** リンクを選択して Catalog ページに移動します。
4. 前述の「新しい接続を作成する」で説明されている手順を完了します。
5. 新しい Customer.io 接続に必要なクレデンシャルを入力します。


## クエリの列名

Customer.io エクスポートコネクターは、以下の列とデータタイプを理解し、解釈します。以下の指定された列に一致するようにエイリアス列名を変更する必要があります。

データには少なくとも1つの識別子（`cio_id`、`id`、または `email`）が含まれている必要があります。

以下の表は、Customer.io エクスポート Integration で使用可能な列について説明しています：

| 列名 | タイプ | 必須 | 説明 |
|  --- | --- | --- | --- |
| `cio_id` | `string` | `条件付き` | Customer.io 内部 ID（最高優先度識別子）。最も信頼性の高いマッチングのために利用可能な場合に使用されます。 |
| `id` | `string` | `条件付き` | 外部カスタマー ID（中優先度）。`cio_id` が利用できない場合に使用されます。 |
| `email` | `string` | `条件付き` | カスタマーメールアドレス（最低優先度）。`cio_id` も `id` も利用できない場合に使用されます。Customer.io ワークスペース設定でメール識別を有効にする必要があります。 |
| その他の列 | `various` | `オプション` | Customer.io カスタマー属性に直接マップされるカスタム属性。`cio_relationships` フィールドは自動的に除外されます。 |


**識別子ロジック**: コネクターは `id_type` 設定パラメータで指定された識別子フィールドの存在を検証します。レコードが正常に処理されるためには、必要な識別子フィールドが含まれている必要があります。

## サンプルクエリ

### プロファイル操作

```sql
-- 'id' 識別子を使用したプロファイルアップサート
SELECT
  customer_id AS id,
  email_address AS email,
  first_name,
  last_name,
  signup_date,
  total_orders,
  lifetime_value
FROM customer_profiles
WHERE TD_TIME_RANGE(time, TD_DATE_TRUNC('day', TD_SCHEDULER_TIME() - 86400, 'UTC'), NULL)
```

### セグメント操作

```sql
-- セグメントへのカスタマー追加
SELECT
  customer_id AS id,
  email_address AS email,
  first_name,
  last_name
FROM high_value_segment
WHERE TD_TIME_RANGE(time, TD_DATE_TRUNC('day', TD_SCHEDULER_TIME() - 86400, 'UTC'), NULL)
```

### 異なる ID タイプの使用

```sql
-- Customer.io 内部 ID（cio_id）を使用
SELECT
  cio_customer_id AS cio_id,
  first_name,
  last_name,
  plan_type
FROM customer_profiles

-- 識別子としてメールを使用
SELECT
  email,
  first_name,
  last_name,
  subscription_status
FROM customer_profiles
```

### (オプション) Query Export ジョブをスケジュールする

Scheduled Jobs と Result Export を使用して、指定したターゲット宛先に出力結果を定期的に書き込むことができます。

Treasure Data のスケジューラー機能は、高可用性を実現するために定期的なクエリ実行をサポートしています。

2 つの仕様が競合するスケジュール仕様を提供する場合、より頻繁に実行するよう要求する仕様が優先され、もう一方のスケジュール仕様は無視されます。

例えば、cron スケジュールが `'0 0 1 * 1'` の場合、「月の日」の仕様と「週の曜日」が矛盾します。前者の仕様は毎月 1 日の午前 0 時 (00:00) に実行することを要求し、後者の仕様は毎週月曜日の午前 0 時 (00:00) に実行することを要求するためです。後者の仕様が優先されます。

#### Treasure コンソール を使用してジョブをスケジュールする

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.


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

div
| フィールド値  | 例  | 例の説明  |
|  --- | --- | --- |
| 各フィールドに対して上記で表示された制限内の単一の値。 |  |  |
| フィールドに基づく制限がないことを示すワイルドカード
`'*'`。 | `'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 を有効にすることで、クエリの開始時刻を遅延させることができます。