Mailchimp Interest Categories 接続

Mailchimpは、メーリングリストとメールマーケティングキャンペーンを使用して​ (顧客、顧客、その他の興味のある関係者) ​の連絡先を管理し、会話するために企業が使用する人気のマーケティングオートメーションプラットフォームおよびメールマーケティングサービスです。 このコネクタを使用すると、興味や好みに基づいて連絡先を並べ替えることができます。

Mailchimp Interest Categoriesでは、​ オーディエンス ​、​ グループ ​、興味のあるカテゴリ (グループ名またはグループタイトルとも呼ばれます)​を使用しています。 各Mailchimp グループは、興味のあるカテゴリのリストです。 連絡先は、web サイトのサインアップフォームを通じて1つ以上の関心カテゴリに登録すると、関心カテゴリに関連付けられます。 オーディエンス内で、連絡先をグループに整理して興味のあるカテゴリに関連付けることもできます。これらのカテゴリを使用してセグメントを作成することもできます。 これらのオーディエンスを使用して、登録済みの連絡先にターゲットキャンペーンメールをブロードキャストできます。

このAdobe Experience Platform 宛先は、Mailchimp batch subscribe or unsubscribe API APIを使用して関心カテゴリ ​を作成し、選択した各Experience Platform オーディエンスの連絡先を対応する関心カテゴリに追加します。 新しい連絡先を追加​または​ 既存のMailchimp連絡先 ​の情報を更新し、新しいセグメント内でアクティブ化した後、既存のMailchimp オーディエンス内の目的のグループ から​連絡先を追加または削除できます。 Mailchimp Interest Groupsは、Experience Platformから選択したオーディエンス名をMailchimp内の関心カテゴリとして使用します。

ユースケース use-cases

Mailchimp Interest Categories宛先を使用する方法とタイミングをより理解しやすくするために、Adobe Experience Platformのお客様がこの宛先を使用して解決できる使用例を次に示します。

マーケティング施策のために連絡先にメールを送信 use-case-send-emails

スポーツ用品web サイトの営業部門は、サッカーに興味を持っていると自ら判断した連絡先のリストに、メールによるマーケティングキャンペーンを配信したいと考えています。 連絡先のリストは、web サイトの開発チームから受け取ったデータ書き出しでバッチとして分類されるので、追跡する必要があります。 既存のMailchimp人のオーディエンスを特定し、各リストの連絡先を追加するExperience Platformオーディエンスの構築を開始します。 これらのオーディエンスをMailchimp Interest Categoriesに送信した後、選択したMailchimp オーディエンスに連絡先が存在しない場合、連絡先が属するオーディエンス名を持つグループに追加されます。 Mailchimp オーディエンスまたはグループに既に連絡先が存在する場合、その情報が更新されます。 データがMailchimp Interest Categoriesに送信されると、セールス チームは、Mailchimp オーディエンス内のサッカーの興味グループにマーケティングキャンペーンのメールを選択して送信できます。

前提条件 prerequisites

Experience PlatformおよびMailchimpで設定する必要がある前提条件と、Mailchimp Interest Categoriesの宛先を操作する前に収集する必要がある情報については、以下の節を参照してください。

Experience Platformの前提条件 prerequisites-in-experience-platform

Mailchimp Interest Categories 宛先へのデータをアクティブ化する前に、スキーマ、データセットおよびセグメントを Experience Platform で作成する必要があります。

Mailchimp Interest Categories宛先の前提条件 prerequisites-destination

Experience PlatformからMailchimp アカウントにデータをエクスポートするには、次の前提条件に注意してください。

Mailchimp アカウントが必要です prerequisites-account

Mailchimp Interest Categories宛先を作成する前に、まずMailchimp アカウントがあることを確認する必要があります。 まだアカウントをお持ちでない場合は、Mailchimp 登録ページ ​にアクセスして、アカウントを登録および作成してください。

Mailchimp API キーを収集 gather-credentials

Mailchimp アカウントに対してMailchimp Interest Categories宛先を認証するには、Mailchimp API キー​が必要です。 宛先🔗を認証すると、API キー​は​ パスワード ​として機能します。

API キー​をお持ちでない場合は、アカウントにサインインし、Mailchimp API キーの生成 ドキュメントを参照して作成してください。

API キーの例は0123456789abcdef0123456789abcde-us14です。

IMPORTANT
API キー​を生成した場合は、生成後にアクセスできないため、書き留めます。

Mailchimp データセンターの特定 identify-data-center

次に、Mailchimp データセンターを特定する必要があります。 これを行うには、Mailchimp アカウントにログインし、アカウントの​ API キーセクション ​に移動します。

値は、ブラウザーに表示されるURLの最初の部分です。 URLが​ https://us14.mailchimp.com/account/api/ ​の場合、データセンターはus14です。

また、key-dc​という形式でAPI キーに追加されます。API キーが0123456789abcdef0123456789abcde-us14の場合、データセンターはus14になります。

データ センターの値​ (us14この例では) ​を書き留めます。この値は、宛先の詳細を入力するときに必要です。

詳細なガイダンスが必要な場合は、Mailchimp 基本ドキュメント ​を参照してください。

ガードレール guardrails

Mailchimp オーディエンスごとに、1つのグループまたは同じオーディエンス内の複数のグループに対して、最大60個のグループ名(または興味のあるカテゴリ)を含めることができます。 必要な説明については、Mailchimp ​ グループ ​を参照してください。 この制限に達すると、Mailchimp APIからのエラー応答として400 BAD_REQUEST Cannot have more than 60 interests per list (Across all categories) メッセージが表示されます。

さらに、Mailchimp APIによって課される制限について詳しくは、Mailchimp ​ レート制限を参照してください。

サポートされている ID supported-identities

Mailchimp では、以下の表で説明する ID のアクティベーションをサポートしています。 ID についての詳細情報。

ターゲット ID
説明
注意点
メール
連絡先のメールアドレス
必須

サポートされるオーディエンス supported-audiences

この節では、この宛先に書き出すことができるオーディエンスのタイプについて説明します。 以下の2つの表は、このコネクタがサポートするオーディエンスを示しています。オーディエンスの由来​と オーディエンスに含まれるプロファイルタイプ :

オーディエンスの由来
サポートあり
説明
Segmentation Service
○
Experience Platform ​ セグメント化サービス ​を通じて生成されたオーディエンス。
その他すべてのオーディエンスの生成元
×

このカテゴリには、Segmentation Serviceを通じて生成されたオーディエンス以外のすべてのオーディエンスのオリジンが含まれます。 様々なオーディエンスの起源について読みます。 次に例を示します。

  • カスタムアップロードオーディエンス がCSV ファイルからExperience Platformにをインポートしました。
  • 類似オーディエンス,
  • 連合オーディエンス,
  • Adobe Journey Optimizerなどの他のExperience Platform アプリで生成されたオーディエンス
  • その他。

オーディエンスのデータタイプ別にサポートされるオーディエンス:

オーディエンスのデータタイプ
サポートあり
説明
ユースケース
人物オーディエンス ​
○
顧客プロファイルにもとづいて、マーケティング施策の特定のグループをターゲットにすることができます。
買い物客やカートの放棄が多い
​ アカウントオーディエンス ​
×
アカウントベースドマーケティング戦略のために、特定の組織内の個人をターゲットにします。
B2B マーケティング
見込みオーディエンス ​
×
まだ顧客ではないが、ターゲットオーディエンスと特徴を共有する個人をターゲットにします。
サードパーティデータによる見込み顧客の開拓
​ データセットの書き出し
×
Adobe Experience Platform データ レイクに保存されている構造化データのコレクション。
レポート,データサイエンスワークフロー

書き出しのタイプと頻度 export-type-frequency

