Google Analytics برای Firebase را به برنامه فوری خود اضافه کنید

پیگیری موفقیت یک برنامه، چه به صورت فوری و چه به صورت نصب شده، برای هر توسعه‌دهنده‌ای مهم است. چندین کتابخانه تحلیلی با Google Play Instant سازگار هستند، از جمله Fabric Answers ، Localytics و Mixpanel .

اگر راهکار تحلیلی فعلی شما در فهرست نیست یا اگر متوجه شدید که با Google Play Instant کار نمی‌کند، استفاده از Google Analytics برای Firebase را به عنوان راهکار سنجش از راه دور خود در نظر بگیرید. این صفحه نحوه راه‌اندازی Google Analytics برای Firebase را در یک پروژه برنامه فوری شرح می‌دهد.

افزودن گوگل آنالیتیکس برای فایربیس به یک پروژه اپلیکیشن فوری

1. با دنبال کردن دستورالعمل‌های شرح داده شده در راهنمای شروع به کار با گوگل آنالیتیکس برای فایربیس، کیت توسعه نرم‌افزار فایربیس (Firebase SDK) را به برنامه خود اضافه کنید.
2. از آخرین نسخه افزونه google-services استفاده کنید.
3. فایل google-services.json را در هر ماژول قرار دهید.

4. خط زیر را به فایل build.gradle هر ماژول اضافه کنید:

   گرووی

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

   کاتلین

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

پس از اینکه Google Analytics for Firebase را به پروژه اپلیکیشن فوری خود اضافه کردید، می‌توانید از APIهای Google Analytics for Firebase مانند یک پروژه اپلیکیشن قابل نصب استفاده کنید.

برای اطلاعات بیشتر در مورد نحوه استفاده از API های Google Analytics برای Firebase، به مستندات شروع به کار Google Analytics برای Firebase مراجعه کنید.

تمایز قائل شدن بین داده‌های نصب‌شده و داده‌های فوری برنامه

از آنجا که هم برنامه نصب‌شده و هم برنامه فوری شما نام بسته مشترکی دارند، ممکن است بخواهید رویدادها و داده‌های جمع‌آوری‌شده از هر یک را از هم متمایز کنید. برای تمایز برنامه‌های فوری و نصب‌شده خود در آنالیتیکس، یک ویژگی کاربر app_type تنظیم کنید، با مقدار "instant" برای برنامه فوری و "installed" برای برنامه نصب‌شده.

قطعه کد زیر یک activity را نشان می‌دهد که یک نمونه از Analytics را دریافت کرده و سپس یک ویژگی کاربر را تنظیم می‌کند. توجه داشته باشید که این کد 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 user، می‌توانید یک رویداد را در تب Events کنسول Analytics انتخاب کرده و سپس رویداد را بر اساس مقدار app_type فیلتر کنید. پیش‌بینی داده حاصل، تعداد رویدادهای مشخص شده در برنامه فوری یا نصب شده شما را به شما نشان می‌دهد.

برای اطلاعات بیشتر در مورد نحوه ثبت و مشاهده رویدادها در گوگل آنالیتیکس برای فایربیس، به بخش ثبت رویدادها مراجعه کنید.

تفسیر رویدادهای تحلیلی

آنالیتیکس به شما امکان می‌دهد معیارهای متنوعی را که برای یک اپلیکیشن فوری ارزشمند هستند، ردیابی کنید. جدول زیر معیارهای مرتبط با اپلیکیشن فوری شما، از جمله نام رویداد یا ویژگی مربوطه در آنالیتیکس را شرح می‌دهد.

برای اطلاعات بیشتر در مورد ثابت‌های رویدادهایی که می‌توانید در Analytics جمع‌آوری کنید، به FirebaseAnalytics.Event مراجعه کنید.