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

هشدار: «Google Play فوری» دیگر دردسترس نخواهد بود. از دسامبر ۲۰۲۵، «برنامه‌های فوری» را نمی‌توان ازطریق Google Play منتشر کرد و همه میاناهای برنامه‌سازی کاربردی فوری خدمات Google Play دیگر کار نخواهند کرد. کاربران دیگر ازطریق هیچ سازوکاری «برنامه‌های فوری» را از Play دریافت نخواهند کرد.

این تغییر را براساس بازخورد توسعه‌دهندگان و سرمایه‌گذاری‌های مداوممان برای بهبود بوم‌سازگان از زمان معرفی «Google Play فوری» انجام می‌دهیم.

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

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

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

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

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

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

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

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

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

نام مقدار 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 را ببینید.