宛先の書き出しのタイプと頻度について詳しくは、以下の表を参照してください。

項目
タイプ
メモ
書き出しタイプ
プロファイルベース
  • セグメントのすべてのメンバーを、フィールドマッピングに従って、必要なスキーマフィールドと共に書き出します​(例:メールアドレス、電話番号、姓)。
  • Experience Platformで選択した各オーディエンスについて、対応するMailchimp Interest Categories セグメントステータスが、Experience Platformからオーディエンスステータスで更新されます。
書き出し頻度
ストリーミング
ストリーミングの宛先は常に、API ベースの接続です。 オーディエンス評価に基づいてExperience Platformでプロファイルが更新されると、コネクターは更新をダウンストリームの宛先プラットフォームに送信します。 詳しくは、ストリーミングの宛先を参照してください。

宛先への接続 connect

IMPORTANT
宛先に接続するには、宛先を表示​および​宛先を管理 ​ アクセス制御権限が必要です。 詳しくは、アクセス制御の概要または製品管理者に問い合わせて、必要な権限を取得してください。

この宛先に接続するには、宛先設定のチュートリアルの手順に従ってください。 宛先の設定ワークフローで、以下の 2 つのセクションにリストされているフィールドに入力します。

宛先 > カタログ​内で、Mailchimp Interest Categoriesを検索します。 または、電子メールマーケティング カテゴリの下に配置することもできます。

宛先に対する認証 authenticate

宛先に対して認証を行うには、以下の必須フィールドに入力し、宛先に接続​を選択します。

フィールド
説明
ユーザー名
あなたのMailchimp Interest Categories ユーザー名。
パスワード
収集 Mailchimp 資格情報 セクションに書き留めたMailchimp API キー。
API キーは{KEY}-{DC}の形式になります。ここでは、{KEY}部分はMailchimp API キー セクションに記載されている値を表し、{DC}部分はMailchimp データセンターを表します。
{KEY}部分またはフォーム全体を指定できます。
例えば、API キーが​
0123456789abcdef0123456789abcde-us14,
の場合、*0123456789abcdef0123456789abcdeまたは​0123456789abcdef0123456789abcde-us14*のいずれかを値として指定できます。

認証方法を示す Experience Platform UIのスクリーンショット。

指定した詳細が有効な場合、UI には​ 接続済み ​ステータスに緑色のチェックマークが表示されます。 その後、次の手順に進むことができます。

宛先の詳細を入力 destination-details

宛先の詳細を設定するには、以下の必須フィールドとオプションフィールドに入力します。 UI のフィールドの横のアスタリスクは、そのフィールドが必須であることを示します。

宛先の詳細を示す Experience Platform UIのスクリーンショット。

フィールド
説明
名前
将来この目的地を認識する名前。
説明
今後この宛先を特定するのに役立つ説明です。
データセンター
お客様のMailchimp アカウント data center ガイダンスについては、Identify Mailchimp data center セクションを参照してください。
オーディエンス名(最初にデータセンターを選択してください)
データセンター​を選択すると、このドロップダウンにMailchimp アカウントのオーディエンス名が自動的に入力されます。 Experience Platformのデータで更新するオーディエンスを選択します。
興味カテゴリ (最初にデータセンターとオーディエンス名を選択してください)
オーディエンス名​を選択すると、このドロップダウンには、Mailchimp アカウントの興味グループ カテゴリ名が自動的に入力されます。 Experience Platformのデータで更新するカテゴリ名を選択します。
TIP
パスワード フィールドまたは​ データセンター ​の値で指定したAPI キーが正しくない場合、UIには次のようにMailchimp API エラー応答​*No options are available. Please verify the values selected for the following dependent fields: dataCenter*​が表示されます。 この場合、「オーディエンス名」フィールドから値を選択できません(最初にデータセンターを選択してください)。 このエラーを修正するには、正しい値を指定します。

アラートの有効化 enable-alerts

