将任何应用事件发送到同一个 API 端点，并在一个地方查看应用的全面视图。 通过 App Events（应用事件），您现在可以跟踪商户在您的应用内的行为，并在同一 Dev Dashboard（开发者仪表板）中查看这些数据，该仪表板还用于监控 webhook 交付、Function 执行和 API 调用。
App Events：完善全景视图
在此之前，了解商户如何使用您的应用需要依赖单独的分析工具。应用可以接收来自 Shopify 的数据（webhook 交付、Function 执行、API 调用），但如果同步失败、某个功能未被使用或商户遇到错误，您无法将这些情况记录回 Shopify。调试过程意味着需要在您自己的监控工具、单独的数据库以及 Shopify 外部的仪表板之间切换。
App Events 改变了这一现状。
通过一个 API 发送任何事件
App Events API 接受来自您应用的任何事件，由您定义event_handle和属性，事件类型没有固定列表，请追踪对您的应用重要的内容：
- 功能使用情况：bulk_edit_completed、report_generated、automation_created
- 工作流：onboarding_completed、campaign_sent、export_finished
- 性能：sync_failed、api_timeout、rate_limit_hit
- 转化信号：limit_hit、premium_viewed、milestone_achieved
- 计费活动：order_processed、email_sent、label_printed
您发送的任何事件也可以成为 Shopify App Pricing（应用定价）中的可计费计量单位，但这并非必须。您可以决定哪些事件用于分析，哪些事件用于支持计费。
在一个仪表板中查看所有内容
应用事件会自动流入您的 Dev Dashboard Logs（开发者仪表板日志），与您现有的数据——webhook、Functions、GraphQL 请求、REST 请求——并列显示。无需维护单独的分析平台，也无需管理多个仪表板。您可以在一个完整的视图中看到 Shopify 为您的应用做了什么，以及您的应用为商户做了什么。
基于真实行为进行构建
App Events API 会追踪在其运行平台上发生的自有数据。查看哪些功能驱动了用户参与度，发现能预测留存率的使用模式，捕捉导致流失的断点。基于您拥有的数据进行构建，打造商户真正使用的功能，而不是依赖访问权限不完整的第三方工具的近似估算。
从任何事件中解锁收入
在 Shopify App Pricing 中，您应用已发出的任何事件都可以转化为基于使用量的费用。在 Partner Dashboard 中定义一个计量器，将其与event_handle匹配，Shopify 将随后处理计量和开票工作。出现在 Dev Dashboard 分析中的同一事件也会驱动商户的账单，无需单独的计费集成或代码更改。
让我们将其付诸实践：
假设您正在开发一款库存同步应用。您推出了一项新的批量导入功能，并想知道商户是否真的在使用它，以及该功能是否正常工作。
您通过 App Events API 发送事件：当商户启动导入时发送bulk_import_started，完成时发送bulk_import_completed，出错时发送bulk_import_failed。每个事件都携带如item_count等属性，对于失败情况则包含error_type。
/* POST /app/unstable/events */ const response = await fetch("https://api.shopify.com/app/unstable/event", { method: "POST", headers: { "Content-Type": "application/json", Authorization: "Bearer {BEARER_TOKEN}", }, body: JSON.stringify({ shop_id: 23423423, event_handle: "bulk_import_failed", timestamp: "2026-05-08T14:30:00Z", idempotency_key: "evt_88012345", attributes: { item_count: 340, error_type: "csv_parse_error", }, }), }); const data = await response.json();上线几天后，您打开 Dev Dashboard 并按bulk_import_failed进行筛选，发现一家商店尤为突出：他们在两天内触发了六次相同的csv_parse_error。点击进入其事件时间线后，您看到了这一模式：他们启动导入，导入失败，几分钟后再次尝试，出现相同错误。他们陷入了困境。
您联系该商户，发现他们正从一个添加非标准列标题的系统导出数据，于是您推送了一个修复程序来处理这种边缘情况。第二天，该商户的导入从六次失败变为成功完成。
如果没有 App Events，您将完全不知道该商店的功能存在故障。这次导入并未触发您的 API 错误日志——它是在您的应用解析逻辑内部静默失败的。
如果您通过 Shopify App Pricing 按每次导入收费，这些相同的bulk_import_completed事件可以同时作为您的计费计量器。通过筛选计费活动来在同一仪表板中验证费用。
一个涵盖整个应用业务的 Dev Dashboard
一切在此汇聚。
App Events 与您的当前应用数据日志相结合，为您提供更全面的业务视角：流入和流出的数据均可在一个地方查看。
首次实现了对基础设施健康状况和商户行为的统一可见性。
开始使用 Shopify 跟踪应用事件
App Events 为您提供一个端点、一个仪表板以及做出更好决策所需的完整视图。