클라우드 배포

개요

tracio.ai는 완전 관리형 클라우드 플랫폼입니다. 애플리케이션이 브라우저에서 신호를 전송하면 클라우드가 식별 결과를 반환합니다. 플랫폼은 확장, 이중화, 인프라 관리를 처리합니다.

시작하는 데는 몇 분이면 충분합니다. 계정을 만들고, 퍼블릭 키를 받고, SDK를 설치한 뒤 방문자 식별을 시작하세요.

작동 방식

애플리케이션은 클라이언트 측 JavaScript SDK를 통해 클라우드와 통신합니다. SDK는 브라우저에서 에이전트를 로드하고, 신호를 수집하며, 식별 결과를 반환합니다.

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

1. 브라우저 SDK가 에이전트를 로드하고 신호를 수집합니다.
2. 신호가 tracio.ai 클라우드로 전송됩니다.
3. 클라우드가 결과를 반환합니다: visitorId와 bot 정보.

자체 서버에서 결과를 처리하려면, 각 식별을 서명된 webhook으로 수신하세요.

시작하기

1. 가입한 뒤 대시보드를 엽니다.
2. 데이터 리전을 선택합니다(아래 참고).
3. 퍼블릭 키를 복사합니다 — 클라이언트 측 코드에 포함해 배포해도 안전합니다.
4. SDK를 설치하고 초기화합니다:

import { Tracio } from "@tracio/sdk"

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

데이터 리전

SDK의 region 옵션은 SDK가 통신할 데이터 리전을 선택합니다. "us" 또는 "eu"를 허용합니다. 설정하지 않으면 SDK는 일반 https://edge.tracio.ai 엔드포인트를 사용합니다 — 리전을 고정하려면 명시적으로 설정하세요.

API 키 관리

• 퍼블릭 키는 브라우저용이며 클라이언트 측 코드에 노출해도 안전합니다.
• 키는 대시보드에서 관리하고 교체하세요.
• 결과를 서버 측에서 처리하려면 webhook을 구성하세요 — 각 식별이 X-Tracio-Signature로 서명되어 엔드포인트로 전달됩니다.

Webhooks

클라우드로부터 알림을 받도록 webhook을 구성할 수 있습니다. 설정 및 페이로드 세부 정보는 Webhooks를 참고하세요.