بدء استخدام "إحصاءات Google لنظام التشغيل Android"

اختيار المنصة: iOS+ Android Web Flutter Unity C++


يوضّح لك هذا التشغيل السريع كيفية إضافة "إحصاءات Google" إلى تطبيقك والبدء في تسجيل الأحداث.

Google Analytics تجمع بيانات الاستخدام والسلوك لتطبيقك. وتسجِّل حزمة تطوير البرامج (SDK) نوعَين أساسيَين من المعلومات:

  • الأحداث: ما يحدث في تطبيقك، مثل إجراءات المستخدم أو أحداث النظام أو الأخطاء.
  • خصائص المستخدمين: سمات تحدّدها لوصف شرائح من قاعدة المستخدمين لديك، مثل اللغة المفضّلة أو الموقع الجغرافي.

Analytics تسجِّل تلقائيًا بعض الأحداث و خصائص المستخدمين، ولا تحتاج إلى إضافة أي رمز لتفعيلها.

قبل البدء

أضِف Firebase إلى مشروع Android الخاص بك، في حال لم يسبق لك إجراء ذلك، وتأكَّد من تفعيل Google Analytics في مشروع Firebase الخاص بك:

  • إذا كنت بصدد إنشاء مشروع جديد في Firebase، فعِّل Google Analytics أثناء خطوات إنشاء المشروع.

  • إذا كنت تستخدم مشروعًا حاليًا في Firebase لم يتم تفعيل Google Analytics فيه، يمكنك تفعيله في الإعدادات > عمليات الدمج علامة التبويب.

عند تفعيل Google Analytics في مشروعك، يتم ربط تطبيقاتك في Firebase بـ مصادر بيانات Google Analytics.

إضافة حزمة تطوير البرامج (SDK) الخاصة بـ Analytics إلى تطبيقك

  1. في ملف 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:34.12.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:23.2.0")
}

  2. حدِّد العنصر com.google.firebase.analytics.FirebaseAnalytics في أعلى نشاطك:

    Kotlin 

    private lateinit var firebaseAnalytics: FirebaseAnalytics
    MainActivity.kt

    Java 

    private FirebaseAnalytics mFirebaseAnalytics;
    MainActivity.java

  3. ابدأ إعداده في طريقة onCreate():

    Kotlin 

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

    Java 

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

بدء تسجيل الأحداث

بعد إنشاء مثيل FirebaseAnalytics، يمكنك البدء في تسجيل الأحداث باستخدام طريقة logEvent().

يُنصح باستخدام أحداث معيّنة لجميع التطبيقات، بينما يُنصح باستخدام أحداث أخرى لأنواع أو قطاعات معيّنة من الأنشطة التجارية. يجب إرسال الأحداث المقترَحة مع المَعلمات المخصَّصة لها، لضمان توفير أكبر قدر من التفاصيل في تقاريرك وللاستفادة من الميزات وعمليات الدمج المستقبلية عند توفّرها. يوضّح هذا القسم كيفية تسجيل حدث محدّد مسبقًا، ولمزيد من المعلومات عن تسجيل الأحداث، يُرجى الاطّلاع على مقالة تسجيل الأحداث.

يسجِّل الرمز التالي حدث SELECT_CONTENT عندما ينقر مستخدم على عنصر معيّن في تطبيقك.

Kotlin 

firebaseAnalytics.logEvent(FirebaseAnalytics.Event.SELECT_ITEM) {
    param(FirebaseAnalytics.Param.ITEM_ID, id)
    param(FirebaseAnalytics.Param.ITEM_NAME, name)
    param(FirebaseAnalytics.Param.CONTENT_TYPE, "image")
}
MainActivity.kt

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);
MainActivity.java

يمكنك تفعيل التسجيل المطوّل لمراقبة تسجيل الأحداث من خلال حزمة تطوير البرامج (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"، ما يساعدك في التأكّد على الفور من إرسال الأحداث.

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