이 페이지에서

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가 현재 패키징 이전에 생성한 기존 조직에 대해 나타납니다. 기존 조직은 수동으로 활성화해야 하며 몇 가지 고려사항이 있습니다.

  • 히트맵은 히트맵 이벤트를 프로젝트에 직접 전송하므로 이벤트가 이벤트 택소노미에 나타납니다. 모든 히트맵 이벤트 유형이나 속성을 차단하면 히트맵의 작동이 중단될 수 있으며, 이러한 이벤트는 특히 속성별에서 "모든 이벤트" 쿼리에 나타날 수 있습니다.
  • 조직에서 CDP 통합을 사용하는 경우 Amplitude는 히트맵 이벤트를 데이터 웨어하우스로 전달할 수 있습니다.
  • 히트맵은 새로운 이벤트 속성을 전송합니다. 조직의 속성 한계에 도달한 경우 히트맵이 작동하기 전에 제한을 높이십시오.

기존 조직에 대해 히트맵을 활성화하려면 Amplitude 서포트에 문의하십시오.

히트맵이 비어 있거나 "사용 가능한 히트맵 없음"이라는 메시지가 표시됩니다.

빈 히트맵은 일반적으로 데이터가 완전히 새롭거나, URL 필터가 일치하지 않거나, 계측이 요구 사항을 충족하지 못함을 의미합니다. 다음 검사를 수행하십시오.

  • 처리를 기다립니다. 세션 리플레이를 설치하거나 활성화한 직후, Amplitude가 리플레이와 클릭 데이터를 처리할 때까지 URL 목록과 오버레이는 비어 있을 수 있습니다. 이 작업은 몇 분 정도 걸릴 수 있습니다.
  • URL 필터를 확인하십시오. URL 일치 옵션이 Amplitude 이벤트의 URL과 일치하는지 확인하십시오. 너무 좁은 패턴은 데이터를 반환하지 않습니다.
  • SDK 버전을 확인합니다. 히트맵을 사용하려면 세션 리플레이 브라우저 SDK 플러그인 1.7.0 이상 또는 세션 리플레이 독립형 SDK 1.14.0 이상이 필요합니다. 코드에서 버전이 변경된 것뿐만 아니라 라이브 배포 사이트가 업데이트된 SDK를 제공하는지 확인하십시오.
  • 데이터 임계값을 확인합니다. 히트맵은 Amplitude가 충분한 데이터를 수집한 후에 나타납니다. 즉, 최소 10개의 개별 페이지와 각 페이지에서 추적된 약 500건의 리플레이 클릭이 필요합니다.
  • 페이지 URL 속성을 복원합니다. [Amplitude] Page URL속성이 누락된 경우 히트맵은 URL과 일치할 수 없습니다. _데이터 > 속성_에서 복원하십시오: 검색[Amplitude] Page URL하고 복원을 클릭하십시오.

이러한 확인 후에도 히트맵에 여전히 데이터가 표시되지 않는 경우 Amplitude 서포트에 문의하십시오.

배경에 올바른 페이지 상태가 표시되지 않습니다.

히트맵 배경은 세션 리플레이의 스냅샷이므로 기본 스냅샷은 콘텐츠를 덮고 있는 열린 모달이 있는 페이지와 같은 원치 않는 상태를 캡처할 수 있습니다. 배경 선택 옵션을 사용하여 사용 가능한 스냅샷을 탐색하고 분석하려는 페이지와 일치하는 상태를 선택합니다. 각 히트맵은 가장 많은 동작을 생성한 상태에서 8개의 배경을 가져옵니다.

배경은 라이브 페이지의 픽셀 정확한 복사본이 아닙니다. 외부 리소스를 차단하는 콘텐츠 보안 정책(CSP)에 의존하거나 섀도우 DOM 스타일을 사용하는 페이지는 백그라운드에서 다르게 렌더링될 수 있습니다.

모바일 히트맵에 데이터가 표시되지 않음

히트맵은 웹 기반 세션 재생만 지원하며 모바일 앱이나 SDK는 지원하지 않습니다. 모바일 재생이 있음에도 불구하고 모바일 웹 히트맵에 데이터가 표시되지 않는 경우 히트맵에 대해 선택한 장치 유형이 캡처한 뷰포트와 일치하는지 확인하십시오. 선택한 장치 유형과 캡처된 스크린샷 대상 구간의 불일치는 경고, 불량한 렌더링 또는 사용할 수 없는 배경의 원인이 될 수 있습니다.

스크린샷에 히트맵 데이터가 표시되지 않습니다.

히트맵은 클릭 데이터를 1440px 초과, 900–1440px, 500–899px, 500px 미만의 네 가지 화면 너비 버킷으로 그룹화합니다. 맵을 렌더링하려면 스크린샷 배경과 히트맵 데이터가 동일한 버킷에 있어야 합니다. 일치하는 클릭 데이터가 없는 뷰포트 너비에서 스크린샷을 캡처하는 경우(예: 모든 세션이 900–1440px로 캡처되었을 때 1920px의 데스크탑 스크린샷) 데이터가 존재하더라도 히트맵은 비어 있는 것으로 나타납니다.

이 문제를 해결하려면 *스크린샷 변경 > 리플레이에서(From a Replay)*를 사용하고 데이터가 있는 버킷의 뷰포트 너비로 촬영된 스크린샷을 선택합니다. 특정 리플레이를 선택할 필요는 없습니다. 올바른 너비 범위에서 스크린샷을 선택하기만 하면 배경을 데이터와 맞게 정렬할 수 있습니다.

단일 페이지 앱에서 클릭 병합

히트맵은 뷰별이 아니라 URL 문자열별로 데이터를 계산합니다. 여러 상태에서 하나의 URL을 공유하는 단일 페이지 앱(SPA)의 경우 히트맵은 이러한 모든 상태의 클릭을 하나의 오버레이로 병합합니다. 상태를 구분하려면 각 상태를 대상으로 하는 더 좁은 URL 필터를 사용하여 개별 히트맵을 생성하거나, 각 뷰가 고유한 URL을 갖도록 URL 구조를 조정하십시오.

샘플링을 사용할 때 히트맵이 불완전하게 보입니다.

세션 리플레이 샘플링 속도를 적용해도 히트맵은 여전히 생성되지만, 각 히트맵은 캡처된 세션만 반영합니다. 예를 들어 샘플링 속도가 1%이면 1%의 세션에서 히트맵을 구축하게 되므로 포괄적인 뷰가 제공되지 않으며 정확도가 떨어질 수 있습니다. 더 많은 상호작용을 포착하려면 샘플링 속도를 높이십시오.

사용자가 생성하지 않은 히트맵이 나타납니다.

Amplitude는 데이터가 임계값에 도달하면 트래픽이 가장 많은 페이지에 대한 소규모 히트맵 세트를 자동으로 생성합니다. 이 자동 생성은 한 번 실행되며 가장 많은 클릭 기록을 가진 페이지를 선택합니다. 이러한 히트맵은 안전하게 삭제할 수 있으며 Amplitude는 이를 다시 생성하지 않습니다.

SDK를 업데이트하라는 메시지가 표시되는 배너

히트맵의 모든 이점을 활용하기 위해 SDK를 업데이트하라는 배너가 표시된다면 이전 세션 리플레이 SDK 버전을 사용 중임을 의미합니다. 최신 버전의 세션 리플레이 브라우저 SDK 플러그인 또는 세션 리플레이 스탠드얼론 SDK로 업그레이드하여 최신 캡처 및 렌더링 개선 사항을 활용하십시오.

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