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

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

تجمع "إحصاءات Google" بيانات الاستخدام والسلوك لتطبيقك، وتسجِّل نوعين أساسيين من المعلومات:

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

تسجِّل "إحصاءات Google" تلقائيًا بعض الأحداث وخصائص المستخدمين، ولن تحتاج إلى إضافة أي رمز لتفعيلها.

قبل البدء

  1. أضِف Firebase إلى مشروع Apple إذا لم يسبق لك ذلك، وتأكَّد من تفعيل "إحصاءات Google" في مشروع Firebase:

    • إذا كنت بصدد إنشاء مشروع جديد على Firebase، فعِّل "إحصاءات Google" أثناء سير عمل إنشاء المشروع.

    • في حال استخدام مشروع حالي على Firebase لم يتم تفعيل "إحصاءات Google" عليه، انتقِل إلى علامة تبويب عمليات الدمج ضمن > إعدادات المشروع لتفعيله.

    عند تفعيل "إحصاءات Google" في مشروعك، يتم ربط تطبيقات Firebase بمصادر بيانات "إحصاءات Google".

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

إضافة حزمة تطوير البرامج (SDK) لخدمة "إحصاءات Google" إلى تطبيقك

يمكنك استخدام "مدير حزم Swift" لتثبيت اعتماديات Firebase وإدارتها.

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

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

بعد ذلك، نفِّذ بعض خطوات الضبط:

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

    واجهة المستخدم

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

    Swift

    import FirebaseCore
import FirebaseFirestore
import FirebaseAuth
// ...

    Objective-C

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

    واجهة المستخدم

    // 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];
  3. إذا كنت تستخدم SwiftUI، عليك إنشاء تفويض تطبيق وإرفاقه ببنية App من خلال UIApplicationDelegateAdaptor أو NSApplicationDelegateAdaptor. ويجب أيضًا إيقاف إيماءة تفويض التطبيق. لمزيد من المعلومات، راجِع تعليمات 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

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

Objective-C

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

لعرض هذا الحدث في وحدة تحكم تصحيح الأخطاء في Xcode، فعِّل تصحيح الأخطاء في "إحصاءات Google":

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

الخطوات اللاحقة