MailChimp のエンドポイントの作成または編集

エンドポイントは、Studio および統合アプライアンスが MailChimp プラットフォームに接続するために使用する構成情報を提供します。MailChimp コネクターは、ユーザーによる操作の実行を許可するために、基本認証と OAuth2.0 認証の両方の認証メカニズムをサポートします。

MailChimp エンドポイントの選択または編集

  1. 「エンドポイントの作成」ペインまたは「エンドポイントの編集」ペインで、以下の表の説明に従って MailChimp エンドポイントを構成します。
    注: エンドポイントの構成プロパティーを変更すると、プロジェクトでそのエンドポイントを使用しているすべてのオーケストレーションに影響します。 編集はローカルではなく、グローバルとなります。
  2. 「接続のテスト」をクリックして、接続の詳細が有効であること、および MailChimp に正常に接続できることを確認します。
  3. OK」をクリックします。
注:
  • 「基本認証を使用してサーバーにログイン」ラジオ・ボタンをクリックすると、「ユーザー名」「API キー」を要求されます。
  • 「OAuth 2.0 認証を使用してサーバーにログイン」ラジオ・ボタンをクリックすると、「OAuth2.0 アクセス・トークン」を要求されます。
表 1. 接続プロパティー
フィールド名 説明
API バージョン MailChimp API バージョン
ユーザー名 MailChimp インスタンスにアクセスするための認証ユーザー名
API キー MailChimp インスタンスにアクセスするための認証 API キー
OAuth 2.0 アクセス・トークン MailChimp インスタンスにアクセスするためのアクセス・トークン

プロキシー経由で接続を行う場合、エンドポイントの接続のテスト画面で以下のパラメーターが必要です。

フィールド名 説明
ホスト名 プロキシー・ネットワークのホスト名
ポート プロキシー・ネットワークのポート番号
ユーザー名 プロキシー・ネットワーク経由でサービスにアクセスするためのユーザー名。
パスワード プロキシー・ネットワーク経由でサービスにアクセスするためのパスワード。
注: 各アクティビティーの「入力のマップ」セクションで、エンドポイント・パネルの該当フィールドは、実行時に指定変更できるようになります。ユーザーは、プロキシー詳細や接続詳細など、さまざまなパラメーター・グループにデータを指定して、それらを指定変更できます。使用される認証タイプは、エンドポイント・パネルでユーザーが選択したとおりになります。選択されたタイプに必要なパラメーターのみが指定変更可能になります。選択したグループ内の一部のパラメーター値のみを指定することは許可されません。例えば、エンドポイント・パネルで「基本認証」が選択された場合、「API キー」と「ユーザー名」を指定変更しなければなりません。そうしないと、アクセス・トークンが指定変更されます。

MailChimp コネクターによってサポートされるオブジェクト

MailChimp コネクターによってサポートされるオブジェクトは以下のとおりです。

表 2. MailChimp オブジェクトでサポートされる CRUD 操作
MailChimp オブジェクト 作成 すべて取得 取得 更新 削除 検索
Campaign あり あり あり あり あり あり
Feedback あり あり あり あり あり
Campaign Content あり あり
Campaign Send Checklist あり
Conversation あり あり あり
Message あり あり あり あり
File あり あり あり あり あり あり
Folder あり あり あり あり あり あり
List あり あり あり あり あり あり
List Abuse Report あり あり
Template Default Content あり
List Activity あり
Client あり
Growth History あり あり
Interests Category あり あり あり あり あり あり
Interest あり あり あり あり
Member あり あり あり あり あり あり
Member activity あり
Member goal あり
Member Note あり あり あり あり あり あり
Template あり あり あり あり
Authorized App あり あり
Segment あり あり あり あり
Aim Segment あり あり
Automation Segment あり あり
Campaign Poll Segment あり あり
Conversation Segment あり あり
Date Segment あり あり
Email Client Segment あり あり
Language Segment あり あり
Mandrill Segment あり あり
Member Rating Segment あり あり
Signup Source Segment あり あり
Survey Monkey Segment あり あり
VIP Segment あり あり
Ecomm Category Segment あり あり
Ecomm Number Segment あり あり
Ecomm Purchased Segment あり あり
Ecomm Spent Segment あり あり
Ecomm Store Segment あり あり
Goal Activity Segment あり あり
Goal Timestamp Segment あり あり
Fuzzy Segment あり あり
Static Segment あり あり
IPGeoCountry State Segment あり あり
IPGeo ln Segment あり あり
IPGeolnZip Segment あり あり
IPGeolnUnknown Segment あり あり
IPGeoZip Segment あり あり
SocialAge Segment あり あり
SocialGender Segment あり あり
SocialInfluence Segment あり あり
SocialNetworkMember Segment あり あり
SocialNetworkFollow Segment あり あり
Campaign Folder あり あり あり あり あり
Template Folder あり あり あり あり あり
表 3. MailChimp オブジェクトでサポートされるバッチ操作
MailChimp オブジェクト 作成 取得 更新 アップサート バッチ結果の取得
Campaign あり あり あり あり
Feedback あり あり あり あり
Campaign Content あり あり あり
Campaign Send Checklist あり あり
Conversation あり あり
Message あり あり あり
File あり あり あり あり
Folder あり あり あり あり
List あり あり あり あり
List Abuse Report あり あり
Template Default Content あり あり
List Activity あり
Client あり
Growth History あり あり
Interest Category あり あり あり あり
Interest あり あり あり
Member あり あり あり あり あり
Member activity あり
Member goal あり
Member Note あり あり あり あり
Template あり あり
Authorized App あり あり
Segment あり あり
Aim Segment あり あり あり
Automation Segment あり あり あり
Campaign Poll Segment あり あり あり
Conversation Segment あり あり あり
Date Segment あり あり あり
Email Client Segment あり あり あり
Language Segment あり あり あり
Mandrill Segment あり あり あり
Member Rating Segment あり あり あり
Signup Source Segment あり あり あり
Survey Monkey Segment あり あり あり
VIP Segment あり あり あり
Ecomm Category Segment あり あり あり
Ecomm Number Segment あり あり あり
Ecomm Purchased Segment あり あり あり
Ecomm Spent Segment あり あり あり
Ecomm Store Segment あり あり あり
Goal Activity Segment あり あり あり
Goal Timestamp Segment あり あり あり
Fuzzy Segment あり あり あり
Static Segment あり あり あり
IPGeoCountry State Segment あり あり あり
IPGeoIn Segment あり あり あり
IPGeolnZip Segment あり あり あり
IPGeolnUnknown Segment あり あり あり
IPGeoZip Segment あり あり あり
SocialAge Segment あり あり あり
SocialGender Segment あり あり あり
SocialInfluence Segment あり あり あり
SocialNetworkMember Segment あり あり あり
SocialNetworkFollow Segment あり あり あり
Campaign Folder あり あり あり あり
Template Folder あり あり あり あり

