文档Experience Platform标记

Mailchimp事件转发扩展概述

Last update: Tue Jul 16 2024 00:00:00 GMT+0000 (Coordinated Universal Time)
  • 主题：

创建对象：

  • undefined
  • undefined
  • undefined
  • undefined
NOTE
Adobe Experience Platform Launch已更名为Adobe Experience Platform中的一套数据收集技术。 因此，产品文档中的术语有一些改动。 有关术语更改的综合参考，请参阅以下文档。

Mailchimp 事件转发扩展将事件发送到Mailchimp营销API，这可以触发Mailchimp营销活动、历程或交易的电子邮件。

本文档介绍如何使用Add Event操作设置扩展和配置规则。

先决条件

本文档假设您熟悉扩展使用的相关Mailchimp产品。 有关详细信息，请参阅营销活动、历程和交易的Mailchimp帮助文档。

使用此扩展需要Mailchimp帐户。 您可以在此处注册帐户。 在Mailchimp帐户仪表板中，请注意本指南中使用的以下值：

  • 您的Mailchimp域前缀
  • 您的API密钥
  • 受众ID
  • 默认的“发件人”电子邮件地址

根据您的Mailchimp客户计划，您对Mailchimp客户历程工具的访问权限可能会受到限制。

TIP
如果您使用Mailchimp自动化，如事务性电子邮件或客户历程，则步骤和屏幕可能稍有不同，此处列出。 但是，要使用此扩展，您仍需要上述相同的信息。 有关特定帐户和计划的每个值的详细信息，请参阅Mailchimp帮助中心。

域前缀

登录到Mailchimp并登录仪表板视图后，浏览器的地址栏应显示https://us11.admin.mailchimp.com之类的URL或仅显示us11.admin.mailchimp.com。 在此示例中，前缀us11只是占位符，您的值将不同。 在后续步骤中使用前缀记录您的URL。

API密钥

要查找您帐户的API密钥，请在Mailchimp UI中选择您的配置文件图标，然后选择​ 配置文件。 您应该会看到类似https://us11.admin.mailchimp.com/account/profile/的URL，但带有​ 您的 ​前缀而不是us11。

选择​ 额外项，然后选择​ API密钥：

额外菜单，API密钥链接

在​ 您的API密钥 ​下，您可以选择现有密钥，也可以选择​ 创建密钥 ​以创建新密钥。 您可以创建一个新键以专门用于此扩展。 复制API密钥并将其保存以供稍后步骤使用。 有关更多详细信息，请参阅关于如何生成API密钥的Mailchimp文档。

受众ID和发件人地址

在左侧导航中选择​ 受众，然后选择​ 受众仪表板。 接下来，选择要与此扩展一起使用的受众。 若要了解更多信息，请参阅创建受众上的Mailchimp文档。

创建并选择受众后，选择​ 管理受众 ​下拉菜单，然后选择​ 设置。 此屏幕显示受众的各种设置。

在“设置”屏幕底部，您应该看到Unique id for audience [audience name]，其中[audience name]是实际受众的名称。 复制受众ID并将其保存以供稍后步骤使用。

选择​ 受众名称和默认值，并确认​ 默认发件人电子邮件地址 ​具有正确的营销活动值。 请注意，此页面顶部还列出了受众ID，与您在上一步中向下复制的值相同。

Mailchimp自动化

根据您的Mailchimp计划以及您使用事务性电子邮件、客户历程或其他Mailchimp自动化，您的特定旅程设置可能会有所不同。

IMPORTANT
您选择用于在Mailchimp中触发自动化或历程的事件名称与必须使用此扩展发送的事件名称相同。 记下Mailchimp自动化中的事件名称，并将其保存以供稍后步骤使用。

安装和配置

此部分列出了安装和配置扩展的步骤。 若要安全地保存Mailchimp API密钥，必须使用事件转发密钥。

创建密码和数据元素

在事件转发属性中，创建名为Mailchimp API Key的令牌密码。

