사용자가 경로 찾기, 통화 또는 웹사이트를 클릭하거나, 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); } });