Добавьте Google Analytics для Firebase в свое приложение с мгновенным запуском,Добавьте 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 для Firebase в проект приложения с мгновенным запуском, вы можете использовать API Google Analytics для Firebase так же, как и в проекте устанавливаемого приложения.

Дополнительную информацию о том, как использовать API Google Analytics для Firebase, см. в документации по началу работы с 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, см. в разделе Журнал событий .

Интерпретация событий Google Analytics

Аналитика позволяет отслеживать различные показатели, ценные для мгновенного приложения. В следующей таблице описаны соответствующие показатели для вашего приложения с мгновенным запуском, включая соответствующее имя события или свойство в Analytics.

Дополнительную информацию о константах для событий, которые вы можете собирать в Analytics, см. в разделе FirebaseAnalytics.Event .