追蹤程式物件 (也稱為「追蹤程式」) 是一種物件,可以收集並儲存資料,然後將資料傳送到 Google Analytics (分析)。
建立新的追蹤程式時,您必須指定追蹤 ID (與其中一個 Google Analytics (分析) 資源對應的資源 ID),以及指定 Cookie 儲存方式的 Cookie 網域。(建議的值 'auto'
會指定自動 Cookie 網域設定)。
如果指定網域中沒有 Cookie,系統會產生用戶端 ID 並將其儲存在 Cookie 中,並將使用者標示為「新」。如果 Cookie 存在內含用戶端 ID 值,系統會在追蹤程式上設定該用戶端 ID,並將使用者判定為「回訪者」。
建立工具物件後,追蹤程式物件也會收集目前瀏覽內容的資訊,例如網頁標題和網址,以及螢幕解析度、可視區域大小和文件編碼等裝置相關資訊。需要將資料傳送至 Google Analytics (分析) 時,系統會傳送目前儲存在追蹤器中的所有資訊。
建立方法
analytics.js 程式庫提供多種建立追蹤方式的方法,但最常見的做法是使用 create
指令,並將追蹤 ID 和 Cookie 網域欄位做為第二和第三個參數:
ga('create', 'UA-XXXXX-Y', 'auto');
命名追蹤工具
您也可以選擇將 name 欄位做為第 create
指令的第四個引數傳遞,藉此為追蹤程式命名。如要為相同網頁建立多個追蹤器,您必須命名追蹤器。如要進一步瞭解可能需要這麼做的原因,請參閱下方的使用多個追蹤器一節。
ga('create', 'UA-XXXXX-Y', 'auto', 'myTracker');
所謂的「預設」追蹤器,是指在不設定 name
欄位的情況下建立追蹤器。內部預設追蹤程式名稱為「t0」。
在建立時指定欄位
您也可以傳遞選用的欄位物件,以便在建立時設定任何 analytics.js 欄位,這樣這些欄位會儲存在追蹤工具中,並套用至所有傳送的命中。
ga('create', 'UA-XXXXX-Y', 'auto', 'myTracker', {
userId: '12345'
});
與 ga()
函式的所有呼叫一樣,fields 物件也可以用來同時指定所有欄位:
ga('create', {
trackingId: 'UA-XXXXX-Y',
cookieDomain: 'auto',
name: 'myTracker',
userId: '12345'
});
如需更完整的詳細資料,請參閱 create
方法參考資料。
使用多個追蹤器
在某些情況下,您可能想要從單一網頁將資料傳送至多個資源。如果網站有多位擁有者共同監控某個網站的各個部分,因此十分實用,每位擁有者都能查看自己的資源。
若要追蹤兩個不同資源的資料,您必須建立兩個不同的追蹤器,且其中至少一個追蹤器必須是具名追蹤器。以下兩個指令會建立預設追蹤器和名為「clientTracker」的追蹤器:
ga('create', 'UA-XXXXX-Y', 'auto');
ga('create', 'UA-XXXXX-Z', 'auto', 'clientTracker');
對特定追蹤器執行指令
如要執行特定追蹤程式的 analytics.js 指令,請在指令名稱前面加上追蹤程式名稱,後面加上一個點。如果您未指定追蹤器名稱,指令會在預設追蹤器上執行。
若要傳送上述兩個追蹤程式的瀏覽量,您必須執行下列兩個指令:
ga('send', 'pageview');
ga('clientTracker.send', 'pageview');
日後的指南將詳細說明執行特定指令的語法。您也可以參閱指令佇列參考資料,查看所有 analytics.js 指令的完整指令語法。
後續步驟
建立追蹤器後,您可能需要存取儲存在該追蹤器物件中的資料。下一份指南將說明如何取得和設定追蹤器資料。