| Выберите платформу: | iOS+ Android Web Flutter Unity C++ |
В этом кратком руководстве рассказывается, как добавить Google Аналитику в приложение и начать регистрировать события.
Google Analytics собирает данные об использовании приложения и поведенческие данные для вашего приложения. SDK регистрирует два основных типа информации:
- События. Что происходит в приложении, например действия пользователей, системные события или ошибки.
- Свойства пользователей. Атрибуты, описывающие сегменты пользовательской базы (языковые настройки, географическое местоположение и др.).
Analytics автоматически регистрирует некоторые события и свойства пользователей – вам не нужно добавлять для них код.
Запрос к ИИ для получения помощи от ИИ
Чтобы получить помощь от ИИ, скопируйте запрос ниже и вставьте его в Antigravity, Gemini в Android Studio, Claude Code, Codex, Cursor или другой ИИ-инструмент для программирования. Вы можете изменить запрос и продолжить работу с агентом. Подробные инструкции по установке вы найдете в статье Навыки агента Firebase.
Help me use Firebase in my app.
1. Make sure that **Firebase agent skills** are installed and updated. For Claude Code, Codex, or Cursor agents, help me install the Firebase plugin. For other agents, run `npx skills add firebase/agent-skills`. Always try to use **Firebase agent skills** for Firebase-related tasks.
2. Help me set up Google Analytics for Firebase and log screen view events in my app.
Подготовка
Если вы ещё этого не сделали, добавьте Firebase в проект для Android и убедитесь, что в проекте Firebase включен Google Analytics.
Если вы создаете новый проект Firebase, включите Google Analytics в процессе его создания.
Если вы используете существующий проект Firebase, в котором не включен сервис Google Analytics, вы можете включить его на вкладке
Settings (Настройки) > Integrations (Интеграции).
Когда вы включаете в своем проекте Google Analytics, приложения Firebase связываются с потоками данных Google Analytics.
Добавьте в приложение Analytics SDK
В файле Gradle на уровне модуля (приложения) (обычно
<project>/<app-module>/build.gradle.ktsили<project>/<app-module>/build.gradle) добавьте зависимость для библиотеки Analytics для Android. Для управления версиями библиотек рекомендуем использовать Firebase Android BoM.dependencies { // Import the BoM for the Firebase platform implementation(platform("com.google.firebase:firebase-bom:35.2.0")) // Add the dependency for the Analytics library // When using the BoM, you don't specify versions in Firebase library dependencies implementation("com.google.firebase:firebase-analytics") }
Благодаря Firebase Android BoM в вашем приложении всегда будут использоваться совместимые версии библиотек Firebase Android.
(Альтернативный вариант) Добавьте зависимости библиотеки Firebase без использования BoM.
Если вы не хотите использовать Firebase BoM, вам нужно будет указать версию каждой библиотеки Firebase в строке зависимости.
Если вы используете в приложении несколько библиотек Firebase, настоятельно рекомендуем управлять их версиями с помощью BoM. Это позволит обеспечить совместимость всех версий.
dependencies { // Add the dependency for the Analytics library // When NOT using the BoM, you must specify versions in Firebase library dependencies implementation("com.google.firebase:firebase-analytics:24.0.0") }
Вверху файла укажите объект
com.google.firebase.analytics.FirebaseAnalytics:Kotlin
private lateinit var firebaseAnalytics: FirebaseAnalytics
Java
private FirebaseAnalytics mFirebaseAnalytics;
Выполните инициализацию этого объекта в методе
onCreate():Kotlin
// Obtain the FirebaseAnalytics instance. firebaseAnalytics = Firebase.analytics
Java
// Obtain the FirebaseAnalytics instance. mFirebaseAnalytics = FirebaseAnalytics.getInstance(this);
Начать регистрацию событий
После создания экземпляра FirebaseAnalytics вы можете начать регистрировать события с помощью метода logEvent().
Некоторые события рекомендуются для всех приложений, а другие – для определенных видов деятельности или отраслей. Рекомендуемые нами события и связанные с ними обязательные параметры позволят вам получать максимально информативные отчеты и пользоваться всеми возможностями, которые мы планируем добавить в будущем. В этом разделе показано, как регистрировать стандартные события. Подробнее о регистрации событий…
В примере ниже событие SELECT_CONTENT регистрируется, когда пользователь нажимает на определенный элемент в приложении.
Kotlin
firebaseAnalytics.logEvent(FirebaseAnalytics.Event.SELECT_ITEM) { param(FirebaseAnalytics.Param.ITEM_ID, id) param(FirebaseAnalytics.Param.ITEM_NAME, name) param(FirebaseAnalytics.Param.CONTENT_TYPE, "image") }
Java
Bundle bundle = new Bundle(); bundle.putString(FirebaseAnalytics.Param.ITEM_ID, id); bundle.putString(FirebaseAnalytics.Param.ITEM_NAME, name); bundle.putString(FirebaseAnalytics.Param.CONTENT_TYPE, "image"); mFirebaseAnalytics.logEvent(FirebaseAnalytics.Event.SELECT_CONTENT, bundle);
Вы можете включить ведение подробных журналов, чтобы убедиться, что события правильно регистрируются с помощью SDK. Это относится к событиям, регистрируемым как автоматически, так и вручную.
Вы можете включить ведение подробных журналов с помощью серии команд adb:
adb shell setprop log.tag.FA VERBOSE
adb shell setprop log.tag.FA-SVC VERBOSE
adb logcat -v time -s FA FA-SVC
Эта команда отображает ваши события в инструменте Logcat в Android Studio. Так вы сразу сможете проверить, отправляются ли события.
Дальнейшие действия
- Изучите каждый отчет Аналитики.
- Проверьте отправку событий, используя DebugView.
- Ознакомьтесь с данными в консоли Firebase.
- Изучите руководства по событиям и свойствам пользователей.
- Узнайте, как экспортировать данные в BigQuery.