アラートを有効にすると、宛先へのデータフローのステータスに関する通知を受け取ることができます。 リストからアラートを選択して、データフローのステータスに関する通知を受け取るよう登録します。 アラートについて詳しくは、UI を使用した宛先アラートの購読についてのガイドを参照してください。

宛先接続の詳細の提供が完了したら、次へ​を選択します。

この宛先に対してオーディエンスをアクティブ化 activate

IMPORTANT
  • データをアクティブ化するには、宛先の表示、宛先のアクティブ化、プロファイルの表示​および​セグメントの表示 ​ アクセス制御の権限が必要です。 アクセス制御の概要を参照するか、製品管理者に問い合わせて必要な権限を取得してください。
  • ID​をエクスポートするには、ID グラフの表示 ​ アクセス制御権限が必要です。
    ​ ワークフローで強調表示されているID名前空間を選択して、オーディエンスを宛先にアクティブ化します。 {width="100" modal="regular"}

この宛先にオーディエンスをアクティベートする手順は、ストリーミングオーディエンスの書き出し宛先へのプロファイルとオーディエンスのアクティベートを参照してください。

マッピングの考慮事項と例 mapping-considerations-example

オーディエンスデータをAdobe Experience PlatformからMailchimp Interest Categories宛先に正しく送信するには、フィールドマッピング手順を実行する必要があります。 マッピングでは、Experience Platform アカウントのExperience Data Model (XDM)スキーマフィールドと、ターゲット先の対応するスキーマフィールドとの間にリンクを作成します。

XDM フィールドをMailchimp Interest Categories宛先フィールドに正しくマッピングするには、次の手順に従います。

  1. マッピング​手順で、新しいマッピングを追加​を選択します。 新しいマッピング行が画面に表示されるようになりました。

  2. ソースフィールドを選択 ウィンドウで、属性を選択 カテゴリを選択してXDM属性を選択するか、ID名前空間を選択​してIDを選択します。

  3. ターゲットフィールドを選択 ウィンドウで、ID名前空間を選択​してIDを選択するか、属性を選択 カテゴリを選択して、Mailchimp APIから入力された属性のリストから選択します。 選択したMailchimp オーディエンスに追加したカスタム属性は、ターゲットフィールドとして選択することもできます。

    XDM プロファイルスキーマとMailchimp Interest Categoriesの間で使用できるマッピングは次のとおりです。

    table 0-row-3 1-row-3 2-row-3 3-row-3 4-row-3
    ソースフィールド ターゲットフィールド メモ
    IdentityMap: Email Identity: email 必須:はい
    xdm: person.name.firstName Attribute: FNAME
    xdm: person.name.lastName Attribute: LNAME
    xdm: person.birthDayAndMonth Attribute: BIRTHDAY

    さらに、ADDRESSは、Mailchimp オーディエンス内のmerge fieldとして知られる特別なターゲットフィールドです。 Mailchimp ドキュメント ​は、必要なキーをaddr1、city、state、zip、およびオプションのキーaddr2およびcountryと定義しています。 これらのフィールドの値は文字列である必要があります。 ADDRESS フィールドマッピングのいずれかが存在する場合、宛先はADDRESS オブジェクトをMailchimp APIに渡して更新します。 マッピングされていないADDRESS フィールドは、デフォルトがUSの国を除き、デフォルト値がNULLになります。

    ADDRESS フィールドで使用できるマッピングは次のとおりです。

    table 0-row-2 1-row-2 2-row-2 3-row-2 4-row-2 5-row-2 6-row-2
    ソースフィールド ターゲットフィールド
    xdm: workAddress.street1 Attribute: ADDRESS.addr1
    xdm: workAddress.street2 Attribute: ADDRESS.addr2
    xdm: workAddress.city Attribute: ADDRESS.city
    xdm: workAddress.state Attribute: ADDRESS.state
    xdm: workAddress.postalCode Attribute: ADDRESS.zip
    xdm: workAddress.country Attribute: ADDRESS.country

    例えば、連絡先の既存のアドレスフィールド addr1、city、state、zipの値を132, My Street, Kingston、New York、New York、12401としてcountryの値を更新する場合などです。 countryを更新するには、変更​ (もしあれば) ​と国の新しい値で既存の値を渡す必要があります。 そのため、データセットの値は132, My Street, Kingston、New York、New York、12401、USである必要があります。 繰り返しますが、countryのみを渡し、addr1、city、state、zipの値を指定しない場合、NULLによって上書きされます。

    マッピングが完了した例を次に示します。
    ​ フィールドマッピングを示すExperience Platform UI スクリーンショットの例。

