Você pode se inscrever em eventos de análise do Places sobre usuários que clicam em "Rotas", "Ligar" ou "Site", abrem o Google Maps, clicam na classificação por estrelas ou em uma atribuição de autor, abrem o lightbox de fotos ou trocam de guia. Cada evento fornece um conjunto de tags e o elemento público gmp-* mais próximo que contém a interação (ou null), de onde é possível ler o ID de lugar e o local.
Eventos do Analytics fornecidos
A tabela a seguir mostra exemplos de eventos de análise fornecidos pelo Kit de Interface do Places.
| Interação com a interface | tags: Set<string> |
|---|---|
| Botão "Rotas" | {"click", "directions", "outbound"} |
| Botão "Abrir no Maps" | {"click", "maps", "outbound"} |
| Botão para chamadas / número de telefone (guia "Visão geral") | {"click", "call_place", "outbound"} |
| Botão para o site / Site (guia "Visão geral") | {"click", "place_website", "outbound"} |
| Link de atribuição | {"click", "attribution", "outbound"} |
| Link de classificação | {"click", "reviews", "outbound"} |
Link da declaração legal (links da caixa de diálogo ⓘ) |
{"click", "disclosure", "outbound"} |
| Link do relatório | {"click", "report", "outbound"} |
| Link da avaliação | {"click", "review", "outbound"} |
| Link de mídia / foto | {"click", "media", "outbound"} |
| Lightbox de fotos aberto (no app) | {"click", "media"} |
| Guia "Visão geral" selecionada (no app) | {"click", "overview_tab"} |
| Guia "Avaliações" selecionada (no app) | {"click", "reviews_tab"} |
| Guia "Sobre" selecionada (no app) | {"click", "about_tab"} |
Menu flutuante de avaliações (⋮) aberto (no app) |
{"click", "reviews_menu"} |
Menu flutuante do Lightbox (⋮) aberto (no app) |
{"click", "lightbox_menu"} |
Menu de resumo generativo (⋮) aberto (no app) |
{"click", "generative_summary_menu"} |
Menu de resumo das avaliações generativas (⋮) aberto |
{"click", "review_summary_menu"} |
Como novos eventos e tags podem ser adicionados ao longo do tempo, é possível anexar um gerenciador genérico durante o desenvolvimento para registrar todos os eventos transmitidos conforme você interage com um 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); });
Inscrever-se e processar eventos de análise
Para ouvir eventos de análise em todos os elementos do Kit de Interface do Places na página, adicione um listener de eventos gmp-analytics à instância singleton google.maps.Settings.
google.maps.AnalyticsEvent fornece event.tags (um Set<string>) e
event.element (um Element | null que representa o elemento gmp-* público mais próximo
que contém a interação, como gmp-place-details-compact ou
null, se nenhum se aplicar). Quando presente, é possível ler o Place associado de
event.element.place (ou event.element.places em elementos de lista e pesquisa).
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 a página exibir vários elementos do Kit de Interface do Places, verifique event.element em relação a uma referência de elemento DOM específica para determinar qual instância de card acionou o 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); } });