Help: custom

把 Ptengine AI 的落地页推送到 Shopify 店铺

安装「推送到 Shopify」自定义应用，把 Ptengine AI 的落地页推送成 Shopify 店铺里的页面。

Zack Zhao

— 16 min read
Share
0:00
/0:00

1. 推送到 Shopify 后，落地页会显示在哪里？

本应用会把 Ptengine AI 中的落地页放进 Shopify 店铺，生成店铺自己的页面地址，例如 your-store.myshopify.com/pages/xxx。推送本身就是上线，不需要先在 Ptengine AI 发布页面，也不需要自己的发布域名。

适合使用 Shopify 开店、没有发布域名，或希望落地页直接挂在店铺网址下的营销担当。

推送后，落地页显示在 Shopify 店铺里，上方是店铺自己的头部。
推送后，落地页显示在 Shopify 店铺里，上方是店铺自己的头部。

2. 安装「推送到 Shopify」前要准备什么？

本应用以自定义应用的形式安装：先把安装包上传到 Ptengine，再在 Shopify 开发者后台创建一个连接用的应用，最后把两边连起来。

  1. Ptengine 工作区的管理员权限。上传自定义应用需要这个权限。
  2. 本应用的安装包（pga-to-shopify-版本号.zip）。请向 Ptengine 获取。
  3. Shopify 店铺所属组织的账号。要用它在 Shopify 开发者后台（dev.shopify.com）创建连接用的应用。连接用的应用只能连接和它属于同一组织的店铺。
  4. 整个过程约需 15 分钟。

3. 第一步：怎么把「推送到 Shopify」上传到 Ptengine？

Last update: 2026-10-13
pga-to-shopify-4.3.0.zip
pga-to-shopify-4.3.0.zip
366 KB
download-circle
  1. 在 Ptengine 左侧菜单点击「+」→「探索应用」，再点击右上角的「自定义应用管理」。
在「探索应用」右上角进入「自定义应用管理」。
在「探索应用」右上角进入「自定义应用管理」。
  1. 点击「新建」。
在「自定义应用管理」中点击「新建」。
在「自定义应用管理」中点击「新建」。
  1. 在「创建应用」对话框中填写应用名称，把安装包拖进上传区，再点击「创建应用」。
填写应用名称、上传安装包后点击「创建应用」。
填写应用名称、上传安装包后点击「创建应用」。
  1. 应用创建后是「草稿」状态。点击详情页右上角的「发布」，应用才会出现在左侧菜单中。
点击详情页右上角的「发布」。
点击详情页右上角的「发布」。
  1. 在详情页的「基本信息」中复制「应用地址」，例如 https://pga-to-shopify-xxxxxxxx.app.ptengine.ai。下一步在 Shopify 填写时要用。
在「基本信息」中复制「应用地址」。
在「基本信息」中复制「应用地址」。

4. 第二步：怎么在 Shopify 创建连接用的应用？

  1. 用店铺所属组织的账号打开 Shopify 开发者后台（dev.shopify.com），点击「应用」→「创建应用」，选择「手动创建应用」。名称可以自定，例如「Ptengine 页面推送」。
  2. 按下表填写。表中的「应用地址」是上一步复制的地址。
项目填写内容
应用 URL应用地址 + /api/shopify/install
在 Shopify 后台中嵌入应用取消勾选
权限范围read_online_store_pages,write_online_store_pages,read_themes
允许的重定向 URL应用地址 + /api/shopify/oauth/callback
  1. 点击「创建应用」，在弹出的「发布版本」中点击「发布」。
  2. 在应用的「概览」中找到「凭据」，复制「客户端 ID」和「客户端加密密钥」。
在「凭据」中复制「客户端 ID」和「客户端加密密钥」。
在「凭据」中复制「客户端 ID」和「客户端加密密钥」。

5. 第三步：怎么把 Ptengine 和 Shopify 店铺连起来？

  1. 回到 Ptengine 的「自定义应用管理」，打开本应用。
  2. 在「配置」中，SHOPIFY_CLIENT_ID 填写客户端 ID，点击「保存」。
