Aggiungi l'analisi a un componente di Places UI Kit
Puoi iscriverti agli eventi di analisi relativi agli utenti che toccano Indicazioni, Chiama o Sito web, aprono Google Maps, toccano la valutazione a stelle o l'attribuzione dell'autore, aprono il lightbox delle foto o cambiano scheda. Ogni evento indica il componente e il tipo di contenuto attivati, nonché l'ID luogo e la posizione.
Eventi Analytics forniti
La tabella seguente fornisce esempi di eventi di analisi forniti da Places UI Kit.
| Interazione con la UI | tags: Set<String> |
Contenuti associati/Tipo di contenuti |
|---|---|---|
| Pulsante Indicazioni stradali | {"click", "directions", "outbound"} |
"main_action_button" o "corner_action_button" |
| Pulsante Apri in Maps | {"click", "maps", "outbound"} |
"main_action_button" o "corner_action_button" |
| Pulsante Chiama/Numero di telefono (scheda Panoramica) | {"click", "call_place", "outbound"} |
"phone_number", "main_action_button" o "corner_action_button" |
| Pulsante Sito web/Sito web (scheda Panoramica) | {"click", "place_website", "outbound"} |
"website", "main_action_button" o "corner_action_button" |
| Link di attribuzione | {"click", "attribution", "outbound"} |
"review" o "media" |
| Link alla valutazione | {"click", "reviews", "outbound"} |
"rating" o "review_summaries" |
Link alla divulgazione legale (link della finestra di dialogo ⓘ) |
{"click", "disclosure", "outbound"} |
null (non configurabile) |
| Link rapporto | {"click", "report", "outbound"} |
"media", "review" o "generative_summary" |
| Link recensione | {"click", "review", "outbound"} |
"review" |
| Link a contenuti multimediali/foto | {"click", "media", "outbound"} |
"media" |
| Lightbox foto aperto (in-app) | {"click", "media"} |
"media" |
| Scheda Panoramica selezionata (nell'app) | {"click", "overview_tab"} |
null |
| Scheda Recensioni selezionata (in-app) | {"click", "reviews_tab"} |
"review" |
| Scheda Informazioni selezionata (in-app) | {"click", "about_tab"} |
"features" |
Menu extra delle recensioni (⋮) aperto (in-app) |
{"click", "reviews_menu"} |
"review" |
Menu extra lightbox (⋮) aperto (in-app) |
{"click", "lightbox_menu"} |
"media" |
Menu del riepilogo generativo (⋮) aperto (nell'app) |
{"click", "generative_summary_menu"} |
"generative_summary" |
Menu del riepilogo delle recensioni generativo (⋮) aperto (in-app) |
{"click", "review_summary_menu"} |
"review" |
Poiché nel tempo potrebbero essere aggiunti nuovi eventi e tag, durante lo sviluppo puoi collegare un gestore generico per registrare ogni evento trasmesso mentre interagisci con un componente:
// Attach to a Places UI Kit view or a parent container to inspect all broadcast events .onPlaceAnalyticsEvent { event in print( "Analytics event — component: \(event.componentType), " + "tags: \(event.tags.sorted()), " + "content: \(event.contentType ?? "nil"), " + "places: \(event.places.compactMap(\.placeID))" ) }
Iscriviti agli eventi di analisi e gestiscili
Puoi iscriverti agli eventi di analisi da un componente UI Kit utilizzando il modificatore onPlaceAnalyticsEvent. Puoi collegare il modificatore a una visualizzazione container o direttamente a un componente UI Kit.
Il seguente codice mostra come iscriversi e gestire gli eventi di analisi all'interno di una visualizzazione container:
import SwiftUI import PlacesSwift struct PlaceCardScreen: View { @State private var query = PlaceDetailsQuery(identifier: .placeID("ChIJN1t_tDeuEmsRUsoyG83frY4")) var configuration: PlaceDetailsCompactConfiguration { return PlaceDetailsCompactConfiguration( content: PlaceDetailsCompactView.standardContent, theme: PlacesMaterialTheme() ) } var body: some View { VStack { PlaceDetailsCompactView(query: $query, configuration: configuration, placeDetailsCallback: { _ in }) // 1. Direct card tap (for UI navigation, e.g., centering a map) .onTap { place in print("Card tapped for place ID: \(place.placeID ?? "unknown")") } } // 2. Analytics callback (can be attached to the card or any parent container) .onPlaceAnalyticsEvent { event in let placeID = event.places.first?.placeID ?? "none" // Option A: Check for specific interactions using built-in Tag constants if event.tags.contains(PlaceAnalyticsEvent.Tag.directions) { print("User requested directions for place: \(placeID)") } if event.tags.contains(PlaceAnalyticsEvent.Tag.outbound) { print("User is leaving the app via: \(event.tags.sorted().joined(separator: ", "))") } // Option B: Forward every event directly to your analytics SDK (e.g., Firebase) Analytics.logEvent("place_ui_kit_interaction", parameters: [ "component_type": event.componentType, "content_type": event.contentType ?? "none", "tags": event.tags.sorted().joined(separator: ","), "place_id": placeID ]) } } }
Se la tua app mostra più schede dello stesso tipo di widget (ad esempio, due istanze di PlaceDetailsCompactView), collegando .onPlaceAnalyticsEvent direttamente a ogni visualizzazione puoi sapere quale istanza di scheda specifica ha attivato l'evento.
Il seguente snippet di codice mostra come iscriversi e gestire gli eventi di analisi direttamente su un componente AdvancedPlaceDetailsCompactView:
import SwiftUI import PlacesSwift struct SinglePlaceCardView: View { @State private var query = PlaceDetailsQuery( identifier: .placeID("ChIJN1t_tDeuEmsRUsoyG83frY4") ) private var configuration: AdvancedPlaceDetailsCompactConfiguration { AdvancedPlaceDetailsCompactConfiguration( content: AdvancedPlaceDetailsCompactView.standardContent, theme: PlacesMaterialTheme() ) } var body: some View { AdvancedPlaceDetailsCompactView( orientation: .horizontal, query: $query, configuration: configuration ) { _ in } // 1. Direct card-tap callback (must come before generic `View` modifiers) .onTap { place in print("Tapped card for place: \(place.placeID ?? "unknown")") } // 2. Analytics callback scoped to this specific view instance .onPlaceAnalyticsEvent { event in let placeIDs = event.places.compactMap(\.placeID).joined(separator: ", ") let tags = event.tags.sorted().joined(separator: ", ") print("[\(tags)] in \(event.componentType), content: \(event.contentType ?? "nil"), places: [\(placeIDs)]") if event.tags.contains(PlaceAnalyticsEvent.Tag.directions) { print("Directions tapped on this card") } } } }
Aggiungi e gestisci i callback dei tocchi delle tessere
I callback dei tocchi delle schede devono essere configurati e gestiti separatamente per ogni componente di UI Kit.
Utilizza il modificatore .onTap su un componente UI Kit per gestire i tocchi sul corpo della scheda. Quando l'utente tocca la scheda, .onTap passa una struttura Place compilata con tre proprietà:
place.placeID(String?): l'ID luogo univoco per, ad esempio, aprire una schedaPlaceDetailsViewcompleta o selezionare un indicatore.place.location(CLLocationCoordinate2D): le coordinate di latitudine/longitudine del luogo, ad esempio per centrare la fotocamera della mappa o posizionare un indicatore.place.viewportInfo(RectangularCoordinateRegion?): i limiti consigliati per l'area visibile della mappa (coordinatenorthEastesouthWest) per inquadrare il luogo su una mappa.
Il seguente codice mostra come aggiungere e gestire un callback di tocco della scheda per un AdvancedPlaceDetailsCompactView:
import CoreLocation import PlacesSwift import SwiftUI struct PlaceCardTapSampleView: View { static let peetsCoffeePlaceID = "ChIJT7FdmYiAhYAROFOvrIxRJDU" @State private var query = PlaceDetailsQuery( identifier: .placeID(peetsCoffeePlaceID) ) @State private var selectedPlace: Place? var body: some View { AdvancedPlaceDetailsCompactView( orientation: .horizontal, query: $query, configuration: AdvancedPlaceDetailsCompactConfiguration( content: AdvancedPlaceDetailsCompactView.standardContent, theme: PlacesMaterialTheme() ), placeDetailsCallback: { _ in } ) .onTap { place in // Handle the card tap using place.placeID, place.location, or place.viewportInfo selectedPlace = place print("Tapped place ID: \(place.placeID ?? "unknown")") print("Coordinates: \(place.location.latitude), \(place.location.longitude)") if let viewport = place.viewportInfo { print("Viewport NE: \(viewport.northEast), SW: \(viewport.southWest)") } } } }