跟踪

追踪器功能

Umami 追踪器提供了一个函数,如果你想要对追踪进行更多控制,可以在你的网站上调用该函数。默认情况下,一切数据都会自动收集,但你可以通过设置 data-auto-pageview="false" 并使用 umami.track() 自行发送页面浏览来禁用自动页面浏览。只有在你想完全禁用跟踪器初始化时,才使用 data-auto-track="false"。详见跟踪器配置。

函数#

v2.0.0

Pageviews#

v2.0.0

追踪页面浏览。

默认情况下,追踪器会自动收集以下属性:

属性描述
hostname服务器主机名
language浏览器语言
referrer页面来源
screen屏幕尺寸(例如 1920x1080)
title页面标题
url页面 URL
website网站 ID(必需)

如果你希望发送自定义负载,可以向函数传入一个对象:

上述代码仅会发送 website、url 和 title 这几个属性。如果想包含已有属性,可以传入一个函数:

事件#

v2.0.0

追踪一个具有指定名称的事件。

事件数据#

v2.0.0

追踪一个带有动态数据的事件。

追踪事件时,默认属性会包含在负载中。相当于执行了:

事件数据限制#

事件数据可以包含任意 JSON 数据。为了保证性能,制定了一些规则:

数据类型限制
数字最大精度为 4 位。
字符串最大长度为 500。
数组转换为字符串后,最大长度为 500。
对象最多 50 个属性。数组按 1 个属性计算。

覆盖事件时间戳#

你可以通过在负载中添加一个秒级的 UNIX 时间戳来覆盖事件时间戳:

会话#

v2.13.0

传入自己的 ID 来标识用户。

会话数据#

v2.13.0

保存当前会话的数据。

如果不提供唯一 ID,只传入一个 JSON 对象: