يوضح لك هذا Quickstart كيفية إضافة Google Analytics إلى تطبيقك والبدء في تسجيل الأحداث.
يجمع Google Analytics بيانات الاستخدام والسلوك لتطبيقك. تسجل SDK نوعين أساسيين من المعلومات:
- الأحداث: ما يحدث في تطبيقك ، مثل إجراءات المستخدم أو أحداث النظام أو الأخطاء.
- خصائص المستخدم: السمات التي تحددها لوصف أجزاء من قاعدة المستخدمين ، مثل تفضيلات اللغة أو الموقع الجغرافي.
يقوم برنامج Analytics تلقائيًا بتسجيل بعض الأحداث وخصائص المستخدم ؛ لا تحتاج إلى إضافة أي كود لتمكينهم.
قبل ان تبدأ
أضف Firebase إلى مشروع Android الخاص بك وتأكد من تمكين Google Analytics في مشروع Firebase ، إذا لم تكن قد قمت بذلك بالفعل:
إذا كنت تنشئ مشروع Firebase جديدًا ، فقم بتمكين Google Analytics أثناء سير عمل إنشاء المشروع.
إذا كنت تستخدم مشروع Firebase حالي لم يتم تمكين Google Analytics فيه ، فانتقل إلى علامة التبويب "التكامل" في > إعدادات المشروع لتمكينه.
عند تمكين Google Analytics في مشروعك ، يتم ربط تطبيقات Firebase بتدفقات بيانات Google Analytics.
أضف Analytics SDK إلى تطبيقك
في ملف 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:32.1.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-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.3.0' }
Java
dependencies { // Import the BoM for the Firebase platform implementation platform('com.google.firebase:firebase-bom:32.1.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.
(بديل) أضف تبعيات مكتبة 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.3.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);
بدء تسجيل الأحداث
بعد إنشاء مثيل 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
يعرض هذا الأمر الأحداث الخاصة بك في Android Studio logcat ، مما يساعدك على التحقق فورًا من إرسال الأحداث.
الخطوات التالية
- استخدم DebugView للتحقق من الأحداث الخاصة بك.
- استكشف بياناتك في وحدة تحكم Firebase.
- استكشف أدلة الأحداث وخصائص المستخدم.
- تعرّف على كيفية تصدير بياناتك إلى BigQuery.