# Dotdigital Export Integration CLI

ジョブ結果をTreasure DataからDotdigital Marketing Solutionサービスへ直接エクスポートできます。

## 前提条件

- Treasure Dataの基礎知識
- Dotdigital Unified Contactsの基礎知識


## コマンドラインからの接続作成

CLIを使用して接続を設定できます。


```
td query --database your_database --result configuration query
```

以下の表は、設定キーとその説明を示しています。

| Config Key | Type | Required | Description |
|  --- | --- | --- | --- |
| type | string | Yes | エクスポートタイプ: dotdigital |
| region
 | string
 | Yes
 | 利用可能なリージョン:
- ヨーロッパ: r1
- 北米: r2
- アジア太平洋: r3

サイト: https://{region}-api.dotdigital.com
 |
| username | string | Yes | APIユーザー |
| password | string | Yes | APIパスワード |
| mode | string | Yes | エクスポートモード。サポートされる値:- transactional_email
- bulk_contacts
- unified_contacts

 |
| unified_cts_export_operation | string | No | サポートされる値:- upload (デフォルト)
- delete

 |
| unified_cts_merge_option | string | No | サポートされる値:- overwrite (デフォルト)
- overwriteIfEmpty
- overwriteIfNotEmpty

 |
| unified_cts_add_to_list | string | No | サポートされる値:- false (デフォルト)
- true

 |
| unified_cts_list_identifier_mode | string | No | サポートされる値:- id (デフォルト)
- name

 |
| unified_cts_list_id | string | No | コンタクトが割り当てられるリストID。unified_cts_list_identifier_mode = id の場合に必須 |
| unified_cts_list_name | string | No | コンタクトが割り当てられるリスト名。unified_cts_list_identifier_mode = name の場合に必須 |
| unified_cts_create_when_not_found | string | No | サポートされる値:- false (デフォルト)
- true

 |
| unified_cts_new_list_visibility | string | No | サポートされる値:- private (デフォルト)
- public

 |
| ignore_invalid_records | boolean | No | trueに設定すると、無効なレコードをスキップして有効なレコードのアップロードを続行します。false (デフォルト) に設定すると、無効なレコードが検出された際にジョブを終了します。 |


**Unified Contactsをエクスポートするクエリ例: リストにコンタクトを追加しない場合**


```bash
td query --database my_db \
--query 'SELECT match_identifier, contact_id, email, mobile_number, channel_properties, consent_records, firstname, lastname FROM your_table' \
--type presto \
--result '{
  "type":"dotdigital",
  "region":"r1",
  "username":"{api user}",
  "password":"{api password}",
  "mode":"unified_contacts",
  "unified_cts_export_operation":"upload",
  "unified_cts_merge_option":"overwrite",
  "unified_cts_add_to_list":false,
  "ignore_invalid_records":true
}'
```

**Unified Contactsをエクスポートするクエリ例: リストにコンタクトを追加する場合**


```bash
td query --database my_db \
--query 'SELECT match_identifier, contact_id, email, mobile_number, channel_properties, consent_records, firstname, lastname FROM your_table' \
--type presto \
--result '{
  "type":"dotdigital",
  "region":"r1",
  "username":"{api user}",
  "password":"{api password}",
  "mode":"unified_contacts",
  "unified_cts_export_operation":"upload",
  "unified_cts_merge_option":"overwrite",
  "unified_cts_add_to_list":true,
  "unified_cts_list_identifier_mode":"id",
  "unified_cts_list_id":"{list id}",
  "ignore_invalid_records":true
}'
```

**Unified Contactsを削除するクエリ例**


```bash
td query -d database -w \
--query 'SELECT match_identifier, contact_id, email, mobile_number FROM your_table' \
--type presto \
--result '{
  "type":"dotdigital",
  "region":"r1",
  "username":"{api user}",
  "password":"{api password}",
  "mode":"unified_contacts",
  "unified_cts_export_operation":"delete",
  "ignore_invalid_records":true
}'
```

## 関連項目

- [CLIからのData Connectorジョブ実行のスケジュール設定](/ja/int/scheduling-a-data-connector-job-execution-from-the-cli)