从 API 版本 2026-10 开始，ShopifyQL 在两个模式中添加了 Shop Campaigns 字段。shop_campaign_insights模式添加了一个shop_campaign_orders指标以及country和country_code维度。而sales模式则添加了四个 Shop Campaign 维度，使您能够按驱动销售的广告活动进行细分。
变更内容
shop_campaign_insights模式添加了以下字段：
| 字段 | 类型 | 描述 |
|---|---|---|
| shop_campaign_orders | 指标 | 与商店广告活动相关的订单数量。 |
| country | 维度 | 与商店广告活动相关的订单的账单国家。 |
| country_code | 维度 | 账单国家的两位 ISO 3166-1 alpha-2 代码，例如 US 或 CA。 |
例如，此查询返回过去 30 天内按国家/地区划分的广告活动订单和广告支出：
FROM shop_campaign_insights SHOW shop_campaign_orders, shop_campaign_ad_spend GROUP BY country_code SINCE -30d
sales模式添加了以下维度。每个维度都描述了与订单关联的 Shop Campaign：
| 字段 | 描述 |
|---|---|
| shop_campaign_name | 商店广告活动的名称。 |
| shop_campaign_handle | 与订单关联的商店广告活动的商家端句柄（handle）。 |
| shop_campaign_target_name | 广告活动针对的客户群体名称，例如 New customers。 |
| shop_campaign_currency_code | 商店广告活动订单中本地货币字段的货币代码。 |
这些维度可与任何 sales 指标配合使用。例如：
FROM sales SHOW total_sales, orders GROUP BY shop_campaign_name SINCE -30d
未与 Shop Campaign 关联的订单在这些维度中返回 null，因此在分组结果中显示为单独的 null 组。
受影响对象
在 2026-10 或更高版本上运行 ShopifyQL 查询的应用程序。2026-07 及更早版本的查询不包含这些字段。
操作步骤
无需采取任何操作。要使用新字段：
- 将您的 GraphQL Admin API 请求更新至 2026-10 版本。
- 将这些字段添加到您的 ShopifyQL 查询中。
- 在至少包含一个带有订单的 Shop Campaign 的开发商店中进行测试。
相关文档
- https://shopify.dev/docs/api/shopifyql/2026-10/schemas/sales_revenue/sales
- https://shopify.dev/docs/api/shopifyql/2026-10/schemas/marketing/shop_campaign_insights