يوضح لك دليل البدء السريع هذا كيفية إضافة Google Analytics إلى تطبيقك لبدء تسجيل الأحداث.
يجمع "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.1.2")) // 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، سيستخدم تطبيقك دائمًا إصدارات متوافقة من مكتبات Android في Firebase.
(الطريقة البديلة) إضافة اعتماديات مكتبة 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:22.0.2") }
يُرجى تعريف الكائن
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);
بدء تسجيل الأحداث
بعد إنشاء مثيل FirebaseAnalytics
، يمكنك البدء في تسجيل.
الأحداث باستخدام الطريقة logEvent()
.
تُعد بعض الأحداث يُنصح به لجميع التطبيقات والبعض الآخر يوصى به لأنواع أنشطة تجارية أو مجالات محددة. ينبغي إرسال الأحداث المقترَحة إلى جانب المَعلمات المخصَّصة لها لضمان الحدّ الأقصى التفاصيل المتوفرة في تقاريرك وللاستفادة من الميزات عمليات الدمج فور توفرها. يوضح هذا القسم تسجيل حدث محدد مسبقًا، لمزيد من المعلومات حول تسجيل الأحداث، راجع أحداث السجلّ:
يسجِّل الرمز التالي حدث SELECT_CONTENT
عند
ينقر المستخدِم على عنصر معيّن في تطبيقك.
Kotlin+KTX
firebaseAnalytics.logEvent(FirebaseAnalytics.Event.SELECT_ITEM) { param(FirebaseAnalytics.Param.ITEM_ID, id) param(FirebaseAnalytics.Param.ITEM_NAME, name) param(FirebaseAnalytics.Param.CONTENT_TYPE, "image") }
Java
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.