수집과 API

리옵트 데이터를 자기 서비스에 붙이는 개발자를 위한 기술 문서입니다. SDK가 대신 해 주는 일을 HTTP 수준에서 확인하거나, 수집한 데이터를 API로 읽어 갈 때 보세요.

먼저 볼 문서Copy Anchor Link

1. 데이터 수집과 거버넌스에서 수집 요청의 형식, 응답, 오류 코드를 확인하세요.
2. HTTP API에서 자격증명 종류와 공개 API 묶음, 요청 한도를 확인하세요.
3. 데이터가 처리되는 방식에서 수집한 이벤트가 화면에 나타나기까지의 흐름과 갱신 주기를 확인하세요.

SDK를 처음 붙인다면 이 섹션보다 빠른 연동과 추적 설정을 먼저 보세요.

연동할 때 기억할 기준Copy Anchor Link

• 수집에 성공해도 화면에는 바로 반영되지 않습니다. 수집 응답은 바로 돌아오고, 분석 화면 반영은 그 뒤에 이어집니다.
• 이미 저장된 이벤트는 같은 eventId로 다시 보내도 중복으로 집계되고 두 번 저장되지 않습니다.
• 데이터 포인트 한도는 수집 요청 안에서 확인합니다. 한도를 넘은 요청은 저장되지 않고 429 quota_exceeded로 거절됩니다.
• 서버리스 환경에서는 응답이 나간 뒤에도 SDK 전송이 끝나도록 해야 합니다. 서버 SDK는 Vercel에서 요청의 waitUntil을 자동으로 찾아 쓰고(따로 설치할 패키지는 없습니다), 그런 수단이 없는 호스트에서는 flush()를 기다려야 합니다.
• 브라우저에 넣는 write key와 서버에서만 쓰는 client secret은 권한이 다릅니다. secret을 브라우저 번들에 넣지 마세요.