يوضّح لك دليل البدء السريع هذا كيفية إضافة Google Analytics إلى تطبيقك و بدء تسجيل الأحداث.
تجمع Google Analytics بيانات الاستخدام والسلوك لتطبيقك. تسجِّل حزمة SDK نوعَين أساسيَين من المعلومات:
- الأحداث: ما يحدث في تطبيقك، مثل إجراءات المستخدمين أو أحداث النظام أو الأخطاء
- خصائص المستخدِمين: هي السمات التي تحدّدها لوصف شرائح قاعدة المستخدِمين، مثل اللغة المفضّلة أو الموقع الجغرافي.
تسجِّل Analytics تلقائيًا بعض الأحداث و خصائص المستخدِمين، ولا تحتاج إلى إضافة أي رمز لتفعيلها.
قبل البدء
أضِف Firebase إلى مشروع Apple وتأكَّد من تفعيل Google Analytics في مشروع Firebase:
إذا كنت بصدد إنشاء مشروع جديد على Firebase، فعِّل Google Analytics أثناء سير عمل إنشاء المشروع.
إذا كنت تستخدم مشروعًا حاليًا على Firebase لم يتم تفعيل Google Analytics فيه، انتقِل إلى علامة التبويب عمليات الدمج ضمن
لتفعيله. > إعدادات المشروع
عند تفعيل Google Analytics في مشروعك، يتم ربط تطبيقات Firebase بمصادر بيانات Google Analytics.
(إجراء يُنصح به) أضِف إطار عمل AdSupport إلى مشروعك لتفعيل ميزات إضافية، مثل شرائح الجمهور وتحديد مصدر الحملات.
إضافة حزمة تطوير البرامج (SDK) لتطبيق Analytics إلى تطبيقك
استخدِم أداة Swift Package Manager لتثبيت تبعيات Firebase وإدارتها.
- في Xcode، مع فتح مشروع تطبيقك، انتقِل إلى ملف > إضافة حِزم.
- أضِف مستودع حزمة تطوير البرامج (SDK) لمنصّات Apple من Firebase عندما يُطلب منك ذلك:
- اختَر مكتبة Analytics.
- أضِف العلامة
-ObjC
إلى قسم رموز ربط أخرى في إعدادات الإنشاء الخاصة بالهدف. - للحصول على تجربة مثالية مع Analytics، ننصحك بتفعيل Google Analytics في مشروعك على Firebase وإضافة حزمة تطوير البرامج (SDK) لخدمة "إحصاءات Google لبرنامج Firebase" إلى تطبيقك. ويمكنك اختيار المكتبة بدون جمع معرّف جهاز IDFA أو مع جمع معرّف جهاز IDFA.
- عند الانتهاء، سيبدأ Xcode تلقائيًا في حلّ ملفاتك المضمّنة وتنزيلها في الخلفية.
https://github.com/firebase/firebase-ios-sdk.git
يمكنك الاطّلاع على مزيد من المعلومات عن معرّف المعلِنين (IDFA)، وهو المعرّف الإعلاني على مستوى الجهاز، في مستندات Apple المتعلّقة بموضوعَي خصوصية المستخدم واستخدام البيانات و شفافية تتبُّع التطبيقات.
بعد ذلك، عليك تنفيذ بعض خطوات الضبط:
- استورِد وحدة
FirebaseCore
فيUIApplicationDelegate
، بالإضافة إلى أي وحدات Firebase أخرى يستخدمها مفوّض تطبيقك. على سبيل المثال، لاستخدام Cloud Firestore وAuthentication:SwiftUI
import SwiftUI import FirebaseCore import FirebaseFirestore import FirebaseAuth // ...
Swift
import FirebaseCore import FirebaseFirestore import FirebaseAuth // ...
Objective-C
@import FirebaseCore; @import FirebaseFirestore; @import FirebaseAuth; // ...
- يمكنك ضبط مثيل مشترَك لملف
FirebaseApp
في طريقةapplication(_:didFinishLaunchingWithOptions:)
لمفوّض التطبيق باتّباع الخطوات التالية:SwiftUI
// Use Firebase library to configure APIs FirebaseApp.configure()
Swift
// Use Firebase library to configure APIs FirebaseApp.configure()
Objective-C
// Use Firebase library to configure APIs [FIRApp configure];
- إذا كنت تستخدم SwiftUI، عليك إنشاء عنصر نائب للتطبيق وإرفاقه
ببنية
App
من خلالUIApplicationDelegateAdaptor
أوNSApplicationDelegateAdaptor
. عليك أيضًا إيقاف عملية تبديل مفوّض التطبيق. لمزيد من المعلومات، يمكنك الاطّلاع على تعليمات SwiftUI.SwiftUI
@main struct YourApp: App { // register app delegate for Firebase setup @UIApplicationDelegateAdaptor(AppDelegate.self) var delegate var body: some Scene { WindowGroup { NavigationView { ContentView() } } } }
(اختياري) إيقاف تسجيل عملية تحديد المصدر في شبكة Apple الإعلانية
لتسهيل الأمر عليك، تعمل حزمة تطوير البرامج (SDK) تلقائيًا على
تسجيل
تطبيقك لدى Apple لتحديد مصدر الشبكة الإعلانية باستخدام
SKAdNetwork.
إذا أردت إيقاف هذه الميزة، اضبط قيمة
GOOGLE_ANALYTICS_REGISTRATION_WITH_AD_NETWORK_ENABLED
على NO
(منطقية) فيملف
info.plist الخاص بتطبيقك.
بدء تسجيل الأحداث
بعد ضبط مثيل FirebaseApp
، يمكنك البدء في تسجيل
الأحداث باستخدام الأسلوب
logEvent()
.
يُنصَح باستخدام أحداث معيّنة في جميع التطبيقات، ويُنصَح باستخدام أحداث أخرى لأنواع أنشطة تجارية أو قطاعات معيّنة. يجب إرسال الأحداث المقترَحة مع المَعلمات المخصَّصة لها، لضمان توفير أقصى قدر ممكن من التفاصيل في تقاريرك والاستفادة من الميزات وعمليات الدمج المستقبلية عند توفّرها. يوضّح هذا القسم تسجيل حدث محدد مسبقًا. لمزيد من المعلومات عن تسجيل الأحداث، يُرجى الاطّلاع على تسجيل الأحداث.
يوضّح المثال التالي كيفية تسجيل حدث مقترَح للإشارة إلى أنّه قد نقر المستخدِم على عنصر معيّن في تطبيقك:
Swift
Analytics.logEvent(AnalyticsEventSelectContent, parameters: [ AnalyticsParameterItemID: "id-\(title!)", AnalyticsParameterItemName: title!, AnalyticsParameterContentType: "cont", ])
Objective-C
[FIRAnalytics logEventWithName:kFIREventSelectContent parameters:@{ kFIRParameterItemID:[NSString stringWithFormat:@"id-%@", self.title], kFIRParameterItemName:self.title, kFIRParameterContentType:@"image" }];
لعرض هذا الحدث في وحدة تحكّم تصحيح الأخطاء في Xcode، فعِّل تصحيح أخطاء "إحصاءات Google":
- في Xcode، اختَر المنتج > المخطّط > تعديل المخطّط...
- انقر على تشغيل من القائمة اليمنى.
- اختَر علامة التبويب الوسيطات.
- في قسم المَعلمات التي تم تمريرها عند الإطلاق، أضِف
-FIRAnalyticsDebugEnabled
.
الخطوات التالية
- فهم كل تقرير من تقارير "إحصاءات Google"
- استخدِم DebugView للتحقّق من أحداثك.
- استكشِف بياناتك في وحدة تحكّم Firebase.
- اطّلِع على الأدلة حول الأحداث و خصائص المستخدِمين.
- تعرَّف على كيفية تصدير بياناتك إلى BigQuery.