Добавьте 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 со значением «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.

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