Analytics

আপনি Places অ্যানালিটিক্স ইভেন্টে সাবস্ক্রাইব করতে পারেন, যা ব্যবহারকারীদের দিকনির্দেশ, কল বা ওয়েবসাইটে ক্লিক করা, Google Maps খোলা, স্টার রেটিং বা লেখকের অ্যাট্রিবিউশনে ক্লিক করা, ফটো লাইটবক্স খোলা বা ট্যাব পরিবর্তন করার মতো অ্যাক্টিভিটি ট্র্যাক করে। প্রতিটি ইভেন্ট ট্যাগের একটি সেট এবং সবচেয়ে কাছাকাছি পাবলিক gmp-* এলিমেন্ট প্রদান করে যাতে ইন্টার‍্যাকশন (বা null) থাকে, যেখান থেকে আপনি প্লেস আইডি ও লোকেশন পড়তে পারবেন।

অ্যানালিটিক্স ইভেন্ট যা প্রদান করা হয়

নিচের সারণীতে 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"}
জেনারেটিভ সারসংক্ষেপ মেনু (⋮) খোলা হয়েছে (অ্যাপ-মধ্যস্থ) {"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 ইভেন্ট লিসেনার যোগ করে পৃষ্ঠার সমস্ত Places UI Kit এলিমেন্ট জুড়ে অ্যানালিটিক্স ইভেন্ট শুনতে পারেন।

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 এলিমেন্ট দেখানো হলে, কোন কার্ড ইনস্ট্যান্স ইভেন্টটি ট্রিগার করেছে তা নির্ধারণ করতে আপনি নির্দিষ্ট DOM এলিমেন্ট রেফারেন্সের বিপরীতে 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);
  }
});