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

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

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

افزودن Google Analytics برای Firebase به پروژه برنامه فوری

1. Firebase SDK را با دنبال کردن دستورالعمل‌های شرح داده شده در راهنمای شروع به کار برای Google Analytics برای Firebase به برنامه خود اضافه کنید.
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 را به پروژه برنامه فوری خود اضافه کردید، می‌توانید از Google Analytics برای Firebase API مانند یک پروژه برنامه قابل نصب استفاده کنید.

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

تمایز بین داده های برنامه های نصب شده و فوری

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

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

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

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

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

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