本參考資料將說明自訂 Google Analytics (分析) 報表所有層面的方法。
ga.js 基本方法
-
_deleteCustomVar(index)
-
_getName()
-
_getAccount()
-
_getVersion()
-
_getVisitorCustomVar(index)
-
_initData()
已淘汰 -
_setAccount(accountID)
-
_setCookiePersistence(milliseconds)
已淘汰 -
_setCustomVar(index, name, value, opt_scope)
-
_setSampleRate(newRate)
-
_setSessionTimeout(newTimeout)
已淘汰 -
_setSessionCookieTimeout(cookieTimeoutMillis)
-
_setSiteSpeedSampleRate(sampleRate)
-
_setVar(newVal)
已淘汰 -
_setVisitorCookieTimeout(cookieTimeoutMillis)
-
_trackPageLoadTime()
已淘汰 -
_trackPageview(opt_pageURL)
方法說明
_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)
使用提供的變數名稱、值和範圍設定自訂變數。name
和 value
的字元上限為 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
選用參數,用於表示要追蹤指標的網頁路徑。使用這個選項時,請使用開頭的斜線 (/) 表示網頁路徑。