建立追蹤器

追蹤器物件 (又稱為「追蹤程式」) 是一種物件,可收集和儲存資料,然後將這些資料傳送至 Google Analytics (分析)。

建立新的追蹤程式時,您必須指定追蹤 ID (與與您的 Google Analytics (分析) 資源對應的資源 ID 相同) 以及用來指定 Cookie 儲存方式的 Cookie 網域。(建議值 'auto' 會指定自動 Cookie 網域設定)。

如果指定網域沒有 Cookie,系統就會產生用戶端 ID 並儲存在 Cookie 中,並將該使用者視為「新」。如果 Cookie 存在,其中包含用戶端 ID 值,該用戶端 ID 會在追蹤程式上設定,且系統會將使用者視為「回訪」

建立時,追蹤程式物件也會收集目前瀏覽內容的相關資訊,例如網頁標題和網址,以及螢幕解析度、可視區域大小和文件編碼等裝置相關資訊。需要將資料傳送至 Google Analytics (分析) 時,系統會將目前儲存在追蹤器中的所有資訊傳送至追蹤器。

建立方法

analytics.js 程式庫提供多種建立追蹤程式的方式,但最常見的方法是使用 create 指令,並將追蹤 IDCookie 網域欄位做為第二和第三個參數傳遞:

ga('create', 'UA-XXXXX-Y', 'auto');

命名追蹤程式

您也可以視需要在 create 指令中傳遞 name 欄位做為第四個引數,為追蹤器命名。如果您需要為同一個頁面建立多個追蹤器,就必須為追蹤器命名。如要進一步瞭解原因,請參閱下文中「使用多個追蹤程式」一節的說明。

ga('create', 'UA-XXXXX-Y', 'auto', 'myTracker');

如果在沒有設定 name 欄位的情況下建立追蹤程式,就稱為建立「預設」追蹤程式。將預設追蹤器命名為「t0」。

在建立時指定欄位

您也可以傳送選用的 fields 物件,讓您在建立時設定任何 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 指令的完整指令語法。

後續步驟

建立好追蹤器後,您可能需要存取儲存在該追蹤器物件中的資料。下一份指南將說明如何取得及設定追蹤器資料