您可以订阅地点分析事件,了解用户点击“路线”“致电”或“网站”、打开 Google 地图、点击星级或作者署名、打开照片灯箱或切换标签页等行为。每个事件都会提供一组标记和包含互动(或 null)的最接近的公共 gmp-* 元素,您可以从中读取地点 ID 和位置。
提供的 Analytics 事件
下表提供了 Places UI Kit 提供的分析事件示例。
| 界面互动 | tags: Set<string> |
|---|---|
| “路线”按钮 | {"click", "directions", "outbound"} |
| “在 Google 地图中打开”按钮 | {"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); });
订阅和处理分析事件
您可以通过向 google.maps.Settings 单例实例添加 gmp-analytics 事件监听器,监听页面上所有 Places UI Kit 元素的分析事件。
google.maps.AnalyticsEvent 提供 event.tags(一个 Set<string>)和 event.element(一个 Element | null,表示包含互动事件的最接近的公开 gmp-* 元素,例如 gmp-place-details-compact,如果没有适用的元素,则为 null)。如果存在,您可以从 event.element.place(或列表和搜索元素上的 event.element.places)中读取关联的 Place。
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 元素,您可以对照特定 DOM 元素引用检查 event.element,以确定哪个卡片实例触发了事件:
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); } });