Автоматично реєструються події, активовані основними взаємодіями з вашим додатком і/або сайтом (як зазначено під назвою події в таблиці нижче). Якщо використовувати тег Google або пакет Google Analytics for Firebase SDK, писати додатковий код для збирання таких подій не потрібно.
Якщо не вказано інше, Analytics збирає дані як для додатків Android, так і для iOS. Назви й параметри автоматично реєстрованих подій можуть придатися під час роботи з необробленими даними про події в BigQuery.
Щоб дізнатися більше про кожен параметр події і те, як він оновлює параметр або показник у Google Analytics, перегляньте цю статтю.
Примітка
Нижче наведено кілька параметрів, які реєструються за умовчанням для кожної події, зокрема для спеціальних подій.
- Вебпотік:
- language;
- page_location (URL-адреса сторінки);
- page_referrer (URL-адреса попередньої сторінки);
- 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 і firebase_screen_class реєструються автоматично, якщо ви не вимкнете відстеження переглядів екрана.
| Подія | Автоматична активація | Параметри |
|---|---|---|
|
ad_click (додаток) |
Реєструється, коли користувач натискає оголошення. Такі події, визначені видавцем, надходять з AdMob через пакет Google Mobile Ads SDK або з Ad Manager через відповідну інтеграцію. Ця подія не експортується в 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 або з Ad Manager через відповідну інтеграцію. Ця подія не експортується в BigQuery. |
ad_event_id, value* |
|
ad_query (додаток) |
Реєструється, коли з Google Mobile Ads SDK надходить запит оголошення. Ця подія не відображається у звітах і не експортується в BigQuery. |
ad_event_id |
|
ad_reward (додаток) |
Реєструється, коли надається винагорода для оголошення з винагородою, розміщеного через Google Mobile Ads SDK. | ad_unit_code, reward_type, reward_value |
|
adunit_exposure (додаток) |
Реєструється, коли на екрані показується рекламний блок, розміщений через Google 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 більше не підтримуються. Докладніше про ці зміни. |
source, medium, campaign, link_id, accept_time |
|
dynamic_link_ app_update (додаток) |
Реєструється, коли додаток оновлюється й відкривається за динамічним посиланням. Лише для Android. Примітка. Цю подію буде вилучено, оскільки динамічні посилання Firebase більше не підтримуються. Докладніше про ці зміни. |
source, medium, campaign, link_id, accept_time |
|
dynamic_link_ first_open (додаток) |
Реєструється, коли користувач переходить у додаток за динамічним посиланням і відкриває його вперше. Примітка. Цю подію буде вилучено, оскільки динамічні посилання Firebase більше не підтримуються. Докладніше про ці зміни. |
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 (Apple). |
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 із миттєвим запуском, для яких увімкнено Analytics. | |
|
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. Ідентифікатори й назви товарів, а також їх кількість і валюта покупки передаються у вигляді параметрів. Ця подія реєструється лише у версіях додатка, що включають пакет Google Analytics for Firebase SDK. Для Android Щоб переглядати дані про покупки в додатку для Android, зв’яжіть Analytics із Google Play. Зверніть увагу, що Analytics не вимірює дохід від покупок у платних додатках автоматично. Крім того, ваш дохід у Google Analytics може відрізнятися від даних у Google Play Console. Analytics ігнорує події, позначені як недійсні або тестові. Докладніше про тестування Google Play Платежів. Для iOS Зверніть увагу, що Analytics не відстежує дохід від покупок у платних додатках і повернення коштів автоматично. Analytics ігнорує події, позначені як недійсні або тестові. |
product_id, price, value, currency, quantity, subscription, free_trial, introductory_price |
|
notification_dismiss (додаток) |
Реєструється, коли користувач закриває сповіщення від хмарної системи обміну повідомленнями Firebase (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 (page URL), page_referrer (previous page 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 не передаються за допомогою інтеграції за умовчанням.