Chuyển sang tracio.ai

Đăng ký và nhận API key. Gói Free của bạn bao gồm 2,500 lệnh gọi API miễn phí — đủ để chạy so sánh song song đầy đủ với nhà cung cấp hiện tại của bạn.

Thêm @tracio/sdk song song với SDK fingerprinting hiện có của bạn. Đây là một thay đổi trong mã nguồn, không phải việc tráo endpoint — tracio.ai đi kèm client riêng và định dạng kết quả riêng. Chạy cả hai cùng lúc cho phép bạn so sánh trên lưu lượng production mà không làm gián đoạn nó.

npm install @tracio/sdk

Kết quả nhận diện được đẩy đến máy chủ của bạn dưới dạng webhook có chữ ký ngay khi một khách truy cập được nhận diện, nên phần lớn tích hợp bỏ hẳn vòng lặp polling. Nếu bạn vẫn cần đọc lại một lượt truy cập sau đó, Server API trả lời theo requestId từ gói Pro trở lên. Dù theo cách nào, payload vẫn là tài liệu camelCase phẳng của riêng chúng tôi, nên bạn chỉ ánh xạ các trường một lần.

// Before (competitor) — poll by requestId
const resp = await fetch("https://api.competitor.io/events/" + requestId, {
  headers: { "Auth-API-Key": COMPETITOR_API_KEY }
});

// After (tracio.ai) — receive a signed webhook per identification
app.post("/webhook/tracio", (req, res) => {
  // verify req.headers["x-tracio-signature"], then act on req.body
  const event = req.body; // { requestId, visitorId, bot, decision, ... }
  res.status(200).send("OK");
});

Chạy đồng thời cả hai SDK trong 24–48 giờ. Visitor ID sẽ không trùng khớp giữa các nhà cung cấp — mỗi bên được tính từ một cơ sở dữ liệu khác nhau — nên hãy so sánh điều thực sự quan trọng: cùng một thiết bị vật lý có được nhận diện nhất quán qua các lượt truy cập hay không, và các phán quyết về bot khớp với nhau ra sao trên lưu lượng của bạn.

Gỡ SDK cũ và giữ trình xử lý webhook làm nguồn dữ liệu chuẩn phía máy chủ. Không có gián đoạn — cả hai SDK chạy song song cho đến khi bạn bỏ cái cũ. Khách truy cập quay lại sẽ bắt đầu lại từ đầu trong cơ sở dữ liệu của chúng tôi, nên hãy ánh xạ họ với các tài khoản hiện có của bạn bằng linkedId. Nếu có sự cố, đường khôi phục đơn giản là cài lại SDK cũ.