يوضّح لك دليل البدء السريع هذا كيفية إضافة Google Analytics إلى تطبيقك وبدء تسجيل الأحداث.
تجمع حزمة تطوير البرامج (SDK) الخاصة بـ Google Analytics بيانات الاستخدام والسلوك لتطبيقك. وتسجّل حزمة تطوير البرامج (SDK) نوعَين أساسيَّين من المعلومات:
- الأحداث: هي ما يحدث في تطبيقك، مثل إجراءات المستخدم أو أحداث النظام أو الأخطاء.
- خصائص المستخدِمين: هي سمات تحدّدها لوصف شرائح من قاعدة المستخدِمين لديك، مثل اللغة المفضّلة أو الموقع الجغرافي.
تسجّل Analytics تلقائيًا بعض الأحداث وخصائص المستخدِمين، ولا تحتاج إلى إضافة أي رمز لتفعيلها.
قبل البدء
إذا لم يسبق لك إجراء ذلك، أضِف Firebase إلى مشروع Android وتأكَّد من تفعيل Google Analytics في مشروع Firebase:
إذا كنت بصدد إنشاء مشروع جديد في Firebase، فعِّل Google Analytics أثناء خطوات إنشاء المشروع.
إذا كنت تستخدم مشروعًا حاليًا في Firebase لم يتم تفعيل Google Analytics فيه، انتقِل إلى علامة التبويب عمليات الدمج ضمن
لتفعيلها. > إعدادات المشروع
عند تفعيل Google Analytics في مشروعك، يتم ربط تطبيقاتك في Firebase بمصادر بيانات Google Analytics.
إضافة حزمة تطوير البرامج (SDK) Analytics إلى تطبيقك
في ملف Gradle للوحدة (على مستوى التطبيق) (عادةً
<project>/<app-module>/build.gradle.kts
أو<project>/<app-module>/build.gradle
)، أضِف الاعتمادية لمكتبة Analytics لنظام التشغيل Android. ننصحك باستخدام Firebase Android BoM للتحكّم في إصدارات المكتبة.dependencies { // Import the BoM for the Firebase platform implementation(platform("com.google.firebase:firebase-bom:33.16.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متعدّدة في تطبيقك، ننصحك بشدة باستخدام 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:22.5.0") }
عليك تعريف العنصر
com.google.firebase.analytics.FirebaseAnalytics
في أعلى نشاطك:private lateinit var firebaseAnalytics: FirebaseAnalytics
private FirebaseAnalytics mFirebaseAnalytics;
يمكنك إعدادها في الطريقة
onCreate()
على النحو التالي:// Obtain the FirebaseAnalytics instance. firebaseAnalytics = Firebase.analytics
// Obtain the FirebaseAnalytics instance. mFirebaseAnalytics = FirebaseAnalytics.getInstance(this);
بدء تسجيل الأحداث
بعد إنشاء مثيل FirebaseAnalytics
، يمكنك البدء في تسجيل الأحداث باستخدام طريقة logEvent()
.
يُنصح باستخدام أحداث معيّنة لجميع التطبيقات، بينما يُنصح باستخدام أحداث أخرى لأنواع أو قطاعات معيّنة من الأنشطة التجارية. يجب إرسال الأحداث المقترَحة مع المَعلمات المخصَّصة لها لضمان توفير أكبر قدر من التفاصيل في تقاريرك وللاستفادة من الميزات وعمليات الدمج المستقبلية عند توفّرها. يوضّح هذا القسم كيفية تسجيل حدث محدّد مسبقًا. لمزيد من المعلومات حول تسجيل الأحداث، يُرجى الاطّلاع على تسجيل الأحداث.
يسجّل الرمز التالي حدث SELECT_CONTENT
عندما ينقر المستخدم على عنصر معيّن في تطبيقك.
firebaseAnalytics.logEvent(FirebaseAnalytics.Event.SELECT_ITEM) { param(FirebaseAnalytics.Param.ITEM_ID, id) param(FirebaseAnalytics.Param.ITEM_NAME, name) param(FirebaseAnalytics.Param.CONTENT_TYPE, "image") }
Bundle bundle = new Bundle(); bundle.putString(FirebaseAnalytics.Param.ITEM_ID, id); bundle.putString(FirebaseAnalytics.Param.ITEM_NAME, name); bundle.putString(FirebaseAnalytics.Param.CONTENT_TYPE, "image"); mFirebaseAnalytics.logEvent(FirebaseAnalytics.Event.SELECT_CONTENT, bundle);
يمكنك تفعيل التسجيل المفصّل للأحداث لمراقبة تسجيل الأحداث بواسطة حزمة SDK للمساعدة في التأكّد من تسجيل الأحداث بشكل سليم. ويشمل ذلك الأحداث التي يتم تسجيلها تلقائيًا ويدويًا.
يمكنك تفعيل أسلوب التسجيل المطوَّل باستخدام سلسلة من أوامر adb
:
adb shell setprop log.tag.FA VERBOSE
adb shell setprop log.tag.FA-SVC VERBOSE
adb logcat -v time -s FA FA-SVC
يعرض هذا الأمر أحداثك في logcat في "استوديو Android"، ما يساعدك في التأكّد على الفور من أنّه يتم إرسال الأحداث.
الخطوات التالية
- التعرّف على كل تقرير من تقارير "إحصاءات Google"
- استخدِم تقرير DebugView للتحقّق من أحداثك.
- استكشاف بياناتك في وحدة تحكّم Firebase
- اطّلِع على الأدلة المتعلّقة بالأحداث وخصائص المستخدمين.
- تعرَّف على كيفية تصدير بياناتك إلى BigQuery.