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

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

تجمع Google Analytics بيانات الاستخدام والسلوك لتطبيقك. تسجِّل حزمة SDK نوعَين أساسيَين من المعلومات:

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

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

قبل البدء

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

عند تفعيل Google Analytics في مشروعك، يتم ربط تطبيقات Firebase بمصادر بيانات Google Analytics.
(إجراء مقترَح) أضِف إطار عمل AdSupport إلى مشروعك لتفعيل ميزات إضافية، مثل شرائح الجمهور وتحديد مصدر الحملات.

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

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

في Xcode، مع فتح مشروع تطبيقك، انتقِل إلى ملف > إضافة حِزم.
أضِف مستودع حزمة تطوير البرامج (SDK) لمنصّات Apple من Firebase عندما يُطلب منك ذلك:

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

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

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

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

استورِد وحدة 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;
// ...

يمكنك ضبط مثيل مشترَك لملف 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];
```
إذا كنت تستخدم 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":

في Xcode، انقر على المنتج (Product) > المخطّط (Scheme) > تعديل المخطّط… (Edit scheme…‎).
انقر على تشغيل من القائمة اليمنى.
انقر على علامة التبويب الوسيطات.
في قسم المَعلمات التي تم ضبطها عند الإطلاق (Arguments Passed On Launch)، أضِف -FIRAnalyticsDebugEnabled.

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

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