Analytics

אתם יכולים להירשם לאירועי ניתוח נתונים של מקומות שקשורים למשתמשים שלוחצים על "מסלול", "התקשרות" או "אתר", פותחים את מפות Google, לוחצים על דירוג הכוכבים או על שיוך למחבר, פותחים את תיבת האור של התמונות או מחליפים כרטיסיות. כל אירוע מספק קבוצה של תגים ואת רכיב gmp-* הציבורי הקרוב ביותר שמכיל את האינטראקציה (או null), שמהם אפשר לקרוא את מזהה המקום ואת המיקום.

אירועים ב-Analytics שמופיעים

בטבלה הבאה מפורטות דוגמאות לאירועי ניתוח נתונים שמתקבלים מ-Places UI Kit.

אינטראקציה עם ממשק המשתמש tags: Set<string>
כפתור מסלול הגעה {"click", "directions", "outbound"}
כפתור לפתיחה במפות Google {"click", "maps", "outbound"}
כפתור ההתקשרות או מספר הטלפון (בכרטיסייה "סקירה כללית") {"click", "call_place", "outbound"}
כפתור האתר / אתר (הכרטיסייה "סקירה כללית") {"click", "place_website", "outbound"}
קישור לשיוך (Attribution) {"click", "attribution", "outbound"}
קישור לדירוג {"click", "reviews", "outbound"}
קישור לגילוי נאות כנדרש בחוק (ⓘ קישורים לתיבות דו-שיח) {"click", "disclosure", "outbound"}
קישור לדיווח {"click", "report", "outbound"}
הקישור של הביקורת {"click", "review", "outbound"}
קישור למדיה או לתמונה {"click", "media", "outbound"}
פתיחת תמונה ב-Lightbox (בתוך האפליקציה) {"click", "media"}
הכרטיסייה "סקירה כללית" נבחרה (באפליקציה) {"click", "overview_tab"}
הכרטיסייה "ביקורות" נבחרה (בתוך האפליקציה) {"click", "reviews_tab"}
הכרטיסייה "מידע כללי" נבחרה (בתוך האפליקציה) {"click", "about_tab"}
תפריט האפשרויות הנוספות של הביקורות (⋮) נפתח (בתוך האפליקציה) {"click", "reviews_menu"}
תפריט האפשרויות הנוספות של Lightbox (⋮) נפתח (בתוך האפליקציה) {"click", "lightbox_menu"}
תפריט הסיכום הגנרטיבי (⋮) נפתח (באפליקציה) {"click", "generative_summary_menu"}
תפריט הסיכום של הביקורות שנוצר על ידי AI גנרטיבי (⋮) נפתח {"click", "review_summary_menu"}

יכול להיות שעם הזמן יתווספו אירועים ותגים חדשים, לכן אפשר לצרף handler כללי במהלך הפיתוח כדי לתעד כל אירוע שמשודר כשמקיימים אינטראקציה עם רכיב:

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 בדף, מוסיפים רכיב event listener מסוג gmp-analytics למופע היחיד (singleton) של 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,
  });
});

אם בדף שלכם מוצגים כמה רכיבים של Places UI Kit, אתם יכולים לבדוק את 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);
  }
});