이 페이지에서는 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 | 일반적인 오탐 원인 | 해결 방법 |
|---|---|---|
webdriver | 브라우저 테스트 도구가 navigator.webdriver = true를 남김 | 사용자가 테스트 모드를 비활성화해야 함 |
headless | 소프트웨어 GPU 렌더링을 사용하는 VNC/원격 데스크톱 | SwiftShader/llvmpipe가 GPU 렌더러인지 확인 |
unknown | 브라우저 확장 프로그램으로 인한 Eval 길이 이상 | 확장 프로그램을 검토 |
rateBot | 자동 페이지 새로고침 또는 공격적인 폴링 | 요청 빈도를 줄임 |
2. 소프트웨어 렌더링을 사용하는 기업 환경
Citrix, VDI, 터미널 서버 환경은 종종 소프트웨어 GPU 렌더링(SwiftShader, llvmpipe)을 사용하며, 이는 헤드리스 마커입니다. 사용자가 이러한 환경에서 작업하는 경우, 웹훅이 headless 봇 유형을 표시할 때 더 완화된 정책을 적용하세요:
// `event` is the webhook delivery body (/docs/webhooks)if (event.bot.result === "bot" && event.bot.type === "headless") { // Software-GPU (SwiftShader/llvmpipe) VDI users can trip the headless // detector — 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()가 반환하는 데 500ms 이상 걸립니다.
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. 신호 수집에 시간이 너무 오래 걸림
일부 신호에는 타임아웃이 있습니다. 느린 기기에서는 수집에 200ms 이상 걸릴 수 있습니다. 지연을 추가할 가능성이 가장 높은 신호는 오디오 핑거프린트(iOS에서 AudioContext가 일시 중단됨), WebRTC/TURN 프로브, 폰트 감지, DRM 타이밍입니다. 이들은 타임아웃으로 제한되며 무한정 차단되는 일은 없습니다.
일부 신호가 성공이 아닌 상태(예: "not available" 또는 "timeout")를 반환합니다.
신호 오류는 예상되는 것이며 우아하게 처리됩니다 — 시스템은 사용 가능한 신호를 기반으로 신뢰도를 조정합니다. 일반적인 예: CSP에 의해 캔버스가 차단됨, iOS에서 AudioContext 타임아웃, 대부분의 브라우저에서 WebGPU 미지원, Chromium 외부에서 Client Hints 사용 불가. 중요 신호(canvas, WebGL, audio)가 많은 방문자에 걸쳐 지속적으로 실패하지 않는 한 별도의 조치는 필요하지 않습니다.
여기에서 다루지 않은 문제가 발생하면: