Tato stránka popisuje běžné problémy, se kterými se lze setkat při integraci TRACIO, a jejich řešení. TRACIO je spravovaná cloudová služba, takže většina problémů je na straně klienta (blokovaný skript, cookies, funkce ochrany soukromí v prohlížeči), nikoli v infrastruktuře.
Skript agenta nebo identifikační požadavek se nepodaří načíst, nebo konzole prohlížeče zobrazuje chybu CORS vůči edge.tracio.ai.
1. Origin není povolen pro váš klíč
Každý veřejný klíč lze omezit na množinu povolených originů. Pokud origin vašeho webu není na seznamu povolených, edge požadavek odmítne (403). Přidejte svůj origin v sekci Request Filtering v dashboardu, nebo se ujistěte, že klíč, který používáte, není origin-zamčený na jiný web.
2. Ad blocker nebo CSP blokuje požadavek
Rozšíření pro ochranu soukromí (uBlock Origin, AdBlock) nebo striktní Content-Security-Policy mohou zablokovat skript agenta nebo jeho síťový požadavek. SDK to prezentuje jako chybu blocked (viz Ošetření chyb). Chcete-li blokování ztížit, servírujte agenta z first-party subdomény pomocí voleb scriptUrl / endpoint.
3. Špatný endpoint / region
Ujistěte se, že míříte na správný endpoint. Když nastavíte region, SDK komunikuje s edge.us.tracio.ai nebo edge.eu.tracio.ai; bez nastavení používá edge.tracio.ai.
Hodnoty konfidence jsou u vracejících se návštěvníků trvale pod 0.90.
1. Cookie se neperzistuje
Cookie _vid_t se možná nenastavuje správně. Zkontrolujte v prohlížeči:
// In browser consoledocument.cookie.split(";").filter((c) => c.includes("_vid_t"))Pokud cookie chybí, viz sekce Cookie se neperzistuje níže.
2. Nový workspace
Zbrusu nový workspace má prázdnou databázi návštěvníků, takže se všichni návštěvníci jeví jako „noví“ s konfidencí kolem 0.90. Po 24–48 hodinách jsou vracející se návštěvníci rozpoznáni s vyšší konfidencí.
3. Anonymní/soukromé prohlížení
V anonymním režimu se cookies a localStorage při ukončení relace vymažou. TRACIO pak přejde na párování pouze podle signálů, které má nižší konfidenci (typicky 0.85–0.95).
4. Prohlížeče s agresivním anti-fingerprintingem
Brave, Firefox (striktní režim) a Safari (ITP) upravují nebo blokují některé signály prohlížeče. Tím se snižuje množina signálů dostupná pro párování. TRACIO tyto prohlížeče detekuje a konfidenci odpovídajícím způsobem přizpůsobuje.
Prozkoumejte identifikaci v dashboardu (Visitors / Events), nebo reagujte na
doručení webhooku, který u každé události nese
identification.confidence, identification.incognito a verdikt bot.
Legitimní lidští návštěvníci jsou označeni jako boti.
1. Rozšíření prohlížeče upravují vlastnosti navigatoru
Některá rozšíření pro ochranu soukromí upravují navigator.userAgent, navigator.platform nebo jiné vlastnosti. To může spustit detektor manipulace (tampering), ale nemělo by samo o sobě spustit detekci botů.
Zkontrolujte pole bot.type, abyste zjistili, který detektor se spustil:
| bot.type | Častá příčina falešně pozitivního výsledku | Řešení |
|---|---|---|
webdriver | Nástroj pro testování prohlížeče nechal navigator.webdriver = true | Uživatel by měl vypnout testovací režim |
headless | VNC/vzdálená plocha se softwarovým renderováním GPU | Zkontrolujte, zda je rendererem GPU SwiftShader/llvmpipe |
unknown | Anomálie délky eval způsobená rozšířením prohlížeče | Prověřte rozšíření |
rateBot | Automatické obnovování stránky nebo agresivní polling | Snižte frekvenci požadavků |
2. Firemní prostředí se softwarovým renderováním
Prostředí Citrix, VDI a terminálových serverů často používají softwarové renderování GPU (SwiftShader, llvmpipe), což je marker headless. Pokud vaši uživatelé pracují v těchto prostředích, uplatněte mírnější politiku, když webhook zobrazuje typ bota 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. Automatizované testování v produkci
Pokud váš QA tým spouští testy Selenium/Playwright proti produkci, budou správně detekovány jako boti. Použijte pro testovací provoz samostatný klíč.
Cookie _vid_t mizí mezi návštěvami, takže se každá návštěva jeví jako „nový“ návštěvník.
1. Web bez HTTPS
Cookie _vid_t používá příznak Secure a nastavuje se pouze přes HTTPS. Ujistěte se, že váš web používá HTTPS.
2. Cross-site načítání
TRACIO nastavuje na cookie SameSite=Lax. Pokud se agent načítá ve striktně cross-site kontextu, může být cookie zablokováno. Servírování agenta z first-party subdomény (přes scriptUrl / endpoint) jej udržuje same-site.
3. Safari ITP
Intelligent Tracking Prevention (ITP) v Safari může omezit životnost cookies nastavených na straně klienta. TRACIO navíc vystavuje _vid_t i na straně serveru přes hlavičku Set-Cookie a zrcadlí UID do localStorage, takže identita přetrvá i tehdy, když je cookie omezeno.
4. Prohlížeč maže cookies
Některé prohlížeče (Brave, Firefox Focus) mažou cookies při ukončení relace. Uživatelé s agresivním nastavením soukromí se budou vždy jevit jako noví návštěvníci.
tracio.getResult() vrací výsledek déle než za 500 ms.
1. Pomalá síť k edge
Zkontrolujte round-trip latenci k vašemu regionálnímu edge:
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. Sběr signálů trvá příliš dlouho
Některé signály mají timeouty. Na pomalých zařízeních může sběr trvat 200 ms+. Signály, které nejpravděpodobněji přidávají latenci, jsou audio fingerprint (AudioContext pozastavený na iOS), sonda WebRTC/TURN, detekce fontů a časování DRM. Ty jsou omezeny timeouty a nikdy neblokují donekonečna.
Některé signály vrací neúspěšný stav (například „not available“ nebo „timeout“).
Chyby signálů jsou očekávané a jsou ošetřeny elegantně — systém přizpůsobuje konfidenci na základě dostupných signálů. Běžné příklady: canvas blokovaný CSP, timeout AudioContext na iOS, WebGPU nepodporované na většině prohlížečů, Client Hints nedostupné mimo Chromium. Žádná akce není nutná, pokud kritické signály (canvas, WebGL, audio) trvale neselhávají u mnoha návštěvníků.
Pokud narazíte na problém, který zde není popsán:
debug: truerequestId postižené identifikace