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

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

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

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

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

قبل البدء

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

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

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

عند تفعيل 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:35.0.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، سيستخدم تطبيقك دائمًا إصدارات متوافقة من مكتبات 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:24.0.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 عندما ينقر المستخدم على عنصر معيّن في تطبيقك.

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

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، ما يساعدك في التحقّق فورًا من إرسال الأحداث.

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

• فهم كل تقرير من تقارير "إحصاءات Google"
• استخدِم DebugView للتحقّق من أحداثك.
• استكشِف بياناتك في وحدة تحكّم Firebase.
• اطّلِع على الأدلة حول الأحداث وخصائص المستخدمين.
• كيفية تصدير بياناتك إلى BigQuery