接下来，使用Core扩展和Secret数据元素类型创建数据元素以引用您刚刚创建的Mailchimp API Key密码。 输入Mailchimp Token作为数据元素名称。

安装和配置扩展

在同一事件转发属性中，选择​ 扩展、 ​和​ 目录 ​以显示可供安装的扩展。 从此处搜索Mailchimp扩展并选择​ 安装。

安装Mailchimp扩展

出现配置屏幕。 在​ Mailchimp服务器前缀域名 ​下，输入您之前从Mailchimp帐户复制的域，包括唯一的域前缀。

IMPORTANT
请勿在此字段中包含http://或https://。

扩展配置

在​ Mailchimp令牌 ​下，选择数据元素图标，然后选择您之前创建的Mailchimp Token数据元素。 选择​ 保存 ​以保存更改。

扩展现在已安装并配置为可在资产中使用。

数据收集

在规则中使用此扩展时，该扩展会通过每个事件向Mailchimp发送多个数据值。 对于典型实施，您可以将Adobe Experience Platform Web SDK扩展配置为将该数据发送到Platform Edge Network，以供扩展在事件转发属性中使用。

此扩展所需的数据可以作为XDM数据（使用xdm对象）或非XDM数据（使用data对象）从Web SDK发送。

例如，如果客户购买产品或注册了您网站上的事件，则您可以使用此扩展通过Mailchimp发送确认电子邮件。 将所需信息从Web SDK发送到Edge Network后，该扩展会通过Mailchimp触发电子邮件。

添加事件操作配置

数据元素

上一部分中的屏幕截图显示了可随每个事件一起从此扩展发送到Mailchimp的数据。 在配置Web SDK以将此数据发送到Edge Network后，您可以在event forwarding属性中创建数据元素，以便扩展可以访问这些值。

下表提供了每个可能值的更多详细信息。

名称
示例路径
类型
描述
必需
限制
email
arc.event.xdm._tenant.emailId
或
arc.event.data._tenant.emailId
字符串
接收电子邮件的地址
是
必须存在于Mailchimp受众中
listId
arc.event.xdm._tenant.listId
或
arc.event.data._tenant.listid
字符串
受众 ID
是
必须匹配现有的受众ID
name
arc.event.xdm._tenant.name
或
arc.event.data._tenant.name
字符串
事件名称
是
2-30个字符长
properties
arc.event.xdm._tenant.properties
或
arc.event.data._tenant.properties
对象
JSON格式的可选属性列表，其中包含有关事件的详细信息
否
isSyncing
arc.event.xdm._tenant.isSyncing
或
arc.event.data._tenant.isSyncing
布尔
使用is_syncing设置为true 创建的事件将不会 ​触发自动处理
否
occurredAt
arc.event.xdm._tenant.occuredAt
或arc.event.data._tenant.occuredAt
字符串
事件发生时间的ISO 8601时间戳
否
IMPORTANT
上述​ 示例路径 ​值仅为示例。 这些数据元素中引用的字段名称和路径在属性中可能不同，具体取决于您在上面的步骤中命名和配置Web SDK的方式。

在事件转发属性中，您可以为上述每个字段创建一个数据元素。 创建后，您可以引用此扩展的添加事件操作中的数据元素。

添加事件操作配置

您现在可以使用此扩展和Add Event操作来触发受众的Mailchimp电子邮件。

数据验证

使用事件转发扩展时，Adobe Experience Platform Debugger非常有用。 在日志部分的Edge日志下，您可以查看事件转发规则触发后发出的请求。 以下屏幕截图显示了扩展对Mailchimp API发出的请求。

Adobe Experience Platform Debugger

在Mailchimp仪表板中，受众或受众成员的“活动信息源”视图上提供了该受众或受众成员的事件列表。 此操作应该匹配扩展发送的事件，并显示发送的任何可选数据以及它们收到的电子邮件或营销活动。 有关详细信息，请参阅Mailchimp自动化帮助指南。

recommendation-more-help
12b4e4a9-5028-4d88-8ce6-64a580811743