Implementare în cloud

Prezentare generală

tracio.ai este o platformă cloud complet gestionată. Aplicația ta trimite semnale din browser, iar cloud-ul returnează un rezultat de identificare. Platforma se ocupă de scalare, redundanță și gestionarea infrastructurii.

Începutul durează câteva minute: creezi un cont, obții cheia publică, instalezi SDK-ul și începi să identifici vizitatorii.

Doar cloud gestionat. TRACIO nu oferă o variantă self-hosted sau on-premise — nu există nicio componentă de server instalabilă. Ce poți controla este regiunea de date din care este servit traficul tău (vezi mai jos) și, dacă vrei ca agentul să fie servit de pe propriul tău domeniu, un proxy first-party în fața endpoint-ului gestionat, prin opțiunile endpoint / scriptUrl.

Cum funcționează

Aplicația ta comunică cu cloud-ul prin JavaScript SDK-ul care rulează pe partea de client. SDK-ul încarcă un agent în browser, colectează semnale și returnează rezultatul de identificare:

Text

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

SDK-ul din browser încarcă agentul și colectează semnale.
Semnalele sunt trimise către cloud-ul tracio.ai.
Cloud-ul returnează rezultatul: informațiile visitorId și bot.

Pentru a acționa asupra rezultatelor pe propriul tău server, primești fiecare identificare ca un webhook semnat sau le citești la cerere prin Data API.

Primii pași

Înregistrează-te și deschide dashboard-ul.
Alege regiunea ta de date (vezi mai jos).
Copiază cheia publică — poate fi livrată în siguranță în codul de pe partea de client.
Instalează SDK-ul și inițializează-l:

TypeScript

import { Tracio } from "@tracio/sdk"

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

Regiuni de date

Opțiunea region a SDK-ului selectează cu ce regiune de date comunică SDK-ul. Acceptă "us" sau "eu". Când nu este setată, SDK-ul folosește endpoint-ul generic https://edge.tracio.ai — setează-o explicit pentru a fixa o regiune.

Region	Descriere
nesetată	Endpoint generic `edge.tracio.ai` (fără regiune fixată)
`us`	Regiunea de date US
`eu`	Regiunea de date EU

Gestionarea cheilor API

Workspace-ul tău folosește două tipuri de chei, care nu sunt interschimbabile:

Cheie	Unde se folosește	Cum arată
Publică	Browserul — se poate livra în siguranță în codul de pe client	40 de caractere, fără prefix
Secretă	Doar backendul tău — autentifică Data API	`tracio_sk_` plus 43 de caractere

Ambele se creează și se gestionează din dashboard, în secțiunea API Keys. Cheile secrete necesită planul Pro sau superior.
O cheie secretă este afișată o singură dată, la creare — de partea noastră rămâne doar un hash. Dacă o pierzi, nu o recuperezi, ci o rotești.
La rotirea unei chei secrete, cea anterioară rămâne funcțională încă 7 zile, ca să poți face deploy fără întreruperi. Cheile publice nu se rotesc: nu sunt secrete și, prin proiectare, sunt vizibile în sursa paginii tale.

Pentru a folosi rezultatele pe server ai două opțiuni, care se combină bine:

Configurează un webhook — fiecare identificare este livrată către endpoint-ul tău, semnată cu X-Tracio-Signature.
Apelează Data API cu cheia ta secretă pentru a citi la cerere istoricul unui vizitator, sesiuni individuale sau contoare velocity.

Webhooks

Poți configura webhook-uri pentru a primi evenimente de identificare din cloud pe propriul tău server. Webhook-urile sunt disponibile începând cu planul Pro — vezi Webhooks pentru configurare, payload și detalii despre verificarea semnăturii.