คุณสามารถสมัครรับข้อมูลเหตุการณ์การวิเคราะห์เกี่ยวกับสถานที่ที่ผู้ใช้คลิกเส้นทาง โทร หรือเว็บไซต์, เปิด 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); } });