FAQ

연동 중 가장 자주 나오는 질문을 모았습니다.

Custom Event가 운영 환경에서 보이지 않나요?

개발 환경과 달리 운영 환경은 미등록 이벤트와 선언에 어긋난 이벤트를 버립니다(drop). 그래서 개발에서 수집되던 이벤트가 운영에서만 누락됩니다.

abto.events.ts에 그 이벤트가 선언되어 있는지, required property와 type, enum이 선언과 맞는지 확인하세요. 어긋난 항목을 선언에 맞추면 다음 전송부터 정상 수집됩니다. 자세한 규칙은 이벤트 설계에 있습니다.

$ 이름 경고는 왜 나오나요?

$로 시작하는 이름은 ABTO 시스템 전용이라 제품이 쓸 수 없습니다. 경고는 예약된 이름 공간과 충돌했다는 뜻입니다.

이벤트와 property 이름에 $를 쓴 곳이 있는지 확인하세요. checkout_completed처럼 제품 도메인 용어로 이름을 바꾸고, $tenant_id 같은 값은 Custom Property로 보내지 않습니다.

API 키 오류는 어떻게 잡나요?

두 키는 사용 위치가 다릅니다. 브라우저에는 Event Key만 쓰고, Calling Key로는 이벤트를 보낼 수 없습니다.

오류가 난 요청이 어느 키를 쓰는지 먼저 확인하세요. Calling Key는 서버 환경 변수에만 두고 URL query, source map, 클라이언트 번들에서 제거합니다. Event Key가 일부 요청의 URL에 노출되는 것은 정상 동작이며 설정 오류가 아닙니다.

같은 이벤트가 두 번 보이는데 괜찮나요?

괜찮습니다. 일시적인 네트워크 실패 뒤의 재시도는 정상 동작입니다.

수집 서버가 이벤트마다 붙는 고유 id로 중복을 제거하므로 같은 이벤트가 두 번 집계되지 않습니다. 집계 수치가 실제로 두 배로 증가했다면 재시도가 아니라 capture 호출 자체가 두 번 실행된 것이니 이벤트를 보내는 코드가 중복 실행되는지 확인하세요.