5분 만에 시작하고 실행하기
시작까지 단 5분
정확한 디바이스 식별까지 다섯 단계. 신용카드가 필요 없습니다.
1
회원 가입
몇 초 만에 계정을 만드세요. 신용카드가 필요 없습니다. 매월 2,500회의 무료 API 호출을 제공합니다.
이메일
you@company.com
비밀번호
••••••••••••
계정 만들기
2
퍼블릭 키 발급
대시보드에서 퍼블릭 키를 복사하세요. 40자리 16진수 문자열이며, 클라이언트 측 코드에 포함해도 안전합니다.
내 퍼블릭 키
5ca175fc530fcaacccf96a65190dea8a8c1f6fac
복사
3
SDK 설치
@tracio/sdk 클라이언트 라이브러리를 추가하세요. 프레임워크별 패키지는 빠른 시작 가이드를 참고하세요.
4
방문자 식별
Tracio.init()으로 초기화한 다음 tracio.getResult()를 호출하면 고유 방문자 ID와 봇 탐지 결과를 받을 수 있습니다.
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
확인
이벤트가 서버 측에 도착했는지 확인하세요. TRACIO는 각 식별 결과를 서명된 웹훅으로 엔드포인트에 전달하며, 모든 이벤트는 대시보드에서도 확인할 수 있습니다.
웹훅 전송 (엔드포인트로 POST)
X-Tracio-Signature: t=1710432000,v1=5257a869…
{
"requestId": "9c1f4b2e-7d3a-4f18-8b6c-2e5a71d0c4f9",
"visitorId": "X7fh2Hg9LkMn3pQr5tBvQw3xZa9mK2pL4nR8dT6y",
"bot": { "result": "human", "score": 2 },
"identification": { "confidence": 0.95 },
"geo": { "country": "CZ", "city": "Prague" }
}X-Tracio-Signature HMAC를 검증한 다음 페이로드를 처리하세요. 전체 페이로드와 서명 검증 방법은 웹훅을 참고하세요.
문제 해결
npm install이 실패하나요?
Node.js v16 이상을 사용하고 있는지 확인하세요. node --version으로 확인할 수 있습니다.
퍼블릭 키가 작동하지 않나요?
사용 중인 워크스페이스의 40자리 퍼블릭 키가 맞는지 확인하세요.
CORS 오류가 발생하나요?
프록시 연동 설정을 사용해 요청을 자체 도메인을 통해 라우팅하세요.