Bật phép đo tùy chọn

Chúng tôi tự hào có một trong những đoạn mã JavaScript nhẹ nhất trong ngành phân tích.

Chúng tôi đạt được điều đó bằng cách hạn chế đáng kể số lượng tùy chọn trong tập lệnh mặc định. Thay vào đó, chúng tôi cung cấp các phép đo nâng cao dưới dạng tiện ích mở rộng tập lệnh tùy chọn được điều chỉnh theo cách bạn muốn sử dụng Histat. Phương pháp này đảm bảo rằng bạn chỉ tải mã thực sự sẽ được sử dụng trên trang web của mình.

Bạn có thể bật các phép đo tùy chọn này khi thêm một trang web mới vào tài khoản Histat hoặc trong khu vực "Cài đặt trang web" của phần "Chung" trong cài đặt trang web của bạn

Đoạn mã thay đổi tùy thuộc vào lựa chọn phép đo của bạn

Lưu ý rằng đoạn mã theo dõi mà bạn cần chèn vào trang web của mình sẽ thay đổi tùy thuộc vào lựa chọn phép đo nâng cao của bạn. Khi thực hiện thay đổi đối với các phép đo tùy chọn của mình, hãy đảm bảo chèn đoạn mã mới nhất vào trang web của bạn để mọi hoạt động theo dõi diễn ra như mong đợi

Sau đây là danh sách các phép đo tùy chọn của chúng tôi:

Phép đo tùy chọn	Giải thích
Liên kết đi	Tự động theo dõi lượt nhấp vào liên kết đi
Tải tệp xuống	Tự động theo dõi lượt tải tệp xuống
Trang lỗi 404	Tự động theo dõi các trang lỗi 404
Đường dẫn trang được băm	Tự động theo dõi các đường dẫn trang sử dụng # trong URL định tuyến dựa trên băm
Sự kiện tùy chỉnh	Cho phép bạn theo dõi các sự kiện tùy chỉnh như nhấp vào liên kết, gửi biểu mẫu và bất kỳ nhấp chuột nào vào phần tử HTML khác
Thuộc tính tùy chỉnh	Cho phép bạn đính kèm thuộc tính tùy chỉnh (còn được gọi là kích thước tùy chỉnh trong Google Analytics) khi gửi lượt xem trang hoặc sự kiện tùy chỉnh để tạo số liệu tùy chỉnh
Doanh thu thương mại điện tử	Cho phép bạn chỉ định giá trị tiền tệ động cho các sự kiện tùy chỉnh và theo dõi phân bổ doanh thu

Tùy chọn theo dõi nâng cao

Ngoài danh sách trên (script.outbound-links.js, script.file-downloads.js, script.hash.js, script.tagged-events.js, script.pageview-props.js và script.revenue.js), chúng tôi cũng có một số tùy chọn theo dõi nâng cao hơn. Lưu ý rằng những tùy chọn này không có trong danh sách tích hợp trang web nên bạn sẽ cần chèn chúng vào đoạn mã theo dõi theo cách thủ công.

Phần mở rộng	Giải thích
script.compat.js	Chế độ tương thích để theo dõi người dùng trên Internet Explorer (≥IE11)
script.local.js	Cho phép phân tích theo dõi trên máy chủ cục bộ, điều này hữu ích trong các ứng dụng lai
script.manual.js	Không tự động kích hoạt lượt xem trang. Cũng cho phép bạn chỉ định vị trí tùy chỉnh để biên tập URL bằng mã định danh. Bạn cũng có thể sử dụng nó để theo dõi tham số truy vấn tùy chỉnh

Cách thay đổi thủ công đoạn mã theo dõi

Ví dụ: tên tập lệnh mặc định trong đoạn mã của chúng tôi là script.js. Nếu trang web của bạn nằm trên máy chủ cục bộ và bạn muốn theo dõi các lượt truy cập đó, bạn có tùy chọn tải tập lệnh bằng phần mở rộng khác: script.local.js.

Trong trường hợp này, đoạn mã bạn cần chèn vào trang web của mình như sau (đảm bảo thay đổi thuộc tính data-domain thành miền bạn đã thêm vào Histat):

<script defer data-domain="yourdomain.com" src="https://histat.com/js/script.local.js"></script>

Bạn có thể kết hợp và kết hợp các phần mở rộng này theo bất kỳ cách nào bạn muốn. Ví dụ, nếu bạn muốn sử dụng cả định tuyến dựa trên băm và theo dõi nhấp chuột liên kết đi của chúng tôi, bạn có thể kết hợp chúng như sau: script.hash.outbound-links.js.

