Tham chiếu đối tượng trình theo dõi

Tài liệu tham khảo này mô tả các phương thức có trên đối tượng Tracker.

Tóm tắt phương pháp

Phương thức
get(fieldName)	trả về: * Nhận giá trị của một trường được lưu trữ trên công cụ theo dõi.
set(fieldName|fieldsObject, [fieldValue])	trả về: undefined Đặt một cặp trường/giá trị hoặc một nhóm cặp trường/giá trị trên trình theo dõi.
send([hitType], [...fields], [fieldsObject])	trả về: undefined Gửi một lượt truy cập đến Google Analytics.

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

get

Nhận giá trị của một trường được lưu trữ trên công cụ theo dõi.

Cách sử dụng

tracker.get(fieldName);

Tham số

Tên	Loại	Bắt buộc	Nội dung mô tả
fieldName	string	có	Tên của trường nhận giá trị.

Giá trị trả về

*

Ví dụ

// Creates a default tracker.
ga('create', 'UA-XXXXX-Y', auto);

// Gets the client ID of the default tracker and logs it.
ga(function(tracker) {
  var clientId = tracker.get('clientId');
  console.log(clientId);
});

---

set

Đặt một cặp trường/giá trị hoặc một nhóm cặp trường/giá trị trên trình theo dõi.

Cách sử dụng

// Sets a single field/value pair.
tracker.set(fieldName, fieldValue);

// Sets a group of field/value pairs.
tracker.set(fieldsObject);

Lưu ý: bạn nên gọi phương thức set bằng hàng đợi lệnh ga. Hãy xem tài liệu tham khảo về cách đặt phương thức để biết thêm thông tin chi tiết.

Tham số

Xem tài liệu tham khảo về trường để biết từng tài liệu về trường.

Giá trị trả về

undefined

Ví dụ

// Creates a default tracker.
ga('create', 'UA-XXXXX-Y', auto);

ga(function(tracker) {
  // Sets the page field to "/about.html".
  tracker.set('page', '/about.html');
});

// Creates a default tracker.
ga('create', 'UA-XXXXX-Y', auto);

ga(function(tracker) {
  // Sets both the page and title fields.
  tracker.set({
    page: '/about.html',
    title: 'About'
  });
});

---

send

Gửi một lượt truy cập đến Google Analytics.

Cách sử dụng

tracker.send([hitType], [...fields], [fieldsObject]);

Các trường được gửi là giá trị được chỉ định trong tham số ...fields và fieldsObject, hợp nhất với các trường hiện được lưu trữ trên công cụ theo dõi.

Lưu ý: các giá trị được chỉ định trong ...fields và fieldsObject được gửi cùng với lượt truy cập hiện tại, nhưng không được lưu trữ trên đối tượng công cụ theo dõi. Sử dụng phương thức set để cập nhật trình theo dõi.

Tham số

Các trường có thể được chỉ định theo thông số ...fields sẽ khác nhau tuỳ thuộc vào loại lượt truy cập. Bảng sau đây liệt kê các trường tương ứng với từng loại lượt truy cập. Các loại lượt truy cập không được liệt kê không chấp nhận thông số ...fields, mà chỉ chấp nhận thông số fieldsObject.

Loại lượt truy cập	...fields
pageview	page
event	eventCategory, eventAction, eventLabel, eventValue
social	socialNetwork, socialAction, socialTarget
timing	timingCategory, timingVar, timingValue, timingLabel

Xem tài liệu tham khảo về trường để biết từng tài liệu về trường.

Lưu ý: bạn nên gọi phương thức send bằng hàng đợi lệnh ga. Hãy xem tài liệu tham khảo về phương thức gửi để biết thêm thông tin.

Giá trị trả về

undefined

Ví dụ

// Creates a default tracker.
ga('create', 'UA-XXXXX-Y', auto);

ga(function(tracker) {
  // Sends a pageview hit.
  tracker.send('pageview');
});

// Creates a default tracker.
ga('create', 'UA-XXXXX-Y', auto);

ga(function(tracker) {
  // Sends an event hit for the tracker named "myTracker" with the
  // following category, action, and label, and sets the nonInteraction
  // field value to true.
  tracker.send('event', 'link', 'click', 'http://example.com', {
    nonInteraction: true
  });
});