Check out what’s new from Firebase@ Google I/O 2021, and join our alpha program for early access to the new Remote Config personalization feature. Learn more

ابدأ مع Google Analytics

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

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

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

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

قبل ان تبدأ

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

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

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

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

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

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

  1. أضف تبعية Firebase إلى Podfile:
    pod 'Firebase/Analytics'
    
    # For Analytics without IDFA collection capability, use this pod instead
    # pod ‘Firebase/AnalyticsWithoutAdIdSupport’
    
    تعرف على المزيد حول IDFA ، معرف الإعلان على مستوى الجهاز ، في وثائق خصوصية مستخدم Apple واستخدام البيانات وشفافية تتبع التطبيقات .
  2. قم بتشغيل pod install وافتح ملف .xcworkspace تم إنشاؤه.
  3. استيراد وحدة Firebase في UIApplicationDelegate :

    سويفت

    import Firebase

    ج موضوعية

    @import Firebase;
  4. قم FirebaseApp مثيل FirebaseApp المشترك ، عادةً في تطبيق تطبيقك application:didFinishLaunchingWithOptions: method:

    سويفت

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

    ج موضوعية

    // Use Firebase library to configure APIs
    [FIRApp configure];


(اختياري) قم بتعطيل تسجيل إحالة شبكة إعلانات Apple

من أجل راحتك ، تسجل SDK تطبيقك تلقائيًا مع Apple لإحالة شبكة الإعلانات باستخدام SKAdNetwork . إذا كنت ترغب في تعطيل هذه الميزة ، فقم بتعيين قيمة GOOGLE_ANALYTICS_REGISTRATION_WITH_AD_NETWORK_ENABLED إلى NO (منطقي) في ملف info.plist الخاص بتطبيقك.

بدء تسجيل الأحداث

بعد تكوين مثيل FirebaseApp ، يمكنك البدء في تسجيل الأحداث باستخدام طريقة logEvent() .

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

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

سويفت

Analytics.logEvent(AnalyticsEventSelectContent, parameters: [
  AnalyticsParameterItemID: "id-\(title!)",
  AnalyticsParameterItemName: title!,
  AnalyticsParameterContentType: "cont"
  ])

ج موضوعية

[FIRAnalytics logEventWithName:kFIREventSelectContent
                    parameters:@{
                                 kFIRParameterItemID:[NSString stringWithFormat:@"id-%@", self.title],
                                 kFIRParameterItemName:self.title,
                                 kFIRParameterContentType:@"image"
                                 }];

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

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

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