跳到主要内容

启用可选测量

我们很自豪拥有分析行业中最轻量级的 JavaScript 代码片段之一。

我们通过彻底限制默认脚本中的选项数量来实现这一点。相反，我们提供增强的测量作为可选脚本扩展，以根据您想要使用 Histat 的方式进行定制。这种方法可确保您只加载实际将在您的网站上使用的代码。

您可以在将新站点添加到 Histat 帐户时或在“站点设置”中“常规”部分的“站点安装”区域中启用这些可选测量

代码片段会根据您选择的测量而变化

请注意，您需要插入到站点中的跟踪代码片段会根据您选择的增强测量而变化。在更改可选测量时，请确保将最新的代码片段插入到站点中，以使所有跟踪按预期工作

以下是我们的可选测量列表：

可选测量说明
出站链接自动“跟踪出站链接的点击次数”
文件下载自动“跟踪文件下载”
404 错误页面自动“跟踪 404 错误页面”
哈希页面路径自动跟踪 URL 中使用“#”的页面路径“基于哈希的路由”
自定义事件允许您“跟踪自定义事件”，例如链接点击、表单提交和任何其他 HTML 元素点击
自定义属性允许您在发送网页浏览或自定义事件时附加“自定义属性”（在 Google Analytics 中也称为自定义维度）以创建自定义指标
电子商务收入允许您为自定义事件分配动态“货币价值”并跟踪收入归因

高级跟踪选项​

除了上述列表（script.outbound-links.js、script.file-downloads.js、script.hash.js、script.tagged-events.js、script.pageview-props.js 和 script.revenue.js）之外，我们还提供一些更高级的跟踪选项。请注意，这些选项未包含在网站入门列表中，因此您需要手动将它们插入到跟踪代码段中。

扩展说明
script.compat.js用于“在 Internet Explorer 上跟踪用户”的兼容模式（≥IE11）
script.local.js允许分析在本地主机上进行跟踪，这在混合应用中很有用
script.manual.js“不自动触发页面浏览量”。还允许您“指定自定义位置”以使用标识符编辑 URL。您还可以使用它来跟踪“自定义查询参数”

如何手动更改跟踪代码段​

例如，我们的代码段中的默认脚本名称是“script.js”。如果您的网站位于本地主机上，并且您想跟踪这些访问，您可以选择使用不同的扩展名加载脚本：“script.local.js”。

在这种情况下，您需要插入到您网站的代码段如下（确保将 data-domain 属性更改为您添加到 Histat 的域）：

<script defer data-domain="yourdomain.com" src="https://histat.com/js/script.local.js"></script>

您可以随意混合搭配和组合这些扩展。例如，如果您想同时使用我们基于哈希的路由和出站链接点击跟踪，您可以按如下方式组合它们：script.hash.outbound-links.js。

在这种情况下，您需要插入到网站中的代码片段如下（请确保将 data-domain 属性更改为您添加到 Histat 的域）：

<script defer data-domain="yourdomain.com" src="https://histat.com/js/script.hash.outbound-links.js"></script>

或者说您想使用我们的 script.revenue.js 扩展来跟踪电子商务收入，使用我们的 script.local.js 扩展来跟踪本地主机流量，您的代码片段应如下所示：

<script defer data-domain="yourdomain.com" src="https://histat.com/js/script.revenue.local.js"></script>

并且您只需将这一个代码片段插入到您的网站中，无需任何其他内容。

script.compat.js​

默认的 Histat 脚本无法在 Internet Explorer 上运行，因为它使用 document.currentScript API 来读取配置选项。您可以通过包含 script.compat.js 扩展并在脚本标记上定义 id="plausible" 来以兼容模式运行 Histat，以便它可以找到自己。请注意，这仅适用于 ≥ IE11。它应该如下所示：

<script id="plausible" defer data-domain="yourdomain.com" src="https://histat.com/js/script.compat.js"></script>

script.manual.js​

默认情况下，Histat 脚本在首次加载时会触发页面浏览。它还将侦听器附加到 History API，并在您使用 history.pushState 时自动触发页面浏览。这对于大多数网站都很有用，但我们也提供手动模式，以防您想要完全控制网站上触发页面浏览的时间。

其中一个用例是当您使用 Turbo（以前称为 Turbolinks）时。在这种情况下，您希望根据您使用的库在 turbo:load 或 turbolinks:load 浏览器事件上手动触发 Histat 页面浏览。您可以这样做：

<script defer data-domain="yourdomain.com" src="https://histat.com/js/script.manual.js"></script>
<!-- 定义 `plausible` 函数以手动触发事件 -->
<script>window.plausible = window.plausible || function() { (window.plausible.q = window.plausible.q || []).push(arguments) </script>
<!-- 在 turbolinks 导航上触发页面浏览量 -->
<script>
document.addEventListener("turbo:load", function() {
plausible('pageview')
})
</script>

使用 turbolinks 时，应确保在 turbo 导航期间未加载和执行 Histat 脚本。您可能需要将脚本移动到网站的 <head> 部分，或使用 data-turbo-eval="false" 属性来执行此操作。

备注

使用 manual.js 时，每个带有 'pageview' 的脚本调用都会导致计算单独的页面浏览量，即使在同一页面上调用也是如此

为页面 URL 指定自定义位置​

此外，手动脚本扩展允许您在事件中提供一个名为 u 的特殊选项。这允许您指定页面的 URL，并可用于指定自定义位置。

这对于编辑和聚合 URL 包含特定于用户的标识符的多个页面特别有用。

跟踪完整页面 URL 的自定义查询参数​

默认情况下，Histat 会出于隐私目的删除所有查询参数 ref、source、utm_source、utm_medium、utm_campaign、utm_content 和 utm_term。

这意味着像 yoursite.com/blog/index.php?article=some_article&page=11 这样的页面将在您的 Histat 仪表板的“热门页面”报告中报告为 yoursite.com/blog/index.php。