Analytics

Bạn có thể đăng ký nhận các sự kiện phân tích về Địa điểm liên quan đến việc người dùng nhấp vào Đường đi, Gọi hoặc Trang web, mở Google Maps, nhấp vào điểm xếp hạng theo sao hoặc thông tin ghi nhận tác giả, mở hộp đèn ảnh hoặc chuyển đổi thẻ. Mỗi sự kiện cung cấp một tập hợp thẻ và phần tử gmp-* công khai gần nhất chứa hoạt động tương tác (hoặc null), từ đó bạn có thể đọc mã địa điểm và vị trí.

Sự kiện Analytics được cung cấp

Bảng sau đây cung cấp ví dụ về các sự kiện phân tích do Places UI Kit cung cấp.

Tương tác với giao diện người dùng tags: Set<string>
Nút Đường đi {"click", "directions", "outbound"}
Nút Mở trong Maps {"click", "maps", "outbound"}
Nút gọi/Số điện thoại (thẻ Tổng quan) {"click", "call_place", "outbound"}
Nút trang web/Trang web (thẻ Tổng quan) {"click", "place_website", "outbound"}
Đường liên kết phân bổ {"click", "attribution", "outbound"}
Đường liên kết đến điểm xếp hạng {"click", "reviews", "outbound"}
Đường liên kết đến công bố thông tin theo quy định pháp lý (đường liên kết trong hộp thoại ⓘ) {"click", "disclosure", "outbound"}
Đường liên kết đến báo cáo {"click", "report", "outbound"}
Đường liên kết xem lại {"click", "review", "outbound"}
Đường liên kết đến nội dung nghe nhìn/ảnh {"click", "media", "outbound"}
Đã mở hộp đèn ảnh (trong ứng dụng) {"click", "media"}
Đã chọn thẻ Tổng quan (trong ứng dụng) {"click", "overview_tab"}
Đã chọn thẻ Bài đánh giá (trong ứng dụng) {"click", "reviews_tab"}
Đã chọn thẻ Giới thiệu (trong ứng dụng) {"click", "about_tab"}
Đã mở trình đơn mục bổ sung của bài đánh giá (⋮) (trong ứng dụng) {"click", "reviews_menu"}
Đã mở trình đơn mục bổ sung của hộp đèn (⋮) (trong ứng dụng) {"click", "lightbox_menu"}
Đã mở trình đơn tóm tắt bằng AI tạo sinh (⋮) (trong ứng dụng) {"click", "generative_summary_menu"}
Đã mở trình đơn tóm tắt bài đánh giá bằng AI tạo sinh (⋮) {"click", "review_summary_menu"}

Vì các sự kiện và thẻ mới có thể được thêm vào theo thời gian, nên bạn có thể đính kèm một trình xử lý chung trong quá trình phát triển để ghi lại mọi sự kiện được truyền phát khi bạn tương tác với một thành phần:

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

Đăng ký và xử lý các sự kiện phân tích

Bạn có thể theo dõi các sự kiện phân tích trên tất cả các phần tử của Places UI Kit trên trang bằng cách thêm trình nghe sự kiện gmp-analytics vào thực thể singleton google.maps.Settings.

google.maps.AnalyticsEvent cung cấp event.tags (Set<string>) và event.element (Element | null đại diện cho phần tử gmp-* công khai gần nhất chứa lượt tương tác, chẳng hạn như gmp-place-details-compact hoặc null nếu không có phần tử nào phù hợp). Khi có, bạn có thể đọc Place liên kết từ event.element.place (hoặc event.element.places trên các phần tử danh sách và tìm kiếm).

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

Nếu trang của bạn hiển thị nhiều phần tử của Places UI Kit, bạn có thể kiểm tra event.element dựa trên một tham chiếu phần tử DOM cụ thể để xác định thực thể thẻ nào đã kích hoạt sự kiện:

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