레퍼런스

자주 찾는 이름을 한자리에 모았습니다. 개념별 배경 설명은 핵심 개념과 이벤트 설계에 있습니다.

게이트웨이 요청 헤더

헤더	역할
Authorization: Bearer ck-abto-…	ABTO Calling Key로 프로젝트를 식별합니다. 필수입니다.
x-abto-key-openai 등	직접 계약한 모델 제공사의 API 키입니다. 필수입니다.
x-abto-feature-id	기능 ID입니다. 필수이며, 없는 요청은 거절됩니다.
x-abto-device-id	사용자 기기 식별자입니다. 선택이며, 없어도 호출과 호출 분석은 그대로 되지만 행동 연결과 sticky 배정, 사용자 기준 지표에서는 그 요청이 빠집니다.

게이트웨이 응답 헤더

헤더	역할
x-abto-request-id	방금 호출의 식별자입니다. 개별 상호작용을 특정 호출에 연결할 때 쓰며, 하나만 기억한다면 이것입니다.
x-abto-attempt	몇 번째 시도가 이 응답을 만들었는지 나타내는 1 기반 서수입니다. 게이트웨이가 재시도하면 시도마다 결말이 남습니다.
x-abto-provider	실제로 배정된 모델 제공사입니다. 같은 모델 ID가 여러 제공사에 걸칠 수 있어 응답 본문만으로는 복구되지 않습니다.
x-abto-error-source	실패 응답의 출처로 provider, transport, internal 중 하나입니다. 노출 이전 admission 거절에는 붙지 않으므로, 부재 자체가 문전 처리 신호입니다.

게이트웨이의 재시도 규칙은 Node / Server JavaScript에 있습니다.

브라우저 시스템 이벤트

SDK 이름	Analytics event_name
$pageview	pageview
$pageleave	pageleave
$ai_prompt_submitted	llm_prompt_submitted
$ai_response_rendered	llm_response_rendered
$ai_response_interacted	llm_response_interacted

주요 식별자

이름	의미
uuid / event_id	SDK가 자동 생성하는 이벤트 식별자
$device_id	브라우저 설치 식별자. 제품 행동과 AI 사용을 잇는 기본 축
$user_id	identify로 얹는 로그인 사용자 식별자 (선택)
$session_id	논리 세션 식별자
$pageview_id	page/route 관찰 구간 식별자
$feature_id	기능 ID(a.b.c). 게이트웨이 호출 헤더 x-abto-feature-id 와 같은 값
$request_id	게이트웨이가 발급하는 AI 요청 식별자. 호출과 응답 상호작용을 잇는 상관 키
$response_id	개별 AI 응답 식별자