Analytics

您可以订阅地点分析事件,了解用户点击“路线”“致电”或“网站”、打开 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);
  }
});