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