全栈能力，赋能应用分析

对于应用开发者而言，构建面向商家的分析功能一直意味着需要自行搭建整套技术栈：包括图表库、用于同步商家数据的数据仓库、处理货币和本地化的逻辑，以及始终无法与 Shopify 管理后台完美契合的用户界面。通过这些更新，Shopify Analytics 成为一个完整的全栈分析平台，应用可以直接在其之上构建，将基础设施的负担转移给 Shopify，并将应用的数据放置在商家已经进行决策的地方。

以下是已发布的功能及其整合方式。

将您的应用数据引入 Shopify Analytics

Metafields（元字段）

将元字段定义标记为可分析查询，它就会成为 ShopifyQL 中与商店数据并列的维度。例如，向订单添加 campaign_source 元字段或向客户添加 subscription_status 元字段。商家可以对其进行分组、筛选和制图——无需 ETL，也无需单独的架构。

FROM sales SHOW total_sales GROUP BY order.metafields.my_app.campaign_source TIMESERIES day VISUALIZE total_sales

App Events（应用事件，早期访问）

Analytics 中的 App Events 使您的应用已发出的自定义事件在 Shopify Analytics 中可被查询。在 shopify.app.toml 中从新注册表声明事件，通过 App Events API 发出它们，然后商家可以在 ShopifyQL 中以与查询其商店数据相同的方式查询 FROM app_events。

FROM app_events SHOW emails_sent GROUP BY app_name TIMESERIES day VISUALIZE total_sales

查询方式：ShopifyQL API + 开发者文档

ShopifyQL API 作为 Shopify 的分析查询层，现已成为平台的一等公民，并在 shopify.dev 上提供了基于模式级别的参考文档。文档中定义了每个指标和维度，包括其类型、描述和工作示例。

为什么这很重要：

• 对于开发者：基于稳定、版本化且带有模式文档的表面进行构建。
• 对于 LLM（大型语言模型）和智能体：公开的模式文档意味着 AI 工具链可以生成可用的 ShopifyQL 代码。

嵌入它：Analytics Web Components（分析 Web 组件）

用于在 Shopify 管理后台呈现分析的相同 Web 组件——指标卡片（<s-shopifyql-metric-card>）、指标栏（<s-metrics-bar>）及其日期选择器（<s-metrics-bar-date-picker>）——现在可供第三方应用嵌入。只需一个元素即可渲染图表：

<s-shopifyql-metric-card heading="My weekly sales" query="FROM sales SHOW total_sales TIMESERIES week VISUALIZE total_sales TYPE bar"> </s-shopifyql-metric-card>

加载 analytics-ui.js（在 polaris.js 之后），启用 Direct API 访问，然后插入该元素。无需图表库。无需处理货币或区域设置。无需数据格式化代码。该组件运行查询、渲染图表，并与 Shopify 管理后台保持同步。

丰富它：Annotations API（注释 API）+ Metric Targets API（指标目标 API）

两个新的 API 允许应用和商家在数字之上添加上下文信息。

Annotations API（注释 API）

合作伙伴应用现在可以通过 GraphQL Admin API 直接在商家图表上创建注释。忠诚度应用可以标记项目启动的日期；电子邮件应用可以标记新活动；订阅应用可以标记价格变更——并在图表面板中正确显示应用归属。

所需权限范围：read_analytics_annotations、write_analytics_annotations。

Metric Targets API（指标目标 API）

商家现在可以在任何指标上设置目标——例如下一季度的总销售额或本周广告归因收入——并在报告和仪表板内以可视化方式跟踪进度。目标是 GraphQL Admin API 中的一个全新核心基元，因此应用可以以编程方式创建、读取并将它们叠加到图表上。

整体架构

1. 使用 Metafields（以及早期访问阶段的 App Events）对数据进行建模。
2. 通过 ShopifyQL API 进行查询。
3. 使用 Analytics Web Components 进行嵌入。
4. 通过 Annotations 和 Metric Targets 丰富数据。

所有这些功能都集成在 Shopify 内部，而商家已在此做出决策。

开始使用

• 面向开发者的分析功能
• Metafields
• Analytics 中的 App Events —— 注册以获取早期 访问
• ShopifyQL API
• Web Components
• Annotations API
• Metric Targets API