Analytics

Anda dapat berlangganan peristiwa analisis Tempat tentang pengguna yang mengklik Rute, Telepon, atau Situs, membuka Google Maps, mengklik rating bintang atau atribusi penulis, membuka lightbox foto, atau beralih tab. Setiap peristiwa menyediakan sekumpulan tag dan elemen gmp-* publik terdekat yang berisi interaksi (atau null), yang dapat Anda gunakan untuk membaca ID tempat dan lokasi.

Peristiwa Analytics yang disediakan

Tabel berikut memberikan contoh peristiwa analisis yang disediakan oleh Kit UI Places.

Interaksi UI tags: Set<string>
Tombol rute {"click", "directions", "outbound"}
Tombol Buka di Maps {"click", "maps", "outbound"}
Tombol telepon/Nomor telepon (tab Ringkasan) {"click", "call_place", "outbound"}
Tombol situs/Situs (tab Ringkasan) {"click", "place_website", "outbound"}
Link atribusi {"click", "attribution", "outbound"}
Link rating {"click", "reviews", "outbound"}
Link pengungkapan informasi berdasarkan hukum (link dialog ⓘ) {"click", "disclosure", "outbound"}
Laporkan link {"click", "report", "outbound"}
Link ulasan {"click", "review", "outbound"}
Link Media/Foto {"click", "media", "outbound"}
Lightbox Foto dibuka (dalam aplikasi) {"click", "media"}
Tab Ringkasan dipilih (dalam aplikasi) {"click", "overview_tab"}
Tab ulasan dipilih (dalam aplikasi) {"click", "reviews_tab"}
Tab Tentang dipilih (dalam aplikasi) {"click", "about_tab"}
Menu tambahan ulasan (⋮) dibuka (dalam aplikasi) {"click", "reviews_menu"}
Menu tambahan lightbox (⋮) dibuka (dalam aplikasi) {"click", "lightbox_menu"}
Menu ringkasan generatif (⋮) dibuka (dalam aplikasi) {"click", "generative_summary_menu"}
Menu ringkasan ulasan generatif (⋮) dibuka {"click", "review_summary_menu"}

Karena peristiwa dan tag baru dapat ditambahkan seiring waktu, Anda dapat melampirkan pengendali umum selama pengembangan untuk mencatat setiap peristiwa yang disiarkan saat Anda berinteraksi dengan komponen:

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

Berlangganan dan menangani peristiwa analisis

Anda dapat memproses peristiwa analisis di semua elemen Kit UI Places di halaman dengan menambahkan pemroses peristiwa gmp-analytics ke instance singleton google.maps.Settings.

google.maps.AnalyticsEvent menyediakan event.tags (Set<string>) dan event.element (Element | null yang mewakili elemen gmp-* publik terdekat yang berisi interaksi, seperti gmp-place-details-compact, atau null jika tidak ada yang berlaku). Jika ada, Anda dapat membaca Place terkait dari event.element.place (atau event.element.places pada elemen daftar dan penelusuran).

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

Jika halaman Anda menampilkan beberapa elemen Kit UI Places, Anda dapat memeriksa event.element terhadap referensi elemen DOM tertentu untuk menentukan instance kartu mana yang memicu peristiwa:

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