Events and key events

[GA4] Автоматично събирани събития

Автоматично събираните събития се задействат от основни взаимодействия с приложението и/или сайта Ви (както е посочено под името на събитието в таблицата по-долу). Ако използвате маркера на 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_impression.

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

Това събитие се различава от показателите Дневен брой деинсталирания по устройство и Дневен брой деинсталирания по потребител, които се отчитат в Google Play Console. Събитието app_remove отчита премахването на пакети на приложение независимо от източника на инсталиране. Броят премахвания се променя в зависимост от използвания за отчета период от време. Показателите дневен брой деинсталирания по устройство и дневен брой деинсталирания по потребител отчитат премахването на пакети на приложение само когато са инсталирани чрез Google Play и се отчитат ежедневно.

 

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 (булева)

когато потребител отвори повторно приложението чрез динамична връзка

Забележка: Това събитие се премахва, тъй като динамичните връзки от Firebase са оттеглени. Научете повече за тези промени.

source, medium, campaign, link_id, accept_time

при актуализиране до нова версия и отваряне на приложението чрез динамична връзка

Само за Android

Забележка: Това събитие се премахва, тъй като динамичните връзки от Firebase са оттеглени. Научете повече за тези промени.

source, medium, campaign, link_id, accept_time

когато потребител отвори приложението чрез динамична връзка за първи път

Забележка: Това събитие се премахва, тъй като динамичните връзки от Firebase са оттеглени. Научете повече за тези промени.

source, medium, campaign, link_id, accept_time

error

(приложение)

регистрира се вместо събитие, което не може да бъде регистрирано, тъй като по някакъв начин е невалидно

Параметрите _err (firebase_error), _ev (firebase_error_value) и _el (firebase_error_length) съдържат допълнителна информация.

Това събитие не се показва в отчетите и не се експортира в 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 с активиран Анализ client_id, ga_session_id, ga_session_number, ignore_referrer, page_location, page_referrer, page_title, traffic_type

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

(приложение, уебсайт)

когато потребител се ангажира с приложението или уебсайта

Идентификаторът и номерът на сесията се генерират автоматично за всяка сесия и се свързват с всяко събитие в нея. Научете повече

client_id, ga_session_id, ga_session_number, ignore_referrer, page_location, page_referrer, page_title, traffic_type

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

Това полезно ли бе?

Как можем да направим подобрения?
true
Търсене
Изчистване на търсенето
Затваряне на търсенето
Приложения на Google
Главно меню