如何将即时着陆页 (ILP) 连接到 Shopify

重要变化

开始 2026 年 1 月 1 日Shopify将不再支持商家创建自定义应用。这意味着之前的连接方式（创建自定义应用并手动授予店铺和店铺数据权限）将不再可用。 

为了取代这种工作流程，Shopify 在 Shopify 应用商店中提供了官方的 Headless 应用；GemPages 使用此应用作为将 ILP 连接到 Shopify 的新的、受支持的方式。

在开始之前

您必须拥有一个 Shopify 商店，并且拥有必要的管理员权限才能安装应用程序和管理店铺。

如何将 ILP 连接到 Shopify（使用无头应用程序的新方法）

按照以下具体步骤，使用 Shopify 的 Headless 应用将 Instant Landing Page 连接到 Shopify 商店。

步骤 1：安装 Headless 应用

1。 去 Shopify App Store.

2。 搜索 无头 （官方 Shopify Headless 应用）并点击 安装按照 Shopify 的屏幕提示操作，允许将该应用添加到您的商店。

步骤二：创建店铺

1. 在 Headless 应用中，选择以下选项： 创建店面.

2. 给店面起一个清晰易懂的名字，以便日后识别，然后创建它。

步骤 3：管理 Storefront API

找到标有“ 店面 API 并点击 物业管理.

步骤 4：（可选）查看或编辑店铺 API 权限

当您使用 Headless 应用创建新的 Storefront 时，Shopify 会自动为 ILP 连接启用所有必需的 Storefront API 权限。

只有当你想完成此步骤时才需要完成它。 评估 权限或 编辑 他们。 

1。 选择 编辑 查看当前 Storefront API 设置。

2. 查看 Shopify 已预先启用的权限。如有需要，您可以启用其他 Storefront API 权限范围。点击 已保存 如果您进行任何更改。

步骤 5：复制公共访问令牌

1. 保存店铺权限后，找到 公共访问令牌 （也称为发布令牌）在无头应用程序中。

2。 点击 复制 将令牌放入剪贴板。

步骤 6：将令牌粘贴到即时着陆页（GemPages）中

1. 在 GemPages 中打开要连接的即时着陆页项目。

2。 点击 连接 Shopify 在 ILP 项目设置中。

3. 将复制的令牌粘贴到标有“ 公共访问令牌.

4。 点击 将ILP连接到Shopify。

如果连接成功， 连接 Shopify 按钮将被替换为 发布 点击按钮，GemPages 将显示成功通知，确认 ILP 现在已连接到您的 Shopify 商店。

如何恢复您的令牌并将 ILP 重新连接到 Shopify

公共访问令牌失效或无法使用通常有两种情况。请根据令牌丢失的原因，遵循以下指南进行操作。

场景 A：由于店铺被删除，令牌丢失

如果发行令牌的店铺被删除，则令牌失效。恢复方法：

1. 打开 无头 在 Shopify 管理后台中安装应用。
2. 创建一个新的 店面 （请按照上述步骤 2 操作）。只有当没有其他现有店铺可以重复使用时，才需要创建新店铺。
3. （可选）查看或编辑店铺的 Storefront API 权限（按照步骤 4 操作）。
4. 复制新的 公共访问令牌 并将其粘贴到您的 ILP 项目中（按照步骤 5、6 操作）。

另一种方法： 如果您的无头应用仍然包含另一个现有的店铺（未被删除的店铺），则无需创建新的店铺。只需复制该店铺的公共访问令牌并将其粘贴到 ILP 中即可。

场景 B：由于无头应用被卸载，令牌丢失

如果 Headless 应用已从应用商店卸载，则通过该应用颁发的任何令牌都将失效。要恢复令牌：

1. 重新安装 无头 Shopify App Store 中的应用程序。
2. 重新安装后，打开 Headless 应用程序， 创建店面 （步骤 2）或者，如果还有现成的店面，则使用该店面。
3. 启用该店铺的所有 Storefront API 权限（步骤 4）。
4. 复制公共访问令牌并将其粘贴到 ILP 中（步骤 6）。