تمت ترجمة هذه الصفحة بواسطة Cloud Translation API‏.

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

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

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

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

افتح إعدادات المشروع. في بطاقة التطبيقات الخاصة بك ، حدد معرّف حزمة التطبيق الذي تحتاج إلى ملف التكوين الخاص به.
انقر فوق تنزيل GoogleService-Info.plist للحصول على ملف تهيئة أنظمة تشغيل Firebase Apple ( GoogleService-Info.plist ).
- يمكنك تنزيل ملف تهيئة منصات Firebase Apple مرة أخرى في أي وقت.
- تأكد من عدم إلحاق اسم ملف التكوين بأحرف إضافية ، مثل (2) .
انقل ملف التكوين الخاص بك إلى جذر مشروع Xcode الخاص بك. إذا طُلب منك ذلك ، فحدد لإضافة ملف التكوين إلى جميع الأهداف.

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

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

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

في Xcode ، مع فتح مشروع التطبيق الخاص بك ، انتقل إلى File> Swift Packages> Add Package Dependency .
عند المطالبة ، أضف مستودع SDK لأنظمة Apple الأساسية لـ Firebase:

  https://github.com/firebase/firebase-ios-sdk

أضف Firebase SDK لـ Google Analytics ، وحدد إما المكتبة التي تحتوي على مجموعة IDFA أو المكتبة بدونها.
عند الانتهاء ، سيبدأ Xcode تلقائيًا في حل وتنزيل التبعيات الخاصة بك في الخلفية.

بعد ذلك ، هيئ وحدة Firebase:

قم باستيراد وحدة FirebaseCore في مندوب UIApplicationDelegate ، بالإضافة إلى أي وحدات Firebase أخرى يستخدمها مفوض التطبيق. على سبيل المثال ، لاستخدام Cloud Firestore والمصادقة:
SwiftUI
```
import SwiftUI
import FirebaseCore
import FirebaseFirestore
import FirebaseAuth
// ...
      
```
سويفت
```
import FirebaseCore
import FirebaseFirestore
import FirebaseAuth
// ...
      
```
ج موضوعية
```
@import FirebaseCore;
@import FirebaseFirestore;
@import FirebaseAuth;
// ...
      
```

قم بتهيئة مثيل FirebaseApp مشترك في application(_:didFinishLaunchingWithOptions:) :

SwiftUI

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

سويفت

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

ج موضوعية

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

إذا كنت تستخدم 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()
      }
    }
  }
}
      
```

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

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

استخدم DebugView للتحقق من الأحداث الخاصة بك.
استكشف بياناتك في وحدة تحكم Firebase.
استكشف أدلة الأحداث وخصائص المستخدم.
تعرّف على كيفية تصدير بياناتك إلى BigQuery.