在「配置」中填写 SHOPIFY_CLIENT_ID 并保存。
在「配置」中填写 SHOPIFY_CLIENT_ID 并保存。
  1. 在「密钥」中，SHOPIFY_CLIENT_SECRET 填写客户端加密密钥，点击「保存」。
在「密钥」中填写 SHOPIFY_CLIENT_SECRET 并保存。
在「密钥」中填写 SHOPIFY_CLIENT_SECRET 并保存。
  1. 在「版本」中点击当前版本下的「重新部署」。配置和密钥都要重新部署后才生效。
在「版本」中点击「重新部署」。
在「版本」中点击「重新部署」。
  1. 从左侧菜单打开本应用，在「店铺地址」中填写店铺域名，例如 your-store.myshopify.com，也可以直接粘贴 Shopify 后台网址，然后点击「连接店铺」。
填写 Shopify 店铺地址并点击「连接店铺」。
填写 Shopify 店铺地址并点击「连接店铺」。
  1. 新窗口会打开 Shopify。确认授权权限后点击「安装」；窗口显示「已连接 Shopify 店铺」后，点击「关闭窗口」。

    如果你没有 Shopify 店铺的安装权限，可以把下面这段直接转给店主或有「安装应用」权限的员工：
Shopify 窗口显示「已连接 Shopify 店铺」后即可关闭。
Shopify 窗口显示「已连接 Shopify 店铺」后即可关闭。
请在 Ptengine 工作区打开「推送到 Shopify」，填写店铺地址并点击「连接店铺」。新窗口会打开 Shopify，请确认授权权限并点击「安装」。看到「已连接 Shopify 店铺」后，点击「关闭窗口」，再告诉我已完成；我会回到 Ptengine 继续推送页面。
  1. 返回 Ptengine，本应用会自动显示已连接状态。
  2. 要连接另一家店铺，点击「连接另一家店铺」，从填写店铺地址开始重复上述步骤。这家店铺也要和连接用的应用属于同一组织。连接多家店铺后，可在页面上方的店铺下拉菜单中切换。
  3. 点击「断开」会断开当前店铺连接；断开后不能再向这家店铺推送。已经推送的页面仍会留在店铺里。

6. 什么时候会用到连接码？

通常不需要使用连接码。按上一节从 Ptengine 的「推送到 Shopify」输入店铺地址并点击「连接店铺」后，完成 Shopify 授权就会自动关联到当前 Ptengine 工作区，不会显示连接码。

只有先从 Shopify 一侧打开本应用时，才会显示连接码。例如，商家从 Shopify 后台打开已安装的应用；如果本应用通过 Shopify App Store 提供安装，从该入口安装后也会走这一路径。Shopify 无法判断要关联哪个 Ptengine 工作区，因此需要用连接码回到 Ptengine 完成关联：

  1. 在 Shopify 后台打开本应用并完成授权。授权完成页会显示 8 位连接码。
Shopify 后台打开本应用后会显示一次性连接码。
Shopify 后台打开本应用后会显示一次性连接码。
  1. 回到 Ptengine 打开本应用，点击「用连接码连接」，输入连接码，再点击「连接」。
在 Ptengine 输入连接码并点击「连接」。
在 Ptengine 输入连接码并点击「连接」。
  1. 连接码在 30 分钟内有效，只能使用一次。若已过期或用过，请回 Shopify 后台重新打开本应用获取新码。

7. 怎么把一张落地页推送到 Shopify？

    • 如果页面已经发布，复制页面网址。
    • 如果页面尚未发布，或你没有发布域名，在 Ptengine AI 编辑器中点击「预览」，再点击预览页右上角的「复制链接」。预览链接以 https://preview.ptengine.com/preview/ 开头。
  1. 回到本应用，点击右上角「添加页面」，粘贴页面地址，再点击「下一步」。

先准备页面地址：

