Analytics

사용자가 경로 찾기, 통화 또는 웹사이트를 클릭하거나, Google 지도를 열거나, 별표 평점 또는 작성자 저작자 표시를 클릭하거나, 사진 라이트박스를 열거나, 탭을 전환하는 것과 관련된 장소 분석 이벤트를 구독할 수 있습니다. 각 이벤트는 태그 집합과 상호작용(또는 null)을 포함하는 가장 가까운 공개 gmp-* 요소를 제공하며, 여기에서 장소 ID와 위치를 읽을 수 있습니다.

제공되는 애널리틱스 이벤트

다음 표에는 장소 UI 키트에서 제공하는 분석 이벤트의 예가 나와 있습니다.

UI 상호작용 tags: Set<string>
경로 버튼 {"click", "directions", "outbound"}
지도에서 열기 버튼 {"click", "maps", "outbound"}
통화 버튼/전화번호(개요 탭) {"click", "call_place", "outbound"}
웹사이트 버튼/웹사이트(개요 탭) {"click", "place_website", "outbound"}
기여 분석 링크 {"click", "attribution", "outbound"}
평점 링크 {"click", "reviews", "outbound"}
법적 정보 공개 링크(ⓘ 대화상자 링크) {"click", "disclosure", "outbound"}
보고서 링크 {"click", "report", "outbound"}
리뷰 링크 {"click", "review", "outbound"}
미디어/사진 링크 {"click", "media", "outbound"}
사진 라이트박스 열림(인앱) {"click", "media"}
개요 탭 선택됨(인앱) {"click", "overview_tab"}
리뷰 탭 선택됨(인앱) {"click", "reviews_tab"}
정보 탭 선택됨(인앱) {"click", "about_tab"}
리뷰 더보기 메뉴(⋮) 열림(인앱) {"click", "reviews_menu"}
라이트박스 더보기 메뉴(⋮) 열림(인앱) {"click", "lightbox_menu"}
생성형 요약 메뉴(⋮)가 열림(앱 내) {"click", "generative_summary_menu"}
생성형 리뷰 요약 메뉴(⋮) 열림 {"click", "review_summary_menu"}

시간이 지남에 따라 새로운 이벤트와 태그가 추가될 수 있으므로 개발 중에 일반 핸들러를 연결하여 구성요소와 상호작용할 때 브로드캐스트되는 모든 이벤트를 로깅할 수 있습니다.

const {Settings} = await google.maps.importLibrary('core');

// Log every gmp-analytics event broadcast on the page
Settings.getInstance().addEventListener('gmp-analytics', (event) => {
  console.log('Analytics event:', event);
});

애널리틱스 이벤트 구독 및 처리

google.maps.Settings 싱글톤 인스턴스에 gmp-analytics 이벤트 리스너를 추가하여 페이지의 모든 장소 UI 키트 요소에서 분석 이벤트를 수신 대기할 수 있습니다.

google.maps.AnalyticsEvent는 event.tags(Set<string>) 및 event.element(상호작용을 포함하는 가장 가까운 공개 gmp-* 요소를 나타내는 Element | null, 예: gmp-place-details-compact 또는 해당하는 항목이 없는 경우 null)를 제공합니다. 이 속성이 있으면 event.element.place(또는 목록 및 검색 요소의 event.element.places)에서 연결된 Place를 읽을 수 있습니다.

const {Settings} = await google.maps.importLibrary('core');
const {Place} = await google.maps.importLibrary('places');

const settings = Settings.getInstance();

settings.addEventListener('gmp-analytics', (event) => {
  const {tags, element} = event; // google.maps.AnalyticsEvent
  const place = element?.place;
  const placeId = place instanceof Place ? place.id : 'none';

  // Option A: Check for specific interactions using tag strings
  if (tags.has('directions')) {
    console.log(`User requested directions for place: ${placeId}`);
  }

  if (tags.has('outbound')) {
    console.log(`User is leaving the page via: ${[...tags].sort().join(', ')}`);
  }

  // Option B: Forward every event to your analytics pipeline (for instance, Google Analytics / gtag)
  gtag('event', 'maps_javascript_api_analytics', {
    element_tag: element?.localName ?? 'none',
    tags: [...tags].sort().join(','),
    place_id: placeId,
  });
});

페이지에 여러 장소 UI 키트 요소가 표시되는 경우 특정 DOM 요소 참조에 대해 event.element를 확인하여 이벤트를 트리거한 카드 인스턴스를 확인할 수 있습니다.

const {Settings} = await google.maps.importLibrary('core');

const featuredCard = document.querySelector('#featured-place-card');

Settings.getInstance().addEventListener('gmp-analytics', (event) => {
  if (event.element?.contains(featuredCard) && event.tags.has('directions')) {
    console.log('Directions clicked on the featured place card:', featuredCard.place?.id);
  }
});