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

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

تجمع "إحصاءات Google" بيانات الاستخدام والسلوك لتطبيقك. حزمة SDK لتسجيل نوعين أساسيين من المعلومات وهما:

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

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

قبل البدء

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

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

إضافة حزمة تطوير البرامج (SDK) لخدمة "إحصاءات Google" إلى تطبيقك

يمكنك استخدام "مدير حزم Swift" لتثبيت اعتماديات Firebase وإدارتها.

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

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

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

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

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

استيراد وحدة FirebaseCore في UIApplicationDelegate بالإضافة إلى أي تطبيق آخر وحدات Firebase التي يستخدمها تطبيقك المفوَّض على سبيل المثال، لاستخدام Cloud Firestore والمصادقة:
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، اختَر المنتج >. المخطط > تعديل المخطّط...
اختَر تشغيل من القائمة اليمنى.
اختَر علامة التبويب الوسيطات.
في قسم الوسيطات التي تم تمريرها عند الإطلاق، أضف -FIRAnalyticsDebugEnabled

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

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