إضافة إحصاءات إلى أحد مكوّنات حزمة أدوات "خرائط Google" الجاهزة للأماكن
يمكنك الاشتراك في أحداث الإحصاءات حول نقر المستخدمين على "الاتجاهات" أو "اتصال" أو "الموقع الإلكتروني" أو فتح "خرائط Google" أو النقر على التقييم بالنجوم أو تحديد مصدر المؤلف أو فتح مربّع عرض الصور أو تبديل علامات التبويب. ويشير كل حدث إلى المكوّن ونوع المحتوى اللذين تم تشغيلهما، بالإضافة إلى رقم تعريف المكان وموقعه الجغرافي.
أحداث "إحصاءات Google" المقدَّمة
يقدّم الجدول التالي أمثلة على أحداث الإحصاءات التي توفّرها حزمة أدوات "خرائط Google" الجاهزة للأماكن.
| التفاعل مع واجهة المستخدم | tags: Set<String> |
المحتوى المرتبط/نوع المحتوى |
|---|---|---|
| زرّ الاتجاهات | {"click", "directions", "outbound"} |
"main_action_button" أو "corner_action_button" |
| زر "فتح في خرائط Google" | {"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" |
تم فتح القائمة الكاملة في Lightbox (⋮) (داخل التطبيق) |
{"click", "lightbox_menu"} |
"media" |
تم فتح قائمة الملخّصات المستندة إلى الذكاء الاصطناعي التوليدي (⋮) (داخل التطبيق) |
{"click", "generative_summary_menu"} |
"generative_summary" |
تم فتح قائمة ملخّص المراجعات المستنِدة إلى الذكاء الاصطناعي التوليدي (⋮) (داخل التطبيق) |
{"click", "review_summary_menu"} |
"review" |
بما أنّه قد تتم إضافة أحداث وعلامات جديدة بمرور الوقت، يمكنك إرفاق معالج عام أثناء التطوير لتسجيل كل حدث يتم بثه أثناء تفاعلك مع أحد المكوّنات:
// 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))" ) }
الاشتراك في أحداث الإحصاءات ومعالجتها
يمكنك الاشتراك في أحداث الإحصاءات من أحد مكوّنات UI Kit باستخدام المُعدِّل onPlaceAnalyticsEvent. يمكنك إرفاق المُعدِّل بطريقة عرض حاوية أو مباشرةً بمكوّن في حزمة واجهة المستخدم.
يوضّح الرمز التالي كيفية الاشتراك في أحداث الإحصاءات ومعالجتها ضمن طريقة عرض الحاوية:
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 ]) } } }
إذا كان تطبيقك يعرض بطاقات متعددة من نوع التطبيق المصغّر نفسه (على سبيل المثال، مثيلان من PlaceDetailsCompactView)، فإنّ إرفاق .onPlaceAnalyticsEvent مباشرةً بكل طريقة عرض يتيح لك معرفة مثيل البطاقة المحدّد الذي أدّى إلى بدء الحدث.
يوضّح مقتطف الرمز التالي كيفية الاشتراك في أحداث الإحصاءات ومعالجتها مباشرةً في مكوّن 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") } } } }
إضافة عمليات معاودة الاتصال عند النقر على البطاقة ومعالجتها
يجب ضبط عمليات معاودة الاتصال عند النقر على البطاقة ومعالجتها بشكل منفصل لكل مكوّن من مكوّنات UI Kit.
استخدِم المُعدِّل .onTap في أحد مكوّنات UI Kit للتعامل مع النقرات على نص البطاقة. عندما ينقر المستخدم على البطاقة، يمرّر .onTap بنية Place تتضمّن ثلاث سمات:
-
place.placeID(String?): رقم تعريف المكان الفريد، على سبيل المثال، لفتح ورقة بياناتPlaceDetailsViewكاملة أو اختيار علامة place.location(CLLocationCoordinate2D): إحداثيات خط العرض/خط الطول للمكان، على سبيل المثال، لتوسيط كاميرا الخريطة أو وضع علامة-
place.viewportInfo(RectangularCoordinateRegion?): حدود إطار العرض المقترَحة للخريطة (إحداثياتnorthEastوsouthWest) لتحديد إطار المكان على الخريطة.
يوضّح الرمز التالي كيفية إضافة دالة ردّ اتصال عند النقر على البطاقة ومعالجتها لـ 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)") } } } }