आपके पास Places के आंकड़ों से जुड़े इवेंट की सदस्यता लेने का विकल्प है. इनमें, उपयोगकर्ताओं के 'निर्देश', 'कॉल' या 'वेबसाइट' पर क्लिक करने, Google Maps खोलने, स्टार रेटिंग या लेखक के एट्रिब्यूशन पर क्लिक करने, फ़ोटो लाइटबॉक्स खोलने या टैब स्विच करने से जुड़े इवेंट शामिल हैं. हर इवेंट, टैग का एक सेट और इंटरैक्शन (या null) वाले सबसे नज़दीकी सार्वजनिक gmp-* एलिमेंट उपलब्ध कराता है. इससे, जगह का आईडी और जगह की जानकारी पढ़ी जा सकती है.
उपलब्ध कराए गए 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"} |
लाइटबॉक्स ओवरफ़्लो मेन्यू (⋮) खोला गया (ऐप्लिकेशन में) |
{"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); });
आंकड़ों से जुड़े इवेंट की सदस्यता लेना और उन्हें मैनेज करना
google.maps.Settings सिंगलटन इंस्टेंस में gmp-analytics इवेंट लिसनर जोड़कर, पेज पर मौजूद जगहों की जानकारी देने वाली यूआई किट के सभी एलिमेंट के लिए, Analytics इवेंट सुने जा सकते हैं.
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 की जांच की जा सकती है. इससे यह पता लगाया जा सकता है कि किस कार्ड इंस्टेंस ने इवेंट को ट्रिगर किया:
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); } });