Skip to content

App embed 显示为未启用

您在主题编辑器中打开了 Promotions 这个 App embed,但应用仍然显示 Not enabled。下面说明应用实际在看什么,以及如何把它解决掉。

**您已发布的在线商店。**应用会打开您在线商店的首页,寻找 Shopify 为每一个已启用的 App embed 在页面中打印的标记。找到它就是确定的 Enabled。应用每个店铺最多每分钟重新读取一次该页面,因此答案最多可能有一分钟的延迟。

**embed 的上报。**当 embed 运行时它会上报 — 来自您已发布的在线商店, 也来自您在主题编辑器预览中刚把它打开的那一刻。过去 10 分钟内的一次上报, 比一次没有显示标记的页面读取更有说服力:embed 正在运行,是比一个没有提到它的页面 更强的证据。

**当页面无法被读取时。**如果您的在线商店有密码保护,或者请求超时,应用不会去猜。 它会退回到上报:过去 48 小时内有过上报即视为 Enabled,而完全没有上报时状态保持未定。 后台不会有任何轮询 — 状态是在 Promotions 页面加载时计算出来的,因此请重新加载应用 来重新检查。这就是为什么一个有密码保护的店铺可能显示 Not enabled, 而您主题中的开关确实是打开的 — 只是还没有任何东西运行过,应用也就无从听到消息。

  1. 确认这个 embed 是在您已发布的主题中打开的。

    主题编辑器 → App embeds → 打开 PromotionsSave。只在草稿或未发布主题中 启用的 embed,并不在买家 — 或应用 — 所看到的内容里。

  2. 在 embed 打开的情况下打开您的在线商店一次。

    在浏览器中加载您在线商店的一个普通页面。如果在线商店有密码保护, 请先输入密码,然后再加载一个页面。embed 需要的正是这一次页面访问来完成上报。

  3. 稍等片刻,然后重新加载应用。

    在线商店检查最多每分钟重新读取一次,而状态是在页面加载时计算出来的, 所以请等这么久,然后重新加载 Promotions 页面。状态标签应该会显示 Enabled

  4. 如果仍然不一致,请从主题编辑器再保存一次主题。

    在 embed 打开的情况下打开主题编辑器,会让它在预览中运行,从而自行完成上报 — 这是解决一个顽固状态的最快方式。

  • **关闭这个 embed 也是通过同样的方式上报的。**在停用之后,状态最多可能滞后 10 分钟, 因为在那段时间里,一次最近的上报比一个没有标记的页面更有说服力。
  • **加载指示器不代表失败。**它表示尚未确定。它从您点击 Enable 起最多持续约 10 分钟; 在那之后重新加载应用,它会显示 Not enabled,而不会一直转下去。
  • **您的折扣完全不依赖这个状态。**Shopify 仍然会检查购物车,仍然会应用您的折扣。 这个 embed 控制的是展示:Sale Badge、Price Drop,以及自动加入购物车的赠品。
  • **四个小组件区块不受影响。**Quantity Break Table、Quantity Break Picker、Spend More Save More 和 Cart Goal Bar 是主题区块,它们自行渲染。