Mailchimp Interest Categories 连接

Mailchimp 是一个流行的营销自动化平台和电子邮件营销服务,企业使用它来管理和联系联系人 (客户、客户或其他利益关系方) 使用邮件列表和电子邮件营销活动。 使用此连接器可以根据联系人的兴趣和偏好对他们进行排序。

Mailchimp Interest Categories 用途 受众和兴趣类别 (也称为组名或组标题). 每个 Mailchimp 组是兴趣类别的列表。 当联系人通过您网站上的注册表单订阅一个或多个兴趣类别时,他们就会与兴趣类别相关联。 在受众中,您还可以将联系人组织到组中,并将其与兴趣类别关联,然后可以使用这些组来创建区段。 您可以使用这些受众向订阅的联系人广播定向的活动电子邮件。

此 Adobe Experience Platform 目标 使用 Mailchimp batch subscribe or unsubscribe API 要创建的API 兴趣类别 然后将每个选定平台受众的联系人添加到相应的兴趣类别中。 您可以 添加新联系人更新现有的信息 Mailchimp 联系人,则 从所需组中添加或删除这些用户 在现有 Mailchimp 受众,然后在新区段中激活它们。 Mailchimp Interest Groups 将来自Platform的选定受众名称用作中的兴趣类别 Mailchimp.

用例 use-cases

为了帮助您更好地了解您应该如何以及何时使用 Mailchimp Interest Categories 目标,以下是Adobe Experience Platform客户可以使用此目标解决的示例用例。

向营销活动的联系人发送电子邮件 use-case-send-emails

一家体育用品网站的销售部希望向一连串自称对足球感兴趣的熟人广播一个基于电子邮件的营销活动。 联系人列表在从网站开发团队收到的数据导出中分批显示,因此需要对其进行跟踪。 团队发现现有的 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 目标,您必须拥有 架构, a 数据集、和 区段 创建于 Experience Platform.

的先决条件 Mailchimp Interest Categories 目标 prerequisites-destination

请注意以下先决条件,以便将数据从Platform导出到 Mailchimp 帐户:

您必须拥有 Mailchimp 帐户 prerequisites-account

在创建之前 Mailchimp Interest Categories 目标,您必须首先确保 Mailchimp 帐户。 如果您还没有这样的网站,请访问 Mailchimp 注册页面 注册并创建您的帐户。

收集 Mailchimp API密钥 gather-credentials

您需要您的 Mailchimp API密钥 验证 Mailchimp Interest Categories 针对您的目标 Mailchimp 帐户。 此 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 受众可以在一个群组中包含最多60个群组名称(或兴趣类别),也可以跨同一受众内的多个群组。 请参阅 Mailchimp 以取得任何澄清。 达到此限制后,您将 400 BAD_REQUEST Cannot have more than 60 interests per list (Across all categories) 作为错误响应的消息 Mailchimp API。

此外,请参阅 Mailchimp 速率限制 欲详细了解 Mailchimp API。

支持的身份 supported-identities

Mailchimp 支持激活下表中描述的标识。 了解有关 身份.

目标身份
描述
注意事项
电子邮件
联系人电子邮件地址
必需

导出类型和频率 export-type-frequency

有关目标导出类型和频率的信息,请参阅下表。

项目
类型
注释
导出类型
基于配置文件
  • 您正在导出区段的所有成员以及所需的架构字段 (例如:电子邮件地址、电话号码、姓氏),根据您的字段映射。
  • 对于Platform中的每个选定受众,将 Mailchimp Interest Categories 区段状态将从Platform更新为受众状态。
导出频率
流目标为基于API的“始终运行”连接。 当基于受众评估在Experience Platform中更新用户档案时,连接器将更新发送到下游目标平台。 详细了解 流目标.

连接到目标 connect

IMPORTANT
要连接到目标,您需要 查看目标管理目标 访问控制权限. 阅读 访问控制概述 或与产品管理员联系以获取所需的权限。

要连接到此目标,请按照 目标配置教程. 在配置目标工作流中,填写下面两个部分中列出的字段。

范围 目标 > 目录,搜索 Mailchimp Interest Categories. 或者,您也可以在 电子邮件营销 类别。

验证目标 authenticate

要向目标进行身份验证,请填写以下必填字段并选择 连接到目标.

字段
描述
用户名
您的 Mailchimp Interest Categories 用户名。
密码
您的 Mailchimp API密钥,您已在 收集 Mailchimp 凭据 部分。
您的API密钥采用以下形式 {KEY}-{DC},其中 {KEY} 部分指 Mailchimp API密钥 部分和 {DC} 部分是指 Mailchimp 数据中心.
您可以提供 {KEY} 部分或整个表单。
例如,如果您的API密钥为
0123456789abcdef0123456789abcde-us14
您可以提供​*0123456789abcdef0123456789abcde或​0123456789abcdef0123456789abcde-us14*作为值。

