Analytics

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