README

此模块是更具体、扩展的集成模块的直接依赖项（始终开源）：magento2-brevo-sendinblue。

只有当您需要同步Brevo的订阅者且不需要订单同步和购物车事件跟踪时，才安装此扩展。

功能

同步功能：Brevo（以前为Sendinblue）与Magento2集成。此模块将您的Magento2网站与Brevo集成，使您能够优化您的营销策略，在许多场景下创建自动化，并根据您的Magento电子商务网站数据创建活动。

• 简化模块配置
• Sendinblue PHP SDK使用
• 调试日志功能
• 在Brevo上自动同步订阅者数据
• 在Brevo上实现同步和异步数据同步，避免瓶颈
• 在Brevo上跟踪页面浏览和用户导航

兼容性

已完全测试，可在Magento CE(EE) 2.4.4、2.4.5、2.4.6上运行

安装

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

composer require dadolun95/magento2-brevo-sendinblue-light

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

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

配置

您必须从“商店 > 配置 > Dadolun > Brevo > 一般”部分启用模块，并添加您的Brevo API密钥：[图片](https://user-images.githubusercontent.com/8927461/243311198-99b868ef-ecd8-46fa-8d40-2ceb143573ba.png?jwt=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpc3MiOiJnaXRodWIuY29tIiwiYXVkIjoicmF3LmdpdGh1YnVzZXJjb250ZW50LmNvbSIsImtleSI6ImtleTUiLCJleHAiOjE3MjU4MzEyNDYsIm5iZiI6MTcyNTgzMDk0NiwicGF0aCI6Ii84OTI3NDYxLzI0MzMxMTE5OC05OWI4NjhlZi1lY2Q4LTQ2ZmEtOGQ0MC0yY2ViMTQzNTczYmEucG5nP1gtQW16LUFsZ29yaXRobT1BV1M0LUhNQUMtU0hBMjU2JlgtQW16LUNyZWRlbnRpYWw9QUtJQVZDT0RZTFNBNTNQUUs0WkElMkYyMDI0MDkwOCUyRnVzLWVhc3QtMSUyRnMzJTJGYXdzNF9yZXF1ZXN0JlgtQW16LURhdGU9MjAyNDA5MDhUMjEyOTA2WiZYLUFtei1FeHBpcmVzPTMwMCZYLUFtei1TaWduYXR1cmU9ZWQ0OGM5ZGJiMGU1Y2NiMjVkN2MzNzEwNGU3NDRhMmNjMWY1ODcwM2I5MDliYTRkNmU2ZmNiNDExMTdmMDY0YiZYLUFtei1TaWduZWRIZWFkZXJzPWhvc3QmYWN0b3JfaWQ9MCZrZXlfaWQ9MCZyZXBvX2lkPTAifQ.NXXaCsfVbj091tTx1kkPfcLaCnYzXR-rpydrPHnoLO8) [图片](https://user-images.githubusercontent.com/8927461/243311609-69a5cce9-a74f-45fb-a646-1689fd1c456d.png?jwt=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpc3MiOiJnaXRodWIuY29tIiwiYXVkIjoicmF3LmdpdGh1YnVzZXJjb250ZW50LmNvbSIsImtleSI6ImtleTUiLCJleHAiOjE3MjU4MzEyNDYsIm5iZiI6MTcyNTgzMDk0NiwicGF0aCI6Ii84OTI3NDYxLzI0MzMxMTYwOS02OWE1Y2NlOS1hNzRmLTQ1ZmItYTY0Ni0xNjg5ZmQxYzQ1NmQucG5nP1gtQW16LUFsZ29yaXRobT1BV1M0LUhNQUMtU0hBMjU2JlgtQW16LUNyZWRlbnRpYWw9QUtJQVZDT0RZTFNBNTNQUUs0WkElMkYyMDI0MDkwOCUyRnVzLWVhc3QtMSUyRnMzJTJGYXdzNF9yZXF1ZXN0JlgtQW16LURhdGU9MjAyNDA5MDhUMjEyOTA2WiZYLUFtei1FeHBpcmVzPTMwMCZYLUFtei1TaWduYXR1cmU9ZGFkYTgzNTA5OTZmNjU1NzdhNzZlOTNlYmM5ZTRmYjkwYTllZTVhMGI5OTdhOWY4YTQ3MDMwN2JlYWZhZWY3MiZYLUFtei1TaWduZWRIZWFkZXJzPWhvc3QmYWN0b3JfaWQ9MCZrZXlfaWQ9MCZyZXBvX2lkPTAifQ.TdPwAw6jLT30Xdj5g-_MHl2fLIxAbUc1fFi8RCgO0V0) 启用调试器选项后，模块将在/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'
        ]
    ],
...

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

php bin/magento queue:consumers:start sibContactProcessor

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

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

SMTP配置

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

贡献

贡献非常受欢迎。为了贡献，请将此存储库分叉并提交一个 pull request。