Magento 集成

需要开发人员协助

您需要开发团队的帮助来设置此集成。请与他们分享本指南。

集成概述

Magento 是一个领先的电子商务平台，可帮助企业大规模管理产品、客户和订单。通过将 Magento 与 Pushwoosh 集成，您可以自动同步客户、订单和废弃购物车，从而实现实时消息传递、目标细分和跨渠道营销自动化，帮助您直接通过店铺活动吸引用户并提高转化率。

集成类型

目标端：此集成将数据从您的 Magento 店铺推送到 Pushwoosh。

前提条件

在继续之前，请确保满足以下条件：

• 拥有 Magento 管理面板的访问权限

• 拥有一个有效的 Pushwoosh 账户

• 您的 Pushwoosh API 访问令牌和应用代码

• 在您的 Magento 服务器上安装了 Composer

• 满足系统要求：

  • PHP 7.4 / 8.x
  • Magento 2.3 / 2.4
  • Elasticsearch 7
  • RabbitMQ

术语表

实体名称映射（如果不同）：

Magento	Pushwoosh
Customer	User (用户)

同步实体列表：

• 客户
• 订单
• 废弃购物车

使用场景

• 根据订单创建和购物车废弃事件发送推送通知。

• 根据客户属性（例如，位置、生日）对客户进行细分，并发送有针对性的营销活动。

• 发送基于浏览器的促销通知。

设置集成

安装

注意

要安装 Pushwoosh 集成，请确保您已安装 Composer。

1. 在您的 Magento 项目根目录中运行以下 Composer 命令：

composer require pushwoosh/magento2-integration

2. 安装包后，运行 Magento setup 来安装模块：

bin/magento setup:upgrade
bin/magento setup:di:compile
bin/magento cache:clean

安装后配置

完成安装后：

1. 登录 Magento 管理面板。

2. 导航至 Stores > Configuration > Pushwoosh > Configuration。

常规设置

在 General 部分，配置以下字段：

• Status：将其设置为 Enable 以激活集成。
• API URL：输入 Pushwoosh API 端点：https://api.pushwoosh.com/
• API Key：粘贴您的 Pushwoosh API 密钥，用于验证请求。 了解有关 Pushwoosh API 访问密钥的更多信息
• App Code：输入与您的移动或 Web 应用程序对应的 Pushwoosh 应用代码。

以下是可用于同步客户、订单和废弃购物车的配置选项。

订单同步配置

定义订单数据如何在您的 Magento 店铺和 Pushwoosh 之间同步。

填写以下字段：

Order Sync Enable	设置为 Yes 以启用自动订单同步。如果启用，该过程将遵循定义的 cron 计划。设置为 No 以禁用自动同步。
Cron Settings	仅在启用订单同步时可用。使用以下字段定义 cron 作业应何时运行：Minute、Hour、Day、Month、Weekday。Cron 是一个基于时间的调度程序，用于按指定间隔自动运行任务。
Order Sync Numbers	指定每次同步执行期间要处理的订单数量。
Order Sync in Real Time	设置为 Yes 以在下单后立即同步订单。

在这里您还可以看到订单同步状态：

• Total Orders：显示为同步评估的订单总数。
• Synced Orders：已成功与 Pushwoosh 同步的订单数量。
• Not Synced Orders：尚未同步的订单。
• Fail Synced Orders：同步尝试失败的订单。

废弃购物车同步配置

配置您的 Magento 店铺和 Pushwoosh 之间废弃购物车数据的同步。

填写以下字段：

Abandoned Cart Syncing	设置为 Yes 以启用废弃购物车数据的自动同步。如果启用，同步将根据定义的 cron 计划运行。
Cron Schedule Configuration	使用以下字段定义同步应何时运行：Minute、Hour、Day、Month、Weekday。Cron 是一个基于时间的作业调度程序，可按指定间隔自动运行任务。
Number of Abandoned Cart	指定每次同步运行时将处理的废弃购物车数量。
Minimum Inactivity Time	设置购物车被视为废弃的最小不活动时间（以分钟为单位）。例如，60 表示不活动至少 60 分钟的购物车将有资格进行同步。

