إضافة "إحصاءات Google لبرنامج Firebase" إلى تطبيقك الفوري

يُعد تتبع نجاح أي تطبيق، فوري أو مثبّت، مهمًا لكل مطور البرامج. تتوافق العديد من مكتبات التحليلات مع تطبيقات Google Play الفورية، بما في ذلك الإجابات من القماش، Localytics، وMixpanel.

إذا لم يكن حل التحليلات الذي تستخدمه مدرجًا أو وجدت أنه غير مدرج باستخدام تقنية "تطبيقات Google Play الفورية"، ننصحك باستخدام أداة "إحصاءات Google لبرنامج Firebase" حل القياس عن بُعد. توضِّح هذه الصفحة كيفية إعداد "إحصاءات Google لبرنامج Firebase". في مشروع تطبيق فوري.

إضافة "إحصاءات Google لبرنامج Firebase" إلى مشروع تطبيق فوري

1. أضِف حزمة تطوير البرامج (SDK) لمنصّة Firebase إلى تطبيقك باتّباع التعليمات. كما هو موضح في دليل البدء بشأن "إحصاءات Google لبرنامج Firebase".
2. استخدام أحدث إصدار من المكوّن الإضافي لخدمات google.
3. ضَع ملف google-services.json في كل وحدة.

4. أضِف السطر التالي إلى ملف build.gradle الخاص بكل وحدة:

   Groovy

   // android { ... }
   // dependencies { ... }
   plugins {
       id 'com.google.gms.google-services'
   }
   

   Kotlin

   // android { ... }
   // dependencies { ... }
   plugins {
       id("com.google.gms.google-services")
   }
   

بعد إضافة "إحصاءات Google لبرنامج Firebase" إلى مشروع تطبيقك الفوري، يمكنك: استخدام واجهات برمجة تطبيقات "إحصاءات Google لبرنامج Firebase" كما هو الحال في مشروع تطبيق قابل للتثبيت.

لمزيد من المعلومات عن كيفية استخدام واجهات برمجة التطبيقات في "إحصاءات Google لبرنامج Firebase"، يمكنك الاطّلاع على الـ مستندات البدء حول "إحصاءات Google لبرنامج Firebase".

التفريق بين بيانات التطبيقات المثبّتة وبيانات التطبيقات الفورية

بما أنّ التطبيق المثبّت والتطبيق الفوري يتشاركان في اسم حزمة، يمكنك التفريق بين الأحداث والبيانات التي تمّ جمعها من كلٍّ منها. إلى التفريق بين تطبيقاتك الفورية والتطبيقات المثبّتة في "إحصاءات Google"، وضبط خاصيّة مستخدم على app_type، بالقيمة "فوري" للتطبيق الفوري "مثبت" للتطبيق المثبّت.

يعرض مقتطف الرمز التالي نشاطًا مثيل "إحصاءات Google"، ثم تضبط خاصيّة مستخدم لاحظ أن يستخدم التعليمات البرمجية PackageManagerCompat.isInstantApp() في onCreate(android.os.Bundle) لتحديد سياق التطبيق.

val STATUS_INSTALLED = "installed"
val STATUS_INSTANT = "instant"
val ANALYTICS_USER_PROP = "app_type"

private lateinit var firebaseAnalytics: FirebaseAnalytics

protected fun onCreate(savedInstanceState: Bundle?) {
    ...

    firebaseAnalytics = FirebaseAnalytics.getInstance(this)

    // Determine the current app context, either installed or instant, then
    // set the corresponding user property for Google Analytics.
    if (InstantApps.getPackageManagerCompat(this).isInstantApp()) {
        firebaseAnalytics.setUserProperty(ANALYTICS_USER_PROP, STATUS_INSTANT)
    } else {
        firebaseAnalytics.setUserProperty(ANALYTICS_USER_PROP, STATUS_INSTALLED)
    }
}

final String STATUS_INSTALLED = "installed";
final String STATUS_INSTANT = "instant";
final String ANALYTICS_USER_PROP = "app_type";

private FirebaseAnalytics firebaseAnalytics;

@Override
protected void onCreate(Bundle savedInstanceState) {
    ...

    firebaseAnalytics = FirebaseAnalytics.getInstance(this);

    // Determine the current app context, either installed or instant, then
    // set the corresponding user property for Google Analytics.
    if (InstantApps.getPackageManagerCompat(this).isInstantApp()) {
        firebaseAnalytics.setUserProperty(ANALYTICS_USER_PROP, STATUS_INSTANT);
    } else {
        firebaseAnalytics.setUserProperty(ANALYTICS_USER_PROP, STATUS_INSTALLED);
    }

}

بعد إعداد خاصيّة المستخدِم "app_type"، يمكنك اختيار حدث في علامة التبويب الأحداث في وحدة تحكم "إحصاءات Google"، ثم فلترة الحدث حسب قيمة app_type. يمنحك توقع البيانات الناتج عددًا حدثًا محدّدًا في تطبيقك الفوري أو المثبَّت.

لمزيد من المعلومات عن كيفية تسجيل الأحداث وعرضها في "إحصاءات Google لبرنامج Firebase"، راجِع أحداث السجلّ.

تفسير أحداث "إحصاءات Google"

يسمح لك Analytics بتتبع مجموعة متنوعة من المقاييس القيّمة إلى تطبيق فوري. يوضّح الجدول التالي المقاييس ذات الصلة تطبيق فوري، بما في ذلك اسم أو خاصية الحدث المقابل في "إحصاءات YouTube"

لمزيد من المعلومات عن الثوابت في الأحداث التي يمكنك جمعها فيها الإحصاءات، يُرجى الاطّلاع على FirebaseAnalytics.Event: