ابدأ مع Google Analytics

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

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

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

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

قبل ان تبدأ

  1. إذا كنت لم تقم بذلك بالفعل، إضافة إلى مشروع Firebase أبل الخاص بك وتأكد من أن يتم تمكين في Google Analytics مشروع Firebase الخاص بك:

    • إذا كنت تنشئ مشروع Firebase جديدًا ، فقم بتمكين Google Analytics أثناء سير عمل إنشاء المشروع.

    • إذا كنت تستخدم مشروع Firebase القائمة ليس لديها تمكين جوجل تحليلات، انتقل إلى التكاملات التبويب الخاص بك > إعدادات مشروع لتمكينه.

When you enable Google Analytics in your project, your Firebase apps
are linked to Google Analytics data streams.
  1. (مستحسن). إضافة إطار AdSupport لمشروعك لتمكين ميزات إضافية مثل الجماهير وإسناد الحملة.

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

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

  1. في كسكودي، مع مشروع التطبيق فتح، انتقل إلى ملف> حزم سويفت> إضافة حزمة التبعية.
  2. عند المطالبة ، قم بإضافة مستودع SDK لأنظمة Firebase Apple الأساسية:
  3.   https://github.com/firebase/firebase-ios-sdk
      
  4. اختر مكتبة التحليلات.
  5. للحصول على تجربة الأمثل مع تحليلات، نوصي تمكين تحليلات جوجل في مشروع Firebase وإضافة SDK Firebase ل Google Analytics أن التطبيق الخاص بك. يمكنك تحديد المكتبة بدون مجموعة IDFA أو مع مجموعة IDFA.
  6. عند الانتهاء ، سيبدأ Xcode تلقائيًا في حل وتنزيل التبعيات الخاصة بك في الخلفية.

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

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

  1. استيراد وحدة Firebase في حياتك UIApplicationDelegate :

    سويفت

    import Firebase

    ج موضوعية

    @import Firebase;
  2. تكوين ل FirebaseApp المشتركة المثال، عادة في التطبيق الخاص بك application:didFinishLaunchingWithOptions: الأسلوب:

    سويفت

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

    ج موضوعية

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


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

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

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

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

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

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

سويفت

ملاحظة: هذا المنتج Firebase لا يتوفر على الهدف ماك.
Analytics.logEvent(AnalyticsEventSelectContent, parameters: [
  AnalyticsParameterItemID: "id-\(title!)",
  AnalyticsParameterItemName: title!,
  AnalyticsParameterContentType: "cont",
])

ج موضوعية

ملاحظة: هذا المنتج Firebase لا يتوفر على الهدف ماك.
[FIRAnalytics logEventWithName:kFIREventSelectContent
                    parameters:@{
                                 kFIRParameterItemID:[NSString stringWithFormat:@"id-%@", self.title],
                                 kFIRParameterItemName:self.title,
                                 kFIRParameterContentType:@"image"
                                 }];

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

  1. في كسكودي، حدد المنتج> برنامج <تعديل نظام ...
  2. حدد تشغيل من القائمة اليسرى.
  3. حدد علامة التبويب الحجج.
  4. في الحجج مرت في قسم التشغيل، إضافة -FIRAnalyticsDebugEnabled .

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