# Magento 集成
## 集成概述
[Magento](https://business.adobe.com/products/commerce.html) 是一个领先的电子商务平台，可帮助企业大规模管理产品、客户和订单。通过将 Magento 与 Pushwoosh 集成，您可以自动同步客户、订单和废弃购物车，从而实现实时消息传递、定向分段和跨渠道营销自动化，帮助您根据商店活动直接吸引用户并提高转化率。
### 集成类型
**目标**：此集成将数据从您的 Magento 商店推送到 Pushwoosh。
### 前提条件
在继续之前，请确保满足以下条件：
* 有权访问 Magento 管理面板
* 一个有效的 Pushwoosh 帐户
* 您的 Pushwoosh [API 访问令牌](/zh/developer/api-reference/api-access-token/)和[应用代码](/zh/developer/api-reference/api-identifiers/#application-code)
* 在您的 Magento 服务器上安装了 [Composer](https://getcomposer.org/)
* 满足系统要求：
* PHP 7.4 / 8.x
* Magento 2.3 / 2.4
* Elasticsearch 7
* RabbitMQ
### 术语表
实体名称映射（如果不同）：
| Magento | Pushwoosh |
| :---- | :---- |
| 客户 | 用户 |
### 同步实体列表：
* 客户
* 订单
* 废弃购物车
### 用例
* 根据订单创建和购物车废弃事件发送推送通知。
* 根据属性（例如，位置、生日）对客户进行分段，并发送定向营销活动。
* 发送基于浏览器的促销通知。
## 设置集成
### 安装
1. 在您的 Magento 项目根目录中运行以下 Composer 命令：
```shell
composer require pushwoosh/magento2-integration
```
2. 安装包后，运行 Magento 设置以安装模块：
```shell
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 访问密钥的更多信息](/zh/developer/api-reference/api-access-token/)
* **App Code**：输入与您的移动或 Web 应用程序对应的 [Pushwoosh App Code](/zh/developer/api-reference/api-identifiers/#application-code)。
以下是用于同步客户、订单和废弃购物车的可用配置选项。
#### 订单同步配置
定义订单数据在您的 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**：由于错误而未能同步的客户。
#### 网页通知配置
设置为 `Yes` 以启用为您的商店访客提供网页推送通知。设置为 `No` 以禁用此功能。
启用后，您的 Magento 商店可以通过用户的浏览器向他们发送实时消息。通知可用于促销优惠、订单状态更新、废弃购物车提醒和其他营销通信。
#### 保存配置
完成所有必填字段后，单击右上角的 **Save Config** 按钮。如果提示，请清除 Magento 缓存以应用更改。
## 手动同步选项
#### 将选定的客户同步到 Pushwoosh
如果您不想自动同步所有客户，可以手动同步单个或选定的客户。
1. 在 Magento 管理面板中，导航至 **Customers > All Customers**。
2. 找到并选择您希望同步的客户。
3. 从客户列表上方的 **Actions** 下拉菜单中，选择 **Sync to Pushwoosh**。
同步完成后，客户数据将出现在您 Pushwoosh 帐户的 [User Explorer](/zh/product/audience-data-and-segmentation/user-explorer/) 部分，所有相关信息都已从 Magento 传输过来。
#### 将选定的订单同步到 Pushwoosh
如果您不想自动同步所有订单，可以手动同步特定订单。为此：
1. 在 Magento 管理面板中，导航至 **Sales > Orders**。
2. 从列表中选择一个或多个订单。
3. 从 **Actions** 下拉菜单中，选择 **Sync to Pushwoosh**。
同步后，订单将作为 `PW_OrderCreated` 或 `PW_OrderUpdated` 事件（如果订单状态已更改）出现在 Pushwoosh [User Explorer](/zh/product/audience-data-and-segmentation/user-explorer/) 中用户个人资料的“事件”部分，包括详细的订单信息。
#### 同步选定的废弃购物车
要手动同步选定的废弃购物车：
1. 在 Magento 管理面板中，转到 **Abandoned Carts** 部分。
2. 选择您要同步的购物车。
3. 从 **Actions** 下拉菜单中，选择 **Sync to Pushwoosh**。
**注意**：请确保您已在 **Abandoned Cart Sync** 设置中配置了所需的不活动时间段，以确定购物车何时被视为废弃。
同步后，废弃购物车数据将作为 `PW_AbandonedCart` 事件出现在 Pushwoosh [User Explorer](/zh/product/audience-data-and-segmentation/user-explorer/) 中用户个人资料的**事件**部分，并附有详细信息。
此外，用户个人资料上将设置两个标签：
* **Abandoned Cart Date** → `PW_AbandonedCartDate`
* **Abandoned Cart ID** → `PW_AbandonedCartID`
这些标签可用于在您的电子邮件模板中使用连接内容发送废弃购物车提醒。[了解更多](/zh/product/personalization/liquid-templates/#connected-content)
### 验证集成是否正常工作
要确认集成是否正常工作：
1. 在 Magento 中创建一个测试客户。
2. 手动将客户同步到 Pushwoosh。
3. 在您的 Pushwoosh 仪表板中打开 [User Explorer](/zh/product/audience-data-and-segmentation/user-explorer/) 并找到该客户。
如果客户出现在 [User Explorer](/zh/product/audience-data-and-segmentation/user-explorer/) 中，则表示同步成功。