Places UI Kit কম্পোনেন্টে Analytics যোগ করা

আপনি ব্যবহারকারীদের দিকনির্দেশ, কল বা ওয়েবসাইট ট্যাপ করা, Google Maps খোলা, স্টার রেটিং বা লেখক অ্যাট্রিবিউশন ট্যাপ করা, ফটো লাইটবক্স খোলা বা ট্যাব পরিবর্তন করার মতো অ্যানালিটিক্স ইভেন্টে সাবস্ক্রাইব করতে পারেন। প্রতিটি ইভেন্ট থেকে জানা যায় যে কোন কম্পোনেন্ট ও কন্টেন্টের ধরন ফায়ার হয়েছে, এর সাথে প্লেস আইডি ও লোকেশনও জানা যায়।

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

Places UI Kit-এর মাধ্যমে প্রদান করা অ্যানালিটিক্স ইভেন্টের উদাহরণ নিচের সারণিতে দেওয়া হল।

UI ইন্টার‍্যাকশন tags: Set<String> সংশ্লিষ্ট কন্টেন্ট/কন্টেন্টের ধরন
দিকনির্দেশ বোতাম {"click", "directions", "outbound"} "main_action_button" বা "corner_action_button"
Maps-এ খুলুন বোতাম {"click", "maps", "outbound"} "main_action_button" বা "corner_action_button"
কল করার বোতাম / ফোন নম্বর (ওভারভিউ ট্যাব) {"click", "call_place", "outbound"} "phone_number", "main_action_button" অথবা "corner_action_button"
ওয়েবসাইট বোতাম / ওয়েবসাইট (ওভারভিউ ট্যাব) {"click", "place_website", "outbound"} "website", "main_action_button" অথবা "corner_action_button"
অ্যাট্রিবিউশন লিঙ্ক {"click", "attribution", "outbound"} "review" বা "media"
রেটিং লিঙ্ক {"click", "reviews", "outbound"} "rating" বা "review_summaries"
আইনি প্রকাশ সংক্রান্ত লিঙ্ক (ⓘ ডায়ালগ লিঙ্ক) {"click", "disclosure", "outbound"} null (কনফিগার করা যাবে না)
লিঙ্ক সম্পর্কে রিপোর্ট করুন {"click", "report", "outbound"} "media", "review" অথবা "generative_summary"
লিঙ্ক পর্যালোচনা করুন {"click", "review", "outbound"} "review"
মিডিয়া / ফটোর লিঙ্ক {"click", "media", "outbound"} "media"
ফটো লাইটবক্স খোলা হয়েছে (অ্যাপ-মধ্যস্থ) {"click", "media"} "media"
ওভারভিউ ট্যাব বেছে নেওয়া হয়েছে (অ্যাপ-মধ্যস্থ) {"click", "overview_tab"} null
রিভিউ ট্যাব বেছে নেওয়া হয়েছে (অ্যাপ-মধ্যস্থ) {"click", "reviews_tab"} "review"
'সম্পর্কে' ট্যাব বেছে নেওয়া হয়েছে (অ্যাপ-মধ্যস্থ) {"click", "about_tab"} "features"
রিভিউ ওভারফ্লো মেনু (⋮) খোলা হয়েছে (অ্যাপ-মধ্যস্থ) {"click", "reviews_menu"} "review"
লাইটবক্স ওভারফ্লো মেনু (⋮) খোলা হয়েছে (অ্যাপ-মধ্যস্থ) {"click", "lightbox_menu"} "media"
জেনারেটিভ সারসংক্ষেপ মেনু (⋮) খোলা হয়েছে (অ্যাপ-মধ্যস্থ) {"click", "generative_summary_menu"} "generative_summary"
জেনারেটিভ রিভিউ সামারি মেনু (⋮) খোলা হয়েছে (অ্যাপ-মধ্যস্থ) {"click", "review_summary_menu"} "review"

সময়ের সাথে সাথে নতুন ইভেন্ট ও ট্যাগ যোগ করা হতে পারে, তাই আপনি ডেভেলপমেন্টের সময় একটি জেনেরিক হ্যান্ডলার অ্যাটাচ করতে পারেন যাতে কোনও কম্পোনেন্টের সাথে ইন্টার‍্যাক্ট করার সময় ব্রডকাস্ট করা প্রতিটি ইভেন্ট লগ করা যায়:

// Attach to a Places UI Kit view or a parent container to inspect all broadcast events
.onPlaceAnalyticsEvent { event in
  print(
    "Analytics event — component: \(event.componentType), " +
    "tags: \(event.tags.sorted()), " +
    "content: \(event.contentType ?? "nil"), " +
    "places: \(event.places.compactMap(\.placeID))"
  )
}

অ্যানালিটিক্স ইভেন্টে সাবস্ক্রাইব ও তা ম্যানেজ করা

onPlaceAnalyticsEvent মডিফায়ার ব্যবহার করে আপনি UI কিট কম্পোনেন্ট থেকে অ্যানালিটিক্স ইভেন্টে সাবস্ক্রাইব করতে পারবেন। আপনি মডিফায়ারটি একটি কন্টেনার ভিউতে বা সরাসরি একটি UI Kit কম্পোনেন্টে অ্যাটাচ করতে পারেন।

কন্টেনার ভিউয়ের মধ্যে কীভাবে অ্যানালিটিক্স ইভেন্ট সাবস্ক্রাইব ও ম্যানেজ করতে হয় তা নিম্নলিখিত কোড থেকে জানতে পারবেন:

import SwiftUI
import PlacesSwift

struct PlaceCardScreen: View {
  @State private var query = PlaceDetailsQuery(identifier: .placeID("ChIJN1t_tDeuEmsRUsoyG83frY4"))
  var configuration: PlaceDetailsCompactConfiguration {
    return PlaceDetailsCompactConfiguration(
      content: PlaceDetailsCompactView.standardContent,
      theme: PlacesMaterialTheme()
    )
  }

  var body: some View {
    VStack {
      PlaceDetailsCompactView(query: $query, configuration: configuration, placeDetailsCallback: { _ in })
        // 1. Direct card tap (for UI navigation, e.g., centering a map)
        .onTap { place in
          print("Card tapped for place ID: \(place.placeID ?? "unknown")")
        }
    }
    // 2. Analytics callback (can be attached to the card or any parent container)
    .onPlaceAnalyticsEvent { event in
      let placeID = event.places.first?.placeID ?? "none"

      // Option A: Check for specific interactions using built-in Tag constants
      if event.tags.contains(PlaceAnalyticsEvent.Tag.directions) {
        print("User requested directions for place: \(placeID)")
      }

      if event.tags.contains(PlaceAnalyticsEvent.Tag.outbound) {
        print("User is leaving the app via: \(event.tags.sorted().joined(separator: ", "))")
      }

      // Option B: Forward every event directly to your analytics SDK (e.g., Firebase)
      Analytics.logEvent("place_ui_kit_interaction", parameters: [
        "component_type": event.componentType,
        "content_type": event.contentType ?? "none",
        "tags": event.tags.sorted().joined(separator: ","),
        "place_id": placeID
      ])
    }
  }
}

আপনার অ্যাপ যদি একই ধরনের উইজেটের একাধিক কার্ড দেখায় (যেমন, দুটি PlaceDetailsCompactView ইনস্ট্যান্স), তাহলে প্রতিটি ভিউতে সরাসরি .onPlaceAnalyticsEvent অ্যাটাচ করলে আপনি জানতে পারবেন যে কোন নির্দিষ্ট কার্ড ইনস্ট্যান্স ইভেন্টটি ট্রিগার করেছে।

নিম্নলিখিত কোড স্নিপেট থেকে জানা যায় যে কীভাবে সরাসরি AdvancedPlaceDetailsCompactView কম্পোনেন্টে অ্যানালিটিক্স ইভেন্ট সাবস্ক্রাইব ও ম্যানেজ করতে হয়:

import SwiftUI
import PlacesSwift

struct SinglePlaceCardView: View {
  @State private var query = PlaceDetailsQuery(
    identifier: .placeID("ChIJN1t_tDeuEmsRUsoyG83frY4")
  )
  private var configuration: AdvancedPlaceDetailsCompactConfiguration {
    AdvancedPlaceDetailsCompactConfiguration(
      content: AdvancedPlaceDetailsCompactView.standardContent,
      theme: PlacesMaterialTheme()
    )
  }

  var body: some View {
    AdvancedPlaceDetailsCompactView(
      orientation: .horizontal,
      query: $query,
      configuration: configuration
    ) { _ in }
      // 1. Direct card-tap callback (must come before generic `View` modifiers)
      .onTap { place in
        print("Tapped card for place: \(place.placeID ?? "unknown")")
      }
      // 2. Analytics callback scoped to this specific view instance
      .onPlaceAnalyticsEvent { event in
        let placeIDs = event.places.compactMap(\.placeID).joined(separator: ", ")
        let tags = event.tags.sorted().joined(separator: ", ")

        print("[\(tags)] in \(event.componentType), content: \(event.contentType ?? "nil"), places: [\(placeIDs)]")

        if event.tags.contains(PlaceAnalyticsEvent.Tag.directions) {
          print("Directions tapped on this card")
        }
      }
  }
}

কার্ড ট্যাপ কলব্যাক যোগ ও ম্যানেজ করুন

প্রতিটি UI Kit কম্পোনেন্টের জন্য কার্ড ট্যাপ কলব্যাক আলাদাভাবে কনফিগার ও ম্যানেজ করতে হবে।

কার্ডের বডিতে ট্যাপ ম্যানেজ করতে UI Kit কম্পোনেন্টে .onTap মডিফায়ার ব্যবহার করুন। ব্যবহারকারী কার্ডে ট্যাপ করলে, .onTap তিনটি প্রপার্টি সহ একটি Place স্ট্রাক্ট পাস করে:

  • place.placeID (String?): অনন্য স্থান আইডি, যেমন, সম্পূর্ণ PlaceDetailsView শিট খুলতে বা মার্কার বেছে নিতে।
  • place.location (CLLocationCoordinate2D): জায়গার অক্ষাংশ/দ্রাঘিমাংশ স্থানাঙ্ক, যেমন, ম্যাপ ক্যামেরার কেন্দ্র বা মার্কারের জায়গা।
  • place.viewportInfo (RectangularCoordinateRegion?): ম্যাপে জায়গাটি ফ্রেম করার জন্য সাজেস্ট করা ম্যাপ ভিউপোর্ট বাউন্ড (northEast এবং southWest কোঅর্ডিনেট)।

নিম্নলিখিত কোড থেকে জানা যায় যে কীভাবে AdvancedPlaceDetailsCompactView-এর জন্য কার্ড ট্যাপ কলব্যাক যোগ ও ম্যানেজ করতে হয়:

import CoreLocation
import PlacesSwift
import SwiftUI

struct PlaceCardTapSampleView: View {
  static let peetsCoffeePlaceID = "ChIJT7FdmYiAhYAROFOvrIxRJDU"

  @State private var query = PlaceDetailsQuery(
    identifier: .placeID(peetsCoffeePlaceID)
  )
  @State private var selectedPlace: Place?

  var body: some View {
    AdvancedPlaceDetailsCompactView(
      orientation: .horizontal,
      query: $query,
      configuration: AdvancedPlaceDetailsCompactConfiguration(
        content: AdvancedPlaceDetailsCompactView.standardContent,
        theme: PlacesMaterialTheme()
      ),
      placeDetailsCallback: { _ in }
    )
    .onTap { place in
      // Handle the card tap using place.placeID, place.location, or place.viewportInfo
      selectedPlace = place
      print("Tapped place ID: \(place.placeID ?? "unknown")")
      print("Coordinates: \(place.location.latitude), \(place.location.longitude)")

      if let viewport = place.viewportInfo {
        print("Viewport NE: \(viewport.northEast), SW: \(viewport.southWest)")
      }
    }
  }
}