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á třída detekce se spustila (úplný slovník najdete v části Typy botů):
| bot.type | Častá příčina falešně pozitivního výsledku | Řešení |
|---|---|---|
automation | Testovací nástroj nechal prohlížeč v režimu automatizace | Vypněte režim automatizace mimo testovací běhy |
headless | VDI / vzdálená plocha renderuje bez skutečné GPU | Viz „Firemní prostředí“ níže |
extension | Je aktivní rozšíření pro automatizaci, proxy nebo VPN | Prověřte rozšíření |
other | Spustil se nespecifický indikátor automatizace | Třídu zjistíte v reasons (Business+) |
V tarifech Business a Enterprise pole reasons ve webhooku pojmenovává třídu
pozorování, které stojí za verdiktem — je to nejrychlejší cesta k pochopení falešně
pozitivního výsledku. Viz Kódy důvodů.
2. Firemní prostředí se softwarovým renderováním
Prostředí Citrix, VDI a terminálových serverů renderují bez skutečné GPU, což připomíná
headless běhové prostředí. 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") { // VDI and remote-desktop users render without a real GPU and can trip the // headless classification — 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 znatelně déle než na vašich ostatních
testovacích zařízeních a sítích.
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 trvá příliš dlouho
Na méně výkonných zařízeních trvá sběr déle. Každá kontrola, která může být pomalá, je omezena vlastním timeoutem, takže sběr nikdy neblokuje donekonečna — kontrola, které vyprší čas, je prostě ohlášena jako nedostupná a identifikace pokračuje bez ní.
Identifikace proběhne, ale konfidence je u konkrétního prohlížeče nebo třídy zařízení nižší, než se čekalo.
Ne každá kontrola může běžet v každém prostředí: přísná CSP, omezení platformy a funkce ochrany soukromí v prohlížeči některé z nich znepřístupní. To je očekávané a je to ošetřeno elegantně — konfidence se počítá z toho, co se skutečně podařilo sebrat, a proto se zpevněné prohlížeče legitimně identifikují s nižší konfidencí než běžné.
Z vaší strany není nutná žádná akce. Pokud je konfidence trvale nízká u velké části
vašeho provozu, kontaktujte podporu s requestId — to se diagnostikuje ze záznamu na
straně serveru, ne z prohlížeče.
Pokud narazíte na problém, který zde není popsán:
debug: truerequestId postižené identifikace