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 domeniul de pe care este servit scriptul: conectează-ți propriul subdomeniu în dashboard, vezi Domenii personalizate.

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.