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


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

تجمع حزمة تطوير البرامج (SDK) الخاصة بـ Google Analytics بيانات الاستخدام والسلوك لتطبيقك. وتسجّل حزمة تطوير البرامج (SDK) نوعَين أساسيَّين من المعلومات:

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

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

قبل البدء

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

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

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

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

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

إضافة حزمة تطوير البرامج (SDK) Analytics إلى تطبيقك

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

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

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

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

  1. استورِد الوحدة 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;
// ...
  2. اضبط مثيلاً مشتركًا 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];
  3. إذا كنت تستخدم 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

ملاحظة: لا يتوفّر منتج 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، انقر على المنتج (Product) > المخطّط (Scheme) > تعديل المخطّط… (Edit scheme…‎).
  2. انقر على تشغيل (Run) من القائمة اليمنى.
  3. انقر على علامة التبويب الوسيطات (Arguments).
  4. في قسم المَعلمات التي تم ضبطها عند الإطلاق (Arguments Passed On Launch)، أضِف -FIRAnalyticsDebugEnabled.

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