이 페이지에서

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.

디버그 분석

세 가지 도구를 사용하여 Amplitude 계측을 디버깅하십시오. 인제스천 디버거는 요청과 스로틀링을 실시간으로 검사하며, 사용자 조회는 단일 사용자의 전체 이벤트 스트림을 표시하며, 계측 익스플로러 Chrome 확장 기능은 사용자가 사이트를 클릭할 때 발생하는 이벤트를 캡처합니다. 이러한 도구를 사용하여 이벤트가 도착했는지 확인하고, 해당 속성을 확인하며, 계측 버그를 특정 트리거로 추적할 수 있습니다.

이벤트가 Amplitude에 도달하지 않는 것으로 의심되는 경우 인제스천 디버거를 사용하십시오. 이벤트가 도착했지만 특정 사용자에 대해 속성 또는 카운트가 잘못 표시되는 경우 사용자 조회를 사용하십시오. 이벤트가 클라이언트에서 전송되기 전에 브라우저에서 라이브로 이벤트를 검사하려면 계측 익스플로러를 사용하십시오.

이러한 도구 중 하나라도 데이터를 표시하려면 먼저 최소 하나의 계측된 이벤트가 필요합니다. 아직 이벤트를 계측하지 않은 경우 먼저 테스트 앱을 설정하십시오.

인제스션 디버거

Amplitude의 수집 디버거를 사용하여 요청, 이벤트를 확인하고 개수를 식별하며 제한된 사용자나 장치를 확인하십시오.

  1. Amplitude에 로그인하십시오.
  2. 상단 네비게이션 바에서 데이터를 클릭하고 왼쪽 네비게이션 바에서 소스를 선택합니다.
  3. 수집 디버거 탭을 클릭합니다.

수집 디버거는 사용자가 지정한 엔드포인트에 대한 성공 요청, 이벤트 및 ID 개수, 오류 요청이라는 세 가지 차트를 표시합니다. 1시간 또는 1주일의 기간을 지정할 수 있습니다.

데이터 수집 디버거 아래에서 Amplitude는 지난 30분 동안 스로틀링된 사용자와 장치 및 무음화된 장치 ID를 나열합니다.

사용자 조회

1단계: 본인 찾기

이벤트를 계측한 후 해당 이벤트 중 일부를 사용자 디바이스에서 트리거하십시오. 그런 다음 Amplitude 분석을 열고 사용자 > 사용자 프로필로 이동하십시오. 사용자 ID 또는 장치 ID를 기준으로 자신을 검색하십시오.

2단계: 이벤트 스트림 분석

사용자 프로필에서 이벤트 스트림은 사용자의 전체 이벤트 기록을 세션별로 그룹화하여 표시합니다. 가장 최근의 활동이 목록 맨 위에 나타나며 이벤트는 10초에서 1분 사이에 스트림을 채웁니다.

이벤트를 클릭하면 해당 이벤트가 발생한 당시의 사용자 속성 및 이벤트 속성 값을 비롯하여 이벤트에 대한 자세한 정보를 볼 수 있습니다.

이벤트 스트림은 실시간으로 업데이트될 수 있으므로 이를 사용하여 새 이벤트를 올바르게 캡처하고 있는지 확인하거나 계측 오류를 해결하거나 디버깅할 수 있습니다. 예를 들어 이벤트를 한 번만 트리거하지만 이벤트 스트림에 해당 이벤트의 두 인스턴스가 지속적으로 표시되는 경우 계측 오류가 발생할 수 있습니다.

자세한 정보와 이벤트의 원시 데이터를 보려면 _Raw_를 클릭하십시오.

계측 익스플로러

Amplitude Instrumentation 익스플로러는 Google Chrome 웹 스토어의 확장 프로그램으로, 제품과 상호 작용하여 Amplitude Browser SDK 계측을 검토하고 디버깅할 수 있도록 도와줍니다. 이 기능은 사용자가 트리거하는 각 Amplitude 이벤트를 캡처하고 확장 프로그램 팝업에 해당 이벤트를 표시합니다. 계측 익스플로러를 다운로드합니다.

트리거된 이벤트 보기

계측 익스플로러의 이벤트 탭에서는 웹사이트에서 트리거하는 각 이벤트의 매개변수에 대한 자세한 인사이트를 확인할 수 있습니다. 여기에는 user_id, device_id, event_properties 및 user_properties가 포함됩니다.

세션 리플레이 디버그 패널

세션 리플레이 디버그 패널은 계측 익스플로러 Chrome 확장 프로그램의 일부이므로 Amplitude 앱 내부가 아니라 테스트 중인 페이지의 브라우저에서 실행됩니다. 세션 리플레이 활동이 있는 모든 페이지에서 디버그 패널을 켜서 세션 리플레이가 활성화되었는지 확인하고 Amplitude가 페이지를 캡처하는 방법을 검사하십시오. 패널은 페이지 자체 위에 떠 있습니다.

이 패널에는 다음이 표시됩니다.

  • 현재 재생 ID입니다.
  • 세션 리플레이 SDK 버전입니다.
  • 세션 리플레이 플러그인 버전입니다.
  • 샘플링 속도입니다.
  • 기본 및 유효 마스킹 설정입니다.

패널은 라이브 페이지에서 실행되므로 컨텍스트에서 캡처를 확인한 다음, 패널에서 Amplitude 앱의 일치하는 리플레이를 직접 열 수 있습니다.

이 내용이 도움이 되었나요?