README

本插件提供了OroCRM与MailChimp服务的集成。允许将营销列表链接到MailChimp服务，并在OroCRM中接收MailChimp电子邮件营销活动的统计数据。

设置连接

首先，需要创建一个新的类型为“MailChimp”的集成。

转到“系统 -> 集成”，然后点击“创建集成”按钮。

• 类型：必须设置为MailChimp
• 名称：必须填写有意义的集成名称
• API密钥：是来自您的MailChimp个人资料页面的MailChimp API密钥。 关于API密钥
• 检查连接：仅在填写了API密钥后出现。点击按钮以使用给定的API密钥检查与MailChimp API的连接。
• 默认所有者：选择集成的所有者。所有从集成导入的实体都将分配给所选用户。

将营销列表连接到MailChimp

集成创建并启用后，可以将营销列表连接到MailChimp。

只有包含电子邮件字段的营销列表可以连接。

如果营销列表适合连接，则“连接到MailChimp”按钮将出现在营销列表视图页面上。一个营销列表只能连接到一个MailChimp集成。OroCRM营销列表在MailChimp中表示为某个列表的静态分段。

MailChimp API不允许创建列表，因此至少必须存在一个列表才能将成员加载到MailChimp中。 创建新列表

当点击“连接到MailChimp”按钮时，将出现以下表单

• MailChimp分段名称：是在MailChimp订阅者列表中创建的MailChimp静态分段的名称
• MailChimp集成：是MailChimp集成选择器
• MailChimp订阅者列表：是创建成员静态分段的MailChimp订阅者列表

连接已保存后，将安排创建新的静态分段以及成员同步作业。

作业队列守护程序必须运行。

连接到MailChimp的营销列表必须包含电子邮件字段。列表的连接设置作为MailChimp操作添加到它们的视图页面上。可用选项为“连接设置”、“断开连接”和“同步”。同步选项仅适用于已同步状态下的列表。

创建MailChimp营销活动

营销列表成员可用于发送MailChimp营销活动。OroCRM营销列表映射到MailChimp列表的静态分段。只有在将活动发送到连接到OroCRM的静态分段时，OroCRM才会收集活动统计信息。 更多关于MailChimp营销活动

导入同步逻辑

导入使用 oro:cron:integration:sync cron命令执行。

• 列表：所有MailChimp列表都导入带有合并变量信息
• 静态分段：只有与营销列表连接的分段同步
• 活动：只有发送到连接到OroCRM营销列表的静态分段的已发送活动被导入。

将为MailChimp活动在OroCRM中创建新的电子邮件活动，并在后续的导入中同步。

• 成员：所有连接到OroCRM静态段的列表成员都会被导入。使用带有“自”过滤器的导出API
• 成员活动：成员活动会被加载到已导入OroCRM的活动中。使用带有“自”过滤器的导出API

每个成员活动都会通过电子邮件映射到OroCRM营销列表项目和电子邮件活动静态。如果在营销列表中存在多个具有相同电子邮件的实体，则可能会创建多个营销列表项目和电子邮件活动静态记录。活动“打开”、“点击”、“退订”、“滥用”会增加电子邮件活动静态的相应计数器。'已发送'活动会增加“联系次数”计数器并设置营销列表项目的“上次联系时间”变量。

导出逻辑

导出使用oro:cron:mailchimp:export定时命令执行。

在将营销列表成员与MailChimp同步的过程中执行以下步骤：首先，检查所有营销列表成员是否订阅了MailChimp列表。未订阅的成员将被安排订阅。之后，将所有不在静态段中的营销列表成员安排批量添加到该段。所有在静态段中但不在营销列表中的成员将被安排从静态段中删除。

在段导出过程中有4个步骤

• handle_add_state：将新成员添加到MailChimp
• handle_remove_state：从MailChimp的段中删除成员
• handle_unsubscribe_state：从MailChimp的列表中退订成员
• handle_delete_state：从MailChimp的列表中删除成员

扩展合并变量

扩展合并变量是一种添加MailChimp合并变量的功能。合并变量是从营销列表段的定义中创建的。合并变量等于段定义中的列。然后，可以使用合并变量来个性化MailChimp电子邮件模板。在导出过程中执行以下步骤

• 从段定义创建扩展合并变量
• 创建MailChimp合并变量并将其值导出到列表中的每个MailChimp订阅者

如果段建立在购物车实体上，则预定义的购物车项合并变量将被添加。目前它限制为3个购物车项。

已知问题

电子邮件活动统计和MailChimp统计可能不同。电子邮件活动统计是基于导出API数据进行计算的，目前它只包含点击和打开。MailChimp统计包含MailChimp电子邮件活动的汇总统计。