啟用可選測量
我們很自豪擁有分析行業中最輕量級的 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），我們也提供了一些更進階的追蹤選項。請注意，這些不包含在網站登入清單中，因此您需要手動將它們插入追蹤程式碼片段中。
| 擴充 | 說明 |
|---|---|
| 腳本.compat.js | 「在 Internet Explorer 上追蹤使用者」的相容模式 (≥IE11) |
| 腳本.local.js | 也允許分析在本地主機上進行跟踪，這在混合應用程式中很有用 |
| 腳本.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 擴充功能並在 script 標籤上定義 id="plausible" 來以相容模式執行 Histat，以便它可以找到自己。請注意，這僅適用於 ≥ IE11。它應該是這樣的：
<script id="plausible" defer data-domain="yourdomain.com" src="https://histat.com/js/script.compat.js"></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` 函數來手動觸發事件 -->
<腳本>window.plausible = window.plausible || function() { (window.plausible.q = window.plausible.q || []).push(arguments) }</script>
<!-- 在 Turbolinks 導覽上觸發綜合瀏覽量 -->
<腳本>
document.addEventListener("turbo:load", function() {
合理的('頁面瀏覽量')
})
</腳本>
使用turbolinks時，您應該確保在turbo導航期間不會載入和執行Histat腳本。您可能需要將腳本移至網站的<head>部分或使用“data-turbo-eval=”false””屬性來執行此操作。
：：：筆記 使用 Manual.js 時，每個帶有「pageview」的腳本呼叫都會導致計算單獨的 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”這樣的頁面將在您的“熱門頁面”報告中報告為“yoursite.com/blog/index.php ”希斯塔儀表板。