Вы можете подписаться на события аналитики 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); } });