이 페이지에서

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 Event 익스플로러 Chrome 확장 프로그램은 브라우저 JS SDK가 발생하는 모든 Amplitude 이벤트를 캡처하고 사용자가 제품과 상호 작용할 때 각 이벤트의 페이로드를 팝업에 표시합니다. 또한 가이드 및 설문조사 트리거 상태와 웹 실험 노출을 표시하므로 가이드, 설문조사 또는 실험이 예상대로 작동하지 않는 이유를 디버깅할 수 있습니다. Chrome 웹 스토어에서 설치하세요.

브라우저에서 이벤트가 발생하는 순간 해당 원시 이벤트 및 사용자 속성을 사용하여 이벤트를 검사해야 할 경우 확장 기능을 사용하십시오. 이벤트가 Amplitude에 도착한 후 이를 검토하고 사용자와 세션을 검색하려면 대신 사용자 조회를 사용하십시오.

이벤트 익스플로러는 표시 이름이 다른 경우에도 event_type를 표시합니다.

트리거된 이벤트 보기

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

이벤트를 수신하는 여러 Amplitude 프로젝트 대상 구간에서 전환하려면 프로젝트 드롭다운에서 프로젝트를 선택합니다. 축약된 API 키는 각 Amplitude 프로젝트를 구별합니다.

팝업에서 모든 이벤트를 지우려면 이벤트 지우기를 선택합니다.

특정 이벤트 유형을 숨기려면 숨김 아이콘을 선택합니다.

이벤트의 이벤트 및 사용자 속성 매개변수를 복사하려면 복사 아이콘을 선택합니다.

구성 옵션 보기

각 프로젝트의 SDK에 대해 설정한 구성 옵션을 보려면 API 옵션 탭을 선택합니다.

숨겨진 이벤트 보기

숨겨진 이벤트 목록을 보거나 이벤트가 트리거될 때 웹 페이지에 이벤트를 표시하려면 설정 탭을 선택합니다.

가이드 및 설문조사

이 확장기능에는 가이드 및 설문조사를 디버깅하는 데 도움이 되는 도구가 포함되어 있습니다. 이러한 기능을 사용하여 SDK 설정을 확인하고, 가이드나 설문조사가 표시되지 않는 이유를 해결하고, 이벤트 기반 트리거를 테스트하세요.

가이드 및 설문조사 탭은 실시간으로 업데이트되지 않습니다. 페이지의 로딩이 완료될 때까지 기다린 후 페이지의 정보를 검토하십시오.

SDK 설정

특정 가이드나 설문조사의 문제를 해결하기 전에 페이지에서 가이드 및 설문조사 SDK가 올바르게 실행되는지 확인하세요.

SDK 설정 섹션에는 다음 네 단계의 상태가 표시됩니다.

  • 설치됨: 페이지에 SDK를 설치했습니다.
  • 초기화됨: SDK를 구성으로 초기화했습니다.
  • 연결된 분석: SDK는 하나 이상의 분석 SDK에 연결됩니다.
  • 부팅됨: SDK가 사용자 정보를 받았으며 트리거에 따라 가이드와 설문조사를 표시할 준비가 되었습니다.

모든 검사를 통과했지만 가이드 또는 설문조사가 여전히 작동하지 않는 경우 다음 설정을 확인하십시오.

  • 구성: 구성 표시를 사용하여 API 키가 가이드 또는 설문조사를 게시한 프로젝트와 일치하는지 확인하십시오.
  • 사용자 식별: 사용자 정보 표시를 사용하여 user_id가 예상 사용자와 일치하는지 확인합니다.
  • SDK 설치: 일부 페이지에는 가이드 및 설문조사 SDK를 설치했지만 다른 페이지에는 설치하지 않았을 수 있습니다. 가이드나 설문조사를 설정하려는 모든 페이지에 SDK를 설치했는지 확인하세요.
  • 부팅 단계: 부팅 단계는 특정 환경이나 사용자 유형에 따라 달라질 수 있습니다. 환경이나 사용자 유형에 관계없이 코드가 항상 이를 호출하도록 하십시오.

문제 해결 가이드 및 설문 조사

문제 해결 섹션에는 관련 프로젝트의 API 키에 대한 모든 게시된 가이드와 설문조사가 표시됩니다. 각 가이드 또는 설문조사는 해당 트리거 조건과 해당 조건이 통과했는지 여부를 표시합니다.

전체 가이드 또는 설문조사의 미리보기를 열어 미리보기 도구 모음을 확인하고 개별 단계를 디버깅할 수 있습니다. 미리 보기를 사용하면 가이드의 동작을 테스트하고 특정 단계의 문제를 식별할 수 있습니다.

확장된 섹션에서는 미리보기를 열지 않고도 가이드나 설문조사가 표시되지 않는 이유를 보여줍니다. 트리거 조건을 확인하여 어떤 요구 사항이 충족되지 않는지 확인하십시오.

  • 트리거되었는지 표시해야 함: 모든 트리거 조건이 통과되었는지 가이드에 표시할지 여부입니다.
  • 트리거 조건: 내장 스로틀, 사용자 지정 스로틀, 제한, 페이지 타겟팅, 스누즈 설정 및 사용자 타겟팅.

전달된 이벤트

가이드 및 설문조사 SDK가 클라이언트 측에서 인식하는 모든 이벤트를 확인합니다. SDK는 클라이언트측 이벤트만 볼 수 있으며 서버측 이벤트에 액세스할 수 없습니다.

전달된 이벤트 섹션을 사용하여 다음을 수행할 수 있습니다.

  • SDK가 수신한 이벤트를 봅니다.
  • 테스트 이벤트를 시뮬레이션하여 특정 이벤트에 따라 가이드를 트리거합니다.

이벤트 기반 트리거를 테스트하려면 입력 필드에 이벤트 이름을 입력하고 이벤트 테스트를 선택합니다. 이벤트는 해당 타임스탬프와 전체 이벤트 페이로드와 함께 기록된 이벤트 목록에 나타납니다.

웹 실험

이 확장 기능은 활성 웹 실험에 대한 세부적인 타겟팅 정보를 보여주므로 실험이 진행되지 않는 이유를 진단할 수 있습니다. 페이지에서 실험이 실행될 때 확장기능은 노출됨 또는 노출되지 않음을 한 눈에 알 수 있는 전체 노출 배지와 함께 디버깅 세부 정보 패널을 표시합니다.

최신 버전의 확장 프로그램으로 업데이트하여 웹 실험 디버깅 세부 정보를 확인하세요.

오디언스 타겟팅

오디언스 타겟팅 섹션은 일치하는 세그먼트와 실험이 현재 사용자에게 할당한 변형을 보여줍니다. 이를 사용하여 사용자가 예상한 세그먼트에 속하는지 확인하십시오.

페이지 타겟팅

페이지 타겟팅 섹션은 구성된 페이지 보기 규칙, 현재 URL이 해당 규칙과 일치하는지 여부, 트리거 상태를 보여줍니다. URL 불일치 및 트리거 설정 오류가 대부분의 문제를 야기하니, 실험이 실행되지 않을 때 이 섹션을 먼저 확인하세요.

변형 미리보기

실험 구성을 변경하지 않고 특정 변형을 QA하려면 변형 미리보기 를 사용하여 실험에서 현재 사용자에게 할당한 변형을 무시하십시오. 재정의는 사용자의 세션에만 적용되므로 다른 사용자나 실제 실험에 영향을 주지 않습니다.

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