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ề: Đặ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ề: 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);
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.
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.
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 }); });