Shopify 集成

集成概述

Pushwoosh 与 Shopify 无缝集成，Shopify 是一个领先的电子商务平台，使企业能够创建、管理和扩展在线商店。本指南将引导您在 Shopify 商店中安装和配置 Pushwoosh 应用，设置用户识别，并使用通知和自动化工具通过推送、电子邮件、短信和 WhatsApp 等渠道与客户互动。

集成类型

• 目标端：Shopify 将客户数据发送到 Pushwoosh，用于定位和消息发送。

先决条件

• 一个 Pushwoosh 账户
• 访问您的 Shopify 管理面板
• Pushwoosh 设备 API 访问令牌和应用程序代码
• 一个拥有客户和订单数据的 Shopify 商店
• 批准应用请求的 read_orders、write_pixels 和 read_customer_events 访问范围，这些是订单/购物车事件、结账步骤跟踪和店面行为事件所必需的

已经连接？系统会要求您重新批准访问权限

如果您在订单、购物车和结账跟踪功能出现之前连接了 Pushwoosh 应用，Shopify 会在您下次打开应用时要求您批准新的范围——这是 Shopify 推出新增权限的预期方式，并非错误。请批准它们以开始接收订单、购物车和结账事件。

同步的实体

• 客户：用于通过 Shopify 元字段分配和识别 Pushwoosh UserID

注意

Pushwoosh 中的客户同步方法

由于技术限制，Pushwoosh 提供多种客户同步方法，具体取决于用于通知的通信渠道：

• 电子邮件、Web、短信和 WhatsApp：设备/用户会自动在 Pushwoosh 应用程序中注册。
• 移动和桌面应用：设备/用户可以通过 Pushwoosh 和 Shopify 管理面板手动同步。
• Web 平台（Chrome、Firefox、Safari）：设备/用户由 Shopify 主题嵌入本身管理。

它是如何工作的？

同步过程如下：

1. 系统尝试检索当前用户会话以获取电子邮件或电话号码（这些标识符无需额外配置即可工作）。
2. 如果成功，电子邮件或电话号码将被设置为 Pushwoosh 和客户数据中 pushwoosh_userid 属性的 userID 标识符。
3. 如果无法做到这一点，默认的 Pushwoosh SDK userID 将被分配为 Pushwoosh 和 pushwoosh_userid 属性的标识符。
4. 在任何情况下，双方都会分配一个 userID，确保同步的一致性。

• 客户细分：用于基于群组的定位和消息发送
• 事件和触发器（例如，已下订单、已应用标签）：用于 Shopify Flow 中，以跨渠道自动化消息发送
• 店面：用于通过嵌入式脚本捕获网页推送选择加入
• 产品 Feed：当您连接应用时，您商店的店面 Feed (products.json) 会自动连接到 Pushwoosh 产品目录，如果您卸载应用，它会自动断开连接。
• 订单和购物车：来自 Shopify 的 orders/paid 和 checkouts/create webhook 的服务器到服务器事件。请参阅第 5 部分：跟踪订单、购物车和结账步骤。
• 店面浏览行为：产品浏览和添加到购物车的操作，由用于网页推送选择加入的相同主题嵌入收集。
• 结账步骤：输入的联系信息和提交的支付信息，通过 Shopify Web Pixel 收集。

术语表（如果实体名称不同，则进行映射）

Shopify	Pushwoosh
客户 (Customer)	UserID
orders/paid webhook	事件 PW_OrderCreated — 与其他电子商务集成共享（例如 Magento）
checkouts/create webhook	事件 PW_AbandonedCart — 相同的共享事件，也由产品块的购物车来源使用
产品页面浏览 (Product page view)	事件 PW_ProductViewed

集成如何工作

Pushwoosh 充当 Shopify 的消息发送目标端。集成后，Shopify 会将客户和行为数据发送到 Pushwoosh，用于驱动实时通知、客户细分和跨渠道的个性化消息。

集成的关键组件

1. 通过元字段进行客户识别 每个 Shopify 客户都被分配一个唯一的 UserID，存储在元字段 (custom.pushwoosh_userid) 中。此 ID 允许 Pushwoosh 在不同平台上一致地识别和向用户发送消息。

2. 通过 Shopify Flow 实现事件驱动的自动化 Pushwoosh 提供了 Flow 操作，允许您根据 Shopify 事件（例如以下事件）自动化消息发送（推送、电子邮件、短信、WhatsApp）：

   • 新订单已下
   • 标签已应用于客户
   • 购物车被放弃

3. 基于细分的定位 来自 Shopify 的客户细分可用于跨渠道发送特定群组的通知，例如针对首次购买者的促销活动或针对不活跃用户的重新激活活动。

4. 手动和实时消息发送 从 Shopify 客户或细分视图中，您可以使用 Pushwoosh 扩展手动触发通知：

   • 按客户发送通知：用于个人跟进或测试
   • 按细分发送通知：用于基于活动的营销消息

通过店面嵌入实现网页推送通知

通过在您的 Shopify 主题中启用 Pushwoosh 嵌入，您可以提示网站访问者选择加入基于浏览器的推送通知——无需移动应用。

数据流概述

Shopify 客户和事件数据
         ↓
Pushwoosh API (通过应用)
         ↓
UserID → 细分 → 触发式或手动通知

此集成使您能够自动或按需发送及时、相关的消息，从而提高用户留存率、增加转化率并增强客户体验。

第 1 部分：安装

登录 Shopify

1. 前往 Shopify 管理后台
2. 从仪表板中选择您的商店

注意

本指南假设您已经拥有一个 Pushwoosh 账户。如果没有，请创建一个

安装 Pushwoosh 应用

1. 访问 Pushwoosh 应用商店页面
2. 点击安装 (Install)
3. 在 Shopify 对话框中确认安装

连接您的 Pushwoosh 应用

安装后，您将被重定向到 Shopify 内的 Pushwoosh 应用。

1. 点击连接 (Connect)。

2. 输入应用程序代码 (Application Code) 和设备 API 访问令牌 (Device API Access Token)，您可以在 Pushwoosh 控制面板 → 设置 → API 访问中找到它们。

连接后，将出现一条成功消息：“Pushwoosh app connected.”

自动连接产品目录

连接该应用还会自动将您商店的店面 Feed 连接到 Pushwoosh 产品目录——无需单独设置 Feed。您商店的货币会同时被捕获，如果您之后更改商店的货币，它会自动更新。

订阅计划

1. 点击升级订阅 (Upgrade Subscription)
2. 将显示一个基于使用量的单一计划。
3. 确认账单。

注意

需要付费才能使用消息发送和细分功能。

第 2 部分：设置：通过元字段设置客户 User ID

为了向跨渠道（推送、电子邮件、短信、WhatsApp）的已识别用户发送通知，Pushwoosh 为每个客户使用一个唯一的 User ID。Shopify 将此值存储在 Shopify 的客户元字段 (Customer metafields) 中。

1. 前往设置 → 元字段和元对象 → 客户

2. 点击添加定义 (Add definition) 并使用以下值：

字段	值
命名空间和键 (Namespace and key)	custom.pushwoosh_userid
命名空间 (Namespace)	custom
类型 (Type)	单行文本 (Single line text)
验证 (Validation)	无 (None)
客户账户访问 (Customer Account Access)	读写 (Read and Write)
店面 API 访问 (Storefront API Access)	启用 (Enabled)

为什么这很重要

此元字段是跨移动/Web 设备用于通知和细分的持久用户标识符。

第 3 部分：使用 Pushwoosh 扩展

Pushwoosh 包含用于细分定位、自动化 (Flow) 和特定客户通知的 Shopify 扩展。

扩展 1：按客户发送通知

使用场景

手动向特定用户发送个性化消息或测试通知。

步骤

1. 打开客户 → 选择一个客户
2. 点击更多操作 → 按客户发送通知
3. 选择消息平台（例如，电子邮件）和一个内容预设。
4. 点击发送 (Send)

提示

可用于购买后提醒、个人感谢或重新激活提示。

扩展 2：按细分发送通知

使用场景

针对客户群体——如放弃购物车的用户、首次购买者、高消费用户。

步骤

1. 前往客户 → 细分

2. 选择一个细分 → 点击使用细分 (Use Segment)

3. 选择按细分发送通知 (Notification by Segment)
4. 选择所需的通信渠道和消息预设。点击发送 (Send)。

提示

可以根据购买历史、位置、活动或标签创建细分。

扩展 3：Shopify Flow 中的 Pushwoosh

使用场景

使用订单、标签或行为等触发器在客户旅程中自动化消息发送。

步骤

1. 在 Shopify Flow 中创建一个新的 Flow
2. 添加操作 → 选择 Pushwoosh 通知

3. 配置消息和动态字段

例如：

• 在下订单后发送消息

• 当购物车被放弃时提醒用户

• 在 30 天不活动后发送重新激活推送

第 4 部分：启用网页推送（可选但推荐）

要在您的店面支持基于浏览器的网页推送通知，请执行以下操作：

1. 前往在线商店 → 主题 → 自定义
2. 从左侧菜单打开应用嵌入 (App Embeds)
3. 将 Push Init Embed 切换为开 (ON)

注意

现在您的商店可以直接从店面提示用户选择加入网页推送。

第 5 部分：跟踪订单、购物车和结账步骤

一旦您批准了 read_orders、write_pixels 和 read_customer_events 范围（请参阅先决条件），Pushwoosh 就会开始从您的商店接收三种商业事件。它们来自不同的地方，并且彼此独立停止——不要将它们视为一个 Feed。

服务器端订单和购物车事件

Shopify 直接将订单已支付（orders/paid webhook，事件 PW_OrderCreated）和结账已创建（checkouts/create webhook，事件 PW_AbandonedCart）事件发送到 Pushwoosh，这是服务器到服务器的通信。这两个事件都与其他电子商务集成共享——Magento 使用相同的两个事件名称。与其他入站 webhook 事件（Stripe 的工作方式相同）一样，当您创建细分或设置客户旅程触发器时，它们会出现在事件下拉菜单中，您可以将其中任何一个映射为转化事件的来源，以将 Shopify 收入引入 RFM 细分、旅程归因以及您在电子邮件中发送的产品块统计信息。

因为这些事件来自 Shopify 的服务器，而不是购物者的浏览器，所以即使购物者阻止了跟踪器或使用了广告拦截器，它们也会继续到达。

这里的“购物车放弃”有三种不同的含义

• Shopify Flow 中的购物车放弃触发器（请参阅通过 Shopify Flow 实现事件驱动的自动化）是 Shopify 的原生条件，与 Pushwoosh 事件无关。
• 上述的 checkouts/create webhook 仅表示结账已开始——Shopify 尚未判定其为“已放弃”，也未确认任何订单。
• 产品块的购物车来源通过 PW_AbandonedCartID 标签读取收件人的购物车，与这些事件无关。

请选择与您实际构建的功能相匹配的那个，而不是听起来最接近的名称。

店面浏览事件

产品浏览（事件 PW_ProductViewed）和添加到购物车的操作由您已经为网页推送选择加入安装的相同主题嵌入收集——无需向您的主题添加任何新内容，但该嵌入必须切换为开 (ON)（请参阅启用网页推送）才能接收这些事件。如果您跳过了该切换，您既不会收到网页推送选择加入，也不会收到店面事件。

店面事件需要启用主题嵌入

产品浏览和添加到购物车的事件来自购物者的浏览器。如果购物者阻止了嵌入的脚本，或者您关闭了主题嵌入，您将停止接收这两个事件——但订单已支付和结账已创建事件仍会继续到达，因为它们来自 Shopify 的服务器。不要以为禁用主题嵌入也会暂停订单跟踪。

PW_ProductViewed 没有去重功能

PW_ProductViewed 在每次产品页面加载时都会触发——包括同一会话中的重复访问、页面重新加载以及机器人或爬虫流量。没有去重或节流功能。由于像根据他们浏览的内容这样的策略是基于此事件构建的，因此嘈杂的流量也会影响这些推荐。

结账步骤事件

Shopify Web Pixel 会在购物者填写结账表单时报告两个结账里程碑：

• PW_CheckoutContactInfo：购物者输入了他们的联系信息。
• PW_PaymentInfoSubmitted：购物者提交了他们的支付详情。

完成的购买不属于此像素的一部分

Web Pixel 有意不跟踪完成的购买——这是上面提到的服务器端订单已支付事件。使用 Web Pixel 事件来查看购物者在结账过程中从哪里流失，并使用订单事件来了解销售是否实际发生。

第 6 部分：数据合规性

Shopify 要求每个公共应用都必须响应其强制性的 GDPR/CCPA webhook。Pushwoosh 的处理方式如下：

• customers/redact：当购物者要求商店删除其数据时，Pushwoosh 会根据 Shopify 发送的任何标识符（电子邮件、电话和 Shopify 客户 ID）删除匹配的 Pushwoosh 记录。
• customers/data_request：当购物者请求其数据副本时，Pushwoosh 会向支持团队的内部渠道发布通知，并由专人手动处理该请求。Shopify 要求应用在 30 天内响应这些请求。
• shop/redact：Shopify 会在商店卸载应用 48 小时后发送此请求，要求删除商店的数据。Pushwoosh 设计上没有单独的处理程序——卸载已经删除了商店的整个集成记录（包括设备 API 密钥、应用程序代码和账单 ID），因此当此 webhook 到达时，已没有任何内容可供其删除。

使用场景总结

场景	使用的工具
个性化跟进	按客户发送通知
购物车放弃提醒	Shopify Flow + Pushwoosh 操作
基于细分的促销	按细分发送通知
注册后发送欢迎消息	Flow + 元字段跟踪
推送选择加入	主题嵌入 + 推送初始化切换
收入归因和 RFM 细分	将订单/结账事件映射到转化事件
结账流失分析	PW_CheckoutContactInfo / PW_PaymentInfoSubmitted 事件
浏览或购物车放弃细分	店面产品浏览/添加到购物车事件