Możesz subskrybować zdarzenia analityczne dotyczące miejsc, gdy użytkownicy klikają Wskazówki dojazdu, Zadzwoń lub Witryna, otwierają Mapy Google, klikają ocenę w gwiazdkach lub informacje o autorze, otwierają lightbox ze zdjęciem lub przełączają karty. Każde zdarzenie zawiera zestaw tagów i najbliższy publiczny element gmp-*, który zawiera interakcję (lub null), z którego można odczytać identyfikator miejsca i lokalizację.
Dostępne zdarzenia Analytics
W tabeli poniżej znajdziesz przykłady zdarzeń analitycznych udostępnianych przez Places UI Kit.
| Interakcja z interfejsem | tags: Set<string> |
|---|---|
| Przycisk umożliwiający wyznaczenie trasy | {"click", "directions", "outbound"} |
| Przycisk Otwórz w Mapach | {"click", "maps", "outbound"} |
| Przycisk połączenia / numer telefonu (karta Przegląd) | {"click", "call_place", "outbound"} |
| Przycisk witryny / Witryna (karta Przegląd) | {"click", "place_website", "outbound"} |
| Link do atrybucji | {"click", "attribution", "outbound"} |
| Link do oceny | {"click", "reviews", "outbound"} |
Link do ujawnienia informacji (linki w oknie ⓘ) |
{"click", "disclosure", "outbound"} |
| Link do raportu | {"click", "report", "outbound"} |
| Link do opinii | {"click", "review", "outbound"} |
| Link do multimediów/zdjęcia | {"click", "media", "outbound"} |
| Otwarto lightbox ze zdjęciem (w aplikacji) | {"click", "media"} |
| Wybrano kartę Przegląd (w aplikacji) | {"click", "overview_tab"} |
| Wybrano kartę Opinie (w aplikacji) | {"click", "reviews_tab"} |
| Wybrano kartę Informacje (w aplikacji) | {"click", "about_tab"} |
Otwarto rozszerzone menu opinii (⋮) (w aplikacji) |
{"click", "reviews_menu"} |
Otwarto rozszerzone menu Lightbox (⋮) (w aplikacji) |
{"click", "lightbox_menu"} |
Otwarto menu podsumowania generatywnego (⋮) (w aplikacji) |
{"click", "generative_summary_menu"} |
Otwarto menu podsumowania opinii generowanych przez AI (⋮) |
{"click", "review_summary_menu"} |
Ponieważ z czasem mogą być dodawane nowe zdarzenia i tagi, podczas programowania możesz dołączyć ogólny moduł obsługi, aby rejestrować każde zdarzenie, które jest emitowane podczas interakcji z komponentem:
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); });
Subskrybowanie i obsługa zdarzeń Analytics
Możesz nasłuchiwać zdarzeń analitycznych we wszystkich elementach pakietu Places UI Kit na stronie, dodając detektor zdarzeń gmp-analytics do instancji singletona google.maps.Settings.
google.maps.AnalyticsEvent udostępnia event.tags (Set<string>) i event.element (Element | null reprezentujący najbliższy publiczny element gmp-*, który zawiera interakcję, np. gmp-place-details-compact, lub null, jeśli żaden nie ma zastosowania). Jeśli jest dostępny, możesz odczytać powiązany element Place z event.element.place (lub event.element.places w przypadku elementów listy i wyszukiwania).
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, }); });
Jeśli na stronie wyświetla się kilka elementów Places UI Kit, możesz porównać event.element z odwołaniem do konkretnego elementu DOM, aby określić, które wystąpienie karty wywołało zdarzenie:
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); } });