Trong trường hợp này, đoạn mã bạn cần chèn vào trang web của mình như sau (đảm bảo thay đổi thuộc tính data-domain thành tên miền bạn đã thêm vào Histat):

<script defer data-domain="yourdomain.com" src="https://histat.com/js/script.hash.outbound-links.js"></script>

Hoặc giả sử bạn muốn sử dụng tiện ích mở rộng script.revenue.js của chúng tôi để theo dõi doanh thu thương mại điện tử và tiện ích mở rộng script.local.js của chúng tôi để theo dõi lưu lượng truy cập localhost, đoạn mã của bạn sẽ trông như thế này:

<script defer data-domain="yourdomain.com" src="https://histat.com/js/script.revenue.local.js"></script>

Và bạn chỉ cần chèn một đoạn mã đó vào trang web của mình, không cần bất kỳ thứ gì khác.

script.compat.js

Tập ​​lệnh Histat mặc định sẽ không hoạt động trên Internet Explorer vì nó sử dụng API document.currentScript để đọc các tùy chọn cấu hình. Bạn có thể chạy Histat ở chế độ tương thích bằng cách bao gồm phần mở rộng script.compat.js và định nghĩa id="plausible" trên thẻ script để nó có thể tự tìm thấy. Lưu ý rằng điều này chỉ hoạt động trên ≥ IE11. Sau đây là cách nó sẽ trông như thế nào:

<script id="plausible" defer data-domain="yourdomain.com" src="https://histat.com/js/script.compat.js"></script>

script.manual.js

Theo mặc định, tập lệnh Histat sẽ kích hoạt lượt xem trang khi lần đầu tiên được tải. Nó cũng đính kèm trình lắng nghe vào API Lịch sử và sẽ tự động kích hoạt lượt xem trang khi bạn sử dụng history.pushState. Điều này hữu ích cho hầu hết các trang web nhưng chúng tôi cũng cung cấp chế độ thủ công trong trường hợp bạn muốn kiểm soát hoàn toàn thời điểm kích hoạt lượt xem trang trên trang web của mình.

Một trong những trường hợp sử dụng cho điều này là khi bạn sử dụng Turbo (trước đây là Turbolinks). Trong trường hợp đó, bạn muốn kích hoạt thủ công lượt xem trang Histat trên sự kiện trình duyệt turbo:load hoặc turbolinks:load tùy thuộc vào thư viện bạn sử dụng. Sau đây là cách bạn có thể thực hiện điều đó:

<script defer data-domain="yourdomain.com" src="https://histat.com/js/script.manual.js"></script>
<!-- định nghĩa hàm `plausible` để kích hoạt thủ công các sự kiện -->
<script>window.plausible = window.plausible || function() { (window.plausible.q = window.plausible.q || []).push(arguments) }</script>
<!-- kích hoạt lượt xem trang khi điều hướng turbolinks -->
<script>
document.addEventListener("turbo:load", function() {
plausible('pageview')
})
</script>

Khi sử dụng turbolinks, bạn nên đảm bảo rằng tập lệnh Histat không được tải và thực thi trong khi điều hướng turbo. Bạn có thể cần di chuyển tập lệnh đến phần <head> của trang web hoặc sử dụng thuộc tính data-turbo-eval="false" để thực hiện việc này.

ghi chú

Khi sử dụng manual.js, mỗi lệnh gọi tập lệnh với 'pageview' sẽ dẫn đến một lượt xem trang riêng biệt được tính ngay cả khi được gọi trên cùng một trang

Chỉ định vị trí tùy chỉnh cho URL trang của bạn

Ngoài ra, tiện ích mở rộng tập lệnh thủ công cho phép bạn cung cấp tùy chọn đặc biệt có tên u với các sự kiện của mình. Điều này cho phép bạn chỉ định URL của trang và có thể được sử dụng để chỉ định vị trí tùy chỉnh.

Đặc biệt hữu ích khi biên tập và tổng hợp nhiều trang có URL chứa mã định danh dành riêng cho người dùng.

Theo dõi các tham số truy vấn tùy chỉnh cho URL trang đầy đủ

Theo mặc định, Histat xóa tất cả các tham số truy vấn vì mục đích bảo mật ref, source, utm_source, utm_medium, utm_campaign, utm_content và utm_term.

Điều này có nghĩa là các trang như yoursite.com/blog/index.php?article=some_article&page=11 sẽ được báo cáo là yoursite.com/blog/index.php trong báo cáo "Các trang hàng đầu" của bảng điều khiển Histat của bạn.