README

特性

为Brevo（以前是Sendinblue）提供同步功能 - Magento2集成。此模块将您的Magento2站点与Brevo集成，让您可以优化营销策略，在许多场景中创建自动化，并基于您的Magento电子商务网站数据创建活动。

• 简化模块配置
• Sendinblue PHP SDK使用
• 调试日志功能
• 在Brevo上自主同步订阅者数据
• 在Brevo上自主同步每个订阅者报价和订单数据
• 在Brevo上实施同步与异步数据同步，避免瓶颈
• 在Brevo上跟踪页面浏览和用户导航
• 购物车事件同步（允许您管理遗弃的购物车自动化）

兼容性

经过充分测试，在Magento CE(EE) 2.4.4、2.4.5、2.4.6上运行正常

安装

您可以通过将其添加到app/code文件夹或使用composer安装此模块。

composer require dadolun95/magento2-brevo-sendinblue

然后您需要启用模块并更新您的数据库和文件

php bin/magento module:enable Dadolun_SibCore Dadolun_SibContactSync Dadolun_SibOrderSync
php bin/magento setup:upgrade
php bin/magento setup:di:compile

配置

您必须从“商店 > 配置 > Dadolun > Brevo > 通用”部分启用模块，并添加您的Brevo API密钥： 启用调试选项后，模块将在位于 /var/log/sendinblue-integration.log 文件中的专用文件中记录每个API v3调用结果和响应代码，以及观察者调用。请记住，在生产环境中启用调试选项可能会减慢网站速度。

Enable Brevo visitor tracking in order to register each customer pageview on Brevo via API (always synchronous and client-side): Remember to enable tracking on Brevo, then copy you client key from the js snippet on Magento configurations:

必选：您必须在初始设置后启用联系人同步，以在Brevo上同步新闻通讯订阅： 选择“同步”和“异步”同步类型。

• “同步”模式（不建议）将在每个magento2事件（订阅更新/订单更新）时同步Brevo上的订阅者数据，并对Brevo进行API调用
• “异步”模式（推荐）使用magento2消息队列系统，并使用专用的MySQL操作队列（查看消息队列配置指南），因此您还需要配置magento以正确使用消费者，更新您的app/etc/env.php文件（如下所示）

...
    'cron_consumers_runner' => [
        'cron_run' => true,
        'max_messages' => 1000,
        'consumers' => [
            'sibContactProcessor',
            'sibOrderProcessor',
        ]
    ],
...

该模块在adminhtml上提供了一个“同步联系人”CTA，将所有现有联系人移动到Brevo（只在运行时同步新订阅者）。“同步联系人”CTA使用magento2消息队列系统。因此，点击“同步订单”，您只需在队列中添加一个完整的订单同步请求。如果您已选择同步模式，且未在您的magento安装上配置消息队列系统，您需要从您的cli运行此命令，每次您从adminhtml执行完整的“联系人同步”请求时

php bin/magento queue:consumers:start sibContactProcessor

由于已启用联系人同步功能，因此创建了两个Brevo列表

• [Magento Optin 表单] > 临时 - 双重确认（需要确认的联系人暂时移动到这里）
• [magento] > 订阅 完成联系人同步配置，选择您想要同步联系人的Brevo列表（建议使用创建订阅的列表）。您也可以在Brevo中创建新的列表和文件夹，并为每个配置的magento商店选择不同的列表（例如，对于在美国运营的网站，使用subscriptions_USA；对于在欧洲运营的网站，使用subscriptions_EU）。

您可以在“店铺 > 配置 > 大龙 > Brevo > 订单同步”部分启用订单同步。 同步联系人时请注意“同步类型”配置，您必须在“异步”和“同步”模式之间进行选择。建议将联系人同步和订单同步设置为相同的同步模式（异步或同步）。如果您尚未在您的 Magento 安装上配置消息队列系统（如上所述），则每次您从 adminhtml 进行“订单同步”请求时，都需要从您的 cli 运行此命令。

php bin/magento queue:consumers:start sibOrderProcessor

启用“在 Brevo 上跟踪遗弃的购物车”允许您通过客户端 API 将事件注册到 Brevo 跟踪。以下事件由系统管理：

• cart_created
• cart_deleted
• cart_updated
• 订单完成 一旦启用，您需要在Brevo上创建“遗弃购物车”自动化功能。 在每个步骤上配置正确的事件
• 1 入口点
• 3 邮件设置
• 4/5 场景的退出事件 激活自动化 自定义“遗弃购物车”电子邮件模板 那就是全部了，现在您可以使用Brevo自动化管理您的Magento遗弃购物车通知。

SMTP 配置

对于 Magento 2.4.4 和 Magento 2.4.5，您可以安装 Mageplaza 或 Magepal SMTP 模块。对于 2.4.6 及更高版本，请使用 Magento 核心SMTP配置功能。Brevo SMTP 设置位于“事务 > 设置”部分：

贡献

欢迎贡献。为了贡献，请分支此仓库并提交一个 拉取请求。