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

تحذير: لن تكون "تطبيقات Google Play الفورية" متاحة بعد الآن. اعتبارًا من ديسمبر 2025، لن يكون بإمكانك نشر التطبيقات الفورية من خلال Google Play، كما أنّ جميع واجهات برمجة التطبيقات الفورية في "خدمات Google Play" ستتوقف عن العمل. لن يعرض Play "التطبيقات الفورية" للمستخدمين بعد الآن باستخدام أي آلية.

نُجري هذا التغيير استنادًا إلى ملاحظات المطوّرين واستثماراتنا المستمرة لتحسين المنظومة المتكاملة منذ طرح ميزة "تطبيقات Google Play الفورية".

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

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

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

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

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