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

يعد تتبع نجاح أي تطبيق، سواء فوريًا أو مثبتًا، أمرًا مهمًا لكل مطوِّر. تتوافق العديد من مكتبات الإحصاءات مع تطبيقات Google Play الفورية، بما في ذلك Fabric Questions وLocalytics وMixpanel.

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

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

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

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

   رائع

   // 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 باستخدام القيمة "فورية" للتطبيق الفوري و"تثبيت" للتطبيق المثبّت.

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

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

Kotlin

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

Java

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"

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

الاسم	قيمة "إحصاءات Google"	التعريف
الزيارات	session_start	بدأت الجلسة يتم تتبُّع هذا الحدث تلقائيًا.
عمليات الشراء المادية	Firebase.Event.ECOMMERCE_PURCHASE	المشتريات المادية. وعليك تتبُّع هذا الحدث صراحةً في رمزك.
عمليات شراء رقمية	in_app_purchase	عمليات الشراء الرقمية داخل التطبيق: يتم تتبُّع هذا الحدث تلقائيًا.
مدّة استخدام التطبيق	user_engagement	مقدار الوقت الذي يقضيه التطبيق في المقدّمة يتم تتبُّع هذا الحدث تلقائيًا.
سياق التطبيق الفوري	app_type	الأحداث التي يتم جمعها من التطبيق والتي يتم تشغيلها في السياق الفوري أو السياق المثبَّت. وعليك تتبُّع هذا الحدث صراحةً في رمزك. راجع التفريق بين بيانات التطبيقات المثبّتة والتطبيقات الفورية أعلاه.
الزوّار المكرّرو الزيارة	session_start.count وapp_type	شريحة جمهور من المستخدِمين الذين يزورون الموقع الإلكتروني مرّتين أو أكثر. عليك تتبُّع حدث app_type بشكل صريح، إذ يتم تتبُّع session_start نيابةً عنك. راجع التفريق بين بيانات التطبيقات المثبّتة وبيانات التطبيقات الفورية أعلاه.

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