Nasazení v cloudu

Přehled

tracio.ai je plně spravovaná cloudová platforma. Vaše aplikace odesílá signály z prohlížeče a cloud vrací výsledek identifikace. Platforma se stará o škálování, redundanci a správu infrastruktury.

Začít lze během několika minut: vytvořte účet, získejte veřejný klíč, nainstalujte SDK a začněte identifikovat návštěvníky.

Pouze spravovaný cloud. TRACIO nenabízí self-hosted ani on-premise nasazení — instalovatelná serverová komponenta neexistuje. Ovlivnit můžete datový region, ze kterého je váš provoz obsluhován (viz níže), a pokud chcete agenta doručovat z vlastní domény, first-party proxy před spravovaným endpointem prostřednictvím voleb endpoint / scriptUrl.

Jak to funguje

Vaše aplikace komunikuje s cloudem prostřednictvím klientského JavaScriptového SDK. SDK načte v prohlížeči agenta, shromáždí signály a vrátí výsledek identifikace:

Text

Browser (JS SDK)  ──▶  tracio.ai Cloud
                  ◀──  (identification result)

SDK v prohlížeči načte agenta a shromáždí signály.
Signály se odešlou do cloudu tracio.ai.
Cloud vrátí výsledek: informace o visitorId a bot.

Chcete-li na výsledky reagovat na vlastním serveru, přijímejte každou identifikaci jako podepsaný webhook, nebo si je na vyžádání čtěte přes Data API.

Začínáme

Zaregistrujte se a otevřete svůj dashboard.
Zvolte svůj datový region (viz níže).
Zkopírujte svůj veřejný klíč — lze jej bezpečně dodávat v klientském kódu.
Nainstalujte SDK a inicializujte je:

TypeScript

import { Tracio } from "@tracio/sdk"

const tracio = Tracio.init({
  publicKey: "5ca175fc...",
  region: "eu",
})

Datové regiony

Volba region v SDK určuje, se kterým datovým regionem SDK komunikuje. Přijímá hodnoty "us" nebo "eu". Pokud není nastavena, SDK použije generický endpoint https://edge.tracio.ai — nastavte ji explicitně, abyste region pevně určili.

Region	Popis
nenastaveno	Generický endpoint `edge.tracio.ai` (bez pevného regionu)
`us`	Datový region US
`eu`	Datový region EU

Správa API klíčů

Váš workspace používá dva druhy klíčů a nejsou zaměnitelné:

Klíč	Kam patří	Jak vypadá
Veřejný	Prohlížeč — lze jej bezpečně dodávat v klientském kódu	40 znaků, bez prefixu
Tajný	Pouze váš backend — autentizuje Data API	`tracio_sk_` plus 43 znaků

Oba druhy vytvoříte a spravujete v dashboardu v sekci API Keys. Tajné klíče vyžadují tarif Pro nebo vyšší.
Tajný klíč se zobrazí jen jednou, při vytvoření — na naší straně zůstává pouze hash. Když jej ztratíte, neobnovujete jej, ale rotujete.
Při rotaci tajného klíče zůstává předchozí klíč funkční 7 dní, abyste mohli nasadit změnu bez výpadku. Veřejné klíče se nerotují: nejsou tajné a záměrně jsou vidět ve zdrojovém kódu stránky.

Výsledky můžete na straně serveru zpracovávat dvěma způsoby, které se dobře doplňují:

Nakonfigurujte webhook — každá identifikace je doručena na váš endpoint, podepsaná hlavičkou X-Tracio-Signature.
Volejte Data API se svým tajným klíčem a čtěte na vyžádání historii návštěvníka, jednotlivé relace nebo čítače velocity.

Webhooky

Webhooky můžete nakonfigurovat tak, aby vám identifikační události z cloudu chodily na vlastní server. Webhooky jsou dostupné od tarifu Pro výše — podrobnosti o nastavení, payloadu a ověření podpisu najdete v sekci Webhooks.