Google Analytics هو محرك التحليلات الخاص بـ Firebase. عند استخدام Analytics وCrashlytics معًا في تطبيقك، فإنك تحصل على ميزات تساعدك في إنتاج المشكلات وتتبع بيانات الأعطال بمزيد من الدقة، مثل المستخدمين الذين لا يعانون من الأعطال، ومسارات التنقل التي تتعقب أحداث معينة قبل الأعطال، وBigQuery، حيث يمكنك تصور المقاييس الرئيسية لتطبيقك.
يصف هذا الدليل كيفية إضافة Analytics إلى تطبيق تم إعداد Crashlytics عليه (إذا لم تكن قد قمت بذلك بالفعل، فأضف Crashlytics إلى تطبيقك ).
الخطوة 1: إضافة ملف تكوين Firebase
أضف ملف تكوين Firebase Android إلى تطبيقك:
افتح إعدادات المشروع الخاص بك. في بطاقة تطبيقاتك ، حدد اسم حزمة التطبيق الذي تحتاج إلى ملف تكوين له.
انقر فوق تنزيل google-services.json للحصول على ملف تكوين Firebase Android (
google-services.json
).- يمكنك تنزيل ملف تكوين Firebase Android مرة أخرى في أي وقت.
- تأكد من عدم إلحاق ملف التكوين بأحرف إضافية، مثل
(2)
.
انقل ملف التكوين الخاص بك إلى دليل الوحدة النمطية (على مستوى التطبيق) لتطبيقك.
لتمكين منتجات Firebase في تطبيقك، قم بإضافة المكون الإضافي لخدمات Google إلى ملفات Gradle الخاصة بك.
في ملف Gradle على مستوى الجذر (على مستوى المشروع) (
<project>/build.gradle.kts
أو<project>/build.gradle
)، أضف قواعد لتضمين المكون الإضافي Gradle لخدمات Google. تأكد من أن لديك مستودع Google Maven أيضًا.Kotlin
plugins { id("com.android.application") version "7.3.0" apply false // ... // Add the dependency for the Google services Gradle plugin id("com.google.gms.google-services") version "4.4.0" apply false }
Groovy
plugins { id 'com.android.application' version '7.3.0' apply false // ... // Add the dependency for the Google services Gradle plugin id 'com.google.gms.google-services' version '4.4.0' apply false }
في ملف Gradle الخاص بوحدتك (على مستوى التطبيق) (عادةً
<project>/<app-module>/build.gradle.kts
أو<project>/<app-module>/build.gradle
)، قم بتطبيق المكون الإضافي Gradle لخدمات Google.Kotlin
plugins { id("com.android.application") // Add the Google services Gradle plugin id("com.google.gms.google-services") // ... }
Groovy
plugins { id 'com.android.application' // Add the Google services Gradle plugin id 'com.google.gms.google-services' // ... }
الخطوة 2: أضف Analytics SDK إلى تطبيقك
في ملف Gradle الخاص بوحدتك (على مستوى التطبيق) (عادةً
<project>/<app-module>/build.gradle.kts
أو<project>/<app-module>/build.gradle
)، أضف التبعية لمكتبة Analytics لأجهزة الأندرويد. نوصي باستخدام Firebase Android BoM للتحكم في إصدار المكتبة.dependencies { // Import the BoM for the Firebase platform implementation(platform("com.google.firebase:firebase-bom:32.6.0")) // 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.
هل تبحث عن وحدة مكتبة خاصة بـ Kotlin؟ بدءًا من أكتوبر 2023 (Firebase BoM 32.5.0) ، يمكن لمطوري Kotlin وJava الاعتماد على وحدة المكتبة الرئيسية (لمزيد من التفاصيل، راجع الأسئلة الشائعة حول هذه المبادرة ).(بديل) أضف تبعيات مكتبة 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.5.0' }
قم بتعريف كائن
com.google.firebase.analytics.FirebaseAnalytics
أعلى نشاطك:Kotlin+KTX
private lateinit var firebaseAnalytics: FirebaseAnalytics
Java
private FirebaseAnalytics mFirebaseAnalytics;
قم بتهيئته في طريقة
onCreate()
:Kotlin+KTX
// Obtain the FirebaseAnalytics instance. firebaseAnalytics = Firebase.analytics
Java
// Obtain the FirebaseAnalytics instance. mFirebaseAnalytics = FirebaseAnalytics.getInstance(this);
الخطوات التالية
- استخدم DebugView للتحقق من الأحداث الخاصة بك.
- استكشف بياناتك في وحدة تحكم Firebase.
- استكشف الأدلة المتعلقة بالأحداث وخصائص المستخدم.
- تعرف على كيفية تصدير بياناتك إلى BigQuery.