Firebase is back at Google I/O on May 10! Register now

استخدم Google Analytics للحصول على مقاييس لتقارير الأعطال

تنظيم صفحاتك في مجموعات يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.

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

يصف هذا الدليل كيفية إضافة Analytics إلى تطبيق تم إعداد Crashlytics فيه (إذا لم تكن قد قمت بذلك بالفعل ، فأضف Crashlytics إلى تطبيقك ).

الخطوة 1: أضف ملف تكوين Firebase

  1. أضف ملف تهيئة Firebase Android إلى تطبيقك:

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

    2. انقر فوق تنزيل google-services.json للحصول على ملف تهيئة Firebase Android ( google-services.json ).

      • يمكنك تنزيل ملف تهيئة Firebase Android مرة أخرى في أي وقت.
      • تأكد من عدم إلحاق ملف التكوين بأحرف إضافية ، مثل (2) .
    3. انقل ملف التكوين الخاص بك إلى دليل الوحدة النمطية (مستوى التطبيق) لتطبيقك.

  2. لتمكين منتجات Firebase في تطبيقك ، أضف المكوِّن الإضافي لخدمات google إلى ملفات Gradle.

    1. في ملف Gradle على مستوى الجذر (على مستوى المشروع) ( build.gradle ) ، أضف قواعد لتضمين المكوّن الإضافي Google Services Gradle. تأكد من أن لديك مستودع Google Maven أيضًا.

      buildscript {
      
        repositories {
          // Check that you have the following line (if not, add it):
          google()  // Google's Maven repository
        }
      
        dependencies {
          // ...
      
          // Add the following line:
          classpath 'com.google.gms:google-services:4.3.15'  // Google Services plugin
        }
      }
      
      allprojects {
        // ...
      
        repositories {
          // Check that you have the following line (if not, add it):
          google()  // Google's Maven repository
          // ...
        }
      }
      
    2. في ملف Gradle الخاص بالوحدة (على مستوى التطبيق) (عادةً app/build.gradle ) ، قم بتطبيق مكون Google Services Gradle الإضافي.

      apply plugin: 'com.android.application'
      // Add the following line:
      apply plugin: 'com.google.gms.google-services'  // Google Services plugin
      
      android {
        // ...
      }
      

الخطوة 2: أضف Analytics SDK إلى تطبيقك

  1. في ملف Gradle (على مستوى التطبيق) الوحدة النمطية الخاصة بك (عادةً <project>/<app-module>/build.gradle ) ، أضف التبعية لمكتبة Analytics Android. نوصي باستخدام Firebase Android BoM للتحكم في إصدارات المكتبة.

    Kotlin+KTX

    dependencies {
        // Import the BoM for the Firebase platform
        implementation platform('com.google.firebase:firebase-bom:31.2.3')
    
        // Add the dependency for the Analytics library
        // When using the BoM, you don't specify versions in Firebase library dependencies
        implementation 'com.google.firebase:firebase-analytics-ktx'
    }
    

    باستخدام Firebase Android BoM ، سيستخدم تطبيقك دائمًا إصدارات متوافقة من مكتبات Firebase Android.

    (بديل) أضف تبعيات مكتبة Firebase بدون استخدام BoM

    إذا اخترت عدم استخدام Firebase BoM ، فيجب عليك تحديد كل إصدار من إصدارات مكتبة Firebase في سطر التبعية الخاص بها.

    لاحظ أنه إذا كنت تستخدم مكتبات Firebase متعددة في تطبيقك ، فإننا نوصي بشدة باستخدام BoM لإدارة إصدارات المكتبة ، مما يضمن توافق جميع الإصدارات.

    dependencies {
        // Add the dependency for the Analytics library
        // When NOT using the BoM, you must specify versions in Firebase library dependencies
        implementation 'com.google.firebase:firebase-analytics-ktx:21.2.0'
    }
    

    Java

    dependencies {
        // Import the BoM for the Firebase platform
        implementation platform('com.google.firebase:firebase-bom:31.2.3')
    
        // Add the dependency for the Analytics library
        // When using the BoM, you don't specify versions in Firebase library dependencies
        implementation 'com.google.firebase:firebase-analytics'
    }
    

    باستخدام Firebase Android BoM ، سيستخدم تطبيقك دائمًا إصدارات متوافقة من مكتبات Firebase Android.

    (بديل) أضف تبعيات مكتبة Firebase بدون استخدام BoM

    إذا اخترت عدم استخدام Firebase BoM ، فيجب عليك تحديد كل إصدار من إصدارات مكتبة Firebase في سطر التبعية الخاص بها.

    لاحظ أنه إذا كنت تستخدم مكتبات Firebase متعددة في تطبيقك ، فإننا نوصي بشدة باستخدام BoM لإدارة إصدارات المكتبة ، مما يضمن توافق جميع الإصدارات.

    dependencies {
        // Add the dependency for the Analytics library
        // When NOT using the BoM, you must specify versions in Firebase library dependencies
        implementation 'com.google.firebase:firebase-analytics:21.2.0'
    }
    

  2. قم بتعريف كائن com.google.firebase.analytics.FirebaseAnalytics أعلى نشاطك:

    Kotlin+KTX

    private lateinit var firebaseAnalytics: FirebaseAnalytics

    Java

    private FirebaseAnalytics mFirebaseAnalytics;
  3. قم بتهيئته في طريقة onCreate() :

    Kotlin+KTX

    // Obtain the FirebaseAnalytics instance.
    firebaseAnalytics = Firebase.analytics

    Java

    // Obtain the FirebaseAnalytics instance.
    mFirebaseAnalytics = FirebaseAnalytics.getInstance(this);

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