Добавьте 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 .

Различие между данными установленных и мгновенных приложений

Поскольку и установленное, и мгновенное приложение имеют одно и то же имя пакета, вам может потребоваться различать события и данные, собираемые каждым из них. Чтобы различать мгновенные и установленные приложения в Google 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, см. в разделе FirebaseAnalytics.Event .