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، توضیح می‌دهد.

نام ارزش تجزیه و تحلیل تعریف
بازدید می کند session_start جلسه شروع شد این رویداد به طور خودکار ردیابی می شود.
خریدهای فیزیکی Firebase.Event.ECOMMERCE_PURCHASE خریدهای فیزیکی شما باید به صراحت این رویداد را در کد خود دنبال کنید.
خرید دیجیتال in_app_purchase خریدهای دیجیتال درون برنامه ای این رویداد به طور خودکار ردیابی می شود.
زمان در برنامه user_engagement مقدار زمانی که برنامه در پیش زمینه صرف می کند. این رویداد به طور خودکار ردیابی می شود.
زمینه برنامه فوری app_type رویدادهای ایجاد شده از برنامه در حال اجرا در زمینه آنی یا نصب شده. شما باید به صراحت این رویداد را در کد خود دنبال کنید. به تمایز بین داده های برنامه فوری و نصب شده در بالا مراجعه کنید.
بازگشت بازدیدکنندگان session_start.count و app_type مخاطبان کاربرانی که دو بار یا بیشتر بازدید می کنند. شما باید به صراحت رویداد app_type را دنبال کنید. session_start برای شما پیگیری می شود. به تمایز بین داده های برنامه فوری و نصب شده در بالا مراجعه کنید.

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