Автоматично събираните събития се задействат от основни взаимодействия с приложението и/или сайта Ви (както е посочено под името на събитието в таблицата по-долу). Ако използвате маркера на 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 адреси за кампании, за да проверите дали пътят на URL адреса е валиден.
Параметрите firebase_screen_id и firebase_screen_class се събират автоматично, освен ако не деактивирате проследяването на показванията на екрани.
| Събитие | Автоматично задействане... | Параметри |
|---|---|---|
|
ad_click (приложение) |
когато потребител кликне върху реклама Събития за издатели, произтичащи от AdMob посредством SDK на Google Mobile Ads или от Ad Manager посредством интегрирането на Ad Manager Това събитие не се експортира в BigQuery. |
ad_event_id |
|
ad_exposure (приложение) |
когато поне една реклама, показана от SDK на Google Mobile Ads, е на екрана Това събитие не се показва в отчетите и не се експортира в BigQuery. |
firebase_screen, firebase_screen_id, firebase_screen_class, exposure_time |
|
ad_impression (приложение) |
когато потребител види рекламна импресия Събития за издатели, произтичащи от AdMob посредством SDK на Google Mobile Ads или от Ad Manager посредством интегрирането на Ad Manager Това събитие не се експортира в BigQuery. |
ad_event_id, value* |
|
ad_query (приложение) |
когато заявка за реклама бъде направена в SDK на Google Mobile Ads Това събитие не се показва в отчетите и не се експортира в BigQuery. |
ad_event_id |
|
ad_reward (приложение) |
когато бъде дадено поощрение от реклама с поощрение, показана от SDK на Google Mobile Ads | ad_unit_code, reward_type, reward_value |
|
adunit_exposure (приложение) |
когато рекламен елемент, показан от SDK на Google Mobile Ads, е на екрана Това събитие не се показва в отчетите и не се експортира в 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 с параметъра на абонамента, зададен на 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 за проследяване в приложение. |
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 (приложение) |
когато потребител извърши покупка в приложение, включително първоначален абонамент, и покупката е обработена от App Store или от Google Play Магазин Идентификаторът, името и количеството на продуктите и използваната валута се предават като параметри. Това събитие се задейства само от версии на приложението Ви, които включват SDK на Google Анализ за Firebase. Android: За да видите данните за покупки в приложение за Android, свържете Анализ с Google Play. Обърнете внимание, че Анализ не измерва автоматично приходите от покупки в платени приложения. Също така отчетените Ви приходи от Google Анализ може да се различават от стойностите, които виждате в Google Play Console. Анализ пренебрегва събитията, които са означени като невалидни или пробни. Научете повече за тестването на системата на Google Play за таксуване. iOS: Обърнете внимание, че Анализ не измерва автоматично приходите от покупки в платени приложения и възстановяването на средства. Анализ пренебрегва събитията, които са означени като невалидни или тестова среда. |
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 (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 с активирана поддръжка на API за JavaScript. Събира се по подразбиране чрез подобрено измерване. |
video_current_time, video_duration, video_percent, video_provider, video_title, video_url, visible (Булеви) |
|
video_progress (мрежата) |
когато видеоклипът премине 10%, 25%, 50% и 75% от времетраенето За вградени видеоклипове в YouTube с активирана поддръжка на API за JavaScript. Събира се по подразбиране чрез подобрено измерване. |
video_current_time, video_duration, video_percent, video_provider, video_title, video_url, visible (Булеви) |
|
video_start (мрежата) |
когато видеоклипът започне да се възпроизвежда За вградени видеоклипове в YouTube с активирана поддръжка на API за JavaScript. Събира се по подразбиране чрез подобрено измерване. |
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
* При стандартното интегриране не се предават стойност или валута за ad_impression