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