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