이 페이지에서는 TRACIO 연동 중에 자주 발생하는 문제와 그 해결 방법을 다룹니다. TRACIO는 관리형 클라우드 서비스이므로 대부분의 문제는 인프라 문제가 아니라 클라이언트 측(스크립트 차단, 쿠키, 브라우저의 개인정보 보호 기능)에서 발생합니다.
에이전트 스크립트 또는 식별 요청이 로드되지 않거나, 브라우저 콘솔에 edge.tracio.ai에 대한 CORS 오류가 표시됩니다.
1. 키에 대해 Origin이 허용 목록에 없음
각 공개 키는 허용된 Origin 집합으로 제한할 수 있습니다. 사이트의 Origin이 허용 목록에 없으면 엣지가 요청을 거부합니다(403). 대시보드의 Request Filtering에서 Origin을 추가하거나, 사용 중인 키가 다른 사이트에 Origin으로 잠겨 있지 않은지 확인하세요.
2. 광고 차단기 또는 CSP가 요청을 차단함
개인정보 보호 확장 프로그램(uBlock Origin, AdBlock)이나 엄격한 Content-Security-Policy가 에이전트 스크립트 또는 그 네트워크 요청을 차단할 수 있습니다. SDK는 이를 blocked 오류로 표면화합니다(오류 처리 참조). 차단을 더 어렵게 하려면 scriptUrl / endpoint 옵션을 사용해 퍼스트 파티 서브도메인에서 에이전트를 제공하세요.
3. 잘못된 엔드포인트 / 리전
올바른 엔드포인트를 가리키고 있는지 확인하세요. region을 설정하면 SDK는 edge.us.tracio.ai 또는 edge.eu.tracio.ai와 통신하고, 설정하지 않으면 edge.tracio.ai를 사용합니다.
재방문자에 대한 신뢰도 점수가 지속적으로 0.90 미만입니다.
1. 쿠키가 지속되지 않음
_vid_t 쿠키가 올바르게 설정되지 않았을 수 있습니다. 브라우저에서 확인하세요:
// In browser consoledocument.cookie.split(";").filter((c) => c.includes("_vid_t"))쿠키가 없으면 아래의 쿠키가 지속되지 않음 섹션을 참조하세요.
2. 새 워크스페이스
방금 생성된 워크스페이스는 방문자 데이터베이스가 비어 있어 모든 방문자가 신뢰도 약 0.90의 "신규"로 나타납니다. 24~48시간이 지나면 재방문자가 더 높은 신뢰도로 인식됩니다.
3. 시크릿/사생활 보호 모드 브라우징
시크릿 모드에서는 세션이 종료될 때 쿠키와 localStorage가 삭제됩니다. TRACIO는 신호 전용 매칭으로 폴백하며, 이는 신뢰도가 더 낮습니다(일반적으로 0.85~0.95).
4. 공격적인 안티 핑거프린팅을 사용하는 브라우저
Brave, Firefox(엄격 모드), Safari(ITP)는 일부 브라우저 신호를 수정하거나 차단합니다. 이로 인해 매칭에 사용할 수 있는 신호 집합이 줄어듭니다. TRACIO는 이러한 브라우저를 감지하고 그에 맞춰 신뢰도를 조정합니다.
대시보드(Visitors / Events)에서 식별 정보를 확인하거나, 각 이벤트에 대해
identification.confidence, identification.incognito 및 bot 판정을
전달하는 웹훅 전송을 활용하세요.
정상적인 사람 방문자가 봇으로 표시됩니다.
1. 브라우저 확장 프로그램이 navigator 속성을 수정함
일부 개인정보 보호 확장 프로그램은 navigator.userAgent, navigator.platform 또는 기타 속성을 수정합니다. 이는 변조 감지기를 트리거할 수 있지만, 그것만으로 봇 감지를 트리거해서는 안 됩니다.
어떤 클래스의 탐지가 발동했는지 확인하려면 bot.type 필드를 확인하세요(전체 어휘는 봇 유형 참고):
| bot.type | 일반적인 오탐 원인 | 해결 방법 |
|---|---|---|
automation | 테스트 도구가 브라우저를 자동화 모드로 남겨 둠 | 테스트 실행 외에는 자동화 모드를 비활성화 |
headless | 실제 GPU 없이 렌더링하는 VDI/원격 데스크톱 | 아래 "기업 환경" 참고 |
extension | 자동화, 프록시, VPN 브라우저 확장 프로그램이 활성 상태 | 확장 프로그램을 검토 |
other | 특정되지 않은 자동화 지표가 발동 | 클래스는 reasons(Business 이상)에서 확인 |
Business 및 Enterprise 플랜에서는 웹훅의 reasons 배열이 판정의 근거가 된 관찰의 클래스를 알려줍니다 — 오탐을 이해하는 가장 빠른 방법입니다. 이유 코드를 참고하세요.
2. 소프트웨어 렌더링을 사용하는 기업 환경
Citrix, VDI, 터미널 서버 환경은 실제 GPU 없이 렌더링하므로 헤드리스 런타임과 비슷하게 보입니다. 사용자가 이러한 환경에서 작업하는 경우, 웹훅이 headless 봇 유형을 표시할 때 더 완화된 정책을 적용하세요:
// `event` is the webhook delivery body (/docs/webhooks)if (event.bot?.result === "bot" && event.bot.type === "headless") { // VDI and remote-desktop users render without a real GPU and can trip the // headless classification — consider applying a softer policy for these.}3. 프로덕션에서의 자동화 테스트
QA 팀이 프로덕션 대상으로 Selenium/Playwright 테스트를 실행하면 이는 올바르게 봇으로 감지됩니다. 테스트 트래픽에는 별도의 키를 사용하세요.
_vid_t 쿠키가 방문 사이에 사라져 모든 방문이 "신규" 방문자로 나타납니다.
1. 비 HTTPS 사이트
_vid_t 쿠키는 Secure 플래그를 사용하며 HTTPS를 통해서만 설정됩니다. 사이트가 HTTPS를 사용하는지 확인하세요.
2. 교차 사이트 로딩
TRACIO는 쿠키에 SameSite=Lax를 설정합니다. 에이전트가 엄격한 교차 사이트 컨텍스트에서 로드되면 쿠키가 차단될 수 있습니다. 퍼스트 파티 서브도메인에서(scriptUrl / endpoint를 통해) 에이전트를 제공하면 동일 사이트로 유지됩니다.
3. Safari ITP
Safari의 Intelligent Tracking Prevention(ITP)은 클라이언트가 설정한 쿠키의 수명을 제한할 수 있습니다. TRACIO는 Set-Cookie 헤더를 통해 서버 측에서도 _vid_t를 발급하고 UID를 localStorage에 미러링하므로, 쿠키가 제한되더라도 신원이 유지됩니다.
4. 브라우저가 쿠키를 삭제함
일부 브라우저(Brave, Firefox Focus)는 세션 종료 시 쿠키를 삭제합니다. 공격적인 개인정보 보호 설정을 사용하는 사용자는 항상 신규 방문자로 나타납니다.
tracio.getResult()가 반환되기까지, 보유한 다른 테스트 기기나 네트워크에서보다 눈에 띄게 오래 걸립니다.
1. 엣지까지의 느린 네트워크
지역 엣지까지의 왕복 지연 시간을 확인하세요:
curl -o /dev/null -s -w "DNS: %{time_namelookup}s\nConnect: %{time_connect}s\nTLS: %{time_appconnect}s\nTotal: %{time_total}s\n" https://edge.tracio.ai/health2. 수집에 시간이 너무 오래 걸림
성능이 낮은 기기에서는 수집에 더 오래 걸립니다. 느려질 수 있는 검사에는 각각 자체 타임아웃이 걸려 있어 수집이 무한정 차단되는 일은 없습니다 — 시간이 초과된 검사는 그냥 사용 불가로 보고되고, 식별은 그것 없이 진행됩니다.
식별은 완료되지만, 특정 브라우저나 기기 클래스에서 신뢰도가 예상보다 낮습니다.
모든 검사가 모든 환경에서 실행될 수 있는 것은 아닙니다. 엄격한 CSP, 플랫폼 제약, 브라우저의 프라이버시 기능 때문에 일부는 사용할 수 없게 됩니다. 이는 예상되는 것이며 우아하게 처리됩니다 — 신뢰도는 실제로 수집된 것에서 계산되며, 그래서 강화된 브라우저가 기본 브라우저보다 낮은 신뢰도로 식별되는 것은 정상입니다.
여러분 쪽에서 필요한 조치는 없습니다. 트래픽의 큰 비중에서 신뢰도가 지속적으로 낮다면 requestId와 함께 지원팀에 문의하세요 — 이는 브라우저가 아니라 서버 측 기록에서 진단합니다.
여기에서 다루지 않은 문제가 발생하면: