استخدم Google Analytics للحصول على مقاييس لتقارير الأعطال

Google Analytics هو محرك التحليلات الخاص بـ Firebase. عند استخدام Analytics وCrashlytics معًا في تطبيقك، فإنك تحصل على ميزات تساعدك في إنتاج المشكلات وتتبع بيانات الأعطال بمزيد من الدقة، مثل المستخدمين الذين لا يعانون من الأعطال، ومسارات التنقل التي تتعقب أحداث معينة قبل الأعطال، وBigQuery، حيث يمكنك تصور المقاييس الرئيسية لتطبيقك.

يصف هذا الدليل كيفية إضافة Analytics إلى تطبيق تم إعداد Crashlytics عليه (إذا لم تكن قد قمت بذلك بالفعل، فأضف Crashlytics إلى تطبيقك ).

الخطوة 1: إضافة ملف تكوين Firebase

  1. افتح إعدادات المشروع الخاص بك. في بطاقة تطبيقاتك ، حدد معرف حزمة التطبيق الذي تحتاج إلى ملف تكوين له.

  2. انقر فوق Download GoogleService-Info.plist للحصول على ملف تكوين منصات Firebase Apple ( GoogleService-Info.plist ).

  3. انقل ملف التكوين الخاص بك إلى جذر مشروع Xcode الخاص بك. إذا طُلب منك ذلك، حدد إضافة ملف التكوين إلى جميع الأهداف.

إذا كان لديك معرفات حزمة متعددة في مشروعك، فيجب عليك ربط كل معرف حزمة بتطبيق مسجل في وحدة تحكم Firebase حتى يتمكن كل تطبيق من الحصول على ملف GoogleService-Info.plist الخاص به.

الخطوة 2: أضف Analytics SDK إلى تطبيقك

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

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

بعد ذلك، قم بتكوين وحدة Firebase:

  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()
      }
    }
  }
}

تم الآن إعداد تطبيقك لاستخدام Google Analytics.

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