핵심 개념

ABTO가 연결하는 세 층

층	소유하는 사실	예시
제품 행동	Browser 또는 앱이 직접 관찰한 사용자 행동	페이지 진입, 클릭, prompt 제출, 결제 완료
LLM 운영	Gateway가 확정한 요청 실행 사실	provider, model, tokens, cost, latency, retry
분석 결과	Analytics가 계산한 제품 판단	전환, retention, 비용 대비 성과

Browser는 provider나 token 수를 추측하지 않습니다. 반대로 Gateway는 화면에 응답이 실제로 렌더됐는지 알 수 없습니다. 각 계층은 관찰한 사실만 기록하고 request_id, response_id, trace_id로 연결합니다.

이벤트 UUID와 도메인 ID

uuid는 ABTO SDK가 이벤트마다 자동으로 만드는 전송·중복 제거용 ID입니다. 주문, 문서, 사용자 같은 제품 도메인의 ID가 아닙니다.

abto.capture('checkout_completed', {
  order_id: 'order-123',
});

• order_id: 고객 제품의 주문 식별자 예시
• event uuid: SDK가 자동 생성하는 ABTO 이벤트 식별자
• order_id의 필수 여부: 고객의 abto.events.ts 선언에서 결정

세션

ABTO Browser SDK는 $session_start, $session_end를 확정 사실로 보내지 않습니다. 브라우저 종료 신호는 유실될 수 있기 때문입니다. Analytics는 $session_id와 event timestamp로 세션 범위를 파생합니다.