Автоматически регистрируемые события активируются в результате основных действий пользователей на вашем сайте или в приложении (см. приведенную ниже таблицу). Если вы используете тег Google или SDK Google Аналитики для Firebase, создавать дополнительный код для регистрации таких событий не требуется.
Аналитика собирает данные о событиях в приложениях для Android и iOS, если не указано иное. Названия и параметры этих событий помогут вам при обращении к исходным данным в BigQuery.
Дополнительную информацию о параметрах, которые используются для автоматически регистрируемых и рекомендуемых событий, а также о том, как каждый параметр влияет на параметры и показатели в Google Аналитике, можно найти в статье о параметрах событий Google Аналитики.
Примечания
Ниже указаны некоторые параметры, собираемые по умолчанию для каждого события, включая специальные события:
- поток сайта:
- language
- page_location
- page_referrer
- page_title
- screen_resolution
- поток приложения:
- app_version
- firebase_screen_id
- firebase_screen_class
Значение параметра события должно содержать не более 100 символов, а параметра page_title – не более 300 символов. Значение параметра page_referrer может содержать не более 420 символов. Значение параметра page_location может содержать не более 1000 символов.
Если вы изменяете значение параметра page_location, проверьте правильность пути URL. В противном случае для параметра Местонахождение страницы не будет указано никакого значения. С помощью компоновщика URL кампании можно проверить, действителен ли путь URL.
Параметры firebase_screen_id and firebase_screen_class собираются автоматически, если отслеживание просмотров страниц не отключено.
| Событие | Когда активируется | Параметры |
|---|---|---|
|
ad_click (в приложении) |
Пользователь нажимает на объявление. События, заданные издателем, поступают из AdMob через Google Mobile Ads SDK или из Менеджера рекламы через интеграцию с этим сервисом. Это событие не экспортируется в BigQuery. |
ad_event_id |
|
ad_exposure (в приложении) |
На экране показывается хотя бы одно объявление с помощью Google Mobile Ads SDK. Это событие не отражается в отчетах и не экспортируется в BigQuery. |
firebase_screen, firebase_screen_id, firebase_screen_class, exposure_time |
|
ad_impression (в приложении) |
Пользователю показывается объявление. События, заданные издателем, поступают из AdMob через Google Mobile Ads SDK или из Менеджера рекламы через интеграцию с этим сервисом. Это событие не экспортируется в BigQuery. |
ad_event_id, value* |
|
ad_query (в приложении) |
Выполняется запрос объявления с помощью Mobile Ads SDK. Это событие не отражается в отчетах и не экспортируется в BigQuery. |
ad_event_id |
|
ad_reward (в приложении) |
Предоставляется вознаграждение за просмотр объявления, показанного с помощью Mobile Ads SDK. | ad_unit_code, reward_type, reward_value |
|
adunit_exposure (в приложении) |
На экране показывается рекламный блок с помощью Mobile Ads SDK. Это событие не отражается в отчетах и не экспортируется в BigQuery. |
firebase_screen, firebase_screen_id, firebase_screen_class, exposure_time |
|
app_clear_data (в приложении) |
Пользователь удаляет все данные приложения, включая настройки и данные для входа. Только для Android. |
|
|
app_exception (в приложении) |
В приложении возникает сбой или исключение. Информация о событии передается, если вы интегрировали Firebase Crashlytics. |
fatal, timestamp, engagement_time_msec |
|
app_remove (в приложении) |
Пакет приложения удаляется с устройства Android. Только для Android. |
|
|
app_store_refund (в приложении) |
Google Play возвращает средства за покупку в приложении. Только для Android. Это событие не экспортируется в BigQuery. |
product_id, value, currency, quantity |
|
app_store_ subscription_cancel (в приложении) |
Пользователь отменяет платную подписку в Google Play. Только для Android. Подписка должна быть оформлена не ранее 1 июля 2019 г. Это событие не экспортируется в BigQuery. |
product_id, price, value, currency, cancellation_reason |
|
app_store_ subscription_convert (в приложении) |
После пробного периода включается платная подписка. Это событие задано как ключевое событие по умолчанию. Подписка должна быть оформлена не ранее 1 июля 2019 г. Исходная бесплатная пробная подписка регистрируется как событие in_app_purchase, в котором для параметра subscription указывается значение true. Это событие не экспортируется в BigQuery. |
product_id, price, value, currency, quantity |
|
app_store_ subscription_renew (в приложении) |
Продлевается платная подписка. Это событие задано как ключевое событие по умолчанию. Подписка должна быть оформлена не ранее 1 июля 2019 г. Это событие не экспортируется в BigQuery. |
product_id, price, value, currency, quantity, renewal_count |
|
app_update (в приложении) |
После обновления приложения запускается его новая версия. Идентификатор прежней версии приложения передается как параметр. Это событие принципиально отличается от показателя "Число обновлений за день (по устройствам)" в Google Play Console. Под обновлением понимается обновление исполняемого файла приложения, а событие app_update запускается при последующем запуске обновленного приложения. |
previous_app_version |
|
click (на сайте) |
Регистрируется каждый раз, когда пользователь нажимает на ссылку, ведущую за пределы вашего домена. По умолчанию такое событие регистрируется при нажатии на любую подобную ссылку. Ссылки на домены, для которых настроено междоменное отслеживание, не будут вызывать события исходящих кликов. Заполняются следующие параметры:
Сбор таких данных выполняется по умолчанию с помощью улучшенной статистики. |
link_classes, link_domain, link_id, link_url, outbound (логическое значение) |
|
dynamic_link_app_open (в приложении) |
Пользователь повторно открывает приложение с помощью динамической ссылки. Примечание. Это событие не используется, поскольку в настоящее время прекращена поддержка Firebase Dynamic Links. Подробнее об этих изменениях… |
source, medium, campaign, link_id, accept_time |
|
dynamic_link_ app_update (в приложении) |
После обновления приложения его новая версия открывается с помощью динамической ссылки. Только для Android. Примечание. Это событие не используется, поскольку в настоящее время прекращена поддержка Firebase Dynamic Links. Подробнее об этих изменениях… |
source, medium, campaign, link_id, accept_time |
|
dynamic_link_ first_open (в приложении) |
Пользователь впервые открывает приложение с помощью динамической ссылки. Примечание. Это событие не используется, поскольку в настоящее время прекращена поддержка Firebase Dynamic Links. Подробнее об этих изменениях… |
source, medium, campaign, link_id, accept_time |
|
error (в приложении) |
Происходит событие, которое по какой-либо причине не удается зарегистрировать. Это событие не отражается в отчетах и не экспортируется в BigQuery. |
firebase_error, firebase_error_value |
|
file_download (на сайте) |
Пользователь нажимает на ссылку, указывающую на файл (со стандартным расширением) одного из следующих типов:
Это событие обрабатывается по умолчанию через улучшенную статистику. Ознакомьтесь с расширениями файлов, которые активируют событие. |
file_extension, file_name link_classes, link_id, link_text, link_url |
|
firebase_campaign (в приложении) |
Приложение запускается с параметрами кампании. |
source, medium, campaign, term, content, gclid, aclid, cp1, anid, click_timestamp, campaign_info_source |
|
firebase_in_app_ message_action (в приложении) |
Пользователь совершает действие, мотивированное сообщением в приложении (Firebase). | message_name, message_device_time, message_id |
|
firebase_in_app_ message_dismiss (в приложении) |
Пользователь закрывает сообщение в приложении (Firebase). | message_name, message_device_time, message_id |
|
firebase_in_app_ message_impression (в приложении) |
Пользователь видит сообщение в приложении (Firebase). | message_name, message_device_time, message_id |
|
first_open (в приложении) |
Пользователь впервые запускает приложение после установки. Это событие регистрируется не при скачивании, а при первом запуске приложения после исходной или повторной установки. Статистику по скачиваниям можно посмотреть в Google Play Console или в iTunesConnect. Поддерживается отслеживание ключевых событий first_open для пользователей, которые приняли предложение об отслеживании приложения для iOS 14. |
previous_gmp_app_id, updated_with_analytics, previous_first_open_count, system_app, system_app_update, deferred_analytics_collection, reset_analytics_cause, engagement_time_msec |
|
first_visit (в приложении или на сайте) |
Пользователь впервые открывает сайт или приложение для Android с мгновенным запуском, в котором используется Аналитика. | |
|
form_start (на сайте) |
Пользователь взаимодействует с формой впервые за сеанс. Примечание. Эти параметры можно использовать в отчетах, только если вы создадите для них специальные параметры. Сбор таких данных выполняется по умолчанию с помощью улучшенной статистики. |
form_id, form_name, form_destination |
|
form_submit (на сайте) |
Пользователь отправляет заполненную форму. Примечание. Эти параметры можно использовать в отчетах, только если вы создадите для них специальные параметры. Сбор таких данных выполняется по умолчанию с помощью улучшенной статистики. |
form_id, form_name, form_destination, form_submit_text |
|
in_app_purchase (в приложении) |
Пользователь совершает в приложении покупку или оформляет подписку, которая обрабатывается в Apple App Store или Google Play. Идентификаторы и названия товаров, а также их количество и валюта покупки передаются в виде параметров. Это событие регистрируется только в тех версиях приложений, где используется SDK Google Аналитики для Firebase. Android: Чтобы посмотреть данные о покупках в приложении Android, свяжите Аналитику с Google Play. Обратите внимание, что Google Аналитика не отслеживает доход и покупки в платных приложениях автоматически. Кроме того, ваш доход в Аналитике может отличаться от данных в Google Play Console. Аналитика игнорирует события, отмеченные как недействительные или тестовые. Подробнее о тестировании оплаты в Google Play… iOS: Обратите внимание, что Google Аналитика не отслеживает доход и возвраты средств в платных приложениях автоматически. Система игнорирует события, которые являются недействительными или помечены как изолированная среда. |
product_id, price, value, currency, quantity, subscription, free_trial, introductory_price |
|
notification_dismiss (в приложении) |
Пользователь закрывает уведомление, отправленное Firebase Cloud Messaging (FCM). Только для Android. |
message_name, message_time, message_device_time, message_id, topic, label, message_channel |
|
notification_foreground (в приложении) |
Уведомление от FCM приходит в момент, когда приложение запущено и открыто. | message_name, message_time, message_device_time, message_id, topic, label, message_channel, message_type |
|
notification_open (в приложении) |
Пользователь открывает уведомление от FCM. | message_name, message_time, message_device_time, message_id, topic, label, message_channel |
|
notification_receive (в приложении) |
Уведомление от FCM приходит в момент, когда приложение функционирует в фоновом режиме. Только для Android. |
message_name, message_time, message_device_time, message_id, topic, label, message_channel, message_type |
|
os_update (в приложении) |
Операционная система на устройстве обновляется. Идентификатор прежней версии ОС передается в виде параметра. | previous_os_version |
|
page_view (на сайте) |
Загружается веб-страница или активный сайт изменяет состояние истории браузера. Сбор таких данных выполняется по умолчанию с помощью улучшенной статистики. |
page_location (URL страницы), page_referrer (URL предыдущей страницы), engagement_time_msec |
|
screen_view (в приложении) |
Выполняется переход на другой экран, и при этом соблюдается хотя бы одно из следующих условий:
|
firebase_screen, firebase_screen_class, firebase_screen_id, firebase_previous_screen, firebase_previous_class, firebase_previous_id, engagement_time_msec |
|
scroll (на сайте) |
Срабатывает один раз для страницы, когда пользователь впервые прокручивает ее до конца, т. е. достигает отметки в 90 % высоты страницы. Сбор таких данных выполняется по умолчанию с помощью улучшенной статистики. |
engagement_time_msec |
|
session_start (в приложении или на сайте) |
Пользователь взаимодействует с приложением или сайтом. Для каждого сеанса генерируется его идентификатор и номер, которые затем связываются с каждым событием в этом сеансе. Подробнее… |
|
|
user_engagement (в приложении или на сайте) |
Приложение находится в активном режиме, или пользователь просматривает веб-страницу хотя бы одну секунду. Подробнее… |
engagement_time_msec |
|
video_complete (на сайте) |
Завершается воспроизведение видео. Для встроенных видео YouTube, для которых включена поддержка JS API. Сбор таких данных выполняется по умолчанию с помощью улучшенной статистики. |
video_current_time, video_duration, video_percent, video_provider, video_title, video_url, visible (логическое значение) |
|
video_progress (на сайте) |
При воспроизведении видео достигается отметка 10, 25, 50 или 75 % от общей продолжительности. Для встроенных видео YouTube, для которых включена поддержка JS API. Сбор таких данных выполняется по умолчанию с помощью улучшенной статистики. |
video_current_time, video_duration, video_percent, video_provider, video_title, video_url, visible (логическое значение) |
|
video_start (на сайте) |
Начинается воспроизведение видео. Для встроенных видео YouTube, для которых включена поддержка JS API. Сбор таких данных выполняется по умолчанию с помощью улучшенной статистики. |
video_current_time, video_duration, video_percent, video_provider, video_title, video_url, visible (логическое значение) |
|
view_search_results (на сайте) |
Пользователь выполняет поиск на сайте (это определяется по параметру запроса в URL). Сбор таких данных выполняется по умолчанию с помощью улучшенной статистики. |
search_term и (необязательно) q_<additional key=""> (где <additional key=""> соответствует дополнительному параметру запроса, сбор которого включен в дополнительных настройках). Примечание. Это событие передает параметр unique_search_term, только если его значение равно 1, то есть когда строка уникальна для этого сеанса. |
Примечание. Событие file_download срабатывает для расширений имен файлов, соответствующих следующему регулярному выражению:
pdf|xlsx?|docx?|txt|rtf|csv|exe|key|pp(s|t|tx)|7z|pkg|rar|gz|zip|avi|mov|mp4|mpe?g|wmv|midi?|mp3|wav|wma
* Параметры value или currency для события ad_impression не передаются путем интеграции по умолчанию.