DebugView позволяет просматривать необработанные данные о событиях, зарегистрированных приложением на устройствах разработчиков, практически в реальном времени. Это очень полезно для проверки на этапе разработки, так как позволяет выявлять ошибки в реализации Analytics и убедиться, что все события и свойства пользователей регистрируются правильно.
Как включить режим отладки
Как правило, события, зарегистрированные приложением, объединяются в пакеты в течение примерно одного часа и загружаются вместе. Этот подход позволяет экономить заряд батареи на устройствах конечных пользователей и сократить использование сетевой передачи данных. Однако для проверки реализации Analytics (и чтобы посмотреть Analytics в отчете DebugView) можно включить режим отладки на устройстве разработчика, чтобы загружать события с минимальной задержкой.
iOS+
Чтобы включить режим отладки Analytics на устройстве разработки, укажите следующий аргумент командной строки в Xcode:
-FIRDebugEnabled
Аналитика будет работать в этом режиме, пока вы его не отключите с помощью следующего аргумента командной строки:
-FIRDebugDisabled
Чтобы добавить эти аргументы, измените схему проекта и добавьте новую запись в раздел "Аргументы, передаваемые при запуске".
Android
Чтобы включить режим отладки Analytics на устройстве Android, выполните следующие команды:
adb shell setprop debug.firebase.analytics.app PACKAGE_NAME
Аналитика будет работать в этом режиме, пока вы его не отключите с помощью следующей команды:
adb shell setprop debug.firebase.analytics.app .none.
Веб-приложение
Чтобы включить режим отладки Analytics в браузере, установите расширение Google Analytics Debugger для Chrome.
Затем включите расширение и обновите страницу. После этого расширение будет регистрировать все события в приложении в режиме отладки.
События, зарегистрированные в DebugView, можно посмотреть в консоли Firebase.
Посмотреть события error
В отчете DebugView показываются как автоматически регистрируемые события error (указывающие на проблемы с регистрацией событий или свойств пользователя), так и другие события, включающие параметр firebase_error.
Обратите внимание, что события error отображаются в потоке напрямую, а для других событий, включающих параметр firebase_error, в DebugView не показывается специальный индикатор ошибки в основном потоке событий. Чтобы увидеть параметр firebase_error в списке параметров, нажмите на событие.
Чтобы устранить ошибки реализации Analytics, проверьте журналы консоли устройства на наличие сообщений от Firebase Analytics SDK. В них часто содержится информация о том, почему событие или параметр были отклонены.
Как создавать отчеты на основе данных о событиях
Убедитесь, что на устройствах разработки включен режим отладки, как описано в предыдущем разделе этого руководства.
В консоли Firebase выберите Аналитика > DebugView.
Начните взаимодействовать с приложением, чтобы увидеть, как события приложения регистрируются в отчете DebugView в консоли Firebase.
В среднем столбце "Поток секунд" показаны события, зарегистрированные за последние 60 секунд. Левый столбец "Поток минут" содержит архивы событий за последние 30 минут, а правый – основные события, зарегистрированные в течение 30-минутного периода, а также текущие свойства пользователя на выбранном устройстве разработки.
Поток секунд
По умолчанию в этом столбце отображается список событий, зарегистрированных в течение последних 60 секунд. Для каждого события указана временная метка, соответствующая времени регистрации на устройстве разработки. Выбрав событие, вы увидите список связанных с ним параметров.
Во время работы с приложением свойства пользователя меняются, поэтому в списке будут появляться новые записи.
Поток минут
Этот поток состоит из серии кружков, по одному на каждую из последних 30 минут. Число в каждом кружке обозначает количество полученных за эту минуту событий. Нажав на кружок, вы увидите в столбце "Поток секунд" список событий, зарегистрированных за эту минуту. Это позволяет подробно изучать события, зарегистрированные за последние 30 минут.
Лучшие события и текущие свойства пользователя
В таблице "Топ событий" вы увидите топ событий, зарегистрированные в течение 30-минутного периода. В таблице "Текущие свойства пользователя" представлено последнее состояние набора свойств пользователя на выбранном устройстве разработки.
Селектор устройств
Поскольку режим отладки может быть включен на нескольких устройствах, с помощью специального переключателя можно выбрать устройство, для которого будет составляться отчет DebugView. Благодаря этой функции с инструментами может одновременно работать несколько специалистов.
