Tham khảo phương thức đối tượng ga

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

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

Các phương thức sau có sẵn trên đối tượng ga sau khi thư viện analytics.js được tải. Vì các phương thức này không có sẵn ngay nên bạn phải luôn gọi các phương thức này bằng lệnh gọi lại sẵn sàng trong hàng đợi lệnh ga.

Không nên – dùng các phương thức đối tượng ga bên ngoài readyCallback vì các phương thức này có thể chưa được hỗ trợ.

var trackers = ga.getAll();

Do – dùng các phương thức đối tượng ga bên trong một readyCallback vì các phương thức này được đảm bảo có sẵn.

ga(function() {
  var trackers = ga.getAll();
});

Phương thức
create([trackingId], [cookieDomain], [name], [fieldsObject]);	trả về: Tracker Tạo một thực thể trình theo dõi mới có các trường được chỉ định.
getByName(name)	trả về: Tracker Lấy thực thể trình theo dõi theo tên đã chỉ định.
getAll()	trả về: Array<Tracker> Lấy tất cả các thực thể trình theo dõi.
remove(name)	trả về: undefined Xoá thực thể trình theo dõi có tên đã chỉ định.

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

create

Tạo một thực thể trình theo dõi mới có các trường được chỉ định.

Cách sử dụng

ga.create([trackingId], [cookieDomain], [name], [fieldsObject]);

Lưu ý: bạn nên gọi phương thức create thông qua hàng đợi lệnh ga. Xem tài liệu tham khảo về cách tạo 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ề

Tracker

Ví dụ

// Creates a default tracker for the property UA-XXXXX-Y
// and uses automatic cookie domain configuration.
ga(function() {
  var tracker = ga.create('UA-XXXXX-Y', 'auto');
})

// Creates a tracker with the name "myTracker" for the property
// UA-XXXXX-Y, sets the cookieDomain to "example.com" and specifies
// a site speed sample rate of 10%.
ga(function() {
  var myTracker = ga.create('UA-XXXXX-Y', 'example.com', 'myTracker', {
    siteSpeedSampleRate: 10
  });
});

---

getByName

Lấy thực thể trình theo dõi theo tên đã chỉ định.

Cách sử dụng

ga.getByName(name);

Tham số

Tên	Loại	Bắt buộc	Nội dung mô tả
name	string	có	Tên của thiết bị theo dõi cần lấy.

Giá trị trả về

Tracker

Ví dụ

// Gets the default tracker.
ga(function() {
  ga.getByName('t0');
});

// Gets the tracker with the name "myTracker".
ga(function() {
  ga.getByName('myTracker');
});

---

getAll

Lấy tất cả các thực thể trình theo dõi.

ga.getAll();

Giá trị trả về

Array<Tracker>

Ví dụ:

// Logs a list of all tracker names to the console.
ga(function() {
  var trackers = ga.getAll();
  trackers.forEach(function(tracker) {
    console.log(tracker.get('name'));
  });
});

---

remove

Xoá thực thể trình theo dõi có tên đã chỉ định.

Cách sử dụng

ga.remove(name);

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

Tham số

Tên	Loại	Bắt buộc	Nội dung mô tả
name	string	có	Tên của thiết bị theo dõi cần xoá.

Giá trị trả về

undefined

Ví dụ

// Removes the default tracker.
ga(function() {
  // Note that, unlike the ga command queue's remove method,
  // this method requires passing a tracker name, even when
  // removing the default tracker.
  ga.remove('t0');
});

// Removes the tracker with the name "myTracker".
ga(function() {
  ga.remove('myTracker');
});