追蹤程式碼:基本設定

本參考資料將說明自訂 Google Analytics (分析) 報表所有層面的方法。

ga.js 基本方法

方法說明

_deleteCustomVar()

_deleteCustomVar(index)

這個方法會刪除指派給已提供索引的變數 (如果有的話)。舉例來說,您可以設定訪客層級的自訂變數,然後決定不再使用這個訪客層級的變數。

非同步程式碼片段 (建議)

_gaq.push(['_deleteCustomVar', 1]);

參數

Int   index要刪除的自訂變數索引。


_getName()

_getName()

傳回智能設備建立時提供的名稱。

非同步程式碼片段 (建議)

_gaq.push(function() {
  var pageTracker = _gat._getTrackerByName(); // Gets the default tracker.
  var trackerName = pageTracker._getName();
});

傳回

String追蹤器的名稱。


_getAccount()

_getAccount()

傳回此追蹤器物件的 Google Analytics (分析) ID。如果您要在多個帳戶中追蹤網站上的網頁,可以使用這個方法來判斷與特定追蹤程式物件相關聯的帳戶。

非同步程式碼片段 (建議)

_gaq.push(function() {
  var pageTracker = _gat._getTrackerByName(); // Gets the default tracker.
  var accountId = pageTracker._getAccount();
});

傳回

String使用這個追蹤器物件執行個體化的帳戶 ID。


_getVersion()

_getVersion()

傳回 GATC 版本號碼。

非同步程式碼片段 (建議)

_gaq.push(function() {
  var pageTracker = _gat._getTrackerByName(); // Gets the default tracker.
  var version = pageTracker._getVersion();
});

傳回

String GATC 版本號碼。


_getvisitorCustomVar()

_getVisitorCustomVar(index)

傳回為特定索引指定的訪客層級自訂變數值。

非同步程式碼片段 (建議)

_gaq.push(function() {
  var pageTracker = _gat._getTrackerByName(); // Gets the default tracker.
  var visitorCustomVar1Value = pageTracker._getVisitorCustomVar(1);
});

參數

Int   index訪客層級自訂變數的索引。

傳回

String訪客層級自訂變數的值。如果無法擷取指定索引的變數,則傳回「未定義」。


_initData()

_initData()已淘汰。initData() 會自動在 ga.js 追蹤程式碼中執行。

初始化或重新初始化 GATC (Google Analytics (分析) 追蹤程式程式碼) 物件。

var pageTracker = _gat._getTracker("UA-12345-1");
pageTracker._trackPageview();

_setAccount()

_setAccount(accountId)

只能用於非同步追蹤。設定追蹤物件的網站資源 ID。

_gaq.push(['_setAccount', 'UA-XXXXX-X']);

參數

String accountID 追蹤器物件的完整網站資源 ID (例如 UA-65432-1)。


_setCookiePersistence()

_setCookiePersistence(milliseconds)

此方法已淘汰。請改用 _setVisitorCookieTimeout(cookieTimeoutMillis)

設定 Google Analytics (分析) 訪客 Cookie 到期時間 (以毫秒為單位)。根據預設,訪客 Cookie 的有效期限為 2 年。如有需要,您可以使用這個方法變更訪客 Cookie 的到期日。舉例來說,如要將訪客 Cookie 的到期時間設為 7 天,請使用以下程式碼:

pageTracker._setCookiePersistence(604800000); 

參數

Number   milliseconds 新的訪客 Cookie 到期時間。


_setCustomVar()

_setCustomVar(index, name, value, opt_scope)

使用提供的變數名稱、值和範圍設定自訂變數。namevalue 的字元上限為 128 位元組。

非同步程式碼片段 (建議)

_gaq.push(['_setCustomVar', 1, 'Section', 'Life & Style', 3]);

傳回

Boolean 如果自訂變數成功設定,這個方法會傳回 true;如未設定自訂變數,則會傳回 false (例如,名稱/值字串長度超過 128 個位元組,或是使用的版位有誤)。

參數

Int      index       必要屬性。用於自訂變數的版位。可能的值為 1-5 (含首尾)。

String   name        必要屬性。自訂變數的名稱。

String   value       必要屬性。自訂變數的值。

Int      opt_scope   (選用)自訂變數的範圍。可能的值包括訪客層級 1 和工作階段層級 2,以及網頁層級可能的值 3


_setSampleRate()

_setSampleRate(newRate)

設定新的取樣率。如果網站規模特別大,且流量暴增,請設定取樣率,確保報表不中斷。Google Analytics (分析) 中的取樣功能會持續套用到不重複的訪客,因此即使啟用取樣功能,探索和報表仍會呈現完整性,因為從取樣開始時,不重複訪客會包含在樣本中。

您只需在呼叫 _setAccount() 的相同方法指定此方法,通常為每個網頁或應用程式一次 (無論是初始化追蹤程式碼本身的時間)。請注意,只要追蹤物件本身維持不變,您指定的取樣率值就會持續生效。

非同步程式碼片段 (建議)

_gaq.push(['_setSampleRate', '2.5']);

參數

String newRate要設定的新取樣率。請提供介於 0 到 100 的數字數字 (精確到小數點後兩位)。


_setSessionTimeout()

_setSessionTimeout(newTimeout)

此方法已淘汰。請改用 _setSessionCookieTimeout(cookieTimeoutMillis)

設定新的工作階段逾時時間 (以秒為單位)。工作階段逾時預設為 30 分鐘 (1800 秒)。工作階段逾時是用來計算造訪次數 (請參閱「在 Analytics (分析) 中定義工作階段」一文)。 如果您想根據特定需求變更「工作階段」的定義,可以傳遞秒數來定義新值。這會影響計算造訪次數的所有部分,以及用於計算其他價值的造訪次數報表。舉例來說,如果您縮短工作階段逾時,造訪次數就會隨之增加;如果增加工作階段逾時,則造訪次數通常會減少。

參數

String newTimeout 設定新的工作階段逾時時間 (以秒為單位)。


_setSessionCookieTimeout()

_setSessionCookieTimeout(cookieTimeoutMillis)

設定新的工作階段 Cookie 逾時 (以毫秒為單位)。工作階段逾時情況預設為 30 分鐘。工作階段逾時是用來計算造訪次數,因為造訪次數在瀏覽器閒置 30 分鐘後結束或結束。如要變更特定「工作階段」的定義,您可以修改毫秒數來定義新的值。這會影響系統在計算造訪次數時,將計入造訪次數的計算方式,以及計算其他值時產生的造訪次數。舉例來說,如果您縮短工作階段逾時,造訪次數就會增加;如果增加工作階段逾時,造訪次數就會減少。您可以將到期時間變更為 0,以表示瀏覽器關閉時應刪除此 Cookie。

非同步程式碼片段 (建議)

_gaq.push(['_setSessionCookieTimeout', 1800000]);


參數

Number cookieTimeoutMillis 新的工作階段逾時 (以毫秒或 0 為單位),在瀏覽器關閉時刪除 Cookie。


_setSiteSpeedSampleRate()

_setSiteSpeedSampleRate(sampleRate)

定義網站速度資料收集的新樣本集大小。根據預設,系統會固定抽查 1% 的網站訪客資料,做為產生網站速度指標的資料集。如果您的網站每日訪客人數相對較少 (例如少於 100,000 人),建議您將取樣率調整為較大的取樣率。如此將大幅提高網頁載入時間和其他網站速度指標的精細程度。(如要進一步瞭解「網站速度」報表,請參閱說明中心的網站速度)。

必須在 _trackPageview() 之前呼叫 _setSiteSpeedSampleRate() 方法,才有效。

Analytics (分析) 會將單一資源的「網站速度」集合命中限制在 1% 以上的使用者或每天 10,000 次的命中中,以便為這項功能提供公平的系統資源分配。

注意事項:強烈建議您每天收到超過 100 萬次命中的網站,保持預設的 1% 取樣率。將樣本數調整為較大的數值並不會增加樣本數量。

非同步程式碼片段 (建議)

_gaq.push(['_setSiteSpeedSampleRate', 5]);
_gaq.push(['_trackPageview']);

參數

Number sampleRate 介於 0 到 100 之間的值,用來定義將造訪網站速度目標的網站訪客百分比。舉例來說,5 值會將網站速度集合範例設為 5%。


_setvisitorCookieTimeout()

_setVisitorCookieTimeout(cookieTimeoutMillis)

設定 Google Analytics (分析) 訪客 Cookie 到期時間 (以毫秒為單位)。根據預設,訪客 Cookie 有效期限為 2 年。如有需要,您可以使用這個方法變更訪客 Cookie 的到期日。您可以將到期時間變更為 0,表示在瀏覽器關閉時應刪除此 Cookie。

非同步程式碼片段 (建議)

_gaq.push(['_setVisitorCookieTimeout', 63072000000]);

參數

Number cookieTimeoutMillis新訪客 Cookie 到期時間 (以毫秒或 0 為單位),在瀏覽器關閉時刪除 Cookie。


_setVar()

_setVar(newVal)

此方法已淘汰。請改用「_setCustomVar()」。

使用提供的字串設定或定義自訂訪客區隔。您可以使用這個值,為自家網站的使用者提供額外的區隔。舉例來說,您可以使用登入頁面或表單,根據訪客的輸入內容觸發特定值,例如訪客選擇的偏好設定或隱私權選項。然後在該訪客的 Cookie 中更新此變數。在您的網站上導入資料且透過這個方法收集資料時,Analytics (分析) 報表「訪客」部分的「使用者定義」報表將顯示新定義的區隔。此外,您還可以在「內容詳細資料」報表中查看「使用者定義值」區隔,瞭解有多少百分比的訪客在特定網頁上屬於您定義的區隔。

參數

String newVal 要設定的新使用者定義值。


_trackPageLoadTime()

_trackPageLoadTime()

此方法已自動停用,因為系統會自動為所有使用者啟用網站速度報表。請使用 _setSiteSpeedSampleRate() 調整網站速度報表的取樣率。

為這個頁面啟用網站速度報表。請針對要產生網站速度報表的各個網頁插入這個方法。如要進一步瞭解 Analytics (分析) 中的網站速度報表,請參閱說明中心的網站速度一文。

驗證變更

如果報表中出現資料,表示您的設定正確無誤。如果 24 小時後沒有資料,請檢查您的自訂設定,確保沒有任何錯誤。如需常見的追蹤程式碼錯誤清單,請參閱「追蹤程式碼疑難排解」一文。本疑難排解指南也包含基本偵錯步驟,以及有關偵錯的詳細資訊。

請注意,要是您啟用了網站速度追蹤功能,那麼除了追蹤網頁瀏覽量的 GIF 請求外,Google Analytics (分析) 伺服器還會多收到一個請求。為了盡量避免增加網站整體的等待時間,系統只會針對所採樣的網站瀏覽量提出這個請求。因此,使用 Firebug 等工具對「網站速度」進行除錯時,您可能不會每次都看到這項功能的 GIF 請求,這是正常現象。

非同步程式碼片段 (建議)

_gaq.push(['_setAccount', 'UA-12345-1']);
_gaq.push(['_trackPageview']);
_gaq.push(['_trackPageLoadTime']);

_trackPageview()

_trackPageview(opt_pagePath)

GATC 的主要邏輯 (Google Analytics (分析) 追蹤程式程式碼)。如果啟用連結器功能,它會嘗試從網址擷取 Cookie 值。否則,系統會嘗試從 document.cookie 擷取 Cookie 值。也會視需要更新或建立 Cookie,再將 Cookie 寫入文件物件。備妥所有要傳送給 UCFE 的適當指標 (Urchin 收集器前端)。

非同步程式碼片段 (建議)

_gaq.push(['_setAccount', 'UA-12345-1']);
_gaq.push(['_trackPageview', '/home/landingPage']);

參數

String opt_pagePath 選用參數,用於表示要追蹤指標的網頁路徑。使用這個選項時,請使用開頭的斜線 (/) 表示網頁路徑。