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

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

يجمع Google Analytics بيانات الاستخدام والسلوك لتطبيقك. تسجل SDK نوعين أساسيين من المعلومات:

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

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

قبل ان تبدأ

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

  • إذا كنت تقوم بإنشاء مشروع Firebase جديد، فقم بتمكين Google Analytics أثناء سير عمل إنشاء المشروع.

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

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

أضف Analytics SDK إلى تطبيقك

  1. في ملف Gradle الخاص بوحدتك (على مستوى التطبيق) (عادةً <project>/<app-module>/build.gradle.kts أو <project>/<app-module>/build.gradle )، أضف التبعية لمكتبة Analytics لأجهزة الأندرويد. نوصي باستخدام Firebase Android BoM للتحكم في إصدار المكتبة.

    dependencies {
        // Import the BoM for the Firebase platform
        implementation(platform("com.google.firebase:firebase-bom:32.7.4"))
    
        // 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.5.1")
    }
    
    هل تبحث عن وحدة مكتبة خاصة بـ Kotlin؟ بدءًا من أكتوبر 2023 (Firebase BoM 32.5.0) ، يمكن لمطوري Kotlin وJava الاعتماد على وحدة المكتبة الرئيسية (لمزيد من التفاصيل، راجع الأسئلة الشائعة حول هذه المبادرة ).

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

    Kotlin+KTX

    private lateinit var firebaseAnalytics: FirebaseAnalytics

    Java

    private FirebaseAnalytics mFirebaseAnalytics;
  3. قم بتهيئته في طريقة 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، مما يساعدك على التحقق فورًا من إرسال الأحداث.

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