Analytics

Puedes suscribirte a los eventos de estadísticas de Places sobre los usuarios que hacen clic en Cómo llegar, Llamar o Sitio web, abren Google Maps, hacen clic en la calificación por estrellas o en la atribución de un autor, abren la ventana emergente de fotos o cambian de pestaña. Cada evento proporciona un conjunto de etiquetas y el elemento gmp-* público más cercano que contiene la interacción (o null), desde el que puedes leer el ID de lugar y la ubicación.

Eventos de Analytics que se proporcionan

En la siguiente tabla, se proporcionan ejemplos de eventos de estadísticas que proporciona el kit de IU de Places.

Interacción con la IU tags: Set<string>
Botón Cómo llegar {"click", "directions", "outbound"}
Botón Abrir en Maps {"click", "maps", "outbound"}
Botón de llamada/número de teléfono (pestaña Resumen) {"click", "call_place", "outbound"}
Botón del sitio web/Sitio web (pestaña Resumen) {"click", "place_website", "outbound"}
Vínculo de atribución {"click", "attribution", "outbound"}
Vínculo de clasificación {"click", "reviews", "outbound"}
Vínculo de divulgación legal (vínculos del diálogo ⓘ) {"click", "disclosure", "outbound"}
Vínculo del informe {"click", "report", "outbound"}
Vínculo para la revisión {"click", "review", "outbound"}
Vínculo de contenido multimedia o foto {"click", "media", "outbound"}
Se abrió la galería de fotos (en la app) {"click", "media"}
Se seleccionó la pestaña Resumen (en la app) {"click", "overview_tab"}
Pestaña Opiniones seleccionada (en la app) {"click", "reviews_tab"}
Se seleccionó la pestaña Acerca de (en la app) {"click", "about_tab"}
Se abrió el menú ampliado de opiniones (⋮) (en la app) {"click", "reviews_menu"}
Se abrió el menú ampliado de Lightbox (⋮) (en la app) {"click", "lightbox_menu"}
Se abrió el menú de resumen generativo (⋮) en la app {"click", "generative_summary_menu"}
Se abrió el menú de resumen de opiniones generativo (⋮) {"click", "review_summary_menu"}

Como es posible que se agreguen eventos y etiquetas nuevos con el tiempo, puedes adjuntar un controlador genérico durante el desarrollo para registrar cada evento que se transmita a medida que interactúas 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);
});

Suscríbete a eventos de Analytics y adminístralos

Puedes escuchar eventos de estadísticas en todos los elementos del kit de IU de Places de la página agregando un objeto de escucha de eventos gmp-analytics a la instancia de singleton google.maps.Settings.

google.maps.AnalyticsEvent proporciona event.tags (un Set<string>) y event.element (un Element | null que representa el elemento gmp-* público más cercano que contiene la interacción, como gmp-place-details-compact o null si no se aplica ninguno). Cuando esté presente, podrás leer el Place asociado desde event.element.place (o event.element.places en los elementos de lista y búsqueda).

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

Si tu página muestra varios elementos del kit de IU de Places, puedes comparar event.element con una referencia de elemento del DOM específica para determinar qué instancia de tarjeta activó el 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);
  }
});