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"

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

// Wrap your Places UI Kit composable or parent layout to inspect all broadcast events.
// AnalyticsEvent.toString() includes componentType, tags, place IDs, and contentType.
ProvidePlacesAnalyticsHandler(
  handler = { event ->
    Log.d("PlacesAnalytics", "$event")
  }
) {
  // Places UI Kit composables...
}

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

আপনি UI Kit কম্পোজ কম্পোনেন্ট থেকে অ্যানালিটিক্স ইভেন্টে সাবস্ক্রাইব করতে পারবেন। এর জন্য আপনাকে পেরেন্ট লেআউট কন্টেনার বা কম্পোনেন্টকে ProvidePlacesAnalyticsHandler-এ র‍্যাপ করতে হবে।

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

import android.util.Log
import androidx.compose.foundation.layout.Column
import androidx.compose.runtime.Composable
import com.google.android.libraries.places.compose.AnalyticsEvent
import com.google.android.libraries.places.compose.AdvancedPlaceDetailsCompact
import com.google.android.libraries.places.compose.PlaceReference
import com.google.android.libraries.places.compose.ProvidePlacesAnalyticsHandler
import com.google.firebase.*

@Composable
fun PlaceCardScreen() {
  val placeRef = PlaceReference.PlaceId("ChIJN1t_tDeuEmsRUsoyG83frY4")

  // Analytics callback wraps the container hierarchy
  ProvidePlacesAnalyticsHandler(
    handler = { event ->
      val placeId = event.places.firstOrNull()?.id ?: "none"

      // Option A: Check for specific interactions using built-in Tags constants
      if (AnalyticsEvent.Tags.DIRECTIONS in event.tags) {
        Log.d("PlacesAnalytics", "User requested directions for place: $placeId")
      }

      if (AnalyticsEvent.Tags.OUTBOUND in event.tags) {
        Log.d(
          "PlacesAnalytics",
          "User is leaving the app via: ${event.tags.sorted().joinToString(", ")}"
        )
      }

      // Option B: Forward every event directly to your analytics SDK (e.g., Firebase)
      val firebaseAnalytics = remember { Firebase.analytics }
      firebaseAnalytics.logEvent("place_ui_kit_interaction") {
        param("component_type", event.componentType)
        param("content_type", event.contentType ?: "none")
        param("tags", event.tags.sorted().joinToString(","))
        param("place_id", placeId)
      }
    }
  ) {
    Column {
      AdvancedPlaceDetailsCompact(
        reference = placeRef,
        // Direct card tap (for UI navigation, e.g., centering a map)
        onClick = { place ->
          Log.d("Places", "Card tapped for place ID: ${place.id ?: "unknown"}")
        }
      )
    }
  }
}

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

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

import android.util.Log
import androidx.compose.runtime.Composable
import com.google.android.libraries.places.compose.AdvancedPlaceDetailsCompact
import com.google.android.libraries.places.compose.AnalyticsEvent
import com.google.android.libraries.places.compose.Orientation
import com.google.android.libraries.places.compose.PlaceReference
import com.google.android.libraries.places.compose.ProvidePlacesAnalyticsHandler

@Composable
fun SinglePlaceCardView() {
  val placeRef = PlaceReference.PlaceId("ChIJN1t_tDeuEmsRUsoyG83frY4")

  // Analytics callback scoped to this specific composable instance
  ProvidePlacesAnalyticsHandler(
    handler = { event ->
      val placeIds = event.places.mapNotNull { it.id }.joinToString(", ")
      val tags = event.tags.sorted().joinToString(", ")

      Log.d(
        "PlacesAnalytics",
        "[$tags] in ${event.componentType}, content: ${event.contentType ?: "null"}, places: [$placeIds]"
      )

      if (AnalyticsEvent.Tags.DIRECTIONS in event.tags) {
        Log.d("PlacesAnalytics", "Directions tapped on this card")
      }
    }
  ) {
    AdvancedPlaceDetailsCompact(
      reference = placeRef,
      orientation = Orientation.HORIZONTAL,
      // Direct card-tap callback
      onClick = { place ->
        Log.d("Places", "Tapped card for place: ${place.id ?: "unknown"}")
      }
    )
  }
}

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

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

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

  • place.id (String?): অনন্য স্থান আইডি, উদাহরণস্বরূপ, সম্পূর্ণ স্থান বিবরণ ভিউ খুলতে বা একটি মার্কার নির্বাচন করতে।
  • place.location (LatLng?): জায়গার অক্ষাংশ/দ্রাঘিমাংশ স্থানাঙ্ক, যেমন, ম্যাপ ক্যামেরার কেন্দ্র বা মার্কারের জায়গা।
  • place.viewport (LatLngBounds?): ম্যাপে জায়গাটি ফ্রেম করার জন্য সাজেস্ট করা ম্যাপ ভিউপোর্ট বাউন্ড (northeast এবং southwest কোঅর্ডিনেট)।

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

import android.util.Log
import androidx.compose.runtime.Composable
import androidx.compose.runtime.getValue
import androidx.compose.runtime.mutableStateOf
import androidx.compose.runtime.remember
import androidx.compose.runtime.setValue
import com.google.android.libraries.places.api.model.Place
import com.google.android.libraries.places.compose.AdvancedPlaceDetailsCompact
import com.google.android.libraries.places.compose.Orientation
import com.google.android.libraries.places.compose.PlaceReference

@Composable
fun PlaceCardTapSampleView() {
  val peetsCoffeePlaceId = "ChIJT7FdmYiAhYAROFOvrIxRJDU"
  var selectedPlace by remember { mutableStateOf<Place?>(null) }

  AdvancedPlaceDetailsCompact(
    reference = PlaceReference.PlaceId(peetsCoffeePlaceId),
    orientation = Orientation.HORIZONTAL,
    onClick = { place ->
      // Handle the card tap using place.id, place.location, or place.viewport
      selectedPlace = place
      Log.d("Places", "Tapped place ID: ${place.id ?: "unknown"}")

      place.location?.let { location ->
        Log.d("Places", "Coordinates: ${location.latitude}, ${location.longitude}")
      }

      place.viewport?.let { viewport ->
        Log.d("Places", "Viewport NE: ${viewport.northeast}, SW: ${viewport.southwest}")
      }
    }
  )
}