Analytics

می‌توانید در رویدادهای تجزیه‌وتحلیل «مکان‌ها» درباره کاربران که روی «مسیرها»، «تماس»، یا «وب‌سایت» کلیک می‌کنند، Google Maps را باز می‌کنند، روی رده‌بندی ستاره‌ای یا ارجاع نویسنده کلیک می‌کنند، لایت‌باکس عکس را باز می‌کنند، یا زبانه‌ها را عوض می‌کنند مشترک شوید. هر رویداد مجموعه‌ای از برچسب‌ها و نزدیک‌ترین عنصر عمومی gmp-* را که حاوی تعامل (یا null) است ارائه می‌دهد، که از آن می‌توانید شناسه مکان و موقعیت را بخوانید.

رویدادهای Analytics که ارائه شده است

جدول زیر نمونه‌هایی از رویدادهای تحلیلی را ارائه می‌دهد که توسط کیت میانای کاربر «جاها» ارائه شده‌اند.

تعامل با میانای کاربر tags: Set<string>
دکمه مسیرها {"click", "directions", "outbound"}
دکمه «باز کردن در Maps» {"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"}
منوِ سرریز Lightbox (⋮) باز شد (درون‌برنامه) {"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);
});

مشترک شدن در رویدادهای Analytics و مدیریت آن‌ها

با افزودن شنونده رویداد gmp-analytics به نمونه تک‌قلو google.maps.Settings، می‌توانید رویدادهای تحلیلی را در همه عناصر «کیت میانای کاربر جاها» در صفحه گوش دهید.

‫google.maps.AnalyticsEvent event.tags (یک Set<string>) و event.element (یک Element | null که نشان‌دهنده نزدیک‌ترین عنصر عمومی gmp-* است که حاوی تعامل است، مانند gmp-place-details-compact، یا null اگر هیچ‌کدام اعمال نشود) را ارائه می‌دهد. درصورت وجود، می‌توانید Place مرتبط را از event.element.place (یا event.element.places در عناصر فهرست و جستجو) بخوانید.

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

اگر صفحه‌تان چند عنصر «کیت میانای کاربر جاها» را نمایش می‌دهد، می‌توانید event.element را با مرجع عنصر DOM خاصی مقابله کنید تا مشخص شود کدام نمونه کارت رویداد را راه‌اندازی کرده است:

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