Cloud-Bereitstellung

Überblick

tracio.ai ist eine vollständig verwaltete Cloud-Plattform. Ihre Anwendung sendet Signale aus dem Browser, und die Cloud gibt ein Identifizierungsergebnis zurück. Die Plattform übernimmt Skalierung, Redundanz und Infrastrukturverwaltung.

Der Einstieg dauert nur Minuten: Konto erstellen, Public Key erhalten, SDK installieren und mit der Identifizierung von Besuchern beginnen.

Nur Managed Cloud. TRACIO bietet keine selbst gehostete oder On-Premise-Installation — es gibt keine installierbare Serverkomponente. Steuern können Sie die Datenregion, aus der Ihr Traffic bedient wird (siehe unten), und, wenn der Agent von Ihrer eigenen Domain ausgeliefert werden soll, einen First-Party-Proxy vor dem verwalteten Endpunkt über die Optionen endpoint / scriptUrl.

Funktionsweise

Ihre Anwendung kommuniziert mit der Cloud über das clientseitige JavaScript-SDK. Das SDK lädt einen Agenten im Browser, erfasst Signale und gibt das Identifizierungsergebnis zurück:

Text

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

Das Browser-SDK lädt den Agenten und erfasst Signale.
Die Signale werden an die tracio.ai-Cloud gesendet.
Die Cloud gibt das Ergebnis zurück: visitorId und bot-Informationen.

Um auf Ergebnisse auf Ihrem eigenen Server zu reagieren, empfangen Sie jede Identifizierung als signierten Webhook oder lesen Sie sie bei Bedarf über die Server API.

Einstieg

Registrieren Sie sich und öffnen Sie Ihr Dashboard.
Wählen Sie Ihre Datenregion (siehe unten).
Kopieren Sie Ihren Public Key — er kann gefahrlos in clientseitigem Code ausgeliefert werden.
Installieren Sie das SDK und initialisieren Sie es:

TypeScript

import { Tracio } from "@tracio/sdk"

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

Datenregionen

Die SDK-Option region wählt aus, mit welcher Datenregion das SDK kommuniziert. Sie akzeptiert "us" oder "eu". Ist sie nicht gesetzt, verwendet das SDK den generischen Endpunkt https://edge.tracio.ai — setzen Sie sie explizit, um eine Region festzulegen.

Region	Beschreibung
nicht gesetzt	Generischer `edge.tracio.ai`-Endpunkt (keine Region festgelegt)
`us`	US-Datenregion
`eu`	EU-Datenregion

Verwaltung der API-Schlüssel

Ihr Workspace verwendet zwei Arten von Schlüsseln, die nicht austauschbar sind:

Schlüssel	Wohin er gehört	Sieht so aus
Public Key	Der Browser — gefahrlos in clientseitigem Code auslieferbar	40 Zeichen, ohne Präfix
Secret Key	Nur Ihr Backend — authentifiziert die Server API	`tracio_sk_` plus 43 Zeichen

Beide erstellen und verwalten Sie im Dashboard unter API Keys. Secret Keys erfordern mindestens den Pro-Tarif.
Ein Secret Key wird nur einmal angezeigt, bei der Erstellung — auf unserer Seite wird lediglich ein Hash gespeichert. Geht er verloren, wird er nicht wiederhergestellt, sondern rotiert.
Beim Rotieren eines Secret Keys bleibt der vorherige noch 7 Tage gültig, damit Sie ohne Ausfallzeit deployen können. Public Keys werden nicht rotiert: Sie sind keine Geheimnisse und im Quelltext Ihrer Seite bewusst sichtbar.

Um Ergebnisse serverseitig zu nutzen, haben Sie zwei Möglichkeiten, die sich gut kombinieren lassen:

Konfigurieren Sie einen Webhook — jede Identifizierung wird an Ihren Endpunkt zugestellt, signiert mit X-Tracio-Signature.
Rufen Sie die Server API mit Ihrem Secret Key auf, um bei Bedarf die Historie eines Besuchers, einzelne Sessions oder Velocity-Zähler zu lesen.

Webhooks

Sie können Webhooks konfigurieren, um Identifizierungsereignisse aus der Cloud auf Ihrem eigenen Server zu empfangen. Webhooks sind ab dem Pro-Tarif verfügbar — siehe Webhooks für Einrichtung, Payload und Details zur Signaturprüfung.