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目标之前,您必须在Experience Platform中创建一个架构数据集区段

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

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

您必须拥有Mailchimp帐户 prerequisites-account

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

收集Mailchimp API密钥 gather-credentials

您需要您的Mailchimp API密钥 ​来针对您的Mailchimp帐户验证Mailchimp Interest Categories目标。 当您对目标进行身份验证时,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受众中每个受众最多可以包含60个组名(或兴趣类别),这些组名可以位于单个组中,也可以跨同一受众内的多个组。 有关所需的任何说明,请参阅Mailchimp 。 达到此限制后,您会从Mailchimp API收到400 BAD_REQUEST Cannot have more than 60 interests per list (Across all categories)消息作为错误响应。

此外,有关Mailchimp API施加的限制的详细信息,请参阅Mailchimp 速率限制

支持的身份 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
如果您在​ 密码 ​字段中提供的API密钥或​ 数据中心 ​值不正确,则UI显示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之间的可用映射如下:
    | Source字段 | 目标字段 | 注释 |
    | — | — | — |
    |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 文档将必需键定义为addr1citystatezip,并将可选键定义为addr2country。 这些字段的值必须为字符串。 如果存在任何ADDRESS字段映射,则目标会将ADDRESS对象传递到Mailchimp API进行更新。 除国家/地区默认为US外,任何未映射的ADDRESS字段的值均默认为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

    例如,您希望使用联系人的现有地址字段addr1citystatezip的值更新country的值,即132, My Street, KingstonNew YorkNew York12401。 要更新country,您必须传递更改​ (如果有) ​的现有值和国家/地区的新值。 因此,数据集中的值应为132, My Street, KingstonNew YorkNew York12401US。 为了重申,如果您仅传递country并且不提供addr1citystatezip的值,则这些值将被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

如果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密钥或数据中心值不正确,则显示错误的Platform 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