Mailchimp Interest Categories 接続
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 です。
データセンター 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 についての詳細情報。
書き出しのタイプと頻度 export-type-frequency
宛先の書き出しのタイプと頻度について詳しくは、以下の表を参照してください。
- セグメントのすべてのメンバーを、フィールドマッピングに従って、必要なスキーマフィールドと共に書き出します （例：メールアドレス、電話番号、姓）。
- Platform で選択した各オーディエンスについて、対応する Mailchimp Interest Categories セグメントのステータスが、Platform のオーディエンスステータスで更新されます。
宛先への接続 connect
この宛先に接続するには、宛先設定のチュートリアルの手順に従ってください。宛先の設定ワークフローで、以下の 2 つのセクションにリストされているフィールドに入力します。
宛先/カタログ 内で、Mailchimp Interest Categories を検索します。 または、メールマーケティング カテゴリの下に配置することもできます。
宛先に対する認証 authenticate
宛先に対して認証するには、以下の必須フィールドに入力し、「宛先に接続」を選択します。
{KEY}-{DC} の形式を取ります。{KEY} の部分は Mailchimp API キーセクションに記載されている値を参照し、{DC} の部分は Mailchimp データセンターを参照します。{KEY} の部分またはフォーム全体を指定できます。例えば、API キーが
*
0123456789abcdef0123456789abcde-us14の場合0123456789abcdef0123456789abcdeまたは0123456789abcdef0123456789abcde-us14*のいずれかを値として指定できます。
指定した詳細が有効な場合、UI で 接続済み ステータスに緑色のチェックマークが付きます。その後、次の手順に進むことができます。
宛先の詳細を入力 destination-details
宛先の詳細を設定するには、以下の必須フィールドとオプションフィールドに入力します。UI のフィールドの横のアスタリスクは、そのフィールドが必須であることを示します。
data center。 詳しくは、 データセンターの特定 Mailchimp に関する節参照してください。No options are available. Please verify the values selected for the following dependent fields: dataCenter を以下に示します。 この場合、「オーディエンス名 フィールドから値を選択することはできません（最初にデータセンターを選択してください）。 このエラーを修正するには、正しい値を指定します。アラートの有効化 enable-alerts
アラートを有効にすると、宛先へのデータフローのステータスに関する通知を受け取ることができます。リストからアラートを選択して、データフローのステータスに関する通知を受け取るよう登録します。アラートについて詳しくは、UI を使用した宛先アラートの購読についてのガイドを参照してください。
宛先接続の詳細の入力を終えたら「次へ」を選択します。
この宛先に対してオーディエンスをアクティブ化 activate
この宛先にオーディエンスをアクティベートする手順は、ストリーミングオーディエンスの書き出し宛先へのプロファイルとオーディエンスのアクティベートを参照してください。
マッピングの考慮事項と例 mapping-considerations-example
Adobe Experience Platformから Mailchimp Interest Categories の宛先にオーディエンスデータを正しく送信するには、フィールドマッピングの手順を実行する必要があります。 マッピングは、Platform アカウント内の Experience Data Model （XDM）スキーマフィールドと、ターゲット宛先から対応する同等のスキーマフィールドとの間にリンクを作成して構成されます。
XDM フィールドを Mailchimp Interest Categories の宛先フィールドに正しくマッピングするには、次の手順に従います。
-
マッピング 手順で、「新しいマッピングを追加」を選択します。これで、新しいマッピング行が画面に表示されます。
-
ソースフィールドを選択 ウィンドウで、属性を選択 カテゴリを選択して XDM 属性を選択するか、ID 名前空間を選択 を選択して ID を選択します。
-
ターゲットフィールドを選択 ウィンドウで、ID 名前空間を選択 を選択して、ID を選択するか、属性を選択 カテゴリを選択して、Mailchimp API から入力された属性のリストから選択します。 選択した Mailchimp オーディエンスに追加したカスタム属性も、ターゲットフィールドとして選択できます。
XDM プロファイルスキーマと Mailchimp Interest Categories の間で使用できるマッピングは次のとおりです。
|Sourceフィールド | ターゲットフィールド |備考 |
| — | — | — |
|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.street1Attribute: ADDRESS.addr1xdm: workAddress.street2Attribute: ADDRESS.addr2xdm: workAddress.cityAttribute: ADDRESS.cityxdm: workAddress.stateAttribute: ADDRESS.statexdm: workAddress.postalCodeAttribute: ADDRESS.zipxdm: workAddress.countryAttribute: 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によって上書きされます。完了したマッピングの例を次に示します。
宛先接続のマッピングの指定が完了したら、「次へ」を選択します。
データの書き出しを検証する exported-data
宛先が正しく設定されていることを検証するには、次の手順に従います。
- Mailchimp アカウントにログインします。 次に、Audience ページに移動します。 次に、Manage Contacts メニューを展開し、「Groups」を選択します。
- グループを選択し、選択したオーディエンスが、Platform のオーディエンス名の後に自動生成されたサフィックスを持つカテゴリとして作成されているかどうかを確認します。
- この宛先は、選択したセグメントの名前を使用して、Mailchimp 興味カテゴリの追加 API を使用して、興味カテゴリを作成します。 新しい宛先を作成し、同じオーディエンスを再度アクティブ化する場合、Mailchimp では、既存のセグメントと新しいセグメントを区別するためにサフィックスが追加されます。
- グループにメールが存在しない連絡先は、新しく作成されたカテゴリに追加されます。
- グループ内に既に存在する連絡先の場合、属性フィールドのデータが更新され、新しく作成されたカテゴリに連絡先が追加されます。
データの使用とガバナンス 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 を以下に示します。 この場合、「オーディエンス名 フィールドから値を選択することはできません（最初にデータセンターを選択してください）。
このエラーを修正して次の手順に進むには、正しい値を指定する必要があります。 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 ドキュメントからのその他の役に立つ情報は次のとおりです。