来源中的信息
发生了什么
Admin GraphQL API 2026-10 为 Discount 类型增加只读的 Discount.rollouts 连接，用于读取影响折扣的 Rollouts。
商家可以把折扣加入 Rollouts，以协调发布、按部分买家测试折扣，或配合其他店铺变更运行临时活动；加入 Rollout 后，折扣自身的 startsAt 和 endsAt 不足以描述可用性。
应用需要申请 read_rollouts 权限，并同时读取 Rollout 的排期、有效流量分配、处理组拆分，以及每项变化是激活还是到期；已安装应用可能需要商家重新授权。
100% 有效流量的 Rollout 折扣可在所有销售渠道提供，但部分流量的 Rollout 只适用于 Online Store；早于 2026-10 的 API 版本可能过滤部分处于活动状态但未触达所有买家的折扣。
经营影响
为什么重要
折扣读取逻辑若只依赖原生起止时间，可能把尚未覆盖全部买家的折扣当成全面生效，也可能漏掉由 Rollout 控制的激活或到期变化。
这会影响促销看板、自动化规则、客服解释和销售渠道判断；尤其是部分流量测试，不能直接按全渠道促销处理。
对依赖旧版 API 的集成而言，平台返回的数据可能已经无法完整反映折扣的实际状态，升级与授权状态需要纳入排查范围。
编辑观察
分析判断
Rollouts 把折扣的可用性从单一时间条件变成排期、流量分配、处理组状态和渠道范围共同决定的状态机，因此商家应把折扣状态读取从“是否在日期区间内”改为多字段合并判断；现有证据只确认平台要求读取这些字段，未说明具体状态枚举或接口响应格式。
对商家而言，最大的后果不是折扣配置本身改变，而是依赖折扣数据的工作流可能产生范围错配：例如把 Online Store 的部分流量测试误判为全渠道活动，进而影响促销监控和运营解释；该判断基于已披露的渠道与触达规则，证据未提供实际业务损失或转化影响。
升级优先级应由集成是否读取 Discount、是否依赖折扣状态自动化，以及是否需要识别部分买家触达来决定：满足任一条件就应优先验证 API 版本、read_rollouts 授权和 Rollout 字段读取；在没有看到真实响应或变更通知前，不应假定所有现有应用都会受到同等影响。
适用范围
对卖家的影响
使用促销报表、折扣同步、自动化营销或客服工具的全球 Shopify 商家，需要确认这些工具是否把 Rollout 信息纳入折扣状态判断。
部分流量折扣的销售渠道解释会变得更重要：Online Store 流量测试不能直接等同于其他销售渠道上的促销可用性。
旧版 API 集成可能出现折扣被过滤或状态判断不完整的情况，商家需要把应用升级和重新授权纳入发布检查。
行动建议
现在应该做什么
- 1
盘点读取折扣数据的应用与工作流
now针对全球 Shopify 店铺，列出读取 Discount、生成促销报表、同步折扣或触发自动化的应用，确认其是否已支持 Discount.rollouts；不要仅凭折扣自身起止日期判断 Rollout 活动状态。
- 2
核对 API 版本、权限与重新授权需求
this-week让应用负责人确认是否使用 Admin GraphQL API 2026-10、是否申请 read_rollouts，以及既有安装是否需要商家重新授权；重点检查旧版 API 对活动但未覆盖全部买家的折扣如何返回。
- 3
为促销看板补充触达与渠道字段
this-week在可验证接口响应的前提下，将 Rollout 排期、有效流量分配、处理组拆分、激活或到期状态与折扣原生日期合并展示，并单独标识 Online Store 的部分流量活动。
暂时不要做什么
- 不要把配置的流量分配比例直接当作实际买家触达，也不要把部分流量 Rollout 折扣默认解释为全销售渠道可用。
- 不要在未确认 API 版本、权限和真实返回结果前，断言所有折扣或所有商家都会受到同等影响。
来源与依据
证据与来源
来源可能仅提供标题或摘要。请结合下方具体证据范围阅读；链接与流程校验不等于独立事实核验。内部置信值是工作流信号，不代表事实正确的概率。
- 01来源链接
Update your app to account for discount Rollouts Summary Admin GraphQL API version 2026-10 adds a read-only rollouts connection across Discount types. Apps that read discounts should use Discount.rollouts alongside existing discount fields to account for Rollout-driven schedules and buyer reach. What's changing Merchants can include discounts in Rollouts to coordinate launches, test discounts with a share of buyers, or run temporary events alongside other store changes. When a discount is part of a Rollout, its native dates alone don't describe its availability. Update your integration Request access. Add read_rollouts to your app's scopes. Existing resource scopes still apply to the underlying resource payloads, and existing installations may need merchant reauthorization. Read the discount's Rollouts. Query Discount.rollouts to identify which Rollouts affect the discount. Combine schedules and availability data. Read Rollout schedule fields alongside the discount's existing startsAt and endsAt fields. Also read effective allocation, treatment splits, and whether each change activates or expires the discount. Configured traffic allocation alone does not determine effective reach.
Shopify Developer Changelog · 流程状态: single-source
获取时间: 2026年10月1日 16:07 UTC
Claim is bounded to the ingested title or summary; no source body or quotation is retained.