App embed
DiscountOS 的 App embed（应用嵌入）是主题编辑器中的一个开关。把它打开，应用就可以在您的 在线商店上绘制这些内容：Sale Badge、Price Drop，以及在购物赠礼折扣中 自动加入购物车的赠品。把它关闭，这三者什么都不会显示 — 您的折扣仍然照常生效，因此买家仍然能拿到优惠。
-
在 DiscountOS 应用中打开 Promotions。
在 Shopify 后台侧边栏的 Apps 下面，DiscountOS 有三个条目：Manage discounts、Block codes 和 Promotions (Beta)。
-
点击 Enable in theme editor。
在 embed 关闭期间，Promotions 页面会显示一张 App embed 卡片，上面写着 “Sale Badges and Price Drops need the app embed enabled in your theme”，并带有一个 Enable in theme editor 按钮。这个按钮会直接打开您的主题编辑器并定位到 app embeds 面板。
在某个促销展示自己的页面上，同样的状态会出现在右侧栏中，作为一行常驻的 App embed，并带有一个 Enable 或 Disable 按钮。
-
打开 Promotions 这个 App embed 并保存主题。
在主题编辑器的 App embeds 面板中，打开 Promotions 并点击 Save。
请在您已发布的主题中打开它。只在未发布或草稿主题中启用的 App embed 不会触达买家，应用也不会把它算作已启用。
-
回到应用中，确认状态显示为 Enabled。
App embed 旁边的状态标签会变成 Enabled。在应用还在判断结果时， 它会显示一个加载指示器，而不是一个标签。
App embed 自己有两个设置，位于主题编辑器中的 Free gift 标题下面。 它们只在您运行购物赠礼折扣时才有意义。
Refresh cart pages after gift changes
Section titled “Refresh cart pages after gift changes”默认打开。在应用添加或移除赠品之后，购物车页面会重新加载，让您的主题显示新的购物车。 只有当您的主题不需要重新加载就能更新购物车时，才把它关掉 — 这个设置自己的说明写着， 当它关闭时，赠品变化之后页面永远不会刷新，所以请把它与下面那个事件配合使用， 否则买家可能会一直看到过时的赠品行，直到他们下一次进行交互。
Custom cart update event
Section titled “Custom cart update event”可选。您主题的购物车刷新事件名称。应用会在赠品变化之后触发它， 好让主题就地更新自己的购物车，而不必重新加载。
应用如何判断这个状态
Section titled “应用如何判断这个状态”有两样东西会告诉应用 embed 是否已打开，它们互为佐证。
**在线商店检查。**应用会打开您在线商店的首页，寻找 Shopify 为每一个已启用的 App embed 在页面中打印的标记。这是一个确定的答案，开或关，而且它不会给您带来任何成本 — 它就是买家看到的同一个公开页面。应用每个店铺最多每分钟重新读取一次。
**来自 embed 的上报。**当 embed 运行时，它会上报 — 来自您已发布的在线商店， 也来自您在主题编辑器预览中刚把它打开的那一刻。这就是为什么在您保存主题之后， 状态通常会在片刻之内变成 Enabled。
两者会结合起来判断：
- 找到标记 → Enabled。
- 没有标记，但 embed 在过去 10 分钟内上报过 → Enabled。一次实时上报意味着 embed 确实在运行，这比一个没有显示标记的页面更有说服力。
- 既没有标记，也没有最近的上报 → Not enabled。
- 应用根本无法读取该页面 — 您的在线商店有密码保护，或者请求超时 → 此时完全由上报来决定：过去 48 小时内有过上报即视为 Enabled，而完全没有上报时状态保持未知，应用会继续检查。
在有密码保护的在线商店上，应用无法读取标记，因此上报是唯一的信号。 请在 embed 打开的情况下打开您的在线商店一次，然后重新加载应用。 在那之前，状态可能会落后于您主题中实际已有的设置。
- **四个小组件区块不需要这个 embed。**Quantity Break Table、Quantity Break Picker、 Spend More Save More 和 Cart Goal Bar 是您放进某个分区的主题区块；每一个都自行渲染。 参见在线商店小组件。
- **关闭这个 embed 永远不会让折扣停止。**Shopify 仍然会检查购物车，仍然会应用折扣。 停止的是展示部分：徽章、划掉的价格，以及替买家把赠品放进购物车这件事。 在购物赠礼折扣中，买家仍然可以自己添加赠品，它同样会变成免费。
- **起作用的是已发布的主题。**应用读取的是您已发布的在线商店。
- **更改需要一点时间才会显现。**促销展示通常会在一分钟内到达您的店铺， 有时最多需要 15 分钟。
- Sale Badge — 在产品图片上显示类似 “20% off” 的徽章。
- Price Drop — 划掉的原价与折后价并排显示。
- 购物赠礼 — 由这个 embed 把赠品加入购物车的 那种折扣。
- App embed 显示为未启用 — 当开关已打开但应用却不这么认为时该怎么办。