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 CategoriesAPI キーMailchimpが必要です。 宛先 を 認証すると、API キーは パスワード として機能します。
API キーをお持ちでない場合は、アカウントにサインインし、Mailchimp API キーの生成 ドキュメントを参照して作成してください。
API キーの例は0123456789abcdef0123456789abcde-us14です。
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 グループ を参照してください。 この制限に達すると、400 BAD_REQUEST Cannot have more than 60 interests per list (Across all categories) APIからのエラー応答としてMailchimp メッセージが表示されます。
さらに、Mailchimp APIによって課される制限について詳しくは、 レート制限Mailchimpを参照してください。
サポートされている ID supported-identities
Mailchimpは、次の表に示すIDのアクティブ化をサポートしています。 ID についての詳細情報。
サポートされるオーディエンス supported-audiences
この節では、この宛先に書き出すことができるオーディエンスのタイプについて説明します。 以下の2つの表は、このコネクタがサポートするオーディエンスを示しています。オーディエンスの由来と オーディエンスに含まれるプロファイルタイプ :
このカテゴリには、Segmentation Serviceを通じて生成されたオーディエンス以外のすべてのオーディエンスのオリジンが含まれます。 様々なオーディエンスの起源について読みます。 次に例を示します。
- カスタムアップロードオーディエンス がCSV ファイルからExperience Platformにをインポートしました。
- 類似オーディエンス，
- 連合オーディエンス，
- Adobe Journey Optimizerなどの他のExperience Platform アプリで生成されたオーディエンス
- その他。
オーディエンスのデータタイプ別にサポートされるオーディエンス：
書き出しのタイプと頻度 export-type-frequency
宛先の書き出しのタイプと頻度について詳しくは、以下の表を参照してください。
- セグメントのすべてのメンバーを、フィールドマッピングに従って、必要なスキーマフィールドと共に書き出します（例：メールアドレス、電話番号、姓）。
- Experience Platformで選択した各オーディエンスについて、対応するMailchimp Interest Categories セグメントステータスが、Experience Platformからオーディエンスステータスで更新されます。
宛先への接続 connect
この宛先に接続するには、宛先設定のチュートリアルの手順に従ってください。宛先の設定ワークフローで、以下の 2 つのセクションにリストされているフィールドに入力します。
Destinations > Catalog内で、Mailchimp Interest Categoriesを検索します。 または、Email marketing カテゴリの下に配置することもできます。
宛先に対する認証 authenticate
宛先に対して認証を行うには、以下の必須フィールドに入力し、Connect to destinationを選択します。
お使いのAPI キーは
{KEY}-{DC}の形式になります。ここでは、{KEY}部分はMailchimp API キー セクションに記載されている値を表し、{DC}部分はMailchimp データセンターを表します。{KEY}部分またはフォーム全体を指定できます。例えば、API キーが
0123456789abcdef0123456789abcde-us14、の場合、*
0123456789abcdef0123456789abcdeまたは0123456789abcdef0123456789abcde-us14*のいずれかを値として指定できます。認証方法を示す
指定された詳細が有効な場合、UIには緑色のチェックマークが付いたConnected ステータスが表示されます。 その後、次の手順に進むことができます。
宛先の詳細を入力 destination-details
宛先の詳細を設定するには、以下の必須フィールドとオプションフィールドに入力します。UI のフィールドの横のアスタリスクは、そのフィールドが必須であることを示します。
宛先の詳細を示す
data center ガイダンスについては、Identify Mailchimp data center セクションを参照してください。No options are available. Please verify the values selected for the following dependent fields: dataCenter*が次のように表示されます。 この場合、Audience Name (Please select Data center first) フィールドから値を選択できません。 このエラーを修正するには、正しい値を指定します。アラートの有効化 enable-alerts
アラートを有効にすると、宛先へのデータフローのステータスに関する通知を受け取ることができます。リストからアラートを選択して、データフローのステータスに関する通知を受け取るよう登録します。アラートについて詳しくは、UI を使用した宛先アラートの購読についてのガイドを参照してください。
宛先接続の詳細の提供が完了したら、Nextを選択します。
この宛先に対してオーディエンスをアクティブ化 activate
- データをアクティブ化するには、View Destinations、Activate Destinations、View ProfilesおよびView Segments アクセス制御権限が必要です。 アクセス制御の概要を参照するか、製品管理者に問い合わせて必要な権限を取得してください。
- IDをエクスポートするには、View Identity Graph アクセス制御権限が必要です。
この宛先にオーディエンスをアクティベートする手順は、ストリーミングオーディエンスの書き出し宛先へのプロファイルとオーディエンスのアクティベートを参照してください。
マッピングの考慮事項と例 mapping-considerations-example
オーディエンスデータをAdobe Experience PlatformからMailchimp Interest Categories宛先に正しく送信するには、フィールドマッピング手順を実行する必要があります。 マッピングでは、Experience Platform アカウントのExperience Data Model （XDM）スキーマフィールドと、ターゲット先の対応するスキーマフィールドとの間にリンクを作成します。
XDM フィールドをMailchimp Interest Categories宛先フィールドに正しくマッピングするには、次の手順に従います。
-
Mapping ステップで、Add new mappingを選択します。 新しいマッピング行が画面に表示されるようになりました。
-
Select source field ウィンドウで、Select attributes カテゴリを選択してXDM属性を選択するか、Select identity namespaceを選択してIDを選択します。
-
Select target field ウィンドウで、Select identity namespaceを選択してIDを選択するか、Select attributes カテゴリを選択し、Mailchimp APIから入力された属性のリストから選択します。 選択したMailchimp オーディエンスに追加したカスタム属性は、ターゲットフィールドとして選択することもできます。
XDM プロファイルスキーマとMailchimp Interest Categoriesの間で使用できるマッピングは次のとおりです。
table 0-row-3 1-row-3 2-row-3 3-row-3 4-row-3 ソースフィールド ターゲットフィールド メモ IdentityMap: EmailIdentity: email必須：はい xdm: person.name.firstNameAttribute: FNAMExdm: person.name.lastNameAttribute: LNAMExdm: person.birthDayAndMonthAttribute: BIRTHDAYさらに、
ADDRESSは、merge fieldオーディエンス内のMailchimpとして知られる特別なターゲットフィールドです。 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によって上書きされます。マッピングが完了した例を次に示します。
宛先接続のマッピングの提供が完了したら、Nextを選択します。
データの書き出しを検証する exported-data
宛先が正しく設定されていることを検証するには、次の手順に従います。
- Mailchimp アカウントに移動します。 次に、Audience ページに移動します。 次に、Manage Contacts メニューを展開し、Groupsを選択します。
オーディエンスグループページを示す
- 「グループ」を選択し、選択したオーディエンスがExperience Platformのオーディエンス名を持つカテゴリとして作成されているかどうかを確認します。その後、自動生成されたサフィックスが続く可能性があります。
- この宛先では、選択したセグメントの名前を使用して、Mailchimp 興味カテゴリの追加APIを使用して興味カテゴリを作成します。 新しい宛先を作成し、同じオーディエンスを再びアクティブ化すると、Mailchimpは既存のセグメントと新しいセグメントを区別する接尾辞を追加します。
- グループにメールが存在しなかった連絡先が、新しく作成したカテゴリに追加されます。
- グループ内に既に存在する連絡先の場合、属性フィールドデータが更新され、連絡先が新しく作成されたカテゴリに追加されます。
オーディエンスグループのカテゴリを示す
データの使用とガバナンス data-usage-governance
Adobe Experience Platform のすべての宛先は、データを処理する際のデータ使用ポリシーに準拠しています。Adobe Experience Platform がどのようにデータガバナンスを実施するかについて詳しくは、データガバナンスの概要を参照してください。
エラーとトラブルシューティング errors-and-troubleshooting
Mailchimp API キーまたはデータセンターの値が正しくない場合にエラーが発生しました incorrect-credentials-error
Password フィールドまたは Data center 値で指定したAPI キーが正しくない場合、UIにはMailchimp API エラー応答 No options are available. Please verify the values selected for the following dependent fields: dataCenter が次のように表示されます。 この場合、Audience Name (Please select Data center first) フィールドから値を選択できません。
このエラーを修正して次の手順に進むには、正しい値を指定する必要があります。 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 ドキュメントのその他の有用な情報は次のとおりです。