# Shopify 集成
## 集成概述
Pushwoosh 与 Shopify 无缝集成，Shopify 是一个领先的电子商务平台，使企业能够创建、管理和扩展在线商店。本指南将引导您在 Shopify 商店中安装和配置 Pushwoosh 应用，设置用户识别，并使用通知和自动化工具在移动和 Web 端与客户互动。
### 集成类型
- **目的地**：Shopify 将客户数据发送到 Pushwoosh，用于定位和消息发送。
### 先决条件
* 一个 [Pushwoosh 账户](https://www.pushwoosh.com/)
* 访问您的 Shopify 管理后台
* Pushwoosh [设备 API 访问令牌](/zh/developer/api-reference/api-access-token/#device-api-token) 和 **应用程序代码**
* 一个拥有客户和订单数据的 Shopify 商店
### 同步实体
* **客户**：用于通过 Shopify 元字段分配和识别 Pushwoosh UserID
* **客户细分**：用于基于群组的定位和消息发送
* **事件和触发器**（例如，下单、应用标签）：用于在 Shopify Flow 中自动化推送消息
* **店面**：用于通过嵌入式脚本捕获 Web 推送选择加入
### 术语表（如果实体名称不同，则进行映射）
| **Shopify** | **Pushwoosh** |
| -------------------------- | --------------------------------------------------------- |
| 客户 | UserID |
## 集成工作原理
Pushwoosh 充当 Shopify 的消息目的地。集成后，Shopify 会将客户和行为数据发送到 Pushwoosh，用于在 Web 和移动端实现实时通知、客户细分和个性化消息。
### 集成的关键组件
1. **通过元字段进行客户识别**
每个 Shopify 客户都会被分配一个唯一的 `UserID`，存储在元字段 (`custom.pushwoosh_userid`) 中。此 ID 允许 Pushwoosh 在不同平台上一致地识别和向用户发送消息。
2. **通过 Shopify Flow 实现事件驱动的自动化**
Pushwoosh 提供了 Flow 操作，允许您根据 Shopify 事件（例如以下事件）自动化推送通知：
* 新订单已下达
* 标签已应用于客户
* 购物车放弃
3. **基于细分的定位**
来自 Shopify 的客户细分可用于发送特定群组的推送通知，例如针对首次购买者的促销活动或针对休眠用户的重新激活活动。
4. **手动和实时消息**
在 Shopify 客户或细分视图中，您可以使用 Pushwoosh 扩展手动触发通知：
* **按客户发送通知**：用于个人跟进或测试
* **按细分发送通知**：用于基于营销活动的消息
### 通过店面嵌入的 Web 推送通知
通过在您的 Shopify 主题中启用 Pushwoosh 嵌入，您可以提示网站访问者选择加入基于浏览器的推送通知——无需移动应用。
#### 数据流概述
```
Shopify Customer & Event Data
↓
Pushwoosh API (via App)
↓
UserID → Segmentation → Triggered or Manual Notifications
```
此集成使您能够自动或按需发送及时、相关的消息，从而提高用户留存率、提升转化率并增强客户体验。
## 第 1 部分：安装
### 登录 Shopify
1. 前往 [Shopify 管理后台](https://admin.shopify.com/)
2. 从仪表盘中选择您的商店
### 安装 Pushwoosh 应用
1. 访问 [Pushwoosh 应用商店页面](https://apps.shopify.com/pushwoosh-notifications)
2. 点击 **安装**
3. 在 Shopify 对话框中确认安装
### 连接您的 Pushwoosh 应用
安装后，您将被重定向到 Shopify 内的 Pushwoosh 应用。
1. 点击 **连接**。
2. 输入**应用程序代码**和[设备 API 访问令牌](/zh/developer/api-reference/api-access-token/#device-api-token)，您可以在 **Pushwoosh 控制面板 → 设置 → API 访问**中找到它们。
连接成功后，将出现一条成功消息：“Pushwoosh app connected.”
### 订阅计划
1. 点击 **升级订阅**
2. 将显示一个基于用量的单一计划。
3. 确认计费。
## 第 2 部分：设置：通过元字段设置客户 User ID
为了向已识别的用户发送移动推送通知，Pushwoosh 为每个客户使用一个唯一的 **User ID**。Shopify 将此值存储在 Shopify 的**客户元字段**中。
1. 前往 **设置 → 元字段和元对象 → 客户**
2. 点击 **添加定义** 并使用以下值：
| 字段 | 值 |
| ----------------------- | ------------------------ |
| 命名空间和键 | custom.pushwoosh_userid |
| 命名空间 | custom |
| 类型 | 单行文本 |
| 验证 | 无 |
| 客户账户访问权限 | 读和写 |
| 店面 API 访问权限 | 已启用 |
## 第 3 部分：使用 Pushwoosh 扩展
Pushwoosh 包含用于细分定位、自动化 (Flow) 和客户特定通知的 Shopify 扩展。
### 扩展 1：按客户发送通知
#### 使用场景
手动向特定用户发送个性化消息或测试通知。
#### 步骤
1. 打开 **客户 → 选择一个客户**
2. 点击 **更多操作 → 按客户发送通知**
3. 选择消息平台（例如，电子邮件）和[内容预设](/zh/product/content/push-presets/)。
4. 点击 **发送**
### 扩展 2：按细分发送通知
#### 使用场景
定位客户群组——例如放弃购物车的用户、首次购买者、高消费用户。
#### 步骤
1. 前往 **客户 → 细分**
2. 选择一个细分 → 点击 **使用细分**
3. 选择 **按细分发送通知**
4. 选择所需的通信渠道和消息预设。点击 **发送**。
### 扩展 3：在 Shopify Flow 中使用 Pushwoosh
#### 使用场景
在客户旅程中使用订单、标签或行为等触发器来自动化消息发送。
#### 步骤
1. 在 **Shopify Flow** 中创建一个新的 Flow
2. 添加操作 → 选择 **Pushwoosh 通知**
3. 配置消息和动态字段
例如：
* 下单后发送消息
* 当购物车被放弃时提醒用户
* 在 30 天不活跃后发送重新激活推送
## 第 4 部分：启用 Web 推送（可选但推荐）
要在您的店面支持基于浏览器的 Web 推送通知，请执行以下操作：
1. 前往 **在线商店 → 主题 → 自定义**
2. 从左侧菜单打开 **应用嵌入**
3. 将 **推送初始化嵌入** 开关切换为开
## 使用场景总结
| 场景 | 使用的工具 |
| ----- | ----- |
| 个性化跟进 | 按客户发送通知 |
| 购物车放弃提醒 | Shopify Flow + Pushwoosh 操作 |
| 基于细分的促销 | 按细分发送通知 |
| 注册后欢迎消息 | Flow + 元字段跟踪 |
| 推送选择加入 | 主题嵌入 + 推送初始化开关 |