Analytics

Вы можете подписаться на события аналитики Places, связанные с нажатием пользователями кнопок "Маршруты", "Позвонить" или "Сайт", открытием Google Карт, нажатием на оценку или указание авторства, открытием лайтбокса с фотографиями или переключением вкладок. Каждое событие предоставляет набор тегов и ближайший общедоступный элемент gmp-*, содержащий взаимодействие (или null), из которого можно считать идентификатор места и местоположение.

События Аналитики, которые предоставляются

В таблице ниже приведены примеры событий аналитики, которые предоставляет Places UI Kit.

Взаимодействие с интерфейсом tags: Set<string>
Кнопка "Маршруты" {"click", "directions", "outbound"}
Кнопка "Открыть в Картах" {"click", "maps", "outbound"}
Кнопка вызова/номер телефона (вкладка "Обзор") {"click", "call_place", "outbound"}
Кнопка для сайта/Сайт (вкладка "Обзор") {"click", "place_website", "outbound"}
Ссылка на источник {"click", "attribution", "outbound"}
Ссылка на оценку {"click", "reviews", "outbound"}
Ссылка на юридически обязательное раскрытие информации (ⓘ ссылка в диалоговом окне) {"click", "disclosure", "outbound"}
Ссылка на отчет {"click", "report", "outbound"}
Ссылка на отзыв {"click", "review", "outbound"}
Ссылка на медиаконтент или фото {"click", "media", "outbound"}
Открыто окно просмотра фото (в приложении) {"click", "media"}
Выбрана вкладка "Обзор" (в приложении) {"click", "overview_tab"}
Выбрана вкладка "Отзывы" (в приложении) {"click", "reviews_tab"}
Выбрана вкладка "О канале" (в приложении) {"click", "about_tab"}
Открыто дополнительное меню отзывов (⋮) в приложении {"click", "reviews_menu"}
Открыто дополнительное меню лайтбокса (⋮) (в приложении) {"click", "lightbox_menu"}
Открыто меню генеративного пересказа (⋮) в приложении {"click", "generative_summary_menu"}
Открыто меню сводки отзывов, созданной генеративным ИИ (⋮) {"click", "review_summary_menu"}

Поскольку со временем могут добавляться новые события и теги, вы можете прикрепить общий обработчик во время разработки, чтобы регистрировать каждое событие, которое транслируется при взаимодействии с компонентом:

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

Как подписаться на события аналитики и обрабатывать их

Вы можете отслеживать события аналитики для всех элементов Places UI Kit на странице, добавив прослушиватель событий gmp-analytics к экземпляру синглтона google.maps.Settings.

google.maps.AnalyticsEvent предоставляет event.tags (Set<string>) и event.element (Element | null, представляющий ближайший общедоступный элемент gmp-*, который содержит взаимодействие, например gmp-place-details-compact, или null, если ничего не подходит). Если он есть, вы можете прочитать связанный с ним объект Place из event.element.place (или event.element.places в элементах списка и поиска).

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

Если на странице отображается несколько элементов Places UI Kit, вы можете сравнить event.element со ссылкой на конкретный элемент DOM, чтобы определить, какой экземпляр карточки инициировал событие:

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