您可以訂閱地點數據分析事件,瞭解使用者是否點選「路線」、「通話」或「網站」、開啟 Google 地圖、點選星級評等或作者資訊、開啟相片燈箱,或切換分頁。每個事件都會提供一組標記,以及包含互動 (或 null) 的最接近公開 gmp-* 元素,您可從中讀取地點 ID 和位置。
提供的 Analytics 事件
下表列出 Places UI Kit 提供的數據分析事件範例。
| UI 互動 | 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); });
訂閱及處理數據分析事件
如要監聽網頁上所有 Places UI Kit 元素的數據分析事件,請在 google.maps.Settings 單例模式例項中,新增 gmp-analytics 事件監聽器。
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); } });