Hướng dẫn kết nối Microsoft Clarity

Kết nối để xem tín hiệu hành vi người dùng thật mà Google Analytics không đo được.

Vì sao nên kết nối Microsoft Clarity với ClickSentinel?

Microsoft Clarity là công cụ phân tích hành vi miễn phí của Microsoft, chuyên phát hiện các tín hiệu 'khó chịu' (frustration signals) như rage click, dead click, quickback — những thứ Google Analytics không đo được. ClickSentinel đồng bộ các chỉ số này để bổ trợ cho hệ thống chấm điểm chất lượng traffic.

Kết nối dùng API Token riêng cho Data Export (khác với mã nhúng theo dõi trên site), tạo bởi người có quyền admin project trên Clarity. Do API của Clarity giới hạn chỉ 10 request/project/ngày và chỉ trả về dữ liệu tổng hợp 1-3 ngày gần nhất, ClickSentinel đồng bộ 1 lần/ngày để không vượt giới hạn.

Phát hiện rage click, dead click — dấu hiệu UI có vấn đề mà số liệu traffic thông thường không thấy
Clarity tự tách phiên bot khỏi phiên người dùng thật ngay từ nguồn
Bổ trợ trực tiếp cho tính năng Heatmap có sẵn của ClickSentinel

Khái niệm cần biết

Rage Click & Dead Click

Rage Click là click dồn dập vào cùng 1 vị trí (dấu hiệu bực bội); Dead Click là click vào phần tử không có tác dụng gì (dấu hiệu UI gây nhầm lẫn).

Bot Sessions

Clarity tự nhận diện và tách riêng các phiên do bot tạo ra, không tính vào số liệu hành vi người dùng thật.

Scroll Depth

Độ sâu cuộn trang trung bình (%) — cho biết người dùng có đọc hết nội dung hay rời trang sớm.

Giới hạn Data Export API

Clarity chỉ cho phép 10 request/project/ngày và trả về dữ liệu tổng hợp tối đa 3 ngày gần nhất — không có chi tiết theo từng phiên qua API.

Các bước thực hiện

1Đăng nhập clarity.microsoft.com, chọn project (site) tương ứng cần kết nối.
2Vào Settings → Data Export → Generate new API token (cần quyền admin của project).
3Vào mục Clarity trong ClickSentinel, chọn Site, nhập Project ID và API Token rồi nhấn Kết nối.
4Lần kết nối đầu tiên dùng ngay dữ liệu trả về làm snapshot ban đầu; các ngày sau tự động đồng bộ lúc 3:35 sáng.

Câu hỏi thường gặp

Vì sao Clarity chỉ đồng bộ 1 lần mỗi ngày?

Vì Data Export API của Clarity giới hạn 10 request/project/ngày. ClickSentinel chủ động đồng bộ 1 lần lúc 3:35 sáng để không vượt giới hạn và vẫn chừa quota cho nhu cầu khác.

Dữ liệu Clarity có bị lệch ngày không?

Có thể lệch khoảng 1 ngày. Vì API trả về dữ liệu tổng hợp của 1-3 ngày gần nhất thay vì theo từng ngày cụ thể, ClickSentinel gán số liệu về 'ngày hôm qua' khi dựng biểu đồ — chuỗi dữ liệu sẽ chính xác dần khi tích lũy qua nhiều ngày.

Rage click và dead click khác gì với click gian lận mà ClickSentinel phát hiện?

Đây là 2 khái niệm khác nhau. Rage/dead click là tín hiệu UX cho thấy người dùng THẬT đang gặp khó khăn trên trang; còn click gian lận (bot, VPN, click trùng lặp) là traffic KHÔNG THẬT. Cả hai đều đáng quan tâm nhưng cần xử lý khác nhau.

Có cần cài thêm mã theo dõi (tracking code) của Clarity lên site không?

Có — Clarity vẫn cần mã nhúng riêng của họ chạy trên site để thu thập dữ liệu (giống Google Analytics). API Token trong hướng dẫn này chỉ dùng để ClickSentinel ĐỌC báo cáo, không thay thế cho mã nhúng đó.