9ping Analytics
Cài đặt mã theo dõi
Cách cài chuẩn là một script async duy nhất, đặt trước thẻ đóng body của mỗi trang bạn muốn đo lường. Thay XXXX bằng site_id hiển thị trên trang Quản lý site của bạn.
<script async src="https://9ping.dev/hm.min.js" data-sid="XXXX"></script>
Nếu bạn dùng Google Tag Manager, tạo một thẻ Custom HTML mới, dán đoạn mã y hệt, và đặt trigger thành All Pages.
Đối với khách tắt JavaScript hoặc cho ngữ cảnh email và AMP, thêm một ảnh một pixel dự phòng bên trong thẻ noscript — bạn ít nhất sẽ ghi nhận được lượt xem trang.
<noscript><img src="https://9ping.dev/collect.php?sid=XXXX&type=pv" width="1" height="1" alt=""></noscript>
Với ứng dụng single-page (React, Vue, Next, Nuxt và tương tự), chèn script một lần khi khởi động — mã sẽ tự động đếm một lượt xem trang ảo cho mỗi lần đổi route phía client.
(function(){var s=document.createElement('script');s.async=true;s.src='https://9ping.dev/hm.min.js';s.dataset.sid='XXXX';document.head.appendChild(s);})();
Sự kiện tùy chỉnh
Khi mã đã tải xong, hàm toàn cục window.tj sẵn sàng cho các sự kiện tùy biến như nhấn nút, gửi biểu mẫu và tải xuống. Chữ ký hàm là category, action, label.
tj('event', 'button', 'click', 'download_whitepaper');
Với router bạn tự kiểm soát, bạn có thể kích hoạt một lượt xem trang rõ ràng bằng cách gọi tj('pv'). Với các cú nhấp trước khi mã tải, đoạn stub khởi đầu sẽ xếp hàng các lệnh gọi và phát lại ngay khi script tải xong, nên bạn không cần bọc handler trong setTimeout.
Xác minh quyền sở hữu site
Khuyến nghị xác minh trước khi bạn bật các báo cáo nâng cao. Trang Quản lý site liệt kê bốn phương pháp có thể thay thế nhau cho mỗi site — chọn cái nào dễ nhất cho bạn.
Phương pháp một — tệp HTML. Tải tj-verify-TOKEN.html từ bảng điều khiển và tải lên thư mục gốc của site.
Phương pháp hai — thẻ meta. Dán một thẻ meta duy nhất vào phần head của trang chủ.
<meta name="tj-site-verification" content="YOUR_TOKEN">
Phương pháp ba — mã theo dõi. Nếu trang chủ đã chạy mã của chúng tôi và đã nhận ít nhất một lượt truy cập, nó được xác minh tự động. Phương pháp bốn — DNS TXT. Thêm tj-site-verification=YOUR_TOKEN làm bản ghi TXT trên tên miền gốc.
Open API và triển khai hàng loạt
Mỗi tài khoản đi kèm một khóa API cá nhân (tiền tố tjk_) cho phép bạn liệt kê site, tạo site, lấy đoạn mã theo dõi và đọc số liệu thống kê qua HTTPS. Xác thực bằng cách gửi tiêu đề X-API-Key.
curl -H "X-API-Key: $TJ_KEY" "https://9ping.dev/openapi.php?action=sites"
Để triển khai mã cho cả một nhóm site từ một máy Linux duy nhất, tải tj-deploy.sh từ trang Quản lý site. Nó đăng ký từng tên miền qua API, tạo đoạn mã theo dõi, và có thể tùy chọn chèn vào các template của bạn.
Open API hỗ trợ tạo site hàng loạt từ một tệp văn bản, mỗi dòng là tên miền đơn hoặc domain|name. Bạn có thể tìm danh sách hành động đầy đủ trong tài liệu tham khảo API.
Bảo mật: xác minh 2 bước và mã khôi phục
Mọi tài khoản bảng điều khiển đều bắt buộc xác minh 2 bước bằng Google Authenticator (TOTP, RFC 6238). Khi đăng ký, bạn nhận được mười mã khôi phục một lần — hãy lưu chúng ở nơi an toàn; nếu bạn mất điện thoại, đó là cách duy nhất để quay lại.
Mã khôi phục dùng một lần và được lưu dưới dạng băm trên máy chủ. Để khôi phục, dùng liên kết Khôi phục bằng mã khôi phục trên trang đăng nhập; quy trình khôi phục sẽ cho phép bạn đặt mật khẩu mới và liên kết lại trình xác thực.
Chuyển từ GA4 hoặc Baidu Tongji
Bạn không cần gỡ mã hiện có để dùng thử 9ping Analytics — cả hai mã có thể chạy song song và báo cáo độc lập, đây là cách an toàn nhất để so sánh số liệu trong một tuần trước khi chuyển hẳn.
Để chuyển, thêm tên miền của bạn ở Quản lý site, dán đoạn mã một dòng trước thẻ đóng body (hoặc đẩy qua GTM), xem bảng thời gian thực sáng lên, và gỡ mã cũ bất cứ khi nào bạn sẵn sàng.
Sự kiện tùy chỉnh chuyển đổi gọn gàng: một sự kiện GA4 tên là signup chẳng hạn, với tham số method và plan, trở thành tj('event', 'signup', method, plan). Mục tiêu và phễu được xử lý trong 9ping bằng cách gắn thẻ cho các sự kiện liên quan; không có cấu hình mục tiêu riêng phải duy trì.