Mã theo dõi: Đối tượng toàn cầu _gat

ga.js là một thư viện cũ. Nếu đang bắt đầu triển khai mới, bạn nên sử dụng phiên bản mới nhất của thư viện này, analytics.js. Đối với các hoạt động triển khai hiện có, hãy tìm hiểu cách di chuyển từ ga.js sang analytics.js.

Đối tượng chung _gat được dùng để tạo và truy xuất các đối tượng trình theo dõi mà từ đó mọi phương thức khác sẽ được gọi. Do đó, bạn chỉ nên chạy các phương thức trong danh sách này trên một đối tượng trình theo dõi được tạo bằng biến toàn cục _gat. Tất cả các phương thức khác phải được gọi bằng cách sử dụng đối tượng toàn cục _gaq để theo dõi không đồng bộ.

_gat Phương thức đối tượng

• _getTracker(account) không dùng nữa
• _createTracker(opt_account, opt_name)
• _getTrackerByName(opt_name)
• _anonymizeIp()
• _forceSSL(bool)

Thông tin chi tiết về phương pháp

_getTracker()

_getTracker(account)

Phương thức này không còn được dùng nữa. Thay vào đó, vui lòng sử dụng _gat._createTracker(opt_account, opt_name).

Tạo một đối tượng trình theo dõi cho mã thuộc tính web đã cho. Nếu phương thức này được gọi nhiều lần cho cùng một mã tài khoản Analytics, thì một đối tượng mới sẽ được tạo cho mỗi lệnh gọi.

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

tham số

String account Mã thuộc tính web đầy đủ (ví dụ: UA-65432-1) cho đối tượng trình theo dõi.

giá trị trả về

Tracker Đối tượng theo dõi đã tạo.

---

_createTracker()

_createTracker(opt_account, opt_name)

Tạo một đối tượng trình theo dõi mới và gán tên cho đối tượng đó. Nếu không có tên nào được cung cấp, một tên sẽ được tạo. Các đối tượng công cụ theo dõi được lưu trữ dưới tên để có thể được truy xuất qua _getTrackerByName. Nếu hai trình theo dõi được tạo có cùng tên, trình theo dõi thứ hai sẽ ghi đè trình theo dõi đầu tiên và trình theo dõi đầu tiên sẽ không thể truy xuất được qua _getTrackerByName nữa.

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

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

tham số

String opt_account Mã thuộc tính web đầy đủ (ví dụ: UA-XXXXX-X) cho đối tượng trình theo dõi.
String opt_name Tên (không bắt buộc) để lưu trữ công cụ theo dõi. Sử dụng tên này để truy xuất thiết bị theo dõi qua _getTrackerByName

giá trị trả về

Tracker Đối tượng theo dõi đã tạo.

---

_getTrackerByName()

_getTrackerByName(opt_name)

Truy xuất đối tượng công cụ theo dõi theo tên đã đặt. Nếu không có tên nào được đặt, giá trị mặc định sẽ được sử dụng, tức là chuỗi trống (""). Nếu không có trình theo dõi nào mang tên đã nêu, thì một trình theo dõi mới sẽ được tạo, gán cho tên đó rồi trả về.

_gat._getTrackerByName();

_gat._getTrackerByName('t2');

tham số

String opt_name Tên không bắt buộc của trình theo dõi cần truy xuất. Giá trị mặc định là chuỗi trống ('').

giá trị trả về

Tracker Đối tượng theo dõi được truy xuất hoặc được tạo.

---

_anonymousIp()

_anonymizeIp()

Yêu cầu Google Analytics che thông tin do các đối tượng trình theo dõi gửi bằng cách xoá octet cuối cùng của địa chỉ IP trước khi lưu trữ. Lưu ý rằng điều này sẽ làm giảm một chút tính chính xác của báo cáo địa lý.

Khi sử dụng hàm này để che giấu hoạt động theo dõi, bạn phải dùng hàm push và liên kết đúng cách hàm này với đối tượng của công cụ theo dõi, như minh hoạ dưới đây.

Đoạn mã không đồng bộ (được đề xuất)

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

Đoạn mã truyền thống (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)

Định cấu hình Google Analytics để gửi tất cả các lượt truy cập bằng SSL, ngay cả từ các trang không an toàn (HTTP).

Đoạn mã không đồng bộ (được đề xuất)

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

Đoạn mã truyền thống (ga.js)

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