追蹤程式碼：_gat 全域物件

ga.js 是舊版程式庫，如要開始新的導入作業，建議使用這個程式庫的最新版本 analytics.js。針對現有的實作，請參閱如何從 ga.js 遷移至 analytics.js。

_gat 全域物件可用來建立及擷取追蹤程式物件，系統會透過該物件叫用所有其他方法。因此，這份清單中的方法應僅適用於使用 _gat 全域變數建立的追蹤器物件。至於其他方法應使用 _gaq 全域物件呼叫，以進行非同步追蹤。

_gat 物件方法

• 已淘汰 _getTracker(account)
• _createTracker(opt_account, opt_name)
• _getTrackerByName(opt_name)
• _anonymizeIp()
• _forceSSL(bool)

方法說明

_getTracker()

_getTracker(account)

此方法已淘汰。請改用 _gat._createTracker(opt_account, opt_name)。

為特定的網站資源 ID 建立追蹤物件。如果對同一個 Analytics (分析) 帳戶 ID 重複呼叫這個方法，系統會叫用每次叫用的新物件。

_gat._getTracker('UA-65432-1');

參數

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

return

Tracker 已建立的追蹤物件。

---

_createTracker()

_createTracker(opt_account, opt_name)

建立新的追蹤物件，並為其指派指定名稱。如未提供名稱，系統會產生一個名稱。追蹤器物件會儲存在名稱下，並透過 _getTrackerByName 擷取。如果建立了兩個名稱相同的追蹤器，第二個追蹤器會覆寫第一個，且無法再透過 _getTrackerByName 擷取。

_gat._createTracker('UA-65432-1');

_gat._createTracker('UA-65432-2', 't2');

參數

String opt_account 追蹤器物件的完整網站資源 ID (例如 UA-XXXXX-X)。
String opt_name (選填) 要儲存追蹤器的名稱。請運用此名稱，透過 _getTrackerByName 擷取追蹤器

return

Tracker 已建立的追蹤物件。

---

_getTrackerByName()

_getTrackerByName(opt_name)

擷取具有指定名稱的追蹤器物件。如未指定名稱，系統會使用空白字串 ('')。

_gat._getTrackerByName();

_gat._getTrackerByName('t2');

參數

String opt_name 要擷取的追蹤器名稱。預設為空白字串 ('')。

return

Tracker 擷取或建立的追蹤物件。

---

_anonymizeIp()

_anonymizeIp()

要求 Google Analytics (分析) 移除追蹤器物件傳送的資訊，方法是在儲存資料之前移除 IP 位址的最後八位元。這樣會稍微降低地理區域成效報表的正確性，請您留意。

使用這個函式將追蹤功能去識別化時，必須使用 push 函式，並將函式與追蹤器物件正確建立關聯，如下所示。

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

var _gaq = _gaq || [];
_gaq.push (['_setAccount', 'UA-XXXXXXX-YY']);
_gaq.push (['_gat._anonymizeIp']);
_gaq.push (['_trackPageview']);

傳統 (ga.js) 程式碼片段

<script type="text/javascript">
var gaJsHost = (("https:" == document.location.protocol) ? "https://ssl." : "http://www.");
document.write(unescape("%3Cscript src='" + gaJsHost + "google-analytics.com/ga.js' type='text/javascript'%3E%3C/script%3E"));
</script>
<script type="text/javascript">
try{
var pageTracker = _gat._getTracker("UA-xxxxxx-x");
_gat._anonymizeIp();
pageTracker._trackPageview();
} catch(err) {}</script>

---

_forceSSL()

_forceSSL(bool)

將 Google Analytics (分析) 設為使用安全資料傳輸層 (SSL) 傳送所有命中，即使是來自不安全的 (HTTP) 網頁也一樣。

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

_gaq.push(['_setAccount', 'UA-12345-1']);
_gaq.push(['_gat._forceSSL']);       // Send all hits using SSL, even from insecure (HTTP) pages.
_gaq.push(['_trackPageview']);

傳統 (ga.js) 程式碼片段

var pageTracker = _gat._getTracker("UA-12345-1");
// Send all hits using SSL even from insecure (HTTP) pages.
_gat._forceSSL();
pageTracker._trackPageview();