Analytics

Puoi iscriverti agli eventi di analisi di Places relativi agli utenti che fanno clic su Indicazioni stradali, Chiama o Sito web, aprono Google Maps, fanno clic sulla valutazione a stelle o sull'attribuzione dell'autore, aprono il lightbox delle foto o cambiano scheda. Ogni evento fornisce un insieme di tag e l'elemento gmp-* pubblico più vicino che contiene l'interazione (o null), da cui puoi leggere l'ID luogo e la posizione.

Eventi Analytics forniti

La tabella seguente fornisce esempi di eventi di analisi forniti da Places UI Kit.

Interazione con la UI tags: Set<string>
Pulsante Indicazioni stradali {"click", "directions", "outbound"}
Pulsante Apri in Maps {"click", "maps", "outbound"}
Pulsante Chiama/Numero di telefono (scheda Panoramica) {"click", "call_place", "outbound"}
Pulsante Sito web/Sito web (scheda Panoramica) {"click", "place_website", "outbound"}
Link di attribuzione {"click", "attribution", "outbound"}
Link alla valutazione {"click", "reviews", "outbound"}
Link alla divulgazione legale (link della finestra di dialogo ⓘ) {"click", "disclosure", "outbound"}
Link rapporto {"click", "report", "outbound"}
Link recensione {"click", "review", "outbound"}
Link a contenuti multimediali/foto {"click", "media", "outbound"}
Lightbox foto aperto (in-app) {"click", "media"}
Scheda Panoramica selezionata (nell'app) {"click", "overview_tab"}
Scheda Recensioni selezionata (in-app) {"click", "reviews_tab"}
Scheda Informazioni selezionata (in-app) {"click", "about_tab"}
Menu extra delle recensioni (⋮) aperto (in-app) {"click", "reviews_menu"}
Menu extra lightbox (⋮) aperto (in-app) {"click", "lightbox_menu"}
Menu del riepilogo generativo (⋮) aperto (nell'app) {"click", "generative_summary_menu"}
Menu del riepilogo delle recensioni generativo (⋮) aperto {"click", "review_summary_menu"}

Poiché nel tempo potrebbero essere aggiunti nuovi eventi e tag, durante lo sviluppo puoi collegare un gestore generico per registrare ogni evento trasmesso mentre interagisci con un componente:

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

Iscriviti agli eventi di analisi e gestiscili

Puoi ascoltare gli eventi di analisi in tutti gli elementi del Places UI Kit nella pagina aggiungendo un listener di eventi gmp-analytics all'istanza singleton google.maps.Settings.

google.maps.AnalyticsEvent fornisce event.tags (un Set<string>) e event.element (un Element | null che rappresenta l'elemento gmp-* pubblico più vicino che contiene l'interazione, ad esempio gmp-place-details-compact o null se non è applicabile). Se presente, puoi leggere l'elemento Place associato da event.element.place (o event.element.places negli elementi di elenco e di ricerca).

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

Se la pagina mostra più elementi di Places UI Kit, puoi confrontare event.element con un riferimento a un elemento DOM specifico per determinare quale istanza della scheda ha attivato l'evento:

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