跟踪器配置

Umami 跟踪器提供了多个属性，允许你配置其行为。

data-host-url

v2.0.0

默认情况下，Umami 会将数据发送到脚本所在的位置。你可以覆盖此设置，将数据发送到其他位置。

<script
  defer
  src="http://mywebsite.com/umami.js"
  data-website-id="94db1cb1-74f4-4a40-ad6c-962362670409"
  data-host-url="http://stats.mywebsite.com"
></script>

data-auto-track

v2.0.0

默认情况下，Umami 会自动跟踪所有页面浏览和事件。你可以禁用此行为，并使用跟踪器函数自行跟踪事件。

<script
  defer
  src="http://mywebsite.com/umami.js"
  data-website-id="94db1cb1-74f4-4a40-ad6c-962362670409"
  data-auto-track="false"
></script>

data-domains

v2.0.0

如果你希望跟踪器只在特定域名上运行，你可以将它们添加到跟踪器脚本中。这是一个以逗号分隔的域名列表。每个值都会与 window.location.hostname 进行匹配，因此你应该仔细检查你的网站是否使用了 www。如果你正在使用预发布/开发环境，这会很有帮助。

<script
  defer
  src="http://mywebsite.com/umami.js"
  data-website-id="94db1cb1-74f4-4a40-ad6c-962362670409"
  data-domains="mywebsite.com,www.mywebsite.com"
></script>

data-tag

v2.11.0

将事件按名称标签分组，以便进行筛选和 A/B 测试。更多详情请参见标签。

<script
  defer
  src="http://mywebsite.com/umami.js"
  data-website-id="94db1cb1-74f4-4a40-ad6c-962362670409"
  data-tag="homepage-layout-a"
></script>

data-performance

v3.1.0

启用从访问者浏览器自动收集 Core Web Vitals。更多详情请参见性能。

<script
  defer
  src="http://mywebsite.com/umami.js"
  data-website-id="94db1cb1-74f4-4a40-ad6c-962362670409"
  data-performance="true"
></script>

data-exclude-search

v2.11.0

如果你不想收集 URL 中的搜索参数。

<script
  defer
  src="http://mywebsite.com/umami.js"
  data-website-id="94db1cb1-74f4-4a40-ad6c-962362670409"
  data-exclude-search="true"
></script>

data-exclude-hash

v2.16.0

如果你不想收集 URL 中的哈希值。

<script
  defer
  src="http://mywebsite.com/umami.js"
  data-website-id="94db1cb1-74f4-4a40-ad6c-962362670409"
  data-exclude-hash="true"
></script>

data-do-not-track

v2.17.0

尊重用户浏览器的禁止追踪设置。

<script
  defer
  src="http://mywebsite.com/umami.js"
  data-website-id="94db1cb1-74f4-4a40-ad6c-962362670409"
  data-do-not-track="true"
></script>

data-before-send

v2.18.0

允许你指定一个函数，在数据发送之前被调用。
你可以检查并修改数据负载，或者完全取消发送。
该函数将接收两个参数，type 和 payload。
如果继续发送，返回一个数据负载对象。
如果取消发送，则返回假值。

function beforeSendHandler(type, payload) {
  if (checkPayload(payload)) {
    return payload;
  }
  return false;
}

<script
  defer
  src="http://mywebsite.com/umami.js"
  data-website-id="94db1cb1-74f4-4a40-ad6c-962362670409"
  data-before-send="beforeSendHandler"
></script>

On this page