在这里您还可以看到同步活动的实时指标：

• Total Abandoned Carts：被识别为废弃的购物车总数。
• Synced Abandoned Carts：已成功与 Pushwoosh 同步的购物车数量。
• Not Synced Abandoned Carts：尚未同步的购物车数量。
• Fail Synced Abandoned Carts：同步失败的购物车数量。

客户同步配置

配置从您的 Magento 店铺到 Pushwoosh 的客户数据同步，以根据客户属性实现受众细分和个性化消息传递。

填写以下字段：

Customer Syncing	设置为 Yes 以启用所有现有和新客户记录的同步。同步将遵循定义的 cron 计划并使用指定的属性映射。
Cron Schedule Configuration	使用以下字段定义同步应何时运行：Minute、Hour、Day、Month、Weekday。Cron 是一个基于时间的作业调度程序，可按指定间隔自动运行任务。
Mapping Customer Custom Fields	将 Magento 客户属性映射到 Pushwoosh 自定义字段以实现准确的数据传输。示例：Date of Birth → Birthday、First Name → firstName
Number of Customers	设置每次 cron 运行要同步的最大客户数量。

在这里您还可以看到同步统计信息：

• Total Customer：为同步识别的客户记录总数。
• Synced Customer：已成功与 Pushwoosh 同步的客户数量。
• Not Synced Customer：等待同步的客户。
• Fail Synced Customer：因错误而同步失败的客户。

Web 通知配置

设置为 Yes 以启用为您的店铺访客提供的 Web 推送通知。设置为 No 以禁用此功能。

启用后，您的 Magento 店铺可以通过用户的浏览器向他们发送实时消息。通知可用于促销优惠、订单状态更新、废弃购物车提醒和其他营销通讯。

保存配置

完成所有必填字段后，单击右上角的 Save Config 按钮。如果提示，请清除 Magento 缓存以应用更改。

手动同步选项

将选定的客户同步到 Pushwoosh

如果您不想自动同步所有客户，可以手动同步单个或选定的客户。

1. 在 Magento 管理面板中，导航至 Customers > All Customers。
2. 找到并选择您希望同步的客户。
3. 从客户列表上方的 Actions 下拉菜单中，选择 Sync to Pushwoosh。

同步完成后，客户数据将出现在您 Pushwoosh 账户的 User Explorer 部分，所有相关信息都已从 Magento 传输过来。

将选定的订单同步到 Pushwoosh

如果您不想自动同步所有订单，可以手动同步特定订单。为此：

1. 在 Magento 管理面板中，导航至 Sales > Orders。

2. 从列表中选择一个或多个订单。

3. 从 Actions 下拉菜单中，选择 Sync to Pushwoosh。

同步后，订单将作为 PW_OrderCreated 或 PW_OrderUpdated 事件（如果订单状态已更改）出现在 Pushwoosh User Explorer 中用户个人资料的“事件”部分，并包含详细的订单信息。

同步选定的废弃购物车

要手动同步选定的废弃购物车：

1. 在 Magento 管理面板中，转到 Abandoned Carts 部分。
2. 选择您要同步的购物车。
3. 从 Actions 下拉菜单中，选择 Sync to Pushwoosh。

注意： 确保您已在 Abandoned Cart Sync 设置中配置了所需的不活动期限，以确定何时将购物车视为废弃。

同步后，废弃购物车数据将作为 PW_AbandonedCart 事件出现在 Pushwoosh User Explorer 中用户个人资料的 Events 部分，并包含详细信息。

此外，用户个人资料上将设置两个标签：

• Abandoned Cart Date → PW_AbandonedCartDate
• Abandoned Cart ID → PW_AbandonedCartID

这些标签可用于在您的电子邮件模板中使用连接内容发送废弃购物车提醒。 了解更多

验证集成是否正常工作

要确认集成是否正常工作：

1. 在 Magento 中创建一个测试客户。
2. 手动将该客户同步到 Pushwoosh。
3. 在您的 Pushwoosh 仪表板中打开 User Explorer 并找到该客户。

如果该客户出现在 User Explorer 中，则表示同步成功。