在 Ptengine AI 预览页右上角点击「复制链接」。
在 Ptengine AI 预览页右上角点击「复制链接」。
在「添加页面」中粘贴页面地址并点击「下一步」。
在「添加页面」中粘贴页面地址并点击「下一步」。
  1. 确认粘贴的是可访问的页面网址。若粘贴了 Ptengine AI 编辑器中的地址，例如 www.ptengine.jp/ai/…，本应用无法读取需要登录才能打开的地址；请改用预览页复制的预览链接。
粘贴需要登录的 Ptengine 地址时，页面会提示改用预览链接。
粘贴需要登录的 Ptengine 地址时，页面会提示改用预览链接。
  1. 在推送设置中填写店铺网址，并选择显示方式和页面模板。
    • 店铺网址位于店铺域名后的 /pages/ 路径中，只能使用小写字母、数字、- 和 _。输入时会立即检查是否已被占用；如果冲突，请换一个网址。
      • 「加上店铺的头部和页脚」：勾选时，这张页面最上方是店铺自己的导航（Logo、菜单、购物车），最下方是店铺的页脚，中间是落地页。访客可以从落地页直接进入店铺的其他页面，页面和店铺看起来是一体的。不勾选时，这张页面只显示落地页本身，店铺的导航和页脚都不显示。

        落地页本身不会被改动：它自带的导航和页脚两种情况下都会保留。所以落地页自己已经有完整的导航时，勾选会出现两层导航（如下图左侧）。想让访客只专注这一张页面（比如只填表单、只下单），或落地页自带导航时，可以不勾选。
    • 页面模板从当前 Shopify 主题的页面模板中选择。

显示方式只有一个复选框（落地页始终铺满整个屏幕宽度，和在 Ptengine AI 里预览看到的一样）：

左：勾选时上方多了店铺的导航。右：不勾选时只有落地页。
左：勾选时上方多了店铺的导航。右：不勾选时只有落地页。
推送设置弹框：店铺网址、「加上店铺的头部和页脚」复选框和页面模板。
推送设置弹框：店铺网址、「加上店铺的头部和页脚」复选框和页面模板。
  1. 点击「推送」。推送成功后，这张页面会出现在本应用的页面列表中。一次推送一张页面。

8. 怎么查看和管理已经推送的页面？

  1. 打开本应用的页面列表。列表只显示目前在店铺里的页面，以及每张页面的店铺网址和最后推送时间。
页面列表显示已推送的页面和最后推送时间。
页面列表显示已推送的页面和最后推送时间。
  1. 在页面对应的行中选择操作。
    • 「在店铺打开」图标（鼠标移到行上时出现）：在新标签页打开这张页面在店铺里的线上地址。
    • 点击「···」可选择「编辑」「在 Shopify 后台编辑」或「下线」。「编辑」用来修改店铺网址、显示方式和页面模板，具体见“怎么修改已推送页面的网址、显示方式和模板？”。「下线」会从 Shopify 店铺删除这张页面，并把它从列表里去掉；它的店铺网址随之空出来，可以给别的页面用。确认框会写明页面名称和网址。以后要用，重新「添加页面」即可。
    • 点击「更新」可把 Ptengine AI 中的页面内容同步到店铺。具体更新方式见“怎么把改好的页面更新到 Shopify？”。
鼠标移到行上，右侧出现「在店铺打开」图标和「···」。
鼠标移到行上，右侧出现「在店铺打开」图标和「···」。
「···」菜单：编辑、在 Shopify 后台编辑、下线。
「···」菜单：编辑、在 Shopify 后台编辑、下线。

9. 怎么把改好的页面更新到 Shopify？

  1. 如果最初推送的是已发布页面的网址，修改页面后在本应用列表中点击对应行的「更新」，即可同步。
  2. 如果最初推送的是预览链接，预览链接会过期。点击「更新」后，在弹窗中粘贴新复制的预览链接，再点击「更新」。
用预览链接推送的页面更新时，需要粘贴新的预览链接。
用预览链接推送的页面更新时，需要粘贴新的预览链接。
  1. 更新会沿用当前的店铺网址、显示方式和页面模板。要修改这些设置，请用「编辑」。