宛先接続のマッピングの提供が完了したら、次へ​を選択します。

データの書き出しを検証する exported-data

宛先が正しく設定されていることを検証するには、次の手順に従います。

  • Mailchimp アカウントに移動します。 次に、Audience ページに移動します。 次に、Manage Contacts メニューを展開し、Groups​を選択します。

オーディエンスグループページを示す Mailchimp UIのスクリーンショット。

  • 「グループ」を選択し、選択したオーディエンスがExperience Platformのオーディエンス名を持つカテゴリとして作成されているかどうかを確認します。その後、自動生成されたサフィックスが続く可能性があります。
    • この宛先では、選択したセグメントの名前を使用して、Mailchimp 興味カテゴリの追加APIを使用して興味カテゴリを作成します。 新しい宛先を作成し、同じオーディエンスを再びアクティブ化すると、Mailchimpは既存のセグメントと新しいセグメントを区別する接尾辞を追加します。
  • グループにメールが存在しなかった連絡先が、新しく作成したカテゴリに追加されます。
  • グループ内に既に存在する連絡先の場合、属性フィールドデータが更新され、連絡先が新しく作成されたカテゴリに追加されます。

オーディエンスグループのカテゴリを示す Mailchimp UIのスクリーンショット。

データの使用とガバナンス data-usage-governance

Adobe Experience Platform のすべての宛先は、データを処理する際のデータ使用ポリシーに準拠しています。 Adobe Experience Platform がどのようにデータガバナンスを実施するかについて詳しくは、データガバナンスの概要を参照してください。

エラーとトラブルシューティング errors-and-troubleshooting

Mailchimp API キーまたはデータセンターの値が正しくない場合にエラーが発生しました incorrect-credentials-error

パスワード フィールドまたは​ データセンター ​の値で指定したAPI キーが正しくない場合、UIには次のようにMailchimp API エラー応答​ No options are available. Please verify the values selected for the following dependent fields: dataCenter ​が表示されます。 この場合、「オーディエンス名」フィールドから値を選択できません(最初にデータセンターを選択してください)。

Mailchimp API キーまたはデータセンターの値が正しくない場合のエラーを示すExperience Platform UIのスクリーンショット。

このエラーを修正して次の手順に進むには、正しい値を指定する必要があります。 Identify Mailchimp data centerを参照し、
ガイダンスが必要な場合は、API キーのセクションを Mailchimp 収集してください。

Mailchimp グループ名の制限を超えるとエラーが発生しました group-name-limits-error

宛先の作成時に、次のエラーメッセージが表示される場合があります:Cannot have more than 60 interests per list (Across all categories)​または​400 BAD_REQUEST。 これは、​ ガードレール ​の節で説明しているように、1つのグループまたは同じオーディエンス制限内の複数のグループで60個のグループ名(または関心カテゴリ)を超えた場合に発生します。 このエラーを修正するには、Mailchimpでグループ名の制限を超えていないことを確認してください。

Mailchimp ステータスとエラーコード mailchimp-status-error-codes

ステータスコードとエラーコードの包括的なリストについては、Mailchimp エラーのページ ​を参照してください。

その他のリソース additional-resources

Mailchimp ドキュメントのその他の有用な情報は次のとおりです。

recommendation-more-help
experience-platform-help-destinations