Analytics

คุณสามารถสมัครรับข้อมูลเหตุการณ์การวิเคราะห์เกี่ยวกับสถานที่ที่ผู้ใช้คลิกเส้นทาง โทร หรือเว็บไซต์, เปิด Google Maps, คลิกการให้ดาวหรือการระบุแหล่งที่มาของผู้เขียน, เปิดไลท์บ็อกซ์รูปภาพ หรือเปลี่ยนแท็บ แต่ละเหตุการณ์จะมีชุดแท็กและองค์ประกอบ gmp-* สาธารณะที่ใกล้ที่สุดซึ่งมีการโต้ตอบ (หรือ null) ซึ่งคุณสามารถอ่านรหัสสถานที่และตำแหน่งได้

เหตุการณ์ Analytics ที่ระบุ

ตารางต่อไปนี้แสดงตัวอย่างเหตุการณ์การวิเคราะห์ที่ Places UI Kit มีให้

การโต้ตอบกับ UI 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"}
เปิดเมนูรายการเพิ่มเติมของไลท์บ็อกซ์ (⋮) แล้ว (ในแอป) {"click", "lightbox_menu"}
เปิดเมนูสรุปแบบ Generative (⋮) แล้ว (ในแอป) {"click", "generative_summary_menu"}
เปิดเมนูสรุปรีวิวจาก Generative AI (⋮) แล้ว {"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

คุณสามารถฟังเหตุการณ์ Analytics ในองค์ประกอบ Places UI Kit ทั้งหมดในหน้าเว็บได้โดยเพิ่ม 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);
  }
});