Trình bổ trợ là các tập lệnh giúp nâng cao chức năng của analytics.js để hỗ trợ đo lường hoạt động tương tác của người dùng. Trình bổ trợ thường dành riêng cho một tập hợp các tính năng mà tất cả người dùng Google Analytics có thể không bắt buộc phải có, chẳng hạn như ecommerce hoặc đo lường trên nhiều miền, và do đó không được đưa vào 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 trình bổ trợ analytics.js.
Yêu cầu trình bổ trợ
Lệnh require lấy tên của một trình bổ trợ và đăng ký trình bổ trợ đó để sử dụng với hàng đợi lệnh ga(). Nếu trình bổ trợ chấp nhận các tuỳ chọn cấu hình, thì các tuỳ chọn đó có thể được truyền dưới dạng đối số cuối cùng cho lệnh require.
Dưới đây là chữ ký đầy đủ của lệnh require:
ga('[trackerName.]require', pluginName, [pluginOptions]);
Ví dụ: dưới đây là cách bạn yêu cầu trình bổ trợ 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');
Dưới đây là cách bạn yêu cầu trình bổ trợ Tính năng quảng cáo cho trình theo dõi có tên "myTracker" và chuyển một lựa chọn cấu hình để ghi đè giá trị tên cookie mặc định:
ga('myTracker.require', 'displayfeatures', {
cookieName: 'display_features_cookie'
});
Tải mã trình bổ trợ
Lệnh require khởi chạy các phương thức trình bổ trợ để sử dụng với hàng đợi lệnh ga(), nhưng không tải chính tập lệnh trình bổ trợ. Nếu đang sử dụng trình bổ trợ của bên thứ ba hoặc tự viết trình bổ trợ, bạn sẽ cần tự thêm mã trình bổ trợ vào trang.
Bạn nên thêm mã trình bổ trợ vào trang thông qua thẻ <script> có đặt thuộc tính async để đảm bảo thuộc tính này không chặn việc tải các tính năng khác trên trang web.
Mã sau đây vừa yêu cầu vừa tải trình bổ trợ theo dõi đường 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>
Đang đợi trình bổ trợ tải
Bởi vì cả thư viện analytics.js và trình bổ trợ analytics.js đều được tải không đồng bộ, nên bạn có thể gặp khó khăn khi biết thời điểm các trình bổ trợ đượ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 thực thi hàng đợi lệnh khi gặp lệnh require cho một trình bổ trợ chưa được tải. Sau khi trình bổ trợ được tải, quá trình 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 thử các trình bổ trợ mà mình đang sử dụng để đảm bảo các trình bổ trợ đó tải và chạy chính xác. Nếu trình bổ trợ không tải được hoặc có lỗi, thì trình bổ trợ này sẽ ngăn thực thi tất cả các lệnh analytics.js tiếp theo.
Phương thức trình bổ trợ gọi
Sau khi yêu cầu trình bổ trợ, bạn sẽ có thể sử dụng các phương thức của trình bổ trợ này cùng với hàng đợi lệnh ga(). Dưới đây là chữ ký lệnh để gọi các phương thức trình bổ trợ:
ga('[trackerName.][pluginName:]methodName', ...args);
Ví dụ: phương thức addProduct của trình bổ trợ Thương mại điện tử nâng cao có thể được gọi như sau:
ga('ec:addProduct', {
'id': 'P12345',
'quantity': 1
});
Hoặc trên một trình theo dõi được đặ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
});
Các bước tiếp theo
Nếu đã đọc tất cả hướng dẫn trong phần này, thì bạn chắc hẳn sẽ quen 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 hoạt động triển khai analytics.js để 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ì.