Hướng dẫn kết nối Cloudflare Analytics

Dùng API Token chỉ đọc, xem lưu lượng và bảo mật ngay tại tầng edge — trước khi request chạm tới server.

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

Nếu website của bạn đang chạy qua Cloudflare, mọi request đều đi qua mạng lưới edge của Cloudflare trước khi tới server gốc. ClickSentinel đọc dữ liệu này qua GraphQL Analytics API để cho thấy lưu lượng thật, hiệu quả cache và các mối đe dọa đã bị chặn — góc nhìn mà Google Analytics không có.

Kết nối dùng API Token phạm vi hẹp (Zone → Analytics → Read) do chính bạn tạo trên Cloudflare — không phải OAuth vì Cloudflare không hỗ trợ OAuth cho API cá nhân. Dữ liệu chỉ khả dụng khi domain thực sự nằm trên hạ tầng Cloudflare (DNS proxy đang bật).

Số liệu đo tại edge — phát hiện traffic trước khi chạm server gốc
Theo dõi Cache Hit Ratio để biết server gốc được giảm tải bao nhiêu
Threats Blocked bổ trợ trực tiếp cho phát hiện gian lận của ClickSentinel

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

Requests & Page Views

Requests là tổng số HTTP request Cloudflare xử lý; Page Views là số request tải trang HTML thực sự.

Cache Hit Ratio

Tỷ lệ request được phục vụ từ cache Cloudflare thay vì gọi tới server gốc — tỷ lệ càng cao, server càng nhẹ tải.

Threats Blocked

Số request bị Cloudflare tự động chặn vì nghi ngờ tấn công hoặc bot độc hại — tín hiệu chéo hữu ích cho phát hiện gian lận.

Zone ID vs API Token

Zone ID xác định đúng domain cần lấy dữ liệu; API Token là chìa khóa xác thực — nên tạo token với quyền tối thiểu (chỉ đọc Analytics).

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

1Đăng nhập dash.cloudflare.com, chọn domain cần kết nối, copy Zone ID ở tab Overview (chuỗi 32 ký tự).
2Vào My Profile → API Tokens → Create Token, tạo token với quyền tối thiểu "Zone → Analytics → Read".
3Vào mục Cloudflare trong ClickSentinel, chọn Site, dán Zone ID và API Token rồi nhấn Kết nối.
4Hệ thống xác thực token trước khi lưu; sau khi kết nối thành công, dữ liệu tự động đồng bộ mỗi ngày lúc 3:25 sáng.

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

Cloudflare Analytics có cần trả phí không?

Không. GraphQL Analytics API cơ bản khả dụng ngay cả với gói Cloudflare Free, chỉ giới hạn ở granularity theo ngày (không có theo giờ/phút).

Nếu domain không nằm trên Cloudflare thì sao?

Sẽ không có dữ liệu để đồng bộ. Tính năng này chỉ hoạt động khi domain thực sự dùng Cloudflare làm DNS/Proxy (đám mây màu cam).

API Token có an toàn không?

Token được mã hóa khi lưu trữ trong ClickSentinel. Bạn nên tạo token với quyền tối thiểu (chỉ đọc Analytics) và có thể thu hồi bất cứ lúc nào từ Cloudflare Dashboard.

Vì sao số liệu Cloudflare cao hơn Google Analytics?

Cloudflare đếm request ở tầng edge (trước khi trang tải xong), trong khi GA4 chỉ đếm khi trang đã tải và chạy xong JavaScript — nên Cloudflare thường ghi nhận nhiều hơn, kể cả traffic từ bot chưa chạy JS.