Wdrożenie w chmurze

Przegląd

tracio.ai to w pełni zarządzana platforma chmurowa. Twoja aplikacja wysyła sygnały z przeglądarki, a chmura zwraca wynik identyfikacji. Platforma zajmuje się skalowaniem, redundancją i zarządzaniem infrastrukturą.

Rozpoczęcie zajmuje kilka minut: utwórz konto, uzyskaj klucz publiczny, zainstaluj SDK i zacznij identyfikować odwiedzających.

Wyłącznie zarządzana chmura. TRACIO nie udostępnia wdrożenia self-hosted ani on-premise — nie ma instalowalnego komponentu serwerowego. Kontrolować możesz region danych, z którego obsługiwany jest Twój ruch (zobacz niżej), a jeśli chcesz serwować agenta z własnej domeny — proxy first-party przed zarządzanym punktem końcowym, przez opcje endpoint / scriptUrl.

Jak to działa

Twoja aplikacja komunikuje się z chmurą za pośrednictwem działającego po stronie klienta JavaScript SDK. SDK ładuje agenta w przeglądarce, zbiera sygnały i zwraca wynik identyfikacji:

Text

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

SDK przeglądarki ładuje agenta i zbiera sygnały.
Sygnały są wysyłane do chmury tracio.ai.
Chmura zwraca wynik: informacje o visitorId i bot.

Aby reagować na wyniki na własnym serwerze, odbieraj każdą identyfikację jako podpisany webhook albo odczytuj je na żądanie przez Data API.

Pierwsze kroki

Zarejestruj się i otwórz swój dashboard.
Wybierz swój region danych (patrz niżej).
Skopiuj swój klucz publiczny — można go bezpiecznie umieścić w kodzie po stronie klienta.
Zainstaluj SDK i zainicjalizuj je:

TypeScript

import { Tracio } from "@tracio/sdk"

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

Regiony danych

Opcja SDK region wybiera, z którym regionem danych komunikuje się SDK. Przyjmuje wartość "us" lub "eu". Gdy nie jest ustawiona, SDK korzysta z ogólnego punktu końcowego https://edge.tracio.ai — ustaw ją jawnie, aby przypiąć region.

Region	Opis
nieustawiony	Ogólny punkt końcowy `edge.tracio.ai` (brak przypiętego regionu)
`us`	Region danych US
`eu`	Region danych EU

Zarządzanie kluczami API

Twój workspace korzysta z dwóch rodzajów kluczy, które nie są wymienne:

Klucz	Gdzie jest używany	Jak wygląda
Publiczny	Przeglądarka — bezpiecznie umieszczać go w kodzie po stronie klienta	40 znaków, bez prefiksu
Sekretny	Wyłącznie Twój backend — uwierzytelnia Data API	`tracio_sk_` plus 43 znaki

Oba rodzaje tworzysz i zarządzasz nimi w dashboardzie, w sekcji API Keys. Klucze sekretne wymagają planu Pro lub wyższego.
Klucz sekretny jest pokazywany tylko raz, przy tworzeniu — po naszej stronie przechowywany jest wyłącznie hash. Jeśli go zgubisz, nie odzyskujesz go, tylko rotujesz.
Po rotacji klucza sekretnego poprzedni działa jeszcze przez 7 dni, dzięki czemu wdrożysz zmianę bez przestoju. Kluczy publicznych się nie rotuje: nie są tajne i z założenia są widoczne w źródle strony.

Wyniki po stronie serwera możesz odbierać na dwa sposoby, które dobrze się uzupełniają:

Skonfiguruj webhook — każda identyfikacja jest dostarczana do Twojego punktu końcowego, podpisana za pomocą X-Tracio-Signature.
Wywołaj Data API ze swoim kluczem sekretnym, aby na żądanie odczytywać historię odwiedzającego, pojedyncze sesje lub liczniki velocity.

Webhooki

Możesz skonfigurować webhooki, aby otrzymywać zdarzenia identyfikacji z chmury na własny serwer. Webhooki są dostępne w planie Pro i wyższych — szczegóły konfiguracji, payloadu i weryfikacji podpisu znajdziesz w sekcji Webhooks.