Google is committed to advancing racial equity for Black communities. See how.
ترجمت واجهة Cloud Translation API‏ هذه الصفحة.
Switch to English

ابدأ مع Google Analytics

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

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

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

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

قبل ان تبدأ

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

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

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

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

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

  1. أضف التبعية لمكتبة Google Analytics Android إلى ملف Gradle الخاص بك (على مستوى التطبيق) (عادةً app/build.gradle ):

    جافا

     implementation 'com.google.firebase:firebase-analytics:17.4.4'
     

    Kotlin + KTX

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

    جافا

    private FirebaseAnalytics mFirebaseAnalytics;

    Kotlin + KTX

    private lateinit var firebaseAnalytics: FirebaseAnalytics
  3. قم onCreate() طريقة onCreate() :

    جافا

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

    Kotlin + KTX

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

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

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

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

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

جافا

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);

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")
}

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

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