توضّح لك هذه البداية السريعة كيفية إضافة "إحصاءات Google" إلى تطبيقك لبدء تسجيل الأحداث.
تجمع "إحصاءات Google" بيانات الاستخدام والسلوك لتطبيقك. حزمة SDK لتسجيل نوعين أساسيين من المعلومات وهما:
- الأحداث: ما يحدث في تطبيقك، مثل إجراءات المستخدم والنظام. أو الأحداث أو الأخطاء.
- خصائص المستخدِمين: السمات التي تحدِّدها لوصف شرائح نشاطك التجاري لقاعدة المستخدمين، مثل الإعدادات المفضّلة للغة أو الموقع الجغرافي
تسجِّل "إحصاءات Google" بعض البيانات تلقائيًا الفعاليات خصائص المستخدِمين ولا تحتاج إلى إضافة أي رمز لتفعيلها.
قبل البدء
أضِف Firebase إلى مشروع Apple إذا لم يسبق لك إجراء ذلك. والتأكّد من تفعيل "إحصاءات Google" في Firebase المشروع:
إذا كنت بصدد إنشاء مشروع جديد على Firebase، فعِّل "إحصاءات Google". أثناء سير عمل إنشاء المشروع.
إذا كنت تستخدم مشروعًا حاليًا في Firebase لا يحتوي على في "إحصاءات Google"، انتقل إلى عمليات الدمج علامة التبويب في
لتفعيلها. > إعدادات المشروع
عند تفعيل "إحصاءات Google" في مشروعك، ستتحول تطبيقات Firebase إلى ترتبط بمصادر بيانات "إحصاءات Google"
(موصى به). أضِف إطار عمل AdSupport إلى مشروعك لتفعيل ميزات إضافية مثل تحديد شرائح الجمهور وتحديد مصدر الحملات
إضافة حزمة تطوير البرامج (SDK) لخدمة "إحصاءات Google" إلى تطبيقك
يمكنك استخدام "مدير حزم Swift" لتثبيت اعتماديات Firebase وإدارتها.
- في Xcode، انتقِل إلى File (ملف) > بعد فتح مشروع التطبيق الخاص بك. إضافة حِزم
- أضِف مستودع حزمة تطوير البرامج (SDK) لمنصّات Firebase Apple عندما يُطلب منك ذلك:
- اختَر مكتبة "إحصاءات Google".
- أضِف العلامة
-ObjC
إلى القسم علامات الروابط الأخرى في إعدادات إصدار هدفك. - للحصول على أفضل تجربة في "إحصاءات Google"، ننصح تفعيل "إحصاءات Google" في مشروعك على Firebase وإضافة حزمة تطوير البرامج (SDK) لمنصّة Firebase الخاصة بخدمة "إحصاءات Google" إلى تطبيقك. يمكنك اختيار إما المكتبة التي لا تتضمن جمع معرّف المعلِنين (IDFA) أو من خلال جمع معرّف المعلِنين (IDFA).
- عند الانتهاء، سيبدأ Xcode تلقائيًا في حل وتنزيل ملف والتبعيات في الخلفية.
https://github.com/firebase/firebase-ios-sdk.git
اطّلِع على مزيد من المعلومات عن معرّف المعلِنين (IDFA)، وهو معرِّف الإعلانات على مستوى الجهاز، في خصوصية المستخدم واستخدام البيانات أو شفافية تتبُّع التطبيقات التوثيق.
بعد ذلك، نفِّذ بعض خطوات الضبط:
- استيراد وحدة
FirebaseCore
فيUIApplicationDelegate
بالإضافة إلى أي تطبيق آخر وحدات Firebase التي يستخدمها تطبيقك المفوَّض على سبيل المثال، لاستخدام Cloud Firestore والمصادقة: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.