开发者

发送服务器端事件

使用 Umami API 跟踪来自后端服务的事件。这对于记录发生在浏览器之外的操作非常有用,例如 webhook 事件、支付完成或后台作业结果。

何时使用服务器端跟踪#

  • 支付 webhook:记录由 Stripe、PayPal 或其他支付处理器确认的购买。
  • API 操作:跟踪用户通过您的 API 执行操作时(例如移动应用事件)。
  • 后台作业:记录来自 cron 作业、电子邮件发送或数据处理管道的事件。
  • 导入历史数据:从另一个分析平台回填事件。

Using the Node Client#

对于 Node.js 后端,最简单的方法是使用 Umami Node 客户端:

直接使用 API#

向 /api/send 发送带有事件负载的 POST 请求:

需要 User-Agent

需要有效的 User-Agent 头。没有该头的请求将被拒绝。

Python 示例#

批量发送#

要在单个请求中发送多个事件,请向 /api/batch 端点 POST 一个 JSON 数组。数组中的每个元素都与 /api/send 请求体的结构相同:

每一项都会转发到 /api/send,因此支持相同的 type 值(event、identify、performance)和负载字段。响应会汇总该批次:

如果有任何项失败,errors 表示失败数量,details 会按数组中的 index 列出每个失败项。

提示
  • 服务端事件会显示在与客户端事件相同的仪表板中。如有需要,可使用事件名称或属性来区分它们。
  • 在通过支付 webhook 跟踪收入时,请使用 revenue 和 currency 属性,这样数据就会显示在 收入 洞察中。
  • 对于高流量后端,建议对事件进行排队,并在发送时设置并发限制,以避免压垮你的实例。