跟踪器配置

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