Добавьте Google Analytics для Firebase в свое мгновенное приложение.

Отслеживание успеха приложения, как мгновенного, так и установленного, важно для каждого разработчика. Несколько аналитических библиотек совместимы с Google Play Instant, включая Fabric Answers , Localytics и Mixpanel .

Если ваше текущее решение для аналитики не указано в списке или если вы обнаружите, что оно не работает с Google Play Instant, рассмотрите возможность использования Google Analytics for Firebase в качестве решения для телеметрии. На этой странице описано, как настроить Google Analytics for Firebase в проекте приложения Instant.

Добавление Google Analytics для Firebase в проект мгновенного приложения.

1. Добавьте SDK Firebase в свое приложение, следуя инструкциям, описанным в руководстве по началу работы с 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, а затем устанавливает свойство пользователя. Обратите внимание, что в методе onCreate(android.os.Bundle) используется PackageManagerCompat.isInstantApp() для определения контекста приложения.

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 .