بدء استخدام "إحصاءات Google" لنظام التشغيل iOS+

اختيار النظام الأساسي:

iOS+ Android Web Flutter Unity C++

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

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

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

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

قبل البدء

1. أضِف Firebase إلى مشروع Apple الخاص بك، في حال لم يسبق لك إجراء ذلك، وتأكَّد من تفعيل Google Analytics في مشروع Firebase:

   • إذا كنت بصدد إنشاء مشروع جديد في Firebase، فعِّل Google Analytics أثناء خطوات إنشاء المشروع.

   • إذا كنت تستخدم مشروعًا حاليًا في Firebase لم يتم تفعيل Google Analytics فيه، يمكنك تفعيله في الإعدادات > عمليات الدمج علامة التبويب.

   عند تفعيل Google Analytics في مشروعك، يتم ربط تطبيقاتك في Firebase بمصادر بيانات Google Analytics.

2. (يُفضَّل) أضِف إطار عمل AdSupport إلى مشروعك لتفعيل ميزات إضافية، مثل شرائح الجمهور وتحديد المصدر في الحملات.

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

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

انتقِل إلى دليل التثبيت للتعرّف على الطرق المختلفة التي يمكنك من خلالها إضافة حزم تطوير البرامج (SDK) من Firebase إلى مشروع Apple.

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

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

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

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

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

1. استورِد الو0/ الوحدة في101 1/، بالإضافة إلى أي101 2وحدات Firebase3/ أخرى يستخدمها مفوّض تطبيقك.FirebaseCoreUIApplicationDelegate على سبيل المثال، لاستخدام 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;
   // ...
         

2. اضبط مثيلاً مشتركًا في طريقة application(_:didFinishLaunchingWithOptions:) لمفوّض تطبيقك:FirebaseApp

   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];

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

إذا كنت تتتبّع عمليات الشراء داخل التطبيق، عليك تهيئة مراقب المعاملات في application:didFinishLaunchingWithOptions: قبل تهيئة Firebase، وإلا قد لا يتلقّى المراقب جميع إشعارات الشراء. لمزيد من المعلومات، راجِع أفضل الممارسات المتعلّقة بعمليات الشراء داخل التطبيق من Apple.

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

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

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

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

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

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

Swift

Analytics.logEvent("share_image", parameters: [
  "name": name,
  "full_text": text,
])
MigratedSnippets.swift

Objective-C

[FIRAnalytics logEventWithName:@"share_image"
                    parameters:@{
                                 @"name": name,
                                 @"full_text": text
                                 }];
ObjCMigratedSnippets.m

لعرض هذا الحدث في وحدة تحكّم تصحيح الأخطاء في Xcode، فعِّل تصحيح الأخطاء في "إحصاءات Google":

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

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

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