Analytics

Kullanıcıların Yol Tarifi, Telefon veya Web Sitesi'ni tıklaması, Google Haritalar'ı açması, yıldız puanını veya yazar atıfını tıklaması, fotoğraf lightbox'ını açması ya da sekmeler arasında geçiş yapmasıyla ilgili Places Analytics etkinliklerine abone olabilirsiniz. Her etkinlik, bir dizi etiket ve etkileşimi (veya null) içeren en yakın herkese açık gmp-* öğesini sağlar. Bu öğeden yer kimliğini ve konumu okuyabilirsiniz.

Sağlanan Analytics etkinlikleri

Aşağıdaki tabloda, Places UI Kit tarafından sağlanan analiz etkinliklerine dair örnekler verilmiştir.

Kullanıcı arayüzü etkileşimi tags: Set<string>
Yol tarifi düğmesi {"click", "directions", "outbound"}
Haritalar'da aç düğmesi {"click", "maps", "outbound"}
Ara düğmesi/Telefon numarası (Genel bakış sekmesi) {"click", "call_place", "outbound"}
Web sitesi düğmesi/Web sitesi (Genel bakış sekmesi) {"click", "place_website", "outbound"}
İlişkilendirme bağlantısı {"click", "attribution", "outbound"}
Derecelendirme bağlantısı {"click", "reviews", "outbound"}
Yasal açıklama bağlantısı (ⓘ iletişim kutusu bağlantıları) {"click", "disclosure", "outbound"}
Rapor bağlantısı {"click", "report", "outbound"}
Yorum bağlantısı {"click", "review", "outbound"}
Medya/fotoğraf bağlantısı {"click", "media", "outbound"}
Fotoğraf Lightbox'ı açıldı (uygulama içi) {"click", "media"}
Genel Bakış sekmesi seçildi (uygulama içi) {"click", "overview_tab"}
Yorumlar sekmesi seçildi (uygulama içi) {"click", "reviews_tab"}
"Hakkında" sekmesi seçildi (uygulama içi) {"click", "about_tab"}
Yorumlar taşma menüsü (⋮) açıldı (uygulama içi) {"click", "reviews_menu"}
Lightbox taşma menüsü (⋮) açıldı (uygulama içi) {"click", "lightbox_menu"}
Üretken özet menüsü (⋮) açıldı (uygulama içi) {"click", "generative_summary_menu"}
Üretken yorum özeti menüsü (⋮) açıldı {"click", "review_summary_menu"}

Zaman içinde yeni etkinlikler ve etiketler eklenebileceğinden, geliştirme sırasında genel bir işleyici ekleyerek bir bileşenle etkileşim kurduğunuzda yayınlanan her etkinliği günlüğe kaydedebilirsiniz:

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

Analiz etkinliklerine abone olma ve bunları işleme

google.maps.Settings tekil örneğine bir gmp-analytics etkinlik işleyici ekleyerek sayfadaki tüm Places UI Kit öğelerinde analiz etkinliklerini dinleyebilirsiniz.

google.maps.AnalyticsEvent, event.tags (bir Set<string>) ve event.element (etkileşimi içeren en yakın herkese açık gmp-* öğesini temsil eden bir Element | null, örneğin gmp-place-details-compact veya hiçbiri geçerli değilse null) sağlar. Mevcut olduğunda, ilişkili Place değerini event.element.place (veya liste ve arama öğelerinde event.element.places) üzerinden okuyabilirsiniz.

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

Sayfanızda birden fazla Places UI Kit öğesi gösteriliyorsa etkinliği hangi kart örneğinin tetiklediğini belirlemek için event.element değerini belirli bir DOM öğesi referansıyla karşılaştırabilirsiniz:

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