显示如何进行身份验证的平台UI屏幕截图。

如果提供的详细信息有效,UI将显示 已连接 带有绿色复选标记的状态。 然后,您可以继续执行下一步。

填写目标详细信息 destination-details

要配置目标的详细信息,请填写下面的必需和可选字段。 UI中字段旁边的星号表示该字段为必填字段。

显示目标详细信息的平台UI屏幕截图。

字段
描述
名称
将来用于识别此目标的名称。
描述
可帮助您以后识别此目标的描述。
数据中心
您的 Mailchimp 帐户 data center. 请参阅 识别 Mailchimp 数据中心 部分获取任何指导。
受众名称(请先选择数据中心)
选择您的 数据中心,此下拉列表中自动填充您的 Mailchimp 帐户。 选择要使用Platform中的数据更新的受众。
兴趣类别(请先选择数据中心和受众名称)
选择您的 受众名称,此下拉菜单自动填充了您网站上的 Mailchimp 帐户。 选择要使用Platform中的数据更新的类别名称。
TIP
如果您在 密码 字段或 数据中心 值不正确,用户界面显示 Mailchimp API错误响应: No options are available. Please verify the values selected for the following dependent fields: dataCenter 如下所示。 在这种情况下,您无法从 受众名称(请先选择数据中心) 字段。 要修复此错误,请提供正确的值。

启用警报 enable-alerts

您可以启用警报,以接收有关发送到目标的数据流状态的通知。 从列表中选择警报以订阅接收有关数据流状态的通知。 有关警报的详细信息,请参阅以下内容中的指南: 使用UI订阅目标警报.

完成提供目标连接的详细信息后,选择 下一个.

激活此目标的受众 activate

IMPORTANT
  • 要激活数据,您需要 查看目标激活目标查看配置文件、和 查看区段 访问控制权限. 阅读 访问控制概述 或与产品管理员联系以获取所需的权限。
  • 要导出 身份,您需要 查看身份图 访问控制权限.
    选择工作流中突出显示的身份命名空间以将受众激活到目标。 {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属性或选择 选择身份命名空间 并选择身份。

  3. 选择目标字段 窗口中,选择 选择身份命名空间 并选择身份或选择 选择属性 类别并从填充自 Mailchimp API。 已添加到所选内容的任何自定义属性 Mailchimp 受众也可以选择作为目标字段。

    XDM配置文件架构与之间的可用映射 Mailchimp Interest Categories 如下所示: | 源字段 | 目标字段 | 注释 | | — | — | — | |IdentityMap: Email|Identity: email| 必需:是 | |xdm: person.name.firstName|Attribute: FNAME| | |xdm: person.name.lastName|Attribute: LNAME| | |xdm: person.birthDayAndMonth|Attribute: BIRTHDAY| |

    此外, ADDRESS 是一个特殊的目标字段,称为 merge field 在您的 Mailchimp 受众。 此 Mailchimp 文档 将所需的键定义为 addr1citystate、和 zip和可选键 addr2country. 这些字段的值必须为字符串。 如果任何 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 使用联系人的现有地址字段 addr1citystate、和 zip132, My Street, KingstonNew YorkNew York12401. 要更新 country 您必须传递包含更改的现有值 (如有) 以及国家的新价值。 因此,数据集中的值应 132, My Street, KingstonNew YorkNew York12401、和 US. 再次重申,如果您只通过 country 并且不提供以下值 addr1citystate、和 zip 它们将被覆盖 NULL.

    下面显示了具有已完成映射的示例:
    显示字段映射的平台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

在以下情况下遇到错误: Mailchimp API密钥或数据中心值不正确 incorrect-credentials-error

如果您在 密码 字段或 数据中心 值不正确,用户界面显示 Mailchimp API错误响应: No options are available. Please verify the values selected for the following dependent fields: dataCenter 如下所示。 在这种情况下,您无法从 受众名称(请先选择数据中心) 字段。

如果您的Mailchimp API密钥或数据中心值不正确,则平台UI屏幕截图显示错误。

要修复此错误并继续进行下一步,您必须提供正确的值。 请参阅 识别 Mailchimp 数据中心
收集 Mailchimp API密钥 需要指导的区域。

在以下情况下遇到错误: Mailchimp 超过组名称限制 group-name-limits-error

在创建目标时,您可能会收到以下错误消息: Cannot have more than 60 interests per list (Across all categories)400 BAD_REQUEST. 当单个组中或同一受众限制内跨多个组超过60个组名称(或兴趣类别)时(如 护栏 部分。 要修复此错误,请确保不超过中的组名称限制 Mailchimp.

Mailchimp 状态和错误代码

请参阅 Mailchimp 错误页面 以获取状态和错误代码的完整列表及其说明。

其他资源 additional-resources

其他有用信息来自 Mailchimp 文档如下所示:

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