ドキュメントExperience Platform宛先ガイド

Mailchimp Interest Categories 接続

Last update: Wed Jul 31 2024 00:00:00 GMT+0000 (Coordinated Universal Time)

作成対象：

  • 管理者
  • ユーザー

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

Mailchimp Interest Categories では、audiences、groups および interest カテゴリ （グループ名またはグループタイトルとも呼ばれます） を使用します。 各 Mailchimp グループは、興味のあるカテゴリのリストです。 連絡先は、web サイト上のサインアップフォームを通じて 1 つ以上の興味カテゴリを購読すると、興味カテゴリに関連付けられます。 オーディエンス内では、連絡先をグループ化して興味のあるカテゴリに関連付け、それらの連絡先を使用してセグメントを作成することもできます。 これらのオーディエンスを使用して、ターゲットキャンペーンメールを登録した連絡先にブロードキャストできます。

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

ユースケース use-cases

Mailchimp Interest Categories 宛先を使用する方法とタイミングを理解しやすくするために、Adobe Experience Platform のお客様がこの宛先を使用して解決できるユースケースのサンプルを以下に示します。

マーケティングキャンペーンの連絡先へのメールの送信 use-case-send-emails

スポーツグッズのウェブサイトの販売部門は、サッカーに興味があると自分自身を識別した連絡先のリストにメールベースのマーケティングキャンペーンを放送したいと考えています。 連絡先のリストは、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

Platform から Mailchimp アカウントにデータを書き出すには、次の前提条件に注意してください。

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

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

API キー Mailchimp 収集 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 です。

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

データセンターの値 （この例では us14）を書き留めておきます、この値は 宛先の詳細を入力する際に必要になります。

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

ガードレール guardrails

各 Mailchimp オーディエンスには、1 つのグループまたは同じオーディエンス内の複数のグループにわたって、最大 60 個のグループ名（または興味のあるカテゴリ）を含めることができます。 詳しくは、Mailchimpgroups を参照してください。 この制限に達すると、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
説明
注意点
メール
連絡先メールアドレス
必須

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

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

項目
タイプ
メモ
書き出しタイプ
プロファイルベース
  • セグメントのすべてのメンバーを、フィールドマッピングに従って、必要なスキーマフィールドと共に書き出します​ （例：メールアドレス、電話番号、姓）。
  • Platform で選択した各オーディエンスについて、対応する Mailchimp Interest Categories セグメントのステータスが、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*のいずれかを値として指定できます。

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

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

宛先の詳細を入力 destination-details

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

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

フィールド
説明
名前
今後この宛先を認識するための名前。
説明
今後この宛先を識別するのに役立つ説明。
データセンター
Mailchimp アカウント data center。 詳しくは、 データセンターの特定 Mailchimp に関する節参照してください。
オーディエンス名（最初にデータセンターを選択してください）
データセンター を選択すると、このドロップダウンに Mailchimp アカウントのオーディエンス名が自動的に入力されます。 Platform のデータで更新するオーディエンスを選択します。
関心のあるカテゴリ（データセンターとオーディエンス名を最初に選択してください）
オーディエンス名 を選択すると、このドロップダウンには Mailchimp アカウントの興味/関心グループのカテゴリ名が自動的に入力されます。 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 の宛先にオーディエンスデータを正しく送信するには、フィールドマッピングの手順を実行する必要があります。 マッピングは、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

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

    「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

    例えば、country の値を連絡先の既存の住所フィールド addr1、city、state で更新し、zip の値を 132, My Street, Kingston、New York、New York、12401 で更新するとします。 country を更新するには、変更 （存在する場合）を使用して既存の値を渡し 国の新しい値を渡す必要があります。 したがって、データセットの値は、132, My Street, Kingston、New York、New York、12401 および US である必要があります。 繰り返しになりますが、country のみを渡し、addr1、city、state および zip の値を指定しない場合、これらは NULL によって上書きされます。

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

宛先接続のマッピングの指定が完了したら、「次へ」を選択します。

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

Mailchimp ステータスおよびエラーコード

ステータスとエラーコードの一覧と説明については、Mailchimp エラーページを参照してください。

その他のリソース additional-resources

Mailchimp ドキュメントからのその他の役に立つ情報は次のとおりです。

recommendation-more-help
7f4d1967-bf93-4dba-9789-bb6b505339d6