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

Bạn có thể trực tiếp sử dụng đối tượng toàn cục _gaq để theo dõi trang không đồng bộ thông qua phương thức push(...). Lớp 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 đối tượng 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ục _gat.

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

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

_createAsyncTracker()

    _createAsyncTracker(accountId, opt_name)
    Tạo một đối tượng theo dõi có thể được tham chiếu bằng tên khi thực hiện các lệnh gọi theo dõi không đồng bộ. Nếu tên không được đặt, chuỗi này sẽ là '' chuỗi trống, đại diện cho trình theo dõi mặc định trong cú pháp không đồng bộ. Nếu đã có trình theo dõi không đồng bộ cho tên đã cho, trình theo dõi mới sẽ được ghi đè bằng trình theo dõi mới.

    Lưu ý: Phương thức này thường chỉ an toàn để sử dụng trong một hàm đã được đẩy vào _gaq. Bạn chỉ nên sử dụng tính năng này trong một số ít trường hợp. 
    _gaq._createAsyncTracker('UA-65432-1');

    tham số

      String accountId Mã thuộc tính web đầy đủ (ví dụ: UA-65432-1) cho đối tượng trình theo dõi.
      String opt_name Tên để lưu trữ đối tượng trình theo dõi bên dưới. Sử dụng tên này để tham chiếu đến đối tượng trình theo dõi trong các lệnh gọi theo dõi không đồng bộ sau này.

    câu lệnh trả về

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

_getAsyncTracker()

    _getAsyncTracker(opt_name)
    Trả về đối tượng trình theo dõi đã tạo trước đó dưới tên đã cho. Nếu bạn không đặt tên nào, tên trình theo dõi mặc định (chuỗi trống '') sẽ được sử dụng. Nếu không có đối tượng trình theo dõi nào có tên cho sẵn, một trình theo dõi mới sẽ được tạo, được gán cho tên đó và được trả về.

    Lưu ý: Phương thức này thường chỉ an toàn để sử dụng trong một hàm đã được đẩy vào _gaq. Bạn chỉ nên sử dụng tính năng này trong một số ít trường hợp. 
    _gaq._getAsyncTracker();

    tham số

      String opt_name Tên của đối tượng trình theo dõi để truy xuất.

    câu lệnh trả về

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

chuyển đến

    push(commandArray)
    Thực thi command array đã cho, chỉ đơn giản là một mảng JavaScript tuân thủ định dạng sau. Phần tử đầu tiên của mảng phải là tên của phương thức đối tượng trình theo dõi được chuyển dưới dạng chuỗi. Phần tử còn lại của mảng là các giá trị được chuyển vào dưới dạng đối số cho hàm.

    Trường hợp sử dụng sau đây là thông thường:
    var _gaq = _gaq || [];
_gaq.push(['_setAccount', 'UA-65432-1']);
_gaq.push(['_trackPageview']);

    Hàm này có tên là push để có thể sử dụng một mảng thay cho _gaq trước khi Analytics tải xong. Khi Analytics đang tải, các lệnh sẽ được đẩy/xếp vào hàng đợi trên 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 đã đưa vào hàng đợi. Các lệnh gọi tiếp theo đến _gaq.push phân giải đến hàm này để thực thi các lệnh khi đượ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 có 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 trình theo dõi tuỳ ý tên là MyTracker.
    var _gaq = _gaq || [];
_gaq.push(['myTracker._setAccount', 'UA-65432-2']);
_gaq.push(['myTracker._setDomainName', 'foo.com']);
_gaq.push(['myTracker._trackPageview']);

    Lưu ý: Công cụ theo dõi sẽ được tạo vào lần đầu tiên lệnh tham chiếu đến các công cụ đó. Trình theo dõi mặc định được tạo thông qua lệnh đầu tiên không có tên rõ ràng với 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òn có thể đẩy các đối tượng hàm. Điều này đặc biệt hữu ích cho các phương thức 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 thu thập mà không xảy ra 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 mỗi mảng lệnh, bạn có thể đẩy tất cả các lệnh cùng một lúc. Mã sau đây minh hoạ kỹ thuật này. Hãy xem Hướng dẫn sử dụng đoạn mã không đồng bộ để biết thêm thông tin. 

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

      tham số

        Array commandArray Lệnh sẽ được thực thi. Bạn có thể đẩy một hoặc nhiều lệnh gọi trong cùng một lệnh gọi.

      câu lệnh trả về

        Number Số lệnh không thể thực thi.