Propojení účtů

Propojení účtů spojuje identifikaci TRACIO na úrovni zařízení s vaším vlastním pojetím uživatele. Předáním interního ID účtu jako linkedId říkáte TRACIO, které visitor ID patří téže ověřené osobě — napříč prohlížeči, zařízeními a relacemi.

Co to je

Každý návštěvník, kterého TRACIO uvidí, dostane identifikátor na úrovni zařízení (viz Identifikace). Sám o sobě o vašich uživatelích nic neví — pouze rozpozná vracející se zařízení.

linkedId tuto mezeru uzavírá: je to accountId aktuálně ověřeného uživatele, odesílané spolu s běžným požadavkem na identifikaci. Když dvě nebo více visitor ID sdílejí stejné linkedId, TRACIO je propojí do jednoho účtu, což pohání stránku Connections v dashboardu, identitu napříč zařízeními a detekci driftu při převzetí účtu (ATO) — viz Co získáte.

Bez linkedId vidí TRACIO jen anonymní zařízení a nemá jak je seskupit podle účtů.

Rychlé nastavení

Propojení účtů je doplňkový parametr integrace, kterou už máte. Kód na backendu není potřeba.

Script tag

Přidejte lid do stávajícího script tagu vedle svého veřejného klíče:

<!-- před -->
<script src="https://edge.tracio.ai/s.js?k=PUBLIC_KEY" async></script>

<!-- po (teprve až je uživatel přihlášen) -->
<script src="https://edge.tracio.ai/s.js?k=PUBLIC_KEY&lid=ACCOUNT_ID" async></script>

SDK

Pokud používáte @tracio/sdk, předejte linkedId v konfiguraci:

import { Tracio } from "@tracio/sdk"

const tracio = Tracio.init({
  publicKey: "5ca175fc...",
  linkedId: user.id,
})

Single-page aplikace

linkedId se čte jen jednou, ve chvíli načtení agenta. Pokud se váš script tag nebo volání Tracio.init() spouští před přihlášením, zajistěte, aby bylo linkedId doplněno, jakmile je znám stav přihlášení:

• Script tag: po přihlášení vložte tag znovu (nebo znovu načtěte stránku) s lid=ACCOUNT_ID.
• SDK: opětovné volání Tracio.init() se stejným publicKey vrátí existující instanci a novou konfiguraci ignoruje — linkedId nepřevezme. Zavolejte nejdřív tracio.destroy() a poté Tracio.init({ publicKey, linkedId: user.id }). Případně odložte první volání Tracio.init(), dokud nebude stav přihlášení znám.

Pravidla

• Pouze přihlášení uživatelé. linkedId posílejte až po skutečném přihlášení. Nikdy ho neposílejte pro hosty ani anonymní návštěvníky a nikdy nesahejte po zástupné hodnotě jako "guest" nebo "anonymous" — sdílená zástupná hodnota sloučí nesouvisející lidi do jednoho účtu.
• Použijte stabilní interní ID. Ideální je číselné ID nebo UUID z vaší vlastní tabulky uživatelů. Nepoužívejte e-mailovou adresu ani jméno: interní ID se nezmění, když si uživatel změní e-mail, a neposíláte identifikující údaje, které nepotřebujete.
• Limit 256 bajtů. linkedId se ořízne na 256 bajtech. Běžná ID jsou hluboko pod tímto limitem; nepředávejte rozsáhlé tokeny (například celé JWT).

Soukromí

linkedId se ukládá spolu s ostatními událostními daty vašeho pracovního prostoru a v dashboardu se vám zobrazuje jako identifikátor účtu na stránce Connections — pro zobrazení se nehashuje ani neanonymizuje, protože potřebujete účet poznat.

Interně používá párování TRACIO napříč zařízeními (detekce fanoutu, behaviorální baseline pro ATO) samostatný jednosměrný hash linkedId v rámci daného prostředí — nikdy surovou hodnotu. Logika párování tak nikdy nezávisí na otevřené hodnotě ani ji neodhaluje mimo váš vlastní dashboard a webhooky.

Právě proto by linkedId mělo být neprůhledné interní ID, a ne e-mailová adresa nebo jméno (viz Pravidla): vidíte ho jako identifikátor svého účtu, takže by nemělo nést víc osobních údajů, než už máte.

Ověření, že to funguje

1. Záložka Network. Po přihlášení otevřete DevTools → Network a ověřte, že požadavek na s.js (nebo identifikační požadavek agenta) obsahuje parametry k= i lid=.
2. Dashboard. Otevřete ve svém pracovním prostoru stránku Connections. Dokud není linkedId integrováno, zobrazuje se upozornění na nastavení; zmizí během několika minut po prvním požadavku s lid=.

Co získáte

Jakmile linkedId proudí, TRACIO odemkne:

• Stránka Connections — účty sdílející jedno či více zařízení, se sílou vazby, společnými prohlížeči a zeměmi a s vyšetřovacím grafem pro třídění podezřelých překryvů.
• Identita napříč zařízeními — tatáž osoba rozpoznaná na telefonu, notebooku i v různých prohlížečích, bez spoléhání se pouze na cookies.
• Detekce driftu při převzetí účtu (ATO) — behaviorální baseline pro každý účet, takže relace odchylující se od zavedených zařízení a vzorců účtu lze označit i tehdy, když jsou přihlašovací údaje správné.