# 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后台设置，在结算步骤中校验。
--- # Agent Instructions: Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter: ``` GET https://helps.ptengine.com/cn/integrations/shopify.md?ask= ``` The question should be specific, self-contained, and written in natural language. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.