بدء استخدام "إحصاءات Google"

توضح لك هذه البداية السريعة كيفية إضافة Google Analytics إلى تطبيقك والبدء في تسجيل الأحداث.

يجمع Google Analytics بيانات الاستخدام والسلوك لتطبيقك. تسجل SDK نوعين أساسيين من المعلومات:

  • الأحداث: ما يحدث في تطبيقك، مثل إجراءات المستخدم أو أحداث النظام أو الأخطاء.
  • خصائص المستخدم: السمات التي تحددها لوصف شرائح قاعدة المستخدمين الخاصة بك، مثل تفضيلات اللغة أو الموقع الجغرافي.

يقوم Analytics تلقائيًا بتسجيل بعض الأحداث وخصائص المستخدم ؛ لا تحتاج إلى إضافة أي رمز لتمكينها.

قبل ان تبدأ

  1. إذا لم تكن قد قمت بذلك بالفعل، فأضف Firebase إلى مشروع Apple الخاص بك وتأكد من تمكين Google Analytics في مشروع Firebase الخاص بك:

    • إذا كنت تقوم بإنشاء مشروع Firebase جديد، فقم بتمكين Google Analytics أثناء سير عمل إنشاء المشروع.

    • إذا كنت تستخدم مشروعًا موجودًا في Firebase لم يتم تمكين Google Analytics فيه، فانتقل إلى علامة التبويب عمليات التكامل في > إعدادات المشروع لتمكينه.

    عند تمكين Google Analytics في مشروعك، يتم ربط تطبيقات Firebase بمصادر بيانات Google Analytics.

  2. (مُستَحسَن) . أضف إطار عمل AdSupport إلى مشروعك لتمكين ميزات إضافية مثل الجماهير وإحالة الحملة.

أضف Analytics SDK إلى تطبيقك

استخدم Swift Package Manager لتثبيت تبعيات Firebase وإدارتها.

  1. في Xcode، مع فتح مشروع التطبيق الخاص بك، انتقل إلى File > Add Packages .
  2. عندما يُطلب منك ذلك، قم بإضافة مستودع Firebase Apple الأساسي لـ SDK:
    3.   https://github.com/firebase/firebase-ios-sdk.git
  3. اختر مكتبة التحليلات.
  4. أضف علامة -ObjC إلى قسم إشارات الرابط الأخرى في إعدادات إنشاء هدفك.
  5. للحصول على تجربة مثالية مع Analytics، نوصي بتمكين Google Analytics في مشروع Firebase الخاص بك وإضافة Firebase SDK لـ Google Analytics إلى تطبيقك. يمكنك تحديد المكتبة بدون مجموعة IDFA أو مع مجموعة IDFA.
  6. عند الانتهاء، سيبدأ Xcode تلقائيًا في حل وتنزيل تبعياتك في الخلفية.

تعرّف على المزيد حول IDFA، معرّف الإعلانات على مستوى الجهاز، في وثائق خصوصية المستخدم واستخدام البيانات وشفافية تتبع التطبيقات من Apple.

بعد ذلك، قم بتنفيذ بعض خطوات التكوين:

  1. قم باستيراد وحدة FirebaseCore في UIApplicationDelegate ، بالإضافة إلى أي وحدات Firebase أخرى يستخدمها مندوب تطبيقك. على سبيل المثال، لاستخدام Cloud Firestore والمصادقة:

    سويفتويي

    import SwiftUI
import FirebaseCore
import FirebaseFirestore
import FirebaseAuth
// ...

    سويفت

    import FirebaseCore
import FirebaseFirestore
import FirebaseAuth
// ...

    ج موضوعية

    @import FirebaseCore;
@import FirebaseFirestore;
@import FirebaseAuth;
// ...
  2. قم بتكوين مثيل FirebaseApp مشترك في طريقة application(_:didFinishLaunchingWithOptions:) :

    سويفتويي

    // Use Firebase library to configure APIs
FirebaseApp.configure()

    سويفت

    // Use Firebase library to configure APIs
FirebaseApp.configure()

    ج موضوعية

    // Use Firebase library to configure APIs
[FIRApp configure];
  3. إذا كنت تستخدم SwiftUI، فيجب عليك إنشاء مفوض تطبيق وإرفاقه ببنية App الخاص بك عبر UIApplicationDelegateAdaptor أو NSApplicationDelegateAdaptor . يجب عليك أيضًا تعطيل swizzling مندوب التطبيق. لمزيد من المعلومات، راجع تعليمات 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() .

يوصى بأحداث معينة لجميع التطبيقات ؛ يوصى باستخدام البعض الآخر لأنواع أعمال أو قطاعات محددة. يجب عليك إرسال الأحداث المقترحة مع المعلمات المحددة لها، لضمان أقصى قدر من التفاصيل المتاحة في تقاريرك وللاستفادة من الميزات وعمليات التكامل المستقبلية عندما تصبح متاحة. يوضح هذا القسم تسجيل حدث محدد مسبقًا، لمزيد من المعلومات حول تسجيل الأحداث، راجع أحداث السجل .

يوضح المثال التالي كيفية تسجيل حدث موصى به للإشارة إلى قيام المستخدم بالنقر فوق عنصر معين في تطبيقك:

سويفت

ملاحظة: منتج Firebase هذا غير متوفر على هدف macOS.
Analytics.logEvent(AnalyticsEventSelectContent, parameters: [
  AnalyticsParameterItemID: "id-\(title!)",
  AnalyticsParameterItemName: title!,
  AnalyticsParameterContentType: "cont",
])
ViewController.swift

ج موضوعية

ملاحظة: منتج Firebase هذا غير متوفر على هدف macOS.
[FIRAnalytics logEventWithName:kFIREventSelectContent
                    parameters:@{
                                 kFIRParameterItemID:[NSString stringWithFormat:@"id-%@", self.title],
                                 kFIRParameterItemName:self.title,
                                 kFIRParameterContentType:@"image"
                                 }];
ViewController.m

لعرض هذا الحدث في وحدة تحكم تصحيح أخطاء Xcode، قم بتمكين تصحيح أخطاء Analytics:

  1. في Xcode، حدد المنتج > المخطط > تحرير المخطط...
  2. حدد تشغيل من القائمة اليسرى.
  3. حدد علامة التبويب الحجج.
  4. في قسم الوسائط التي تم تمريرها عند التشغيل ، أضف -FIRAnalyticsDebugEnabled .

الخطوات التالية