10. 怎么修改已推送页面的网址、显示方式和模板？

  1. 在页面列表中点击对应行的「···」，选择「编辑」。
  2. 弹框中已经填好这张页面现在的店铺网址、「加上店铺的头部和页脚」和页面模板。按需修改后点击「保存并推送」。
    • 修改店铺网址时，店铺里还是原来那张页面，只是换到新网址；旧网址随之空出来，列表里也只保留新网址。新网址已被店铺里其他页面占用时会立即提示，请换一个。
    • 保存时会重新读取页面内容再推送，所以 Ptengine AI 里的最新改动也会一起同步到店铺。
编辑弹框里带着当前的店铺网址、显示方式和页面模板。
编辑弹框里带着当前的店铺网址、显示方式和页面模板。
  1. 如果这张页面当初是用预览链接推送的，而链接已经过期，会接着请你粘贴新的预览链接。在 Ptengine AI 编辑器中重新点击「预览」、复制新链接粘贴进来，再点击「保存并推送」，刚才改好的设置会一起生效。
预览链接过期时，编辑会接着要求粘贴新的预览链接。
预览链接过期时，编辑会接着要求粘贴新的预览链接。

11. 怎么在 Ptengine AI 里查看 Shopify 页面访问数据？

  1. 在 Ptengine 的统计设置中添加 Shopify 店铺域名。连接店铺后，本应用页面上方会列出店铺域名。
  2. 添加后，可以在 Ptengine AI 中查看店铺页面的访问数据。不添加时，页面仍可正常打开，表单仍可正常提交，只是看不到访问数据。
  3. 如果 Shopify 主题中已经安装了同一个档案的统计代码，页面不会重复加载该代码。表单收集方式与页面本身一致。

12. 推送到 Shopify 时遇到提示怎么办？

界面提示原因和做法
这是 Ptengine 产品里的地址，要登录才能打开，应用读不到。请在预览页复制以 https://preview.ptengine.com/preview/ 开头的预览链接。粘贴的是需要登录才能打开的 Ptengine 地址。回到 Ptengine AI 页面预览，复制完整预览链接后重新添加。
预览链接不完整。请复制以 https://preview.ptengine.com/preview/ 开头的完整链接。复制的预览链接不完整。回到预览页重新复制完整链接。
预览链接已过期。请在 PGA 编辑器重新点「预览」，复制新的预览链接。预览链接已过期。在 Ptengine AI 中重新点击「预览」，复制新的预览链接后再添加或更新。
店铺里已经有页面在用这个网址，请换一个。店铺中已有其他页面使用这个网址。换一个店铺网址。
这个网址已经推送了另一张页面，请换一个。这个网址已被本应用推送的另一张页面占用。换一个店铺网址。
应用暂时无法连接 Shopify。请联系 Ptengine 客服。第三步的「配置」或「密钥」没有填写，或填写后没有在「版本」中点击「重新部署」。补齐后重新部署。
店铺的授权已失效，可能是在 Shopify 里卸载了本应用。请重新连接。店铺授权已失效。点击「重新连接」，按连接流程重新授权。
连接码不对或已过期。连接码 30 分钟内有效，只能用一次。连接码输入错误、已过期或已使用。回 Shopify 后台重新打开本应用获取新连接码，再回 Ptengine 输入。
页面超过了 Shopify 的大小上限（约 512KB）。请在 PGA 里精简页面（比如压缩图片、删掉不用的区块）。页面代码超过了 Shopify 的上限。这个上限只算页面代码，以网址引用的图片不计入；超限多半是有图片直接嵌在页面里。请在 Ptengine AI 编辑器中改用上传的图片后再推送。

13. 推送到 Shopify 有哪些限制？

  1. 推送需要手动操作，一次只能推送一张页面；不支持批量推送或自动同步。
  2. 预览链接会过期。用预览链接推送的页面每次更新时，都需要粘贴新的预览链接。
  3. 本应用只修改由本应用创建的页面。若店铺中其他页面已经占用目标网址，需要换一个网址。
  4. 只能连接和 Shopify 连接用的应用属于同一组织的店铺。

Read more