계정 연결은 TRACIO의 기기 단위 식별을 고객사가 정의한 사용자 개념과 이어 줍니다. 내부 계정 ID를 linkedId로 전달하면, 어떤 visitor ID가 동일한 인증 사용자에게 속하는지를 TRACIO에 알릴 수 있습니다. 브라우저와 기기, 세션을 넘나들며 동작합니다.
TRACIO가 인식하는 모든 방문자는 기기 단위 식별자를 받습니다(식별 참조). 이 식별자만으로는 고객사의 사용자에 대해 아무것도 알 수 없고, 재방문한 기기를 알아볼 뿐입니다.
linkedId는 그 간극을 메웁니다. 현재 인증된 사용자의 accountId이며, 일반 식별 요청과 함께 전송됩니다. 둘 이상의 visitor ID가 같은 linkedId를 공유하면 TRACIO는 이를 하나의 계정으로 연결하고, 이것이 대시보드의 Connections 페이지와 교차 기기 아이덴티티, 계정 탈취(ATO) 드리프트 탐지를 뒷받침합니다. 무엇을 얻게 되나요를 참고하세요.
linkedId가 없으면 TRACIO는 익명 기기만 볼 수 있어 계정 단위로 묶을 방법이 없습니다.
계정 연결은 이미 사용 중인 연동에 추가되는 파라미터입니다. 백엔드 코드는 필요하지 않습니다.
기존 스크립트 태그에 공개 키와 나란히 lid를 추가합니다.
<!-- 이전 --><script src="https://edge.tracio.ai/s.js?k=PUBLIC_KEY" async></script>
<!-- 이후 (사용자가 인증된 뒤에만) --><script src="https://edge.tracio.ai/s.js?k=PUBLIC_KEY&lid=ACCOUNT_ID" async></script>@tracio/sdk를 사용한다면 설정에서 linkedId를 전달하세요.
import { Tracio } from "@tracio/sdk"
const tracio = Tracio.init({ publicKey: "5ca175fc...", linkedId: user.id,})linkedId는 에이전트가 로드되는 시점에 한 번만 읽힙니다. 스크립트 태그나 Tracio.init() 호출이 로그인 전에 실행된다면, 인증 상태를 알게 된 즉시 linkedId가 포함되도록 해야 합니다.
lid=ACCOUNT_ID를 붙여 태그를 다시 삽입하거나 페이지를 새로고침합니다.publicKey로 Tracio.init()을 다시 호출하면 기존 인스턴스가 반환되고 새 설정은 무시되어 linkedId를 반영하지 않습니다. 먼저 tracio.destroy()를 호출한 뒤 Tracio.init({ publicKey, linkedId: user.id })을 실행하세요. 또는 사용자의 인증 상태를 알 때까지 첫 Tracio.init() 호출을 미루는 방법도 있습니다.linkedId는 실제 로그인 이후에만 전송하세요. 게스트나 익명 방문자에게는 절대 보내지 말고, "guest"나 "anonymous" 같은 자리표시자로 대체해서도 안 됩니다. 공유된 자리표시자 값은 서로 무관한 사람들을 한 계정으로 합쳐 버립니다.linkedId는 256바이트에서 잘립니다. 일반적인 ID는 그보다 훨씬 짧습니다. 큰 토큰(예: 전체 JWT)은 전달하지 마세요.linkedId는 워크스페이스의 다른 이벤트 데이터와 함께 저장되며, 대시보드의 Connections 페이지에서 계정 식별자로 그대로 표시됩니다. 계정을 알아봐야 하므로 표시 단계에서는 해시나 익명화를 적용하지 않습니다.
내부적으로 TRACIO의 교차 기기 매칭(팬아웃 탐지, ATO 행동 기준선)은 linkedId에 대해 환경 범위로 계산한 별도의 단방향 해시만 사용하며 원본 값은 사용하지 않습니다. 따라서 매칭 로직은 평문 값에 의존하지 않고, 고객사 자신의 대시보드와 웹훅을 넘어 값이 노출되지도 않습니다.
그래서 linkedId는 이메일 주소나 이름이 아니라 의미 없는 내부 ID여야 합니다(규칙 참조). 이 값은 계정 식별자로 고객사에게 보이므로, 이미 보유한 것보다 더 많은 개인정보를 담아서는 안 됩니다.
s.js 요청(또는 에이전트의 식별 요청)에 k=와 lid= 파라미터가 모두 포함되어 있는지 확인하세요.linkedId가 연동되기 전까지는 설정 안내가 표시되며, lid=를 담은 첫 요청이 들어오고 몇 분 안에 사라집니다.linkedId가 유입되기 시작하면 TRACIO는 다음을 제공합니다.