Автоматически регистрируемые события активируются в результате основных действий пользователей на вашем сайте или в приложении (см. приведенную ниже таблицу). Если вы используете SDK Google Аналитики для Firebase или gtag.js, создавать дополнительный код для регистрации таких событий не требуется.
Аналитика собирает данные о событиях в приложениях для Android и iOS, если не указано иное. Названия и параметры этих событий помогут вам при обращении к исходным данным в BigQuery.
Примечание
По умолчанию для всех событий, в том числе специальных, регистрируются параметры, приведенные в таблице ниже. Однако если у автоматически регистрируемых событий нет параметров, указанных в таблице ниже, для них собираются только следующие параметры:
- language
- page_location
- page_referrer
- page_title
- screen_resolution
Значение специального параметра должно содержать не более 100 символов, а параметра page_title – не более 300 символов. Значения параметров page_location и page_referrer могут содержать не более 420 символов.
Если вы перезаписываете параметр page_location, убедитесь, что у вас задан действительный путь URL. В противном случае для параметра Местонахождение страницы не будет указано никакого значения. С помощью Компоновщика URL кампании вы можете проверить, действителен ли путь URL.
Событие | Когда активируется | Параметры |
---|---|---|
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 (в приложении) |
В приложении возникает сбой или исключение. | 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 (на сайте) |
Регистрируется каждый раз, когда пользователь нажимает на ссылку, ведущую за пределы вашего домена. Сбор таких данных выполняется по умолчанию с помощью улучшенной статистики. |
Никакие параметры не регистрируются |
dynamic_link_app_open (в приложении) |
Пользователь повторно открывает приложение с помощью динамической ссылки. | source, medium, campaign, link_id, accept_time |
dynamic_link_ app_update (в приложении) |
После обновления приложения его новая версия открывается с помощью динамической ссылки. Только для Android. |
source, medium, campaign, link_id, accept_time |
dynamic_link_ first_open (в приложении) |
Пользователь впервые открывает приложение с помощью динамической ссылки. | source, medium, campaign, link_id, accept_time |
error (в приложении) |
Происходит событие, которое по какой-либо причине не удается зарегистрировать. Это событие не отражается в отчетах и не экспортируется в BigQuery. |
firebase_error, firebase_error_value |
file_download (на сайте) |
Пользователь нажимает на ссылку, указывающую на файл (со стандартным расширением) одного из следующих типов:
Это событие обрабатывается по умолчанию через улучшенную статистику. Ознакомьтесь с расширениями файлов, которые активируют событие. |
file_extension, file_name link_classes, link_domain, link_id, link_text, link_url |
firebase_campaign (в приложении) |
Приложение запускается с параметрами кампании. Это событие не отражается в отчетах и не экспортируется в BigQuery. |
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 |
notification_send (в приложении) |
Отправляется уведомление от FCM. Только для Android. |
message_name, message_time, message_device_time, message_id, topic, label, message_channel |
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=""> соответствует дополнительному параметру запроса, сбор которого включен в дополнительных настройках) |
Примечание. Событие 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