जगहों की जानकारी देने वाली यूआई किट के कॉम्पोनेंट में Analytics जोड़ना

आपके पास उपयोगकर्ताओं की गतिविधि से जुड़े आंकड़ों के इवेंट की सदस्यता लेने का विकल्प होता है. जैसे, उपयोगकर्ताओं का 'निर्देश', 'कॉल करें' या 'वेबसाइट' पर टैप करना, Google Maps खोलना, स्टार रेटिंग या लेखक के एट्रिब्यूशन पर टैप करना, फ़ोटो लाइटबॉक्स खोलना या टैब स्विच करना. हर इवेंट से पता चलता है कि किस कॉम्पोनेंट और कॉन्टेंट टाइप को ट्रिगर किया गया. साथ ही, जगह के आईडी और जगह की जानकारी भी मिलती है.

उपलब्ध कराए गए Analytics इवेंट

नीचे दी गई टेबल में, जगहों की जानकारी देने वाली यूआई किट से मिलने वाले आंकड़ों के इवेंट के उदाहरण दिए गए हैं.

यूज़र इंटरफ़ेस (यूआई) से इंटरैक्शन 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...
}

आंकड़ों से जुड़े इवेंट की सदस्यता लेना और उन्हें मैनेज करना

यूज़र इंटरफ़ेस (यूआई) किट के कंपोज़ कॉम्पोनेंट से, Analytics इवेंट की सदस्यता ली जा सकती है. इसके लिए, पैरंट लेआउट कंटेनर या कॉम्पोनेंट को ProvidePlacesAnalyticsHandler में रैप करें.

यहां दिए गए कोड में, कंटेनर की हैरारकी में Analytics इवेंट की सदस्यता लेने और उन्हें मैनेज करने का तरीका बताया गया है:

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"}")
      }
    )
  }
}

कार्ड टैप कॉलबैक जोड़ना और मैनेज करना

कार्ड टैप कॉलबैक को यूज़र इंटरफ़ेस (यूआई) किट के हर कॉम्पोनेंट के लिए अलग से कॉन्फ़िगर और मैनेज करना होगा.

कार्ड के मुख्य हिस्से पर टैप करने की सुविधा को मैनेज करने के लिए, यूज़र इंटरफ़ेस (यूआई) किट के कंपोज़ेबल पर onClick पैरामीटर का इस्तेमाल करें. जब उपयोगकर्ता कार्ड पर टैप करता है, तो onClick, Place ऑब्जेक्ट को पास करता है. इसमें तीन प्रॉपर्टी होती हैं:

  • place.id (String?): जगह का आईडी. उदाहरण के लिए, Place Details का पूरा व्यू खोलने या मार्कर चुनने के लिए.
  • 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}")
      }
    }
  )
}