アトミック操作:

  • レポートの取得:
    • Click レポート
    • Members Click レポート
    • Email Activities レポート
    • Recipient レポート
    • Unsubscribed Members レポート
  • すべてのレポートを取得:
    • Campaign Feedback レポート
    • Click レポート
    • Members Click レポート
    • Domain Performance レポート
    • Social Activity レポート
    • Email Activities レポート
    • Location レポート
    • Recipient レポート
    • Campaign Sub レポート
    • Unsubscribed Member レポート
  • キャンペーンのキャンセル
  • メンバーのアップサート
  • キャンペーンの送信
  • バッチ状況の取得

カスタム・オブジェクトのサポート

MailChimp は、カスタム・オブジェクトをサポートしません。

カスタム・フィールドのサポート

MailChimp マージ・フィールドはカスタム・フィールドとして扱われます。これらのフィールドは、エンド・ユーザーが作成でき、作成には MailChimp UI のみを使用できます。これらのフィールドは、MailChimp の Member オブジェクトのみに関連付けられます。また、マージ・フィールドには特定のリストが関連付けられます。各 MailChimp リストに異なるマージ・フィールドを含めることができます。 カスタム・フィールドは、リストの選択時に動的にディスカバーされます。

「構成」パネルで Member オブジェクトを選択すると、マージ・フィールドに関連付ける list_id を選択するために、リスト名の「参照」ボタンが使用可能になります。リスト名を選択すると、「入力のマップ」/「出力のマップ」パネルにマージ・フィールドが動的に取り込まれます。「リスト名参照 (List Name Browse)」パネルには、デフォルトで 50 件のリストが表示されます。「次へ」ボタンおよび「前へ」ボタンを使用して、「カウント」テキスト・フィールドに従ってリストをフェッチします。

ユーザーには、「入力のマップ」で「list_Id」の値を指定変更するための機能が提供されます。2 つの異なるリストに同じマージ・フィールドのセットが含まれる場合、いずれかの list_id を指定すれば十分です。ただし、指定変更された list_id に異なるマージ・フィールドが含まれる場合は、共通するフィールドのみが値を保持し、他のフィールドは無視されます。指定変更された list_id に必須のマージ・フィールドがいくつか定義されている場合に、構成パネル内の選択された list_id でそれらのマージ・フィールドが使用可能でないと、実行はエラーになります。ユーザーはこの点に注意して、取り込まれるマージ・フィールドに応じた適切な list_Id を指定しなければなりません。また、「入力のマップ」で list_id が提供された場合は、それが、構成パネルで選択されたものより優先される点にも注意してください。

「入力のマップ」でマージ・フィールドをサポートする Member オブジェクトのコネクター・アクティビティーを以下に記載します。

  • オブジェクトの作成
  • オブジェクトの更新
  • オブジェクトのバッチ作成
  • オブジェクトのバッチ更新
  • オブジェクトのバッチ・アップサート
  • メンバーのアップサート

「出力のマップ」でマージ・フィールドを動的に取り込む Member オブジェクトのコネクター・アクティビティーを以下に記載します。

  • 検索
  • すべて取得
  • 取得
  • バッチ結果の取得

マージ・フィールドは、list_id に関連付けられます。