Lấy và thiết lập dữ liệu trường

 Việc lấy và thiết lập dữ liệu trường trên trình theo dõi đôi khi yêu cầu phải có tham chiếu đến chính đối tượng của trình theo dõi. Vì các lệnh được thêm vào ga()hàng đợi lệnh thực thi không liên tục và không trả về giá trị và vì trình theo dõi được tạo phổ biến nhất bằng cách sử dụng createlệnh, việc nhận tham chiếu đến đối tượng trình theo dõi yêu cầu phải đợi cho đến khi createlệnh được thực thi. Bạn có thể làm điều này thông qua cuộc gọi lại sẵn sàng .

Cuộc gọi lại đã sẵn sàng

Lệnh gọi lại sẵn sàng là một hàm mà bạn có thể thêm vào ga()hàng đợi lệnh. Hàm sẽ được gọi ngay sau khi thư viện analytics.js được tải đầy đủ và tất cả các lệnh trước đó được thêm vào hàng đợi đã được thực thi.

Vì tất cả các lệnh vào hàng đợi được thực thi theo thứ tự, nên việc thêm lệnh gọi lại sẵn sàng vào hàng đợi sau khi thêm createlệnh sẽ đảm bảo rằng lệnh gọi lại sẵn sàng được thực hiện sau khi trình theo dõi đã được tạo. Nếu một trình theo dõi mặc định đã được tạo khi một lệnh gọi lại sẵn sàng được gọi, nó sẽ được chuyển làm đối số đầu tiên (và duy nhất) của lệnh gọi lại.

Đoạn mã sau đây cho thấy cách truy cập đối tượng trình theo dõi mặc định và đăng nhập nó vào bảng điều khiển:

ga('create', 'UA-XXXXX-Y', 'auto');

ga(function(tracker) {
  // Logs the tracker created above to the console.
  console.log(tracker);
});

Nhận trình theo dõi thông qua các phương thức ga Object

Nếu bạn không sử dụng trình theo dõi mặc định hoặc nếu bạn có nhiều trình theo dõi trên trang, bạn có thể truy cập các trình theo dõi đó thông qua một trong các gaphương thức đối tượng .

Khi thư viện analytics.js được tải đầy đủ, nó sẽ thêm các phương thức bổ sung vào gachính đối tượng. Hai trong số các phương pháp đó getByNamevà getAllđược sử dụng để truy cập các đối tượng của trình theo dõi.

Lưu ý: gacác phương thức đối tượng chỉ khả dụng khi analytics.js đã tải đầy đủ, vì vậy bạn chỉ nên tham chiếu chúng bên trong một lệnh gọi lại sẵn sàng .

getByName

Nếu bạn biết tên của trình theo dõi bạn muốn truy cập, bạn có thể làm như vậy bằng getByNamephương pháp:

ga('create', 'UA-XXXXX-Y', 'auto', 'myTracker');

ga(function() {
  // Logs the "myTracker" tracker object to the console.
  console.log(ga.getByName('myTracker'));
});

lấy tất cả

Để lấy một mảng tất cả các trình theo dõi đã tạo, hãy sử dụng getAllphương pháp:

ga('create', 'UA-XXXXX-Y', 'auto', 'tracker1');
ga('create', 'UA-XXXXX-Z', 'auto', 'tracker2');

ga(function() {
  // Logs an array of all tracker objects.
  console.log(ga.getAll());
});

Nhận dữ liệu được lưu trữ trên trình theo dõi

Khi bạn có tham chiếu đến đối tượng trình theo dõi, bạn có thể sử dụng getphương thức của đối tượng đó để truy cập giá trị của bất kỳ trường nào hiện được lưu trữ trên trình theo dõi.

ga('create', 'UA-XXXXX-Y', 'auto');

ga(function(tracker) {
  // Logs the trackers name.
  // (Note: default trackers are given the name "t0")
  console.log(tracker.get('name'));

  // Logs the client ID for the current user.
  console.log(tracker.get('clientId'));

  // Logs the URL of the referring site (if available).
  console.log(tracker.get('referrer'));
});

Cập nhật dữ liệu

Các đối tượng theo dõi có thể được cập nhật bằng setphương pháp này. setPhương thức của trình theo dõi có thể được gọi trên chính đối tượng của trình theo dõi hoặc bằng cách thêm setlệnh vào ga()hàng đợi lệnh.

Vì việc nhận tham chiếu đến một đối tượng trình theo dõi yêu cầu sử dụng lệnh gọi lại sẵn sàng, sử dụng ga()hàng đợi lệnh là cách được khuyến nghị để cập nhật trình theo dõi.

Các ga()hàng đợi lệnh

Các setlệnh có thể được gọi bằng hai cách: bằng cách đi qua hai tham số, một lĩnh vực và giá trị tương ứng của nó, hoặc bằng cách thông qua một đối tượng của cặp lĩnh vực / giá trị.

Ví dụ sau đặt pagetrường thành '/about'trên trình theo dõi mặc định:

ga('set', 'page', '/about');

Ví dụ này đặt các trường pagevà titlecùng một lúc:

ga('set', {
  page: '/about',
  title: 'About Us'
});

Sử dụng trình theo dõi đã đặt tên

Nếu bạn đang sử dụng trình theo dõi được đặt tên thay vì trình theo dõi mặc định, bạn có thể chuyển tên của nó vào chuỗi lệnh.

Lệnh gọi sau đặt pagetrường trên trình theo dõi có tên "myTracker":

ga('myTracker.set', 'page', '/about');

Trên chính đối tượng theo dõi

Nếu bạn có tham chiếu đến đối tượng trình theo dõi, bạn có thể gọi settrực tiếp phương thức của trình theo dõi đó :

ga(function(tracker) {
  tracker.set('page', '/about');
});

Lưu ý: các đối tượng trình theo dõi không tự cập nhật. Nếu người dùng thay đổi kích thước của cửa sổ hoặc nếu mã chạy trên trang cập nhật URL, các đối tượng trình theo dõi không tự động nắm bắt thông tin này. Để đối tượng trình theo dõi phản ánh những thay đổi này, bạn phải cập nhật nó theo cách thủ công.

Ký hiệu và cú pháp

Các trường của trình theo dõi thường được lấy và đặt bằng tên trường của chúng. (Tham khảo phần tham chiếu trường để có danh sách đầy đủ các trường analytics.js và tên của chúng.)

Một cách thay thế để lấy và đặt các trường là tham chiếu đến chúng bằng tên tham số Giao thức đo lường tương ứng của chúng .

Ví dụ: hai console.logbiểu thức sau đều ghi tiêu đề tài liệu vào bảng điều khiển:

ga(function(tracker) {
  // Gets the title using the analytics.js field name.
  console.log(tracker.get('title'));

  // Gets the title using the measurement protocol
  // parameter name, prefixed with an ampersand.
  console.log(tracker.get('&dt'));
});

Nói chung, cú pháp dấu và không được khuyến nghị và chỉ nên sử dụng khi tên trường analytics.js cho thông số Giao thức đo lường không tồn tại (điều này ngẫu nhiên xảy ra nếu một tính năng mới được thêm vào Giao thức đo lường trước khi nó được triển khai trong analytics.js ).

Bước tiếp theo

Bây giờ bạn đã biết cách tạo trình theo dõi và cập nhật dữ liệu được lưu trữ trên chúng, bước tiếp theo là tìm hiểu cách gửi dữ liệu đó đến Google Analytics để xử lý.

Facebook Google Twitter More

• Pinterest
• Linkedin
• Tumblr

Posted by : Phạm Văn Hiếu tháng 2 14, 2021 Tags : Google Analytics

Subscribe by Email

Follow Updates Articles from This Blog via Email