Tham chiếu phán quyết
Mỗi phán quyết của Fraud Prevention — dù được gửi tới callback onVerdict của bạn trong Web SDK hay được kéo từ Data API — đều là cùng một đối tượng BotVerdict. Trang này mô tả từng trường và cách hành động với nó.
{
"is_bot": false,
"score": 18,
"level": "low",
"action": "record_only",
"consistency": { "ok": true },
"degraded": false
}Các trường
| Trường | Kiểu | Mô tả |
|---|---|---|
is_bot | boolean | Phán quyết chính. true = lượt truy cập bị đánh giá là lưu lượng tự động hoặc không hợp lệ; false = trông giống người thật. Đây là trường mà hầu hết các tích hợp dựa vào để rẽ nhánh. |
score | number (0–100) | Mức độ đáng ngờ của lượt truy cập. Càng cao càng đáng ngờ. Dùng nó để đặt ngưỡng riêng của bạn — ví dụ loại bỏ các lượt truy cập vượt một mốc cắt mà bạn chọn. Giá trị cụ thể do mô hình rủi ro của chúng tôi tạo ra và không nhằm để bị suy diễn ngược. |
level | enum | Phân dải thô của score: low, medium, high, critical. Tiện khi bạn muốn dùng các nhóm thay vì một con số thô. |
action | enum | Cách xử lý được khuyến nghị của chúng tôi cho lượt truy cập: record_only, challenge, hoặc flag. Xem bên dưới. |
consistency | object | Một kết luận về tính nhất quán xuyên tín hiệu. Hãy đọc consistency.ok (boolean): true = các tín hiệu của lượt truy cập khớp với kỳ vọng; false = có gì đó không khớp và lượt truy cập đáng được soi xét thêm. Phần chi tiết nội bộ phía sau kết luận này không được lộ ra. |
degraded | boolean | true khi phán quyết không thể được tính toán đầy đủ (dịch vụ không truy cập được, lỗi, v.v.) và một giá trị dự phòng thận trọng được trả về. Hãy coi phán quyết suy giảm là "không rõ", chứ không phải "sạch". |
action — nên làm gì
action là khuyến nghị của chúng tôi; bạn vẫn nắm quyền quyết định cuối cùng.
action | Ý nghĩa | Nên làm gì |
|---|---|---|
record_only | Lượt truy cập trông bình thường. | Tiếp tục như thường. Chỉ ghi lại phán quyết phục vụ báo cáo và đối soát. |
flag | Lượt truy cập đáng ngờ nhưng chưa kết luận là xấu. | Vẫn phục vụ trang, nhưng đánh dấu lượt truy cập là chất lượng thấp — loại nó khỏi số liệu của bạn, tách nó ra khỏi các luồng phía sau, và tính trọng số cho nó trong các quyết định của riêng bạn (ví dụ phân bổ chuyển đổi hoặc mức độ tin tưởng lượt truy cập). |
challenge | Lượt truy cập có rủi ro cao. | Yêu cầu thêm một lần xác minh trước khi coi khách truy cập là người thật. Với escalate: true của Web SDK, việc này được xử lý giúp bạn (xem Nâng cấp xác minh); nếu không, hãy áp dụng cổng chặn của riêng bạn. |
Hành động xử lý có thể cấu hình
action báo cáo gì cho một lượt truy cập rủi ro cao là cấu hình theo từng ứng dụng, được đặt trong bảng điều khiển dưới phần chi tiết ứng dụng của bạn. Phán quyết là quyền uy ở phía máy chủ: action chỉ trở thành challenge hoặc flag khi lượt truy cập đạt dải rủi ro cao và ứng dụng của bạn được cấu hình với hành động tương ứng. Dưới dải đó, phán quyết vẫn là record_only.
| Cấu hình | action trả về khi rủi ro cao | Ý nghĩa |
|---|---|---|
record_only (mặc định) | record_only | Chỉ ghi nhận. Phán quyết được ghi lại phục vụ báo cáo và đối soát; không yêu cầu gì ở khách truy cập. |
challenge | challenge | Kích hoạt một CAPTCHA xác minh lại. Web SDK bật lên một challenge (kiểu dáng do challengeConfig của SDK điều khiển). |
flag | flag | Đánh dấu lượt truy cập. Phán quyết mang flag; tích hợp của bạn tự quyết cách hành động với nó (chặn / phân tách / xử lý). |
Vì quyết định được đưa ra ở phía máy chủ, mã của bạn vẫn đơn giản: đọc verdict.action trong onVerdict và hành động theo nó — tiếp tục, chặn, hoặc để SDK hiển thị một challenge. Bạn không cần tự suy ra lại rủi ro.
level so với score
level chỉ là một cách phân dải của score, cung cấp cho tiện:
level | Dùng khi |
|---|---|
low | Coi như lưu lượng sạch. |
medium | Giáp ranh — ghi nhận thì ổn, cân nhắc loại khỏi các phễu giá trị cao. |
high | Đáng ngờ rõ rệt — gắn cờ và loại bỏ. |
critical | Gần như chắc chắn không hợp lệ — gắn cờ/loại bỏ và, lý tưởng nhất, nâng cấp xác minh. |
Chọn trường phù hợp với pipeline của bạn
- Cổng chặn có/không đơn giản → rẽ nhánh theo
is_bot. - Theo khuyến nghị → rẽ nhánh theo
action. - Ngưỡng tùy chỉnh → rẽ nhánh theo
score(hoặclevelđể chia nhóm).
Xử lý phán quyết suy giảm
Khi degraded là true, phán quyết chưa được tính toán đầy đủ. Giá trị dự phòng được cố ý đặt thận trọng (is_bot: false, action: record_only) nên người dùng thật không bao giờ bị chặn. Trong báo cáo, hãy coi những lượt này là không rõ thay vì tính chúng là lưu lượng đã xác nhận sạch.