Analytics

Sie können Places Analytics-Ereignisse abonnieren, die ausgelöst werden, wenn Nutzer auf „Route“, „Anrufen“ oder „Website“ klicken, Google Maps öffnen, auf die Sternebewertung oder eine Autorenangabe klicken, die Fotogalerie öffnen oder den Tab wechseln. Jedes Ereignis enthält eine Reihe von Tags und das nächstgelegene öffentliche gmp-*-Element, das die Interaktion enthält (oder null), aus dem Sie die Orts-ID und den Standort ablesen können.

Bereitgestellte Analytics-Ereignisse

In der folgenden Tabelle finden Sie Beispiele für Analyseereignisse, die vom Places UI Kit bereitgestellt werden.

UI-Interaktion tags: Set<string>
Button „Route“ {"click", "directions", "outbound"}
Schaltfläche „In Maps öffnen“ {"click", "maps", "outbound"}
Schaltfläche „Anruf“ / Telefonnummer (Tab „Übersicht“) {"click", "call_place", "outbound"}
Schaltfläche „Website“ / Website (Tab „Übersicht“) {"click", "place_website", "outbound"}
Attribution link {"click", "attribution", "outbound"}
Link zur Bewertung {"click", "reviews", "outbound"}
Link zur rechtlichen Offenlegung (ⓘ Dialogfeldlinks) {"click", "disclosure", "outbound"}
Link zum Bericht {"click", "report", "outbound"}
Review link {"click", "review", "outbound"}
Medien-/Fotolink {"click", "media", "outbound"}
Foto-Lightbox geöffnet (In-App) {"click", "media"}
Tab „Übersicht“ ausgewählt (In-App) {"click", "overview_tab"}
Tab „Rezensionen“ ausgewählt (In-App) {"click", "reviews_tab"}
Tab „Über“ ausgewählt (In-App) {"click", "about_tab"}
Dreipunkt-Menü für Rezensionen (⋮) geöffnet (In-App) {"click", "reviews_menu"}
Dreipunkt-Menü der Lightbox (⋮) geöffnet (In-App) {"click", "lightbox_menu"}
Menü für generative Zusammenfassung (⋮) geöffnet (in der App) {"click", "generative_summary_menu"}
Menü für KI-generierte Rezensionsüberblicke (⋮) geöffnet {"click", "review_summary_menu"}

Da im Laufe der Zeit neue Ereignisse und Tags hinzugefügt werden können, können Sie während der Entwicklung einen generischen Handler anhängen, um jedes Ereignis zu protokollieren, das bei der Interaktion mit einer Komponente übertragen wird:

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

Analyseereignisse abonnieren und verarbeiten

Sie können Analytics-Ereignisse für alle Places UI Kit-Elemente auf der Seite erfassen, indem Sie der Singleton-Instanz google.maps.Settings einen gmp-analytics-Event-Listener hinzufügen.

google.maps.AnalyticsEvent stellt event.tags (ein Set<string>) und event.element (ein Element | null, das das nächstgelegene öffentliche gmp-*-Element darstellt, das die Interaktion enthält, z. B. gmp-place-details-compact, oder null, falls keines zutrifft) bereit. Wenn vorhanden, können Sie die zugehörige Place aus event.element.place (oder event.element.places für Listen- und Suchelemente) lesen.

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

Wenn auf Ihrer Seite mehrere Places UI Kit-Elemente angezeigt werden, können Sie event.element mit einer bestimmten DOM-Elementreferenz vergleichen, um festzustellen, welche Karteninstanz das Ereignis ausgelöst hat:

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