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

تحذير: لن تتوفّر "تطبيقات Google Play الفورية" بعد الآن. اعتبارًا من ديسمبر 2025، لن يكون بالإمكان نشر "التطبيقات الفورية" من خلال Google Play، وستتوقف جميع واجهات برمجة التطبيقات الفورية لخدمات Google Play عن العمل. لن يعود بإمكان Google 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 لكل وحدة:

    أنيق

    // 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) لتحديد سياق التطبيق.

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.