클라우드 배포

개요

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

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

매니지드 클라우드 전용. TRACIO는 셀프 호스팅이나 온프레미스 배포를 제공하지 않습니다. 설치형 서버 구성 요소는 존재하지 않습니다. 제어할 수 있는 것은 트래픽이 처리되는 데이터 리전(아래 참고), 그리고 에이전트를 자체 도메인에서 제공하려는 경우 endpoint / scriptUrl 옵션으로 매니지드 엔드포인트 앞에 두는 퍼스트파티 프록시입니다.

작동 방식

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

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

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

자체 서버에서 결과를 처리하려면, 각 식별을 서명된 webhook으로 수신하거나 Data API로 필요할 때 조회하세요.

시작하기

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 키 관리

워크스페이스에는 두 종류의 키가 있으며, 서로 대체할 수 없습니다.

• 둘 다 대시보드의 API Keys에서 만들고 관리합니다. 시크릿 키는 Pro 플랜 이상에서 사용할 수 있습니다.
• 시크릿 키는 생성 시 한 번만 표시되며, 우리 쪽에는 해시만 보관됩니다. 잃어버렸다면 복구가 아니라 교체(로테이션)로 대응하세요.
• 시크릿 키를 교체해도 이전 키는 7일 동안 계속 동작하므로 다운타임 없이 배포할 수 있습니다. 퍼블릭 키는 교체하지 않습니다. 비밀이 아니며 설계상 페이지 소스에 노출됩니다.

결과를 서버 측에서 받는 방법은 두 가지이며, 함께 쓰기에도 좋습니다.

• webhook을 구성하세요 — 각 식별이 X-Tracio-Signature로 서명되어 엔드포인트로 전달됩니다.
• 시크릿 키로 Data API를 호출해 방문자 이력, 개별 세션, velocity 카운터를 필요할 때 조회하세요.

Webhooks

클라우드의 식별 이벤트를 자체 서버에서 받도록 webhook을 구성할 수 있습니다. webhook은 Pro 플랜 이상에서 사용할 수 있습니다 — 설정, 페이로드, 서명 검증 세부 정보는 Webhooks를 참고하세요.