Analysen zu einer Places UI Kit-Komponente hinzufügen
Sie können Analyseereignisse abonnieren, die ausgelöst werden, wenn Nutzer auf „Route“, „Anrufen“ oder „Website“ tippen, Google Maps öffnen, auf die Sternebewertung oder eine Urheberangabe tippen, die Fotogalerie öffnen oder Tabs wechseln. Für jedes Ereignis wird angegeben, welche Komponente und welcher Inhaltstyp ausgelöst wurden, sowie die Orts-ID und der Standort.
Bereitgestellte Analytics-Ereignisse
In der folgenden Tabelle finden Sie Beispiele für Analyseereignisse, die vom Places UI Kit bereitgestellt werden.
| UI-Interaktion | tags: Set<String> |
Verknüpfter Inhalt/Inhaltstyp |
|---|---|---|
| Button „Route“ | {"click", "directions", "outbound"} |
"main_action_button" oder "corner_action_button" |
| Schaltfläche „In Maps öffnen“ | {"click", "maps", "outbound"} |
"main_action_button" oder "corner_action_button" |
| Schaltfläche „Anruf“ / Telefonnummer (Tab „Übersicht“) | {"click", "call_place", "outbound"} |
"phone_number", "main_action_button" oder "corner_action_button" |
| Schaltfläche „Website“ / Website (Tab „Übersicht“) | {"click", "place_website", "outbound"} |
"website", "main_action_button" oder "corner_action_button" |
| Attribution link | {"click", "attribution", "outbound"} |
"review" oder "media" |
| Link zur Bewertung | {"click", "reviews", "outbound"} |
"rating" oder "review_summaries" |
Link zur rechtlichen Offenlegung (ⓘ Dialogfeldlinks) |
{"click", "disclosure", "outbound"} |
null (nicht konfigurierbar) |
| Link zum Bericht | {"click", "report", "outbound"} |
"media", "review" oder "generative_summary" |
| Review link | {"click", "review", "outbound"} |
"review" |
| Medien-/Fotolink | {"click", "media", "outbound"} |
"media" |
| Foto-Lightbox geöffnet (In-App) | {"click", "media"} |
"media" |
| Tab „Übersicht“ ausgewählt (In-App) | {"click", "overview_tab"} |
null |
| Tab „Rezensionen“ ausgewählt (In-App) | {"click", "reviews_tab"} |
"review" |
| Tab „Über“ ausgewählt (In-App) | {"click", "about_tab"} |
"features" |
Dreipunkt-Menü für Rezensionen (⋮) geöffnet (In-App) |
{"click", "reviews_menu"} |
"review" |
Dreipunkt-Menü der Lightbox (⋮) geöffnet (In-App) |
{"click", "lightbox_menu"} |
"media" |
Menü für generative Zusammenfassung (⋮) geöffnet (in der App) |
{"click", "generative_summary_menu"} |
"generative_summary" |
Menü für generativen Rezensionsüberblick (⋮) geöffnet (In-App) |
{"click", "review_summary_menu"} |
"review" |
Da im Laufe der Zeit neue Ereignisse und Tags hinzugefügt werden können, können Sie während der Entwicklung einen generischen Handler anhängen, um jedes Ereignis zu protokollieren, das bei der Interaktion mit einer Komponente übertragen wird:
// 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... }
Analyseereignisse abonnieren und verarbeiten
Sie können Analyseereignisse von einer UI-Kit-Compose-Komponente abonnieren, indem Sie einen übergeordneten Layoutcontainer oder die Komponente selbst in ProvidePlacesAnalyticsHandler einbinden.
Der folgende Code zeigt, wie Sie Analyseereignisse innerhalb einer Containerhierarchie abonnieren und verarbeiten:
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"}") } ) } } }
Wenn in Ihrer App mehrere Karten desselben Widget-Typs angezeigt werden (z. B. zwei AdvancedPlaceDetailsCompact-Kompositionen), können Sie durch das Verpacken jeder Komposition in ein eigenes ProvidePlacesAnalyticsHandler-Element feststellen, welche spezifische Karteninstanz das Ereignis ausgelöst hat.
Das folgende Code-Snippet zeigt, wie Sie Analyseereignisse für eine einzelne AdvancedPlaceDetailsCompact-komponierbare Funktion abonnieren und verarbeiten:
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"}") } ) } }
Callbacks für das Tippen auf Karten hinzufügen und verarbeiten
Callbacks für das Tippen auf Karten müssen für jede UI-Kit-Komponente separat konfiguriert und verarbeitet werden.
Verwenden Sie den Parameter onClick für eine UI Kit-komponierbare Funktion, um das Tippen auf den Karteninhalt zu verarbeiten. Wenn der Nutzer auf die Karte tippt, übergibt onClick ein Place-Objekt mit drei Eigenschaften:
place.id(String?): Die eindeutige Orts-ID, um beispielsweise eine vollständige Place Details-Ansicht zu öffnen oder eine Markierung auszuwählen.place.location(LatLng?): Die Breiten- und Längengradkoordinaten des Ortes, um beispielsweise eine Kartenkamera zu zentrieren oder eine Markierung zu platzieren.place.viewport(LatLngBounds?): Die empfohlenen Grenzen des Darstellungsbereichs der Karte (northeast- undsouthwest-Koordinaten) für die Darstellung des Ortes auf einer Karte.
Der folgende Code zeigt, wie Sie einen Callback für das Tippen auf eine Karte für eine zusammensetzbare AdvancedPlaceDetailsCompact-Funktion hinzufügen und verarbeiten:
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}") } } ) }