Добавление Google Аналитики для Firebase в приложение с мгновенным запуском

Внимание! Google Play Instant больше не будет доступен. С декабря 2025 года приложения с мгновенным запуском нельзя будет публиковать в Google Play, а все Instant API сервисов Google Play перестанут работать. Пользователи больше не будут получать приложения с мгновенным запуском из Google Play.

Мы приняли это решение на основе отзывов разработчиков и наших постоянных инвестиций в улучшение экосистемы с момента запуска Google Play Instant.

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

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

Если вы не нашли в списке свое решение для аналитики или оно не работает с Google Play Instant, попробуйте использовать Google Аналитику для Firebase. В этой статье рассказывается, как настроить Google Аналитику для Firebase в проекте приложения с мгновенным запуском.

Как добавить Google Аналитику для Firebase в проект приложения с мгновенным запуском

1. Добавьте Firebase SDK в приложение, следуя инструкциям в кратком руководстве по Google Аналитике для Firebase.
2. Используйте последнюю версию плагина google-services.
3. Поместите файл google-services.json в каждый модуль.

4. Добавьте в файл build.gradle каждого модуля следующую строку:

   Яркий

   // android { ... }
   // dependencies { ... }
   plugins {
       id 'com.google.gms.google-services'
   }

   Kotlin

   // android { ... }
   // dependencies { ... }
   plugins {
       id("com.google.gms.google-services")
   }

Добавив Google Аналитику для Firebase в проект приложения с мгновенным запуском, вы сможете использовать API Google Аналитики для Firebase так же, как и в проекте устанавливаемого приложения.

Дополнительную информацию об использовании API Google Аналитики для Firebase можно найти в документации по началу работы с Google Аналитикой для Firebase.

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

Поскольку у установленного приложения и приложения с мгновенным запуском одно и то же название пакета, вам может потребоваться различать события и данные, собранные в каждом из них. Чтобы различать в Аналитике приложение с мгновенным запуском и установленное приложение, задайте свойство пользователя app_type со значением instant для приложения с мгновенным запуском и installed для установленного приложения.

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

В приведенном ниже фрагменте кода показано действие, которое получает экземпляр Аналитики, а затем задает свойство пользователя. Обратите внимание, что в коде используется PackageManagerCompat.isInstantApp() в методе onCreate(android.os.Bundle) для определения контекста приложения.

Kotlin

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)
    }
}

Java

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, вы можете выбрать событие на вкладке События в консоли Аналитики и отфильтровать его по значению app_type. В результате вы получите количество указанных событий в приложении с мгновенным запуском или установленном приложении.

Подробнее о том, как регистрировать и просматривать события в Google Аналитике для Firebase…

Интерпретация событий Аналитики

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

Название	Ценность в Аналитике	Определение
посещения специалистов;	session_start	Сеанс начат. Это событие отслеживается автоматически.
Покупки физических товаров	Firebase.Event.ECOMMERCE_PURCHASE	Покупки в обычных магазинах. Это событие необходимо явно отслеживать в коде.
Цифровые покупки	in_app_purchase	Цифровые покупки в приложении. Это событие отслеживается автоматически.
Время в приложении	user_engagement	Время, в течение которого приложение работает в активном режиме. Это событие отслеживается автоматически.
Контекст приложения с мгновенным запуском	app_type	События, вызванные приложением, которое запущено в контексте мгновенного запуска или установки. Это событие необходимо явно отслеживать в коде. Подробнее о различиях между данными установленных приложений и данными приложений с мгновенным запуском…
Вернувшиеся посетители	session_start.count и app_type	Аудитория пользователей, которые посещают сайт два или более раз. Событие app_type нужно отслеживать явным образом, а session_start отслеживается автоматически. Подробнее о том, как различать данные установленных приложений и приложений с мгновенным запуском…

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