Skip to content
/
Dotdigital Export Integra...
Last updated

Dotdigital Export Integration CLI

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

前提条件

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

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

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

td query --database your_database --result configuration query

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

Config KeyTypeRequiredDescription
typestringYesエクスポートタイプ: dotdigital

region

string

Yes

利用可能なリージョン:

  • ヨーロッパ: r1
  • 北米: r2
  • アジア太平洋: r3

サイト: https://{region}-api.dotdigital.com

usernamestringYesAPIユーザー
passwordstringYesAPIパスワード
modestringYesエクスポートモード。サポートされる値:
  • transactional_email
  • bulk_contacts
  • unified_contacts
unified_cts_export_operationstringNoサポートされる値:
  • upload (デフォルト)
  • delete
unified_cts_merge_optionstringNoサポートされる値:
  • overwrite (デフォルト)
  • overwriteIfEmpty
  • overwriteIfNotEmpty
unified_cts_add_to_liststringNoサポートされる値:
  • false (デフォルト)
  • true
unified_cts_list_identifier_modestringNoサポートされる値:
  • id (デフォルト)
  • name
unified_cts_list_idstringNoコンタクトが割り当てられるリストID。unified_cts_list_identifier_mode = id の場合に必須
unified_cts_list_namestringNoコンタクトが割り当てられるリスト名。unified_cts_list_identifier_mode = name の場合に必須
unified_cts_create_when_not_foundstringNoサポートされる値:
  • false (デフォルト)
  • true
unified_cts_new_list_visibilitystringNoサポートされる値:
  • private (デフォルト)
  • public
ignore_invalid_recordsbooleanNotrueに設定すると、無効なレコードをスキップして有効なレコードのアップロードを続行します。false (デフォルト) に設定すると、無効なレコードが検出された際にジョブを終了します。

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

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をエクスポートするクエリ例: リストにコンタクトを追加する場合

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を削除するクエリ例

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
}'

関連項目

Previous page
Next page