بدء استخدام "إحصاءات Google"


يوضّح لك دليل البدء السريع هذا كيفية إضافة 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 إلى تطبيقك

  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: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.

    إذا اخترت عدم استخدام 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")
    }
    هل تبحث عن وحدة مكتبة خاصة بلغة Kotlin؟ اعتبارًا من أكتوبر 2023 (Firebase BoM 32.5.0)، يمكن لمطوّري Kotlin وJava الاستفادة من وحدة المكتبة الرئيسية (للحصول على التفاصيل، يُرجى الاطّلاع على الأسئلة الشائعة حول هذه المبادرة).

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

    KotlinJava
    private lateinit var firebaseAnalytics: FirebaseAnalytics
    private FirebaseAnalytics mFirebaseAnalytics;
  3. يمكنك إعدادها في الطريقة onCreate() على النحو التالي:

    KotlinJava
    // Obtain the FirebaseAnalytics instance.
    firebaseAnalytics = Firebase.analytics
    // Obtain the FirebaseAnalytics instance.
    mFirebaseAnalytics = FirebaseAnalytics.getInstance(this);

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

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

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

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

KotlinJava
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 في &quot;استوديو Android&quot;، ما يساعدك في التأكّد على الفور من أنّه يتم إرسال الأحداث.

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