dadolun95/magento2-brevo-sendinblue

Magento2 Brevo(以前称为Sendinblue)订单同步集成模块

1.0.14 2023-09-02 09:40 UTC

README

Latest Stable Version

功能

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密钥:image image 启用调试选项后,模块将在/var/log/sendinblue-integration.log文件中的专用文件中记录每个API v3调用结果和响应代码,以及观察者调用。请记住,在生产环境中启用调试选项可能会降低网站速度。

启用Brevo访客跟踪,以便通过API(始终同步和客户端)在Brevo上注册每位客户的页面浏览量:image image 记得在Brevo上启用跟踪,然后从Magento配置中的js片段复制您的客户端密钥:image image 选择“同步”和“异步”同步类型。

  • “同步”模式(不推荐)将在每个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表单] > Temp - DOUBLE OPTIN(需要确认的联系临时移动到这里)
  • [magento] > 订阅 完成联系同步配置,选择您想要同步联系(订阅创建列表)的Brevo列表。您还可以在Brevo上创建新的列表和文件夹,并为每个配置的magento商店选择不同的列表(例如,对于在美国工作的网站,使用subscriptions_USA,对于在欧洲工作的网站,使用subscriptions_EU)。image

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

php bin/magento queue:consumers:start sibOrderProcessor

启用“Brevo追踪遗弃购物车”允许您通过客户端API将事件注册到Brevo跟踪。以下事件被管理:

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

对于 Magento 2.4.4 和 Magento 2.4.5,您可以安装 MageplazaMagepal SMTP 模块。对于 2.4.6 及更高版本,请使用 Magento 核心SMTP 配置功能。Brevo SMTP 设置位于“事务 > 设置”部分:[点击查看图片](https://user-images.githubusercontent.com/8927461/243324031-82af3caa-af3c-4ad9-96ee-caaa5c1804c0.png?jwt=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpc3MiOiJnaXRodWIuY29tIiwiYXVkIjoicmF3LmdpdGh1YnVzZXJjb250ZW50LmNvbSIsImtleSI6ImtleTUiLCJleHAiOjE3MjY4MjQzOTYsIm5iZiI6MTcyNjgyNDA5NiwicGF0aCI6Ii84OTI3NDYxLzI0MzMyNDAzMS04MmFmM2NhYS1hZjNjLTRhZDktOTZlZS1jYWFhNWMxODA0YzAucG5nP1gtQW16LUFsZ29yaXRobT1BV1M0LUhNQUMtU0hBMjU2JlgtQW16LUNyZWRlbnRpYWw9QUtJQVZDT0RZTFNBNTNQUUs0WkElMkYyMDI0MDkyMCUyRnVzLWVhc3QtMSUyRnMzJTJGYXdzNF9yZXF1ZXN0JlgtQW16LURhdGU9MjAyNDA5MjBUMDkyMTM2WiZYLUFtei1FeHBpcmVzPTMwMCZYLUFtei1TaWduYXR1cmU9ZTEzZWY4Yjg5MzliMzhmM2Q1MTNjMGVlNTVlMmRmNDRiZjdiN2VlZjc5OWU4NzQ1MWZmZDlmM2I0ODUxMTFlZSZYLUFtei1TaWduZWRIZWFkZXJzPWhvc3QifQ.wI5tSrZy3cA_yMZHxGfCwv9QEotCHJkusO_IS6YBKtA) image image

贡献

贡献非常欢迎。为了贡献,请Fork此仓库并提交一个 拉取请求