Browser Unified SDK 이벤트 확인
Browser Unified SDK는 번들로 제공되는 Browser SDK 2를 통해 분석 이벤트를 전송합니다. 분석 이벤트는 Browser SDK 2에서와 동일한 4단계(캡처, 변환, 전송 및 수신)를 거칩니다. 이 페이지에서는 초기화부터 시작하여 통합 SDK 고유의 검사에 대해 설명하고, 다른 단계는 브라우저 SDK 2의 단계로 연결합니다.
| 스테이지 | 질문 | 찾을 수 있는 곳 |
|---|---|---|
| 초기화됨 | initAll()사용하는 모든 제품을 설정했습니까? | 엑세서 및 브라우저 네트워크 탭 |
| 캡처됨 | SDK가 호출을 수락했습니까? | 디버그 로그 |
| 변환됨 | 플러그인에서 무엇을 추가, 변경 또는 삭제했나요? | 검사 플러그인 |
| 전송됨 | 요청이 브라우저를 떠났습니까? 그렇다면 어떤 페이로드로 전송되었습니까? | 브라우저의 네트워크 탭 |
| 수신됨 | Amplitude가 이벤트를 수락하고 저장했습니까? | 업로드 결과 및 사용자 조회 |
모든 Amplitude SDK에 공통적으로 발생하는 문제에 대해서는 SDK 문제 해결 및 디버깅으로 이동하십시오. 버전 간 변경 사항은 @amplitude/unified변경 로그로 이동하십시오.
디버그 로깅 켜기
analytics내부로 logLevel통과합니다. 세션 리플레이는 동일한 로거를 통해 기록되므로 해당 메시지가 분석 메시지와 함께 표시됩니다.
amplitude.initAll("YOUR_API_KEY", {
analytics: { logLevel: amplitude.Types.LogLevel.Debug },
});
로그 수준과 각 메시지에 포함된 내용을 확인하려면 브라우저 SDK 2에서 디버그 로깅 켜기로 이동하십시오. 출시하기 전에 Warn원래대로 logLevel되돌리십시오.
각 제품이 초기화되었는지 확인하십시오.
initAll()를 기다린 다음, 액세서를 통해 각 제품을 확인하십시오.
await amplitude.initAll("YOUR_API_KEY", {
sessionReplay: { sampleRate: 1 },
});
console.log(amplitude.sessionReplay()?.getSessionReplayProperties());
// { "[Amplitude] Session Replay ID": "..." } while recording; {} when not
console.log(typeof amplitude.experiment()?.fetch);
// "function"
브라우저의 네트워크 탭에서 필터링하고 amplitude.com다음 요청을 찾습니다.
| 제품 | 요청 | 언제 |
|---|---|---|
| 세션 리플레이 | sr-client-cfg.amplitude.com/config/<API key> (sr-client-cfg.eu.amplitude.com EU의 경우) | initAll() 동안 |
| 세션 리플레이 | api-sr.amplitude.com/sessions/v2/track (api-sr.eu.amplitude.com EU의 경우) | 세션이 기록하는 동안 |
| 기능 실험 | api.lab.amplitude.com/sdk/v2/vardata (api.lab.eu.amplitude.com EU의 경우) | fetch()를 호출한 후에만 |
| 가이드 및 설문조사 | cdn.amplitude.com/engagement-browser/..., 그런 다음gs.amplitude.com/sdk/v1/... | skip동안, ~initAll()이 아닌 이상 |
getSessionReplayProperties()가 반환되는 경우 세션 리플레이가 기록되지 않습니다. {}이 메시지에 대한 로그를 확인하십시오. sampleRate그런 다음 0이 값이 이상Session ... not being captured due to capture being disabled for project or because the remote config could not be fetched.인지 확인하십시오.
SDK가 전송한 내용을 확인하십시오.
api2.amplitude.com/2/httpapi(api.eu.amplitude.com EU)에 대한 요청을 찾아 해당 페이로드를 엽니다. 각 통합 SDK 이벤트의 library필드에는 두 개의 버전 번호가 포함됩니다.
{
"event_type": "Sign Up Clicked",
"library": "amplitude-ts-unified/1.1.43-amplitude-ts/2.48.1"
}
첫 번째 버전은 @amplitude/unified입니다. 두 번째는 번들로 제공되는 브라우저 SDK 2입니다. 브라우저 SDK 2 릴리즈 노트와 동작을 비교할 때 이 버전을 사용하십시오. 페이로드 필드 및 압축을 확인하려면 'SDK가 전송한 데이터 확인'로 이동하여 브라우저 SDK 2에서의 내용을 확인하십시오.
이 내용이 도움이 되었나요?
For AI agents: a documentation index is available at /docs/llms.txt. Append .md to any page URL for markdown, or send Accept: text/markdown.