Hướng dẫn này giải thích cách sử dụng phiên bản gỡ lỗi của thư viện analytics.js để đảm bảo các hoạt động triển khai của bạn đang hoạt động đúng cách.
Phiên bản gỡ lỗi của thư viện analytics.js
Google Analytics cung cấp một phiên bản gỡ lỗi của thư viện analytics.js giúp ghi lại các thông báo chi tiết đến bảng điều khiển JavaScript khi bảng điều khiển đang chạy. Các thông báo này bao gồm các lệnh được thực thi thành công, cũng như cảnh báo và thông báo lỗi có thể cho bạn biết thời điểm thẻ được thiết lập không đúng cách. Báo cáo này cũng cung cấp bảng chi tiết về từng lượt truy cập được gửi đến Google Analytics, nhờ đó, bạn có thể biết chính xác dữ liệu nào đang được thu thập.
Bạn có thể bật phiên bản gỡ lỗi của analytics.js bằng cách thay đổi URL trong thẻ JavaScript từ https://www.google-analytics.com/analytics.js thành https://www.google-analytics.com/analytics_debug.js:
(function(i,s,o,g,r,a,m){i['GoogleAnalyticsObject']=r;i[r]=i[r]||function(){
(i[r].q=i[r].q||[]).push(arguments)},i[r].l=1*new Date();a=s.createElement(o),
m=s.getElementsByTagName(o)[0];a.async=1;a.src=g;m.parentNode.insertBefore(a,m)
})(window,document,'script','https://www.google-analytics.com/analytics_debug.js','ga');
ga('create', 'UA-XXXXX-Y', 'auto');
ga('send', 'pageview');
Kiểm tra phương thức triển khai mà không cần gửi lượt truy cập
Phiên bản gỡ lỗi của analytics.js sẽ gửi dữ liệu đến Google Analytics giống hệt như phiên bản không gỡ lỗi. Nhờ đó, bạn có thể truy cập vào một trang web đang chạy mã analytics.js và kiểm tra quá trình triển khai mà không ảnh hưởng đến cách dữ liệu được thu thập.
Nếu không muốn gửi dữ liệu đến Google Analytics trong một số trường hợp nhất định (ví dụ: môi trường phát triển hoặc thử nghiệm), bạn có thể tắt tác vụ sendHitTask và sẽ không có tác vụ nào được gửi.
Khi chạy trên localhost, mã sau sẽ ngăn gửi bất kỳ lượt truy cập nào đến Google Analytics:
(function(i,s,o,g,r,a,m){i['GoogleAnalyticsObject']=r;i[r]=i[r]||function(){
(i[r].q=i[r].q||[]).push(arguments)},i[r].l=1*new Date();a=s.createElement(o),
m=s.getElementsByTagName(o)[0];a.async=1;a.src=g;m.parentNode.insertBefore(a,m)
})(window,document,'script','https://www.google-analytics.com/analytics_debug.js','ga');
ga('create', 'UA-XXXXX-Y', 'auto');
if (location.hostname == 'localhost') {
ga('set', 'sendHitTask', null);
}
ga('send', 'pageview');
Gỡ lỗi theo dõi
Việc bật tính năng gỡ lỗi theo dõi sẽ xuất thông tin chi tiết hơn cho bảng điều khiển.
Để bật tính năng gỡ lỗi theo dõi, hãy tải phiên bản gỡ lỗi của analytics.js như mô tả ở trên và thêm dòng JavaScript sau đây trước bất kỳ lệnh gọi nào vào hàng đợi lệnh ga().
window.ga_debug = {trace: true};
Sau đây là thẻ đầy đủ đã bật tính năng gỡ lỗi theo dõi:
(function(i,s,o,g,r,a,m){i['GoogleAnalyticsObject']=r;i[r]=i[r]||function(){
(i[r].q=i[r].q||[]).push(arguments)},i[r].l=1*new Date();a=s.createElement(o),
m=s.getElementsByTagName(o)[0];a.async=1;a.src=g;m.parentNode.insertBefore(a,m)
})(window,document,'script','https://www.google-analytics.com/analytics_debug.js','ga');
window.ga_debug = {trace: true};
ga('create', 'UA-XXXXX-Y', 'auto');
ga('send', 'pageview');
Tiện ích Google Analytics Debugger của Chrome
Google Analytics cũng cung cấp một tiện ích của Chrome có thể bật phiên bản gỡ lỗi của analytics.js mà không yêu cầu bạn phải thay đổi thẻ. Điều này cho phép bạn gỡ lỗi trang web của riêng mình và cũng xem cách các trang web khác đã triển khai Google Analytics bằng analytics.js.
Hỗ trợ thẻ Google
Google Tag Assistant là một Tiện ích của Chrome giúp bạn xác thực thẻ trên trang web và khắc phục các vấn đề thường gặp. Đây là công cụ lý tưởng để gỡ lỗi và kiểm tra cục bộ việc triển khai analytics.js và đảm bảo mọi thứ đều chính xác trước khi triển khai mã chính thức.
Tiện ích Tag Assistant hoạt động bằng cách cho phép bạn ghi lại quy trình thông thường của người dùng. Tính năng này thu thập tất cả các lượt truy cập mà bạn gửi, kiểm tra xem có vấn đề nào không và cung cấp cho bạn báo cáo đầy đủ về các lượt tương tác. Nếu phát hiện thấy bất kỳ vấn đề nào hoặc khả năng cải thiện, tính năng này sẽ thông báo cho bạn.
Để tìm hiểu thêm, hãy truy cập vào trung tâm trợ giúp và đọc bài viết Giới thiệu về tiện ích Tag Assistant và Giới thiệu về Bản ghi hỗ trợ thẻ. Bạn cũng có thể xem video minh hoạ này. Video này cho thấy cách Tag Assistant được dùng để phát hiện lỗi và kiểm tra tính hợp lệ của các phương pháp triển khai nâng cao như tính năng đo lường trên nhiều miền.