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

Имя Ценность аналитики Определение
Посещения 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 .