Mailchimp事件转发扩展概述
邮差 事件转发 扩展将事件发送到Mailchimp营销API,这可以触发Mailchimp营销活动、历程或交易的电子邮件。
本文档介绍如何使用Add Event操作设置扩展和配置规则。
先决条件
本文档假设您熟悉扩展使用的相关Mailchimp产品。 有关详细信息,请参阅Mailchimp帮助文档 营销活动, 历程、和 交易.
使用此扩展需要Mailchimp帐户。 您可以注册帐户 此处. 在Mailchimp帐户仪表板中,请注意本指南中使用的以下值:
- 您的Mailchimp域前缀
- 您的API密钥
- 受众ID
- 默认的“发件人”电子邮件地址
根据您的Mailchimp客户计划,您对Mailchimp客户历程工具的访问权限可能会受到限制。
域前缀
登录Mailchimp并登录功能板视图后,浏览器的地址栏应显示URL,如 https://us11.admin.mailchimp.com
或只是 us11.admin.mailchimp.com
. 在此示例中,前缀为 us11
只是占位符,您的值将不同。 在后续步骤中使用前缀记录您的URL。
API密钥
要查找您帐户的API密钥,请在Mailchimp UI中选择您的配置文件图标,然后选择 个人资料. 您应会看到URL,如 https://us11.admin.mailchimp.com/account/profile/
但使用 您的 前缀而不是 us11
.
选择 其他内容,则 API密钥:
下 您的API密钥,您可以选择现有密钥,也可以选择 创建密钥 以创建一个新的存储库。 您可以创建一个新键以专门用于此扩展。 复制API密钥并将其保存以供稍后步骤使用。 有关更多详细信息,请参阅Mailchimp文档,了解如何 生成API密钥.
受众ID和发件人地址
选择 受众 在左侧导航中,然后 受众仪表板. 接下来,选择要与此扩展一起使用的受众。 要了解更多信息,请参阅上的Mailchimp文档 创建受众.
创建并选择受众后,选择 管理受众 下拉菜单并选择 设置. 此屏幕显示受众的各种设置。
在“设置”屏幕底部,您应会看到 Unique id for audience [audience name]
位置 [audience name]
是实际受众的名称。 复制受众ID并将其保存以供稍后步骤使用。
选择 受众名称和默认值 并确认 默认发件人电子邮件地址 具有正确的营销活动值。 请注意,此页面顶部还列出了受众ID,与您在上一步中向下复制的值相同。
Mailchimp自动化
根据您的Mailchimp计划以及您使用事务性电子邮件、客户历程或其他Mailchimp自动化,您的特定旅程设置可能会有所不同。
安装和配置
此部分列出了安装和配置扩展的步骤。 要安全地保存Mailchimp API密钥,您必须使用事件转发 密钥.
创建密码和数据元素
在事件转发属性中, 创建 令牌 密码 已调用 Mailchimp API Key
.
下一步, 创建数据元素 使用 核心 扩展和 密码 要引用 Mailchimp API Key
你刚刚创建的密码。 输入 Mailchimp Token
作为数据元素名称。
安装和配置扩展
在同一事件转发属性中,选择 扩展, 则 目录 以显示可用于安装的扩展。 在此处,搜索Mailchimp扩展并选择 安装.
出现配置屏幕。 下 Mailchimp服务器前缀域名,输入您之前从Mailchimp帐户复制的域,包括唯一的域前缀。
http://
或 https://
在此字段中。
下 Mailchimp令牌,选择数据元素图标,然后选择 Mailchimp Token
您之前创建的数据元素。 选择 保存 以保存更改。
扩展现在已安装并配置为可在资产中使用。
数据收集
在中使用此扩展时 规则,则扩展会通过每个事件向Mailchimp发送多个数据值。 对于典型实施,您可以配置 Adobe Experience Platform Web SDK扩展 以将该数据发送至 Platform Edge Network 以供扩展在事件转发属性中使用。
此扩展所需的数据可以作为XDM数据从Web SDK发送(使用 xdm
对象)或非XDM数据(使用 data
对象)。
例如,如果客户购买产品或注册了您网站上的事件,则您可以使用此扩展通过Mailchimp发送确认电子邮件。 将所需信息从Web SDK发送到Edge Network后,该扩展将通过Mailchimp触发电子邮件。
数据元素
上一部分中的屏幕截图显示了可随每个事件一起从此扩展发送到Mailchimp的数据。 在配置Web SDK以将此数据发送到Edge Network后,您可以在事件转发属性中创建数据元素,以便扩展可以访问这些值。
下表提供了每个可能值的更多详细信息。
email
arc.event.xdm._tenant.emailId
或
arc.event.data._tenant.emailId
listId
arc.event.xdm._tenant.listId
或
arc.event.data._tenant.listid
name
arc.event.xdm._tenant.name
或
arc.event.data._tenant.name
properties
arc.event.xdm._tenant.properties
或
arc.event.data._tenant.properties
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
在事件转发属性中,您可以为上述每个字段创建一个数据元素。 创建后,您可以引用以下位置中的数据元素: 添加事件 此扩展的操作中执行了此调用。
您现在可以使用此扩展和Add Event操作来触发受众的Mailchimp电子邮件。
数据验证
使用事件转发扩展时, Adobe Experience Platform Debugger 非常有用。 在日志部分的边缘日志下方,您可以看到事件转发规则在触发请求后发出的请求。 以下屏幕截图显示了扩展对Mailchimp API发出的请求。
在Mailchimp仪表板中,受众或受众成员的“活动信息源”视图上提供了该受众或受众成员的事件列表。 此操作应该匹配扩展发送的事件,并显示发送的任何可选数据以及它们收到的电子邮件或营销活动。 请参阅 Mailchimp自动化帮助指南 以了解更多详细信息。