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