Thêm số liệu phân tích vào một thành phần của Places UI Kit
Bạn có thể đăng ký nhận sự kiện phân tích về việc người dùng nhấn vào Đường đi, Gọi điện hoặc Trang web, mở Google Maps, nhấn vào điểm xếp hạng theo sao hoặc thông tin ghi nhận tác giả, mở hộp đèn ảnh hoặc chuyển đổi thẻ. Mỗi sự kiện cho biết thành phần và loại nội dung nào đã kích hoạt, cũng như mã địa điểm và vị trí.
Sự kiện Analytics được cung cấp
Bảng sau đây cung cấp ví dụ về các sự kiện phân tích do Places UI Kit cung cấp.
| Tương tác với giao diện người dùng | tags: Set<String> |
Nội dung liên quan/Loại nội dung |
|---|---|---|
| Nút Đường đi | {"click", "directions", "outbound"} |
"main_action_button" hoặc "corner_action_button" |
| Nút Mở trong Maps | {"click", "maps", "outbound"} |
"main_action_button" hoặc "corner_action_button" |
| Nút gọi/Số điện thoại (thẻ Tổng quan) | {"click", "call_place", "outbound"} |
"phone_number", "main_action_button" hoặc "corner_action_button" |
| Nút trang web/Trang web (thẻ Tổng quan) | {"click", "place_website", "outbound"} |
"website", "main_action_button" hoặc "corner_action_button" |
| Đường liên kết phân bổ | {"click", "attribution", "outbound"} |
"review" hoặc "media" |
| Đường liên kết đến điểm xếp hạng | {"click", "reviews", "outbound"} |
"rating" hoặc "review_summaries" |
Đường liên kết đến công bố thông tin theo quy định pháp lý (đường liên kết trong hộp thoại ⓘ) |
{"click", "disclosure", "outbound"} |
null (không thể định cấu hình) |
| Đường liên kết đến báo cáo | {"click", "report", "outbound"} |
"media", "review" hoặc "generative_summary" |
| Đường liên kết xem lại | {"click", "review", "outbound"} |
"review" |
| Đường liên kết đến nội dung nghe nhìn/ảnh | {"click", "media", "outbound"} |
"media" |
| Đã mở hộp đèn ảnh (trong ứng dụng) | {"click", "media"} |
"media" |
| Đã chọn thẻ Tổng quan (trong ứng dụng) | {"click", "overview_tab"} |
null |
| Đã chọn thẻ Bài đánh giá (trong ứng dụng) | {"click", "reviews_tab"} |
"review" |
| Đã chọn thẻ Giới thiệu (trong ứng dụng) | {"click", "about_tab"} |
"features" |
Đã mở trình đơn mục bổ sung của bài đánh giá (⋮) (trong ứng dụng) |
{"click", "reviews_menu"} |
"review" |
Đã mở trình đơn mục bổ sung của hộp đèn (⋮) (trong ứng dụng) |
{"click", "lightbox_menu"} |
"media" |
Đã mở trình đơn tóm tắt bằng AI tạo sinh (⋮) (trong ứng dụng) |
{"click", "generative_summary_menu"} |
"generative_summary" |
Đã mở trình đơn tóm tắt bài đánh giá bằng AI tạo sinh (⋮) (trong ứng dụng) |
{"click", "review_summary_menu"} |
"review" |
Vì các sự kiện và thẻ mới có thể được thêm vào theo thời gian, nên bạn có thể đính kèm một trình xử lý chung trong quá trình phát triển để ghi lại mọi sự kiện được truyền phát khi bạn tương tác với một thành phần:
// 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))" ) }
Đăng ký và xử lý các sự kiện phân tích
Bạn có thể đăng ký nhận sự kiện phân tích từ một thành phần của Bộ công cụ giao diện người dùng bằng cách sử dụng đối tượng sửa đổi onPlaceAnalyticsEvent. Bạn có thể đính kèm đối tượng sửa đổi vào một thành phần hiển thị vùng chứa hoặc trực tiếp vào một thành phần của Bộ giao diện người dùng.
Mã sau đây cho biết cách đăng ký và xử lý các sự kiện phân tích trong một khung hiển thị vùng chứa:
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 ]) } } }
Nếu ứng dụng của bạn hiển thị nhiều thẻ của cùng một loại tiện ích (ví dụ: hai thực thể PlaceDetailsCompactView), thì việc đính kèm .onPlaceAnalyticsEvent trực tiếp vào mỗi thành phần hiển thị sẽ giúp bạn biết thực thể thẻ cụ thể nào đã kích hoạt sự kiện.
Đoạn mã sau đây cho biết cách đăng ký và xử lý các sự kiện phân tích ngay trên một thành phần 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") } } } }
Thêm và xử lý lệnh gọi lại khi nhấn vào thẻ
Bạn phải định cấu hình và xử lý riêng các lệnh gọi lại khi nhấn vào thẻ cho từng thành phần của Bộ giao diện người dùng.
Sử dụng đối tượng sửa đổi .onTap trên một thành phần của Bộ giao diện người dùng để xử lý các thao tác nhấn vào phần thân thẻ. Khi người dùng nhấn vào thẻ, .onTap sẽ truyền một cấu trúc Place được điền sẵn 3 thuộc tính:
place.placeID(String?): Mã địa điểm duy nhất, chẳng hạn như để mở một trang tínhPlaceDetailsViewđầy đủ hoặc chọn một điểm đánh dấu.place.location(CLLocationCoordinate2D): Toạ độ vĩ độ/kinh độ của địa điểm, ví dụ: để căn giữa camera bản đồ hoặc đặt điểm đánh dấu.place.viewportInfo(RectangularCoordinateRegion?): Các ranh giới khung nhìn bản đồ được đề xuất (toạ độnorthEastvàsouthWest) để định khung địa điểm trên bản đồ.
Đoạn mã sau đây cho biết cách thêm và xử lý lệnh gọi lại khi nhấn vào thẻ cho 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)") } } } }