Sử dụng plugin

 Plugin là các tập lệnh nâng cao chức năng của analytics.js để hỗ trợ đo lường sự tương tác của người dùng. Các plugin thường dành riêng cho một tập hợp các tính năng có thể không được yêu cầu bởi tất cả người dùng Google Analytics, chẳng hạn như thương mại điện tử hoặc đo lường tên miền chéo và do đó không được bao gồm trong analytics.js theo mặc định.

Hướng dẫn này giải thích cách yêu cầu và sử dụng plugin analytics.js.

Yêu cầu plugin

Các requirelệnh có tên của một plugin và đăng ký nó để sử dụng với ga()hàng đợi lệnh. Nếu plugin chấp nhận các tùy chọn cấu hình, các tùy chọn đó có thể được chuyển làm đối số cuối cùng cho requirelệnh.

Sau đây là requirechữ ký của lệnh đầy đủ :

ga('[trackerName.]require', pluginName, [pluginOptions]);

Ví dụ: đây là cách bạn yêu cầu plugin Thương mại điện tử nâng cao để sử dụng với trình theo dõi mặc định:

ga('require', 'ec');

Và đây là cách bạn yêu cầu plugin Tính năng quảng cáo cho trình theo dõi có tên "myTracker" và chuyển tùy chọn cấu hình ghi đè giá trị tên cookie mặc định:

ga('myTracker.require', 'displayfeatures', {
  cookieName: 'display_features_cookie'
});

Đang tải mã plugin

Các requirelệnh khởi tạo các phương pháp plugin cho sử dụng với ga()hàng đợi lệnh, nhưng nó không load script plugin chính nó. Nếu bạn đang sử dụng plugin của bên thứ ba hoặc tự viết plugin , bạn sẽ cần thêm mã plugin vào trang theo cách thủ công.

Phương pháp được đề xuất để thêm mã plugin vào trang là thông qua <script>thẻ có asyncthuộc tính được đặt để đảm bảo nó không chặn việc tải các tính năng khác trên trang web của bạn.

Đoạn mã sau vừa yêu cầu vừa tải một plugin theo dõi liên kết giả định:

<script>
ga('create', 'UA-XXXXX-Y', 'auto');
ga('require', 'linkTracker');
ga('send', 'pageview');
</script>

<!--Note: plugin scripts must be included after the tracking snippet. -->
<script async src="/path/to/link-tracker-plugin.js"></script>

Lưu ý: Các plugin Google Analytics chính thức cho analytics.js được tải tự động khi chúng được yêu cầu; bạn không cần thêm thẻ script cho chúng. Bạn có thể tìm thấy danh sách đầy đủ các plugin analytics.js chính thức trong phần Plugin chính thức trong điều hướng bên trái.

Đang đợi plugin tải

Vì cả thư viện analytics.js và plugin analytics.js đều được tải không đồng bộ nên có thể là một thách thức để biết khi nào các plugin được tải đầy đủ và sẵn sàng sử dụng.

Thư viện analytics.js giải quyết vấn đề này bằng cách tạm dừng việc thực thi hàng đợi lệnh khi nó gặp requirelệnh cho một plugin chưa được tải. Khi plugin được tải, việc thực thi hàng đợi sẽ tiếp tục như bình thường.

Do đó, điều cực kỳ quan trọng là bạn phải kiểm tra các plugin đang sử dụng để đảm bảo chúng tải và chạy chính xác. Nếu một plugin không tải được hoặc có lỗi, nó sẽ ngăn không cho tất cả các lệnh analytics.js tiếp theo thực thi.

Gọi các phương thức plugin

Sau khi yêu cầu một plugin, các phương thức của nó sẽ có sẵn để sử dụng với ga()hàng đợi lệnh. Đây là chữ ký lệnh để gọi các phương thức plugin:

ga('[trackerName.][pluginName:]methodName', ...args);

Ví dụ: phương pháp của plugin Thương mại điện tử nâng caoaddProduct có thể được gọi như sau:

ga('ec:addProduct', {
  'id': 'P12345',
  'quantity': 1
});

Hoặc trên trình theo dõi đã đặt tên bằng cách thêm tên trình theo dõi vào chuỗi lệnh:

ga('myTracker.ec:addProduct', {
  'id': 'P12345',
  'quantity': 1
});

Bước tiếp theo

Nếu bạn đã đọc tất cả các hướng dẫn trong phần này, bạn nên quen thuộc với hầu hết các tính năng của analytics.js. Hướng dẫn tiếp theo giải thích cách gỡ lỗi triển khai analytics.js của bạn để dễ dàng phát hiện lỗi hơn và xem chính xác mã của bạn đang làm gì.

Facebook Google Twitter More

• Pinterest
• Linkedin
• Tumblr

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

Subscribe by Email

Follow Updates Articles from This Blog via Email