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

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

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

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

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

قبل ان تبدأ

إذا لم تكن قد قمت بذلك بالفعل ، فأضف Firebase إلى مشروع Apple الخاص بك وتأكد من تمكين Google Analytics في مشروع Firebase الخاص بك:
- إذا كنت تنشئ مشروع Firebase جديدًا ، فقم بتمكين Google Analytics أثناء سير عمل إنشاء المشروع.
- إذا كنت تستخدم مشروع Firebase حالي لم يتم تمكين Google Analytics فيه ، فانتقل إلى علامة التبويب "التكامل" في > إعدادات المشروع لتمكينه.
تحذير: يجب ترقية أي مشروع Firebase تم إنشاؤه قبل 31 تموز (يوليو) 2019 إلى تجربة Google Analytics 4 الكاملة إذا لم يكن قد تم إنشاؤه بالفعل. (تُعرض اللافتات في لوحة معلومات Analytics إذا كانت الترقية مطلوبة.) يجب قبول شروط الخدمة المرتبطة بحلول 15 فبراير 2022 لضمان استمرار جمع البيانات. راجع الأسئلة المتداولة حول الدعم حول الترقية للحصول على مساعدة في العثور على مالكي المشروع .
عند تمكين Google Analytics في مشروعك ، يتم ربط تطبيقات Firebase بتدفقات بيانات Google Analytics.
(موصى به) . أضف إطار عمل AdSupport إلى مشروعك لتمكين ميزات إضافية مثل الجماهير وإحالة الحملة.

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

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

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

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

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

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

بعد ذلك ، قم بتنفيذ بعض خطوات التكوين:

قم باستيراد وحدة 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()
      }
    }
  }
}
      
```

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

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

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

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

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

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

سويفت

ملاحظة: منتج Firebase هذا غير متوفر على هدف macOS.

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

ج موضوعية

ملاحظة: منتج Firebase هذا غير متوفر على هدف macOS.

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

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

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

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

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