Analytics

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);
  }
});