> For the complete documentation index, see [llms.txt](https://helps.ptengine.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://helps.ptengine.com/cn/integrations/shopify.md).
# Shopify相关
> 关于Ptengine代码安装，请参阅[Shopify代码部署](/cn/start-guide/othertag/tag-shopify.md)。
## Shopify 整合设置指南
### 打开Shopify应用设置
请按照以下步骤操作进行Shopify集成：
1. 登录并访问相关账户
2. 在Experience模块下，点击档案列表右侧的“设置”图标，并点击“外部应用集成”，选择Shopify
3. 点击Shopify，进入后续设置
## 前往Shopify创建自定义应用
首先，您需要创建一个Shopify自定义应用程序，以接收来自Ptengine的数据。 这个过程只需要不到5分钟的时间，无需技术技能（但需要您在Shopify中具有相关权限）。 这个自定义应用将仅在授权区域内运行，并且不会对您的商店性能或客户体验造成任何风险。
创建自定义应用共分为四部：
[第一步：创建应用](https://www.notion.so/a8b8195c81704357932ed4d32ba1017d?pvs=21)
[第二步：**配置应用权限**](https://www.notion.so/8af46c23bc9f42399e3108b954ff1761?pvs=21)
[第三步：**安装应用**](https://www.notion.so/62ebc700562d46098964267354b8727b?pvs=21)
[第四步：获取令牌](https://www.notion.so/f917794c13354adfbb775258071e7dab?pvs=21)
### 第一步：创建应用
1. 进入shopify商店后台管理页面，点击左下角设置
2. 点击应用和销售渠道
3. 点击为您的商店开发应用
4. 点击允许自定义应用开发
5. 允许之后会显示如下页面，点击创建应用
6. 填写相关信息点击创建（应用名称需自己取名）
7. 进入到如下页面表示创建成功
### 第二步：**配置应用权限**
1. 新应用创建成功是没有任何权限的，接入webhook需配置下API权限：点击配置后台API范围
2. 这是该应用所有后台权限的开关
3. 找到如下权限并勾选
4. 点击保存
### 第三步：**安装应用**
1. 权限配置完之后点击API凭据
2. 点击安装应用并确认安装
### 第四步：获取令牌
1. 安装之后点击显示一次令牌
（**令牌只能查看一次**，请务必妥善保管，点击显示令牌之后如没有手动保存一定不能刷新、切换页面，否则将无法在查看到该信息）
2. 保存好API令牌后，前往Ptengine继续创建Shopify连接
## 创建Shopify连接
### 创建Shopify连接
1. 在Shopify管理界面中，点击第二步中的“创建连接”
2. 在设置界面上输入相关信息
**链接名称**
请给这个连接起一个名字，便于在未来使用时识别
**Shopify商店名称**
注意，**这是您在Shopify中商店的注册信息，而非商店中的显示的名称**
通常您可以在登录Shopify后台的状态下，从URL中直接看到它
或
**Shopify 自定义应用令牌**
将[第四步：获取令牌](https://www.notion.so/f917794c13354adfbb775258071e7dab?pvs=21) 中的令牌黏贴复制到这里
3. 信息均填写完成后，点击“开始验证”
4. 验证成功，连接就可以保存了。
如果您需要不同的表单结果推送至不同商店的用户列表，可以在这里创建多项连接。
#### 常见连接错误：
报错提示如上图：
错误情况一：shopify商店name有误
错误情况二：对应shopify商店token有误（注意：在shopify后台设置时token只有在生成时会进行展示后续均显示为加密状态，需要另保存下来）
### 修改Shopify连接
点击列表后的编辑按钮，可以修改Shopify连接。
编辑的流程与创建的操作方式一致。
如果您由于Shopify中的设置发生变更（例如令牌重置），可以在这里输入变更后的信息。
之前在体验中被设置过的连接会在修改后仍然保持生效。
### 删除Shopify连接
点击列表后的删除按钮，可以删除Shopify连接。
注意：设置在删除后无法恢复，请在删除前认真确认连接未来不再使用，以及不会影响使用该连接进行数据推送的体验。
在删除时，我们会为您检查运行中或定时中的体验，如果没有相关体验，您可以直接删除；但如果有正在运行或定时的体验，您需要勾选“确认”选框后，才能继续执行“删除”。
删除后，所有推送将立刻停止。
但对于体验本身的运行和表单数据在Ptengine中的收集，不会产生任何影响。
## 对体验设置Shopify推送
### 进入推送设置
请按照以下步骤操作，在体验中完成Shopify的推送设置
\*此设置仅适用于具备表单的体验，如果您无法看到相关选项，请先创建表单
1. 点击体验编辑
2. 查看“自动化”模块，点击“编辑”
（当前“自动化”仅具备表单结果推送功能，因此需要您在体验中先创建表单后才可查看。 未来将在此模块更新更多自动化能力，也欢迎您将数据推送、自动行为等自动化相关的需求反馈给我们。）
### 设置推送规则
1. 选择将结果推送至Shopify
2. 从之前创建好的连接中，选择需要使用的连接
3. 选择连接后，Ptengine将解析体验中所有使用到的表单字段
* 对于Email类型字段，Ptengine会自动识别与对应
* 对于其他类型字段，如果您需要推送，则需要手动添加、并指定它们与目标字段的匹配关系，例如：
* 关于Shopify必填字段
* Shopify使用”Email“字段作为唯一关联，因此在推送时，必须有对应推送Shopify Email的字段。
* 如果您创建了多个实验版本、或多个设备， 每个版本和设备的表单都必须有对应推送Shopify Email的字段。（默认情况下，Email会为您自动识别关联，但如果由于修改设置或其它异常导致失去关联，请您按照提示进行修正。）
1. 完成设置后，点击”保存“
2. 注意：推送设置只有”发布“或”更新发布“后，才会生效。
生效期间，表单收录到新提交数据时，数据将被实时推送至Shopify。
参考：当前支持Shopify接收的数据
| 字段 | 用途 | 备注 |
| ---------------- | ---------------- | ----------------------- |
| Email (Required) | 客户的邮箱地址，用于关联其它信息 | 作为唯一关联识别使用，必须确保设置时有对应关系 |
| First name | 客户名 | |
| Last name | 客户姓 | |
| Tag | 标签可用于对客户进行分组 | |
| Subscription | 是否订阅 | 默认为订阅，暂时无法自定义 |
注意，当前综合Shopify的常用场景，由Ptengine收录并转发的Email，将自动标记为“客户同意接受营销电子邮件”，请酌情使用、并在需要的情况下于体验内容中告知用户。 未来我们将对此设置进行优化，支持该选项的自定义，以便适配更多邮箱收集场景。
## 常见问题
### 在推送设置前或中断期间的数据，如何同步到Shopify中？
当前推送的工作时机是在有人提交表单、表单收录到数据时立刻实时推送。因此只在连接生效期间时工作，对于启用前、或失效期间的数据，即使表单数据能够收录在Ptengine的报告中，也无法在连接设置或恢复后自动推送至Shopify。
在这种情况下，可以通过手动下载Ptengine中的表格数据，并导入Shopify的顾客列表。
解决方法：
1. 在体验报告中，切换至”表单提交“，点击”CSV下载“
2. 前往Shopify，进入”客户“模块，点击右上角的”导入“
注意：请下载示例CSV，并将数据处理成对应格式后，进行上传。
### 对于已经订阅过的客户，Ptengine可以不展示相关体验吗？
Ptengine不限定邮箱用于”订阅“的场景，因此不会自动按照是否订阅来停止展示。
**对于Ptengine收集到的邮箱，可以通过限定”目标用户“来隐藏展示：**
1. 点击体验编辑
2. 查看“目标用户”模块，点击“编辑”
3. 切换至”触达特定条件的用户“，输入搜索”email“，并选中设置
将email条件设置为”空“，其含义为只在未收集到email的情况下展示体验。
这项设置可以与其它用户限定条件叠加使用，这样您可以实现更多样的个性化设置。
**对于已存在于Shopify客户列表中的邮箱，可以使用上述动作进行指定“邮箱排除”。**
注意，使用此功能需要：
Ptengine中设置过[User identification](https://help.ptengine.com/docs/ptx-user-identification/)（用户身份关联）
访问者需登录（否则无法建立起浏览环境与用户邮箱之间的关系）
1. 排除邮箱不超过1000个时
a. 打开email条件设置，选择“不包含”
b. 将需要排除的email直接黏贴进来（可批量），保存即可
2. 排除邮箱超过1000个时
需要通过其它技术方式对接，并需要贵方技术支持，如果需要请与我们联系。
Ptengine只能在是否展示体验层面进行控制，由于数据推送的特性，无法在用户提交邮箱后按照客户列表是否已存在进行验证报错。因此，如果您在提交成功后发放优惠券，如需限制优惠券的使用次数，请通过shopify后台设置，在结算步骤中校验。
