بدء استخدام "إحصاءات 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 إلى مشروعك لتفعيل ميزات إضافية مثل تحديد شرائح الجمهور وتحديد مصدر الحملات

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

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

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

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

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

  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، اختَر المنتج >. المخطط > تعديل المخطّط...
  2. اختَر تشغيل من القائمة اليمنى.
  3. اختَر علامة التبويب الوسيطات.
  4. في قسم الوسيطات التي تم تمريرها عند الإطلاق، أضف -FIRAnalyticsDebugEnabled

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