Zum Inhalt springen
In 5 Minuten einsatzbereit

Erste Schritte in 5 Minuten

Fünf Schritte zur präzisen Geräteidentifikation. Keine Kreditkarte erforderlich.

1

Registrieren

Erstellen Sie Ihr Konto in Sekunden. Keine Kreditkarte erforderlich. Erhalten Sie 2,500 kostenlose API-Aufrufe pro Monat.

E-Mail
you@company.com
Passwort
••••••••••••
Konto erstellen
2

Public Key holen

Kopieren Sie Ihren Public Key aus dem Dashboard. Es handelt sich um einen 40-stelligen Hex-String, der sicher in clientseitigem Code ausgeliefert werden kann.

Ihr Public Key
5ca175fc530fcaacccf96a65190dea8a8c1f6fac
Kopieren
3

SDK installieren

Fügen Sie die Client-Bibliothek @tracio/sdk hinzu. Framework-spezifische Pakete finden Sie im Schnellstart.

Terminal
$ npm install @tracio/sdk

Nutzen Sie ein Framework? Im Schnellstart finden Sie Pakete für React, Vue, Angular und Svelte.

4

Einen Besucher identifizieren

Initialisieren Sie mit Tracio.init() und rufen Sie dann tracio.getResult() auf, um eine eindeutige Besucher-ID und ein Bot-Detection-Ergebnis zu erhalten.

app.js
import { Tracio } from '@tracio/sdk'

// Initialize the SDK
const tracio = Tracio.init({ publicKey: '5ca175fc...' })

// Get the visitor identification
const result = await tracio.getResult()
5

Verifizieren

Bestätigen Sie, dass das Event serverseitig angekommen ist. TRACIO liefert jede Identifikation als signierten Webhook an Ihren Endpunkt, und jedes Event ist zudem in Ihrem Dashboard sichtbar.

Webhook-Zustellung (POST an Ihren Endpunkt)
X-Tracio-Signature: t=1710432000,v1=5257a869…

{
  "requestId": "1710432000_abc123def",
  "visitorId": "X7fh2Hg9LkMn3pQr",
  "bot": { "result": "human", "score": 0.02 },
  "identification": { "confidence": 0.95 },
  "geo": { "country": "CZ", "city": "Prague" }
}

Verifizieren Sie den X-Tracio-Signature-HMAC und verarbeiten Sie dann die Payload. Die vollständige Payload und Signaturprüfung finden Sie unter Webhooks.

Fehlerbehebung

npm install schlägt fehl?

Stellen Sie sicher, dass Sie Node.js v16 oder höher verwenden. Prüfen Sie dies mit node --version.

Public Key funktioniert nicht?

Vergewissern Sie sich, dass Ihr Schlüssel der 40-stellige Public Key aus dem Workspace ist, in dem Sie arbeiten.

Leeres Ergebnis?

Prüfen Sie, ob Ihre Regionskonfiguration mit der bei der Registrierung ausgewählten Region übereinstimmt.

CORS-Fehler?

Nutzen Sie das Proxy-Integrations-Setup, um Anfragen über Ihre eigene Domain zu leiten.

Bereit für die ersten Schritte?

Erstellen Sie Ihr kostenloses Konto und identifizieren Sie Besucher in unter 5 Minuten.