जगहों की जानकारी देने वाली यूआई किट के कॉम्पोनेंट में 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}") } } ) }