# Sailthru Export Integration Sailthruに様々なセグメントをアクティベートすることで、パーソナライズされたメールマーケティングキャンペーンを実施し、より良い顧客体験を提供できます。 Sailthruは、キャンペーン、トリガー、トランザクションメールを含む、すべてのマーケティングメールニーズを支えるマーケティングオートメーションソリューションです。Sailthru独自のアルゴリズムは、メール、ウェブサイト、モバイルアプリに対して個人レベルでパーソナライズできます。これらはすべて顧客プロファイルによって支えられています。500万人の異なる顧客に500万通の異なるメールを送信することを可能にします。レコメンデーションアルゴリズムは、製品、コンテンツ、割引、オファー、カスタマージャーニーのタッチポイント、さらにはメール獲得ポップアップもパーソナライズできます。 このIntegrationにより、マーケティングチームは次のことが可能になります: - セグメントからSailthruにユーザーリストを送信して、システム上で対応するマーケティングキャンペーンを準備し、それらのリストを自動的に同期し続けることができます。 - Sailthruから異なるプロファイルですべてのユーザー情報を更新し、様々なマーケティングキャンペーンを通じて顧客により良いパーソナライズされた体験を提供できます。 ## 前提条件 - Sailthruの基礎知識とSailthruアカウント - Treasure Dataの基礎知識 ## 制限事項 Sailthru APIには、いくつかの固有の制限があります: - カスタムフィールド(例: vars)の名前は[Sailthruの仕様](https://getstarted.sailthru.com/audience/managing-users/set-variables-on-users/)に準拠します。 - ユーザーのカスタムフィールドの最大数は1000です。([https://getstarted.sailthru.com/developers/api/user/#Error_Codes](https://getstarted.sailthru.com/developers/api/user/#Error_Codes)) - プライマリリストの最大数は50です。この上限に達した場合のエラーメッセージ: "*You may only track up to 50 primary lists*" - 合計リスト数(プライマリとセカンダリを含む)の最大数は2000です。この上限に達した場合のエラーメッセージ: "*Maximum list count reached: 2000*" - **Bulk User** exportモード(`target: bulk_user`)では、バッチに`lists`が含まれている場合(ソースデータの列または結果エクスポート設定のいずれかを通じて)、`signup_date`列は更新されません。 - `sms`キーはTreasure Dataによって完全にテストされていません。 - `signup_date`列はCESTタイムゾーンです。サポートされている形式の例については、[Sailthru API](https://getstarted.sailthru.com/developers/api)ドキュメントを参照してください。 ## TD Consoleを使用してConnectionを作成する ### API KeyとSecretを取得する 1. Sailthruにログインします。[https://my.sailthru.com/settings/api_postbacks](https://my.sailthru.com/settings/api_postbacks)に移動します。 2. **API Key and Secret**のロックアイコンを選択します。 ![](/assets/screen-shot-2020-05-22-at-19.16.16.8158820beae429a610c5fdc392c4fcf68609e93b998ef7c02c90f3346f553da1.d53d9105.png) 3. ダイアログが開き、API KeyとSecretが表示されます。これは新しいConnectionを作成するために必要です。 ![](/assets/api___postbacks.6e3d077bc106d28fcffb63f755b96f95f6c6439c4f241982f1233a3a1f939d8e.d53d9105.png) ### 新しいConnectionを作成する クエリを実行する前に、エクスポート時に使用するデータConnectionを作成して設定します。データConnectionの一部として、Integrationにアクセスするための認証情報を提供します。 1. **TD Console**を開きます。 2. **Integrations Hub** > **Catalog**に移動します。 3. **Sailthru**を検索して選択します。 4. **New Authentication**ダイアログが開きます。 ![](/assets/image-20200522-123609.fcf47dff319c859f344b3c23db4060a810bdbc583eead59d499241fe4fe54477.d53d9105.png) 5. API KeyとSecretを入力します。 6. Connectionの名前を入力します。 7. **Done**を選択します。 ### Sailthruのクエリ例 有効な結果データを持つクエリの例: **List** exportモードの場合: ``` SELECT 'my@email.com' as email; ``` **User**または**Bulk User** exportモードの場合: ``` SELECT 'my@email.com' as id, '012345' as sms, '123' as sid, 'My Name' as name, 'Mar 11' as dob; ``` ### Data Connectionでエクスポート結果を設定する クエリを作成または再利用します。クエリ内で、データConnectionを設定します。 **Listモードについて** Treasure DataからSailthruに顧客リストをエクスポートすると、対応するSailthruジョブがトリガーされます(データサイズによっては複数; 一般的には1GBごとに分割されます)。この非同期性により、TDジョブが完了してから、データがSailthruプラットフォームで表示されるまでに遅延が発生します。クエリの結果には`email`列が含まれている必要があります。 リストが存在する場合、Connectorは新しい情報(公開名、プライマリかどうかなど)で更新し、そのリストにさらにメールを追加します。リストが存在しない場合、Connectorは情報を使用して新しいリストを作成し、新しく作成されたリストにメールをアップロードします。 **Userモードについて** これは新しいユーザーを作成し、既存のユーザーを更新して、ユーザータイプのより多くの情報をエクスポートできるようにします。リクエストが行ごとに実行されるため、List Export Modeよりも遅くなります。このモードを使用すると、[Lifecycle events](https://getstarted.sailthru.com/lo/overview/)がトリガーされます。 クエリ結果には、以下の必須列が含まれている必要があります。 | **Column** | **Description** | **Type** | **Required** | | --- | --- | --- | --- | | `id` | 値はemail、sid、extid、またはsmsのいずれかです。この値は、ID Type設定パラメータの値に依存します。 | string | Required | | `optout_email` | "none"、"basic"、"all"、"blast"、またはNULLのいずれかです。 | string | Optional | | `lists` | Sailthru Listのカンマ区切りリスト。例については、`Lists`設定パラメータを参照してください。 | string | Optional | | `optout_templates` | Sailthru Optout Templatesのカンマ区切りリスト。有効な値の例については、Opt-out Templates設定パラメータを参照してください。 | string | Optional | KeysおよびVarsパラメータで指定された列はオプションです。 **Bulk Userモードについて** Userモードと同様に、Bulk Userモードは新しいユーザーを作成し、既存のユーザーを更新して、ユーザータイプのより多くの情報をエクスポートできるようにします。主な違いは、Lifecycle eventsをトリガーしないことです。Sailthru APIへの送信は、Listモードと同じ方法で、非同期バルクジョブによって行われます。 クエリ結果には、以下の列を含めることができます: | **Column** | **Description** | **Type** | **Required** | | --- | --- | --- | --- | | `id` | 値はemail、sid、extid、またはsmsのいずれかです。この値は、ID Type設定パラメータの値に依存します。 | string | Required | | `signup_date` | Sailthruで受け入れられる日付形式の文字列。例: "Jan 18, 2013"、"2016-07-01"。詳細については、Sailthru APIドキュメントを参照してください。 | string | Optional | | `optout` | "none"、"basic"、"all"、またはNULLのいずれかです。 | string | Optional | | `lists` | Sailthru Listのカンマ区切りリスト。有効な値の例については、Lists設定パラメータも参照してください。 | string | Optional | KeysおよびVarsパラメータで指定された列はオプションです。 1. **TD Console**を開きます。 2. **Data Workbench** > **Queries**に移動します。 3. データをエクスポートするために使用する予定のクエリを選択します。 4. クエリエディタの上部にある**Export Results**を選択します。 Choose Integrationダイアログが開きます。 5. 作成した認証を選択します(または新しいものを作成します)。 6. **Next**を選択します。 7. ターゲット出力データタイプとそれに対応するパラメータを設定します。 次のExport Modesがサポートされています: - **List**: 指定されたリストにメールをエクスポートします。 - **User**: IDでユーザーを作成または既存のユーザーを更新します。これによりLifecycle eventsがトリガーされます。 - **Bulk User**: Sailthru bulk jobによってIDでユーザーを作成または既存のユーザーを更新します。これによりLifecycle eventsはトリガーされません。 8. オプションで、以下のいずれかを設定します: - リストへのエクスポートを設定する 1. Export Modeで **List** を選択します。 ![](/assets/image-20200522-144048.416b171bf0aab388da8c1b8bfbabc91fb3cb6aee92dd08c8289e2bec80d56bfb.d53d9105.png) 2. 送信先のリスト名を入力します。 リストが存在しない場合は新しいリストが作成され、既存のリストがある場合は更新されます。Sailthruで[リスト名を確認](https://my.sailthru.com/lists)できます。 3. PrimaryまたはSecondaryのいずれかを選択します。 **Primary**リストは、定期的に送信する主要な購読者リストです。リストの成長を追跡したい場合は、プライマリとしてマークする必要があります。 **Secondary**リストは、成長レポートが不要なリストです。成長が追跡されないため、Primary Listレポートには表示されません。 オプションを選択すると、既存のリストがこのタイプに更新されます。[プライマリリストとセカンダリリストの違い](https://getstarted.sailthru.com/audience/managing-lists/primary-and-secondary-lists/)については、Sailthruを参照してください。 4. オプションで、購読者に表示される名前(オプトアウトページなど)を入力します。 - ユーザーへのエクスポートを設定する 1. Export Modeで **User** を選択します。 ![](/assets/screen-shot-2022-03-15-at-22.29.09.6a3e6bd25460813b24eb11bbbf8141b1f94bc93097471c3e25f338db3c5f1bfc.d53d9105.png) 2. `id`カラムの対応するタイプ(email、sms、sid、extid)を選択します。 3. オプションで、Ignore Error Recordsを選択すると、ユーザーを作成/更新できない場合でもエクスポートジョブが続行されます。チェックを外したままにすると、エラーレコードが発生した場合にTreasure Dataジョブが終了します。送信された(Sailthru)ジョブはロールバックできます。Userエクスポートモードとは異なり、「Ignore Error Records」は一部のクライアント側検証(ListsまたはVarsの不正な構文など)のみを対象としています。その他の種類の無効なレコードは、デフォルトでSailthruのジョブで自動的に無視されます。 4. オプションで、ユーザーのキーを更新するためのカンマ区切りのキーカラムを追加します。 カラム名はキータイプと正確に一致する必要があります。 5. Key Conflict Resolutionの値を入力します。 **error**: 競合が発生した場合にジョブを終了します。例えば、変更されたキーがSailthruデータベースに既に存在する別のキーと一致する場合です。 **merge:** 競合したユーザーを現在の`id`を持つユーザーと解決しようとします。 6. オプションで、ユーザーが属するListsを更新します。 値は次の構文に従う必要があります。 `"List Name": 0|1, "Another List Name": 0|1, ...` `0`はリストからユーザーを削除します。 `1`はリストにユーザーを追加します(まだ存在しない場合)。 7. オプトアウトテンプレートからユーザーを追加または削除します。 8. オプションで、Thread Countの値を更新します。Thread Countは、Sailthru APIへのリクエストを送信するために並列で実行されるジョブの数を指します。Thread Countは1から40の範囲内である必要があります。 - ユーザーのバルクエクスポートを設定する 1. Export Modeで **Bulk** **User** を選択します。 ![](/assets/image-20200731-070025.6e923584d541738e4d5ac5c55b395a2311e8285a3edb3f8e9e00cc2fcb5025f2.d53d9105.png) 2. `id`カラムの対応するタイプ(email、sms、sid、extid)を選択します。 3. オプションで、Ignore Error Recordsを選択すると、ユーザーを作成/更新できない場合でもエクスポートジョブが続行されます。チェックを外したままにすると、エラーレコードが発生した場合にTreasureData側のジョブが終了します。送信された(Sailthru側)ジョブはロールバックできません。Userエクスポートモードとは異なり、「Ignore Error Records」は一部のクライアント側検証(ListsまたはVarsの不正な構文など)のみを対象としています。その他の種類の無効なレコードは、デフォルトでSailthruのジョブで自動的に無視されます。 4. オプションで、ユーザーのキーを更新するためのカンマ区切りのキーカラムを追加します。 カラム名はキータイプと正確に一致する必要があります。 5. オプションで、ユーザーが属するListsを更新します。 値は次の構文に従う必要があります。 `"List Name": 0|1, "Another List Name": 0|1, ...` `0`はリストからユーザーを削除します。 `1`はリストにユーザーを追加します(まだ存在しない場合)。 ### (オプション) Query Export ジョブをスケジュールする Scheduled Jobs と Result Export を使用して、指定したターゲット宛先に出力結果を定期的に書き込むことができます。 Treasure Data のスケジューラー機能は、高可用性を実現するために定期的なクエリ実行をサポートしています。 2 つの仕様が競合するスケジュール仕様を提供する場合、より頻繁に実行するよう要求する仕様が優先され、もう一方のスケジュール仕様は無視されます。 例えば、cron スケジュールが `'0 0 1 * 1'` の場合、「月の日」の仕様と「週の曜日」が矛盾します。前者の仕様は毎月 1 日の午前 0 時 (00:00) に実行することを要求し、後者の仕様は毎週月曜日の午前 0 時 (00:00) に実行することを要求するためです。後者の仕様が優先されます。 #### TD Console を使用してジョブをスケジュールする 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. 各フィールド間には単一のスペースが必要です。各フィールドの値は、次のもので構成できます: | フィールド値 | 例 | 例の説明 | | --- | --- | --- | | 各フィールドに対して上記で表示された制限内の単一の値。 | | | | フィールドに基づく制限がないことを示すワイルドカード `'*'`。 | `'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 を有効にすることで、クエリの開始時刻を遅延させることができます。 ### クエリを実行する クエリに名前を付けて保存して実行するか、単にクエリを実行します。クエリが正常に完了すると、クエリ結果は指定された宛先に自動的にエクスポートされます。 設定エラーにより継続的に失敗するスケジュールジョブは、複数回通知された後、システム側で無効化される場合があります。 (オプション) Delay execution を有効にすることで、クエリの開始時刻を遅延させることができます。 ## Audience Studio で Segment をアクティベートする Audience Studio で activation を作成することで、segment データをターゲットプラットフォームに送信することもできます。 1. **Audience Studio** に移動します。 2. parent segment を選択します。 3. ターゲット segment を開き、右クリックして、**Create Activation** を選択します。 4. **Details** パネルで、Activation 名を入力し、前述の Configuration Parameters のセクションに従って activation を設定します。 5. **Output Mapping** パネルで activation 出力をカスタマイズします。 ![](/assets/ouput.b2c7f1d909c4f98ed10f5300df858a4b19f71a3b0834df952f5fb24018a5ea78.8ebdf569.png) - Attribute Columns - **Export All Columns** を選択すると、変更を加えずにすべての列をエクスポートできます。 - **+ Add Columns** を選択して、エクスポート用の特定の列を追加します。Output Column Name には、Source 列名と同じ名前があらかじめ入力されます。Output Column Name を更新できます。**+ Add Columns** を選択し続けて、activation 出力用の新しい列を追加します。 - String Builder - **+ Add string** を選択して、エクスポート用の文字列を作成します。次の値から選択します: - String: 任意の値を選択します。テキストを使用してカスタム値を作成します。 - Timestamp: エクスポートの日時。 - Segment Id: segment ID 番号。 - Segment Name: segment 名。 - Audience Id: parent segment 番号。 1. **Schedule** を設定します。 ![](/assets/snippet-output-connector-on-audience-studio-2024-08-28.a99525173709da1eb537f839019fa7876ffae95045154c8f2941b030022f792c.8ebdf569.png) - スケジュールを定義する値を選択し、オプションでメール通知を含めます。 1. **Create** を選択します。 batch journey の activation を作成する必要がある場合は、[Creating a Batch Journey Activation](/products/customer-data-platform/journey-orchestration/batch/creating-a-batch-journey-activation) を参照してください。 ## Workflowでエクスポート結果をオプションで設定する Treasure Workflow内で、このデータコネクタを使用してデータをエクスポートすることを指定できます。 ### **例:** リストへメールをエクスポートするWorkflow ```yaml _export: td: database: sample_datasets +export_to_sailthru: td>: queries/samples.sql result_connection: my_sailthru_connection result_settings: target: bulk_user bulk_user_key: email bulk_user_lists: '"My List": 1' bulk_user_keys_column: sms, sid bulk_user_vars_columns: name, dob bulk_user_ignore_error: true ``` ### **例:** ユーザーをエクスポートするWorkflow ```yaml _export: td: database: sample_datasets +export_to_sailthru: td>: queries/samples.sql result_connection: my_sailthru_connection result_settings: target: user user_key: email user_lists: '"My List": 1' user_keys_column: sms, sid user_vars_columns: name, dob user_keys_conflict_resolution: error user_optout_templates: '"My OptOut Template": 1' user_ignore_error: true ``` ### **例**: ユーザーをバルクエクスポートするWorkflow ```yaml _export: td: database: sample_datasets +export_to_sailthru: td>: queries/samples.sql result_connection: my_sailthru_connection result_settings: target: bulk_user bulk_user_key: email bulk_user_lists: '"My List": 1' bulk_user_keys_column: sms, sid bulk_user_vars_columns: name, dob bulk_user_ignore_error: true ``` 詳細については、[workflowでデータをエクスポートする際のデータコネクタの使用](https://docs.treasuredata.com/smart/project-product-documentation/exporting-data-with-parameters)を参照してください。