Emberpoint Mailpublisher Import Integration

Copy

• Copy for LLM

  Copy page as Markdown for LLMs
• View as Markdown

  Open this page as Markdown
• Open in ChatGPT

  Get insights from ChatGPT
• Open in Claude

  Get insights from Claude
• Cursorに接続

  CursorにMCPサーバーをインストール
• VS Codeに接続

  VS CodeにMCPサーバーをインストール

EmberPoint MailPublisher Export Integrationの詳細はこちら。

このコネクタを使用すると、EmberPoint MailPublisherの統計情報をTreasure Dataにインポートできます。

この同じコネクタを使用して、ジョブ結果をMailPublisherに送信することもできます。EmberPoint MailPublisher Export Integrationを参照してください。

前提条件

• Toolbeltを含むTreasure Dataの基本知識。
• APIアクセスが有効化されたMailPublisher Smartアカウント（MailPublisher Smartコンソールから実行）。

制限事項

• このコネクタはカスタムエンドポイントをサポートしていません。デフォルトのエンドポイントのみをサポートします。

MailPublisher Smartアカウント情報

メール配信リストをアップロードする前に、API対応アカウントへのアクセスが必要です。Site IDはMailPublisher Smartコンソールから取得できます。

APIアクセス用の新しいアカウントを有効化して作成する手順：

1. 左メニューでAccount > Create（アカウント > 新規作成）を選択

2. 外部システム連携タイプのUser（利用種別：外部システム連携）を作成。

   

File IDの取得

File IDはこちらで確認できます：（リスト管理 > リスト管理 > チェック・確認）

Draft IDの取得

1. "send_email"オプションを使用するには、こちらで確認できるDraft IDを取得する必要があります（メール配信・一覧 > 下書きメール）

TD Consoleを使用して接続を作成

新しい接続の作成

データ接続を構成する際に、統合にアクセスするための認証情報を提供します。Treasure Dataでは、認証を構成してからソース情報を指定します。

1. TD Consoleを開きます。

2. Integrations Hub > Catalogに移動します。

3. Catalog画面の右端にある検索アイコンをクリックし、Mailpublisherと入力します。

4. MailPublisherコネクタにカーソルを合わせ、Create Authenticationを選択します。

5. 次のダイアログが開きます。

6. MailPublisher Smartの認証情報を提供して、新しい接続情報を完成させます。

   • MailPublisher Smart Site ID（必須）：MailPublisher SmartのSite IDです。
   • MailPublisher Smart Login ID（必須）：サービス固有のLogin IDです。
   • MailPublisher Smart password（必須）：上記Login 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を選択します。

Treasure Dataへのデータ転送

認証済み接続を作成すると、自動的にAuthentications画面に移動します。

1. 作成した接続を検索します。
2. New Sourceを選択します。
3. Data Transfer フィールドにSourceの名前を入力します**。**

4. Nextを選択します。

Source Table

期間の値（= Start Date + Duration - 1日）は、今日または未来の日付であってはなりません。

例えば、日本で今日が「2018-10-02」の場合：

• 「Start Date = 2018-10-01 かつ Duration = 1」=> 許容される
• 「Start Date = 2018-10-01 かつ Duration = 2」=> 許容されない

1. Nextを選択します。 Source Tableダイアログが開きます。
2. 以下のパラメータを編集します：

Data Settings

1. Nextを選択します。 Data Settingsページが開きます。
2. Nextを選択します。

Data Preview

Data previewはオプションです。必要に応じて、Nextをクリックしてダイアログの次のページに進むことができます。

1. Generate Previewを選択して、インポートを実行する前にデータのプレビューを表示します。

   データプレビューに表示されるデータは、ソースから概算されたものです。実際にインポートされるデータではありません。

2. データがおおよそ期待通りであることを確認します。

   

3. Nextを選択します。

Data Placement

データの配置について、データを配置したいターゲット database と table を選択し、インポートを実行する頻度を指定します。

1. Next を選択します。Storage の下で、インポートされたデータを配置する新しい database を作成するか、既存の database を選択し、新しい table を作成するか、既存の table を選択します。

2. Database を選択 > Select an existing または Create New Database を選択します。

3. オプションで、database 名を入力します。

4. Table を選択 > Select an existing または Create New Table を選択します。

5. オプションで、table 名を入力します。

6. データをインポートする方法を選択します。

   • Append (デフォルト) - データインポートの結果は table に追加されます。 table が存在しない場合は作成されます。
   • Always Replace - 既存の table の全体の内容をクエリの結果出力で置き換えます。table が存在しない場合は、新しい table が作成されます。
   • Replace on New Data - 新しいデータがある場合のみ、既存の table の全体の内容をクエリの結果出力で置き換えます。

7. Timestamp-based Partition Key 列を選択します。 デフォルトキーとは異なるパーティションキーシードを設定したい場合は、long または timestamp 列をパーティショニング時刻として指定できます。デフォルトの時刻列として、add_time フィルターで upload_time を使用します。

8. データストレージの Timezone を選択します。

9. Schedule の下で、このクエリを実行するタイミングと頻度を選択できます。

一度だけ実行

1. Off を選択します。
2. Scheduling Timezone を選択します。
3. Create & Run Now を選択します。

定期的に繰り返す

1. On を選択します。
2. Schedule を選択します。UI では、@hourly、@daily、@monthly、またはカスタム cron の 4 つのオプションが提供されます。
3. Delay Transfer を選択して、実行時間の遅延を追加することもできます。
4. Scheduling Timezone を選択します。
5. Create & Run Now を選択します。

転送が実行された後、Data Workbench > Databases で転送の結果を確認できます。

Result Schemas

外部システムとデータ型をマッピングする際は、MailPublisher Smart マニュアルのAPI「3-2 リスト状態レポート」を参照してください。（または、「外部システムとの連携利用マニュアル」を参照してデータ型を調整することもできます。）Mail Publisher Connectorは、リクエストパラメータを追加することで、できるだけ多くの項目を取得しようとします。詳細については、APIマニュアルを参照してください。

外部システムとデータ型をマッピングするには、MailPublisher Smartマニュアルの API「3-11 記事状態レポート」を参照してください。(または、ja: "外部システムとの連携利用マニュアル"を参照してデータ型を調整することもできます。)このコネクターは、「Email List Status」タイプと同様に、すべての項目を取得しようとします。

外部システムとデータ型をマッピングするには、MailPublisher Smartマニュアルの API「3-21 クリックカウント詳細一覧」を参照してください。(または、ja: "外部システムとの連携利用マニュアル"を参照してデータ型を調整することもできます。)Treasure Data内の1レコード(行)は、各クリックカウントURLの統計データを提供します。