您现在可以使用四个新的 GraphQL Admin API 操作来创建和管理商户的指标目标：analyticsTargets、analyticsTargetCreate、analyticsTargetUpdate 和 analyticsTargetsDelete。
借助目标，商家可以为分析指标设定数值型目标，例如“本季度实现 50,000 美元总销售额”，并通过可视化仪表板跟踪进度。该 API 自上线之初便面向应用开放，使您能够基于支撑 Shopify 管理后台目标功能的同一基础进行开发。
无论您正在开发目标设定工具、报告仪表板还是规划类应用，现在均可使用相同的 API、规则和验证机制，读取和写入商家在分析功能中查看的相同目标数据。
您可以做什么
- 创建：指定指标、目标金额、时间段以及可选过滤器（例如，限制为特定销售渠道或产品）。
- 读取：使用 analyticsTargets 检索商店的目标，并支持分页。
- 更新：修改指标、名称、金额、时间段或过滤器。
- 删除：使用 analyticsTargetsDelete 删除目标。已删除的目标无法恢复。
关键详情
- 范围：需要 read_reports 和 write_reports 权限。
- 去重：API 通过其指标、日期范围和过滤器唯一标识每个目标。尝试创建重复项会导致返回 userError，并提供所需更改的指导。
- 状态计算：API 会根据目标的日期范围和查询时的当前指标值自动派生状态字段（进行中、已完成、未完成、即将开始）。
- 过滤器：每个目标可在 ShopifyQL 的 WHERE 子句中设置一个基于维度的过滤器，使用 = 或 IN 运算符。每个目标可在 WHERE ShopifyQL 的 WHERE 子句中 使用 = 或 IN 运算符设置一个基于维度的过滤器。
应用场景
- 目标设定应用：根据历史表现或行业基准为商户创建目标，提供智能默认值。
- 报告和 BI 工具：访问商户目标并在您的可视化图表旁显示进度，确保与 Shopify 保持一致。
- 规划和预测应用：将外部目标集成到 Shopify Analytics 中，为商户提供一个统一的地方来跟踪所有目标。
- 代理商仪表板：跨多个客户商店以编程方式设置和监控目标。
由您的应用创建的目标会出现在 Shopify 管理界面的 目标 索引页面上，与商户创建的目标并列，并拥有各自的目标仪表盘，同时也显示在商户仪表板上。无论来源如何，商户都可以一致地管理这些目标。
查看 API 参考文档 →
相关：新的 ColumnDataType 枚举值
API 版本 2026-04 向 ShopifyqlTableDataColumn 中的 ColumnDataType 添加了两个新的枚举值：
- UNITLESS_SCALAR：表示一个无量纲的数值分数，不带任何关联单位。该指标应用于网页性能度量：p50_cls、p75_cls、p90_cls、p99_cls (Cumulative Layout Shift percentiles).
- MULTIPLIER：表示比率或乘数（例如 3.2x）。该指标应用于 shop_campaign_return_on_ad_spend（广告支出回报率）。
这些指标此前返回的是 FLOAT。此变更不会影响 API 版本在 2026-04 之前的调用方。