Pornire rapidă

Acest ghid vă conduce prin integrarea TRACIO în aplicația dumneavoastră. Veți instala SDK-ul client, îl veți inițializa cu cheia publică și veți citi primul rezultat de identificare a vizitatorului.

Pasul 1: Instalați SDK-ul

Instalați SDK-ul TRACIO folosind managerul de pachete preferat:

npm install @tracio/sdk

Sau cu pnpm:

pnpm add @tracio/sdk

Sau cu yarn:

yarn add @tracio/sdk

Snippet CDN fără build

Dacă nu folosiți un bundler, adăugați tag-ul de script edge în pagina dumneavoastră. Acesta se inițializează automat cu cheia publică din parametrul de interogare k:

<script src="https://edge.tracio.ai/s.js?k=PUBLIC_KEY" async></script>

Pasul 2: Inițializați SDK-ul

Importați Tracio și apelați Tracio.init() cu cheia dumneavoastră publică. Aceasta returnează imediat o TracioInstance — agentul subiacent se încarcă în fundal.

import { Tracio } from "@tracio/sdk"

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

Cheia dumneavoastră publică poate fi livrată fără riscuri în codul client-side. O găsiți în dashboard, la secțiunea API Keys.

Opțiuni de configurare

Tracio.init() acceptă un obiect TracioConfig:

Pasul 3: Obțineți un ID de vizitator

Apelați tracio.getVisitorId() pentru a primi un identificator stabil de vizitator. Aceasta este o operațiune asincronă.

const visitorId = await tracio.getVisitorId()

console.log(visitorId) // "X7fh2Hg9LkMn3pQr"

Pasul 4: Citiți rezultatul complet

Apelați tracio.getResult() pentru a primi rezultatul complet de identificare, inclusiv detectarea boților.

const result = await tracio.getResult()

console.log(result.visitorId) // "X7fh2Hg9LkMn3pQr"

if (result.bot.detected) {
  console.warn("bot, confidence:", result.bot.confidence)
}

Rezultatul are forma:

{
  visitorId: "X7fh2Hg9LkMn3pQr",
  bot: {
    detected: false,
    confidence: 2,        // 0-100
    reasons: [],
  },
}

Pasul 5: Ciclu de viață și erori

Folosiți callback-urile de ciclu de viață pentru a reacționa atunci când agentul este gata sau când ceva eșuează, și destroy() pentru a demonta instanța:

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

tracio.onReady((result) => {
  console.log("ready:", result.visitorId)
})

tracio.onError((error) => {
  console.error("tracio error:", error.code, error.message)
})

// later, when you no longer need it
tracio.destroy()

Consultați Gestionarea erorilor pentru lista completă a codurilor de eroare și a helper-elor de reîncercare.

Modele de integrare frecvente

Protecția autentificării

import { Tracio } from "@tracio/sdk"

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

async function handleLogin(email: string, password: string) {
  const visitorId = await tracio.getVisitorId()

  const response = await fetch("/api/login", {
    method: "POST",
    body: JSON.stringify({ email, password, visitorId }),
  })

  return response.json()
}

Prevenirea fraudei la plăți

import { Tracio } from "@tracio/sdk"

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

async function processPayment(paymentData: PaymentData) {
  const result = await tracio.getResult()

  if (result.bot.detected) {
    throw new Error("Automated client detected")
  }

  const response = await fetch("/api/payment", {
    method: "POST",
    body: JSON.stringify({ ...paymentData, visitorId: result.visitorId }),
  })

  return response.json()
}

Pași următori

• Cum funcționează — Înțelegeți colectarea semnalelor și pipeline-ul de identificare
• Referință SDK JavaScript — Documentația completă a API-ului SDK
• Webhooks — Primiți evenimente de identificare pe serverul dumneavoastră în timp real
• Detectarea boților — Analiză detaliată a detectării automatizării