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

Bạn có thể sử dụng trực tiếp đối tượng chung _gaq để theo dõi trang không đồng bộ thông qua phương thức push(...). API này cũng có các phương thức để tạo đối tượng trình theo dõi, nhưng chỉ nên sử dụng các phương thức này trong một số ít trường hợp.

Để theo dõi trang truyền thống, hãy sử dụng đối tượng toàn cầu _gat để thay thế.

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

_createAsyncTracker(accountId, opt_name) không dùng nữa
_getAsyncTracker(opt_name) không dùng nữa
push(commandArray)

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

_createAsyncTracker()

_createAsyncTracker(accountId, opt_name)

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).

''

cú pháp không đồng bộ

Lưu ý: Phương thức này thường chỉ an toàn khi sử dụng bên trong một hàm đã được đẩy lên _gaq. Bạn chỉ nên sử dụng thuộc tính này trong một số ít trường hợp.

_gaq._createAsyncTracker('UA-65432-1');

tham số

String accountId

String opt_name

giá trị trả về

Tracker

_getAsyncTracker()

_getAsyncTracker(opt_name)

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._getTrackerByName(opt_name).

''

_gaq._getAsyncTracker();

tham số

String opt_name

giá trị trả về

Tracker

push

push(commandArray)

command array

var _gaq = _gaq || [];
_gaq.push(['_setAccount', 'UA-65432-1']);
_gaq.push(['_trackPageview']);

push để có thể dùng một mảng thay cho _gaq trước khi Analytics tải hoàn toàn. Trong khi Analytics đang tải, các lệnh sẽ được đẩy/thêm vào hàng đợi trong mảng. Khi tải xong, Analytics sẽ thay thế mảng bằng đối tượng _gaq và thực thi tất cả các lệnh trong hàng đợi. Các lệnh gọi tiếp theo tới _gaq.push sẽ phân giải đến hàm này. Hàm này sẽ thực thi các lệnh khi chúng được đẩy.

Bạn có thể đặt tên cho trình theo dõi bằng cách đặt tên trình theo dõi (cùng với dấu chấm) trước tên phương thức. Nếu tên hàm đủ điều kiện với tên của trình theo dõi, thì tên đó sẽ được thực thi trên trình theo dõi đó.

Ví dụ sau đây sẽ tạo và sử dụng một công cụ theo dõi có tên là myTracker tuỳ ý.

var _gaq = _gaq || [];
_gaq.push(['myTracker._setAccount', 'UA-65432-2']);
_gaq.push(['myTracker._setDomainName', 'foo.com']);
_gaq.push(['myTracker._trackPageview']);

Lưu ý: Trình theo dõi được tạo lần đầu tiên có lệnh tham chiếu đến các trình theo dõi đó. Trình theo dõi mặc định được tạo thông qua lệnh đầu tiên không nêu rõ tên trình theo dõi. Tên của trình theo dõi mặc định là chuỗi trống ''.

Ngoài việc đẩy các mảng lệnh, bạn cũng có thể đẩy các đối tượng hàm. Điều này có thể đặc biệt hữu ích cho những phương thức trình theo dõi trả về giá trị. Các hàm này có thể tham chiếu cả _gat và _gaq.

var _gaq = _gaq || [];
_gaq.push(function() {
  var tracker = _gat._getTracker('UA-65432-1');
  tracker._trackPageview();
});

Bạn cũng có thể sử dụng cú pháp "đẩy" ngay trong HTML của trang.

onclick="_gaq.push(['_trackEvent', 'name', value]);"

Miễn là đoạn mã Analytics không đồng bộ tồn tại phía trên đường liên kết, các lượt nhấp sẽ được ghi lại mà không bị lỗi; ngay cả khi Analytics chưa tải đầy đủ tại thời điểm xảy ra lượt nhấp. Đây là một trong nhiều lợi ích của tính năng theo dõi không đồng bộ.

Cuối cùng, thay vì nhập _gaq.push(...) cho từng mảng lệnh, bạn có thể đẩy tất cả lệnh cùng một lúc. Mã sau đây minh hoạ kỹ thuật này. Xem Hướng dẫn sử dụng đoạn mã không đồng bộ để biết thêm chi tiết.

_gaq.push(
  ['_setAccount', 'UA-XXXXX-X'],
  ['_setDomainName', 'example.com'],
  ['_setCustomVar', 1, 'Section', 'Life & Style', 3],
  ['_trackPageview']
);

tham số

Array commandArray

giá trị trả về

Number