# Emberpoint Mailpublisher Export Integration [Emberpoint MailPublisher Import Integrationについて詳しく見る](/ja/int/emberpoint-mailpublisher-import-integration)。 このインテグレーションにより、Treasure DataからEmberPoint MailPublisherにセグメントを公開でき、ユーザーはパーソナライズされたメールを送信できるようになります。Web、モバイル、CRMからのファーストパーティデータを使用して、データドリブンなメールキャンペーンを実行できます。 このコネクタは、MailPublisherのデータをTreasure Dataにインポートする際にも使用できます。 ## MailPublisher Smart メール配信リストデータの制限事項 MailPublisher Smartには、配信リストデータの列名に関していくつかの制限があります： - 最初の列名は「email」である必要があります - 列名に予約語を含めることはできません - image_[number] 例：image_001 - linkurl_[number] 例：linkurl_001 - cvurl_[number] 例：cvurl_001 - boundary[number] 例：boundary00 - carrier_type - code_mini - 列名に次の文字を含めることはできません - 「-」（ハイフン）および「 」（スペース） - 列の値には、現在「,」（カンマ）、「"」（二重引用符）、および改行（CR/LF/CRLF）を含めることができません。 - 列の値には、IBM拡張、NEC拡張漢字、丸数字（①など）などの特殊文字を含めることはできません。 - 列の値のメール文字列は有効な形式である必要があります。無効な形式のメールアドレスは、メール配信リストをアップロードする際に削除されます。 配信先として「Japan」を選択した場合、アップロードされたファイルはShift_JIS文字エンコーディングでエンコードされます。一部のテキストが文字化けする可能性があります。 「MailPublisher Smart外部システムとの連携利用マニュアル」および「MailPublisher Smart機能説明マニュアル」を参照してください。どちらもMailPublisher Smartコンソールからダウンロードできます。 ## 前提条件 - [Toolbelt](https://toolbelt.treasuredata.com/)を含むTreasure Dataの基本知識。 - APIアクセスが有効になっているMailPublisher Smartアカウント（MailPublisher Smartコンソール経由で実行）。 ## 制限事項 - このコネクタはカスタムエンドポイントをサポートしていません。デフォルトエンドポイントのみをサポートします。 ## MailPublisher Smart アカウント情報 メール配信リストをアップロードする前に、API対応アカウントへのアクセスが必要です。サイトIDはMailPublisher Smartコンソールから取得できます。 APIアクセス用の新しいアカウントを有効化して作成する手順： 1. 左側のメニューで**アカウント** > **新規作成**を選択します 2. 外部システム連携タイプのユーザー（利用種別：外部システム連携）を作成します。 ![](/assets/image-20191021-161236.1e135a85e586672b5dc0c8f6b67528d23dc00789c9968695a863bf9ece2c91d9.c00703fc.png) ### Draft IDの取得 「send_email」オプションを使用するには、次のように表示されるDraft IDを取得する必要があります（メール配信・一覧 > 下書きメール）。 ![](/assets/image-20191021-161221.991c645aeb7126d791f31f4c2b9dc8f0bc7dbc307823e4940d10bd55c75ca044.c00703fc.png) ### List IDの取得 ![](/assets/image2022-11-23_21-6-47.18b42232d7fa657e4e17d3a86209f85086646bb33b5dd53997a8d0d184e18843.c00703fc.png) ## TD Consoleを使用して接続を作成する ### 新しい接続を作成する データ接続を設定する際には、インテグレーションにアクセスするための認証情報を提供します。Treasure Dataでは、認証情報を設定してから、ソース情報を指定します。 1. 1. **TD Console**を開きます。 2. **Integrations Hub > Catalog**に移動します。 3. Catalog画面の右端にある検索アイコンをクリックし、**Mailpublisher**と入力します。 4. MailPublisherコネクタにカーソルを合わせて、**Create Authentication**を選択します。 ![](/assets/emberpointmailpublisher.e2e930d955b4e27c77cff4cff36def99290719661d5534252fd82eb71b2376e0.c00703fc.png) 5. 次のダイアログが開きます。 ![](/assets/image-20201009-215244.3c7c88619181cba170460d13d723e98deae640f8acff769392974332177b178f.c00703fc.png) 6. MailPublisher Smartの認証情報を提供して、新しい接続情報を入力します。 - **MailPublisher Smart Site ID**（必須）：MailPublisher SmartのサイトID。 - **MailPublisher Smart Login ID**（必須）：サービス固有のログインID。 - **MailPublisher Smart password**（必須）：上記のログインIDのパスワード。 - **Retry limit**（オプション、デフォルト：`7`）：コネクタが接続とデータ送信の試行を停止する前の再試行回数 - **Maximum intervals in milliseconds between retries**（オプション、デフォルト：`120000`）：再試行間の最大時間（ミリ秒）。 - **Initial intervals in milliseconds between retries**（オプション、デフォルト：`15000`）：回復可能なエラーが発生した場合に再試行する間隔（ミリ秒）。 - MailPublisher Smartは、最小再試行間隔時間を15秒（15000ミリ秒）とすることを推奨しています。 - **Timeout**（オプション、デフォルト：`100000`）：各HTTPリクエストのタイムアウト（ミリ秒）。 ### 接続に名前を付ける 1. 接続の名前を入力します。 2. **Done**を選択します。 ### クエリを定義する - 列名は大文字と小文字を区別しません。たとえば、`email`または`EMAIL`を使用できます。 - クエリの例 1. **Data Workbench > Queries**に移動します。 2. New Queryを選択するか、使用するクエリを検索します。 3. 次のサンプルクエリを確認します： ```SQL SELECT email, td_global_id as tdglobalid, firstname, lastname, company FROM ( VALUES ('name+test1@treasure-data.com', 'b1b065f5-1222-4a14-b151-379d49ec39e3', 'John', 'Doe', 'MailPublisher Dummy Data - DO NOT USE'), ('name+test2@treasure-data.com', 'x1b065f5-1222-4a14-b151-379d49ec39e3', 'Janes', 'Doe', 'MailPublisher Dummy Data - DO NOT USE'), ('name+test3@treasure-data.com', 'p1b065f5-1222-4a14-b151-379d49ec39e3', 'Tony', 'Doe', 'MailPublisher Dummy Data - DO NOT USE'), ('name+test4@treasure-data.com', 'o1b065f5-1222-4a14-b151-379d49ec39e3', 'Bill', 'Adam', 'MailPublisher Dummy Data - DO NOT USE'), ('name+test5@treasure-data.com', 't1b065f5-1222-4a14-b151-379d49ec39e3', 'Dan', 'Steve', 'MailPublisher Dummy Data- DO NOT USE') ) tbl ( email, td_global_id, firstname, lastname, company ) ``` または ```SQL SELECT an_email_column AS email, another_phone_column AS phone FROM your_table; ``` 1. Export Resultsを選択します。 2. 既存のインテグレーションを使用し、MailPublisher接続を選択します。 3. 次のパラメータフィールドに入力します： - **Action mode**： - list_upload：配信リストをアップロードする - send_email：リストのアップロードに加えてメール配信を予約する - **Email delivery destination**： - JapanまたはWorldwide - 配信先が「Japan」の場合、アップロードされるファイルはShift_JIS文字エンコーディングでエンコードされます。それ以外の場合、ファイルはUTF-8でエンコードされます。 - **File name prefix**：（オプション、デフォルト：「delivery_list_」）：アップロードされるファイル名にこのプレフィックスが付きます。 - **Draft ID**：（「send_email」モードで必須）メール配信に使用する下書きのID。これはMailPublisherコンソールで確認できます。 - **List ID**：（オプション）：データを上書きするファイルのID。 - **Use immediate email delivery**：すぐにメールを送信する場合はチェックします - このオプションを使用する際は注意してください。この段階ではメール配信設定をテストできません。 - **Booking date time**：（「immediate delivery」モード以外では必須）メールを送信します。メールは、出力ジョブが実行されてから少なくとも10分後に送信されます。形式は「2018-09-18 12:00」などの「YYYY-MM-DD HH:mm」である必要があります - **Booking timezone**：予約日時のタイムゾーン。 ### (オプション) 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 を有効にすることで、クエリの開始時刻を遅延させることができます。 1. MailPublisher Smartコンソールで新しいメール配信リストの結果を確認します。 # （オプション）ワークフローでExport Resultsを設定する Treasure Workflow内で、このデータコネクタを使用してデータをエクスポートするように指定できます。 詳しくは[Exporting Data with Parameters](https://docs.treasuredata.com/display/public/PD/Exporting+Data+with+Parameters)をご覧ください。