RioHub vừa ra một tính năng mà nhiều anh chị đối tác đã hỏi: theo dõi đơn hàng tới từng click, chỉ với 1 link cho mỗi sản phẩm.
Trước đây Muốn biết đơn đến từ đâu thì phải tạo link riêng với sub_id riêng cho mỗi kênh, mỗi bài hoặc mỗi người dùng. Mỗi link là 1 lần gọi API sang TikTok, mất gần 1 giây. Muốn chi tiết tới từng click thì phải tạo hàng nghìn link, vừa chậm vừa dễ chạm giới hạn API.
Bây giờ
1. Tạo 1 link gốc cho mỗi sản phẩm qua POST /partner/tiktok/affiliate/general-links, chỉ làm 1 lần.
2. Mỗi click, hệ thống của bạn sinh 1 mã riêng (event_id) rồi gắn vào link trước khi chuyển hướng người mua. Không cần gọi API nữa.
3. Khi có đơn, postback gửi về kèm:
"trace_type": "GENERAL",
"trace_id": "<mã click của bạn>"
4. Tra lại đơn theo mã click bất kỳ lúc nào: GET /partner/tiktok/affiliate/orders?trace_id=<mã>
Lợi ích
- Nhanh hơn: gắn mã ngay trên máy của bạn, không phải chờ API.
- Giảm tải: 1 link dùng cho mọi click, số lần gọi API giảm mạnh, không lo chạm giới hạn.
- Chi tiết hơn: đối soát tới từng click thay vì gom theo nhóm sub_id.
- Ổn định: đây là cơ chế chính thức của TikTok, đã kiểm bằng đơn thật trên RioHub.
Lưu ý
- Mã click chỉ dùng chữ, số và . _ -.
- Gắn mã theo đúng hàm mẫu: event_id phải nằm ở cả 2 chỗ, trong chain_key và cuối link.
- Link general không có sub_id riêng. Đơn về luôn có subid = open_api_san, nên hãy phân biệt bằng trace_id.
- Link tạo bằng sub_id như trước vẫn chạy bình thường. Đơn từ các link đó cũng có thêm trace_id (bằng chính sub_id, trace_type = SPECIFIC).
Hướng dẫn và code mẫu
- Code mẫu PHP / Node.js / Python có sẵn hàm gắn mã, ở phần 6: https://riohub.vn/tiktok-shop-developer#sec-samples
- Muốn nhờ AI viết code: vào mục Tích hợp bằng AI, chọn "Theo dõi từng click (event_id)".
Cần hỗ trợ tích hợp thì nhắn RioHub nhé!
