Ang mga event na awtomatikong kinokolekta ay nati-trigger ng mga karaniwang interaction sa iyong app at/o site (tulad ng nakasaad sa ilalim ng pangalan ng event sa talahanayan sa ibaba). Hangga't ginagamit mo ang Google tag o Google Analytics para sa Firebase SDK, hindi mo kailangang magsulat ng anumang karagdagang code para kolektahin ang mga event na ito.
Nangongolekta ng mga event ang Analytics para sa mga Android at iOS app maliban kung iba ang nakasaad. Posibleng makatulong ang mga pangalan at parameter ng mga event na ito kapag ina-access mo ang iyong raw na data ng event sa BigQuery.
Para maunawaan ang bawat parameter ng event na nakalista sa ibaba at kung paano ina-update ng bawat parameter ang isang dimensyon o sukatan sa Google Analytics, tingnan ang Mga parameter ng event sa Google Analytics.
Tandaan:
Ang mga sumusunod ay ilan sa mga parameter na nakolekta bilang default sa bawat event, kasama ang mga custom na event:
- Web stream:
- wika
- page_location
- page_referrer
- page_title
- screen_resolution
- App stream:
- app_version
- firebase_screen_id
- firebase_screen_class
Dapat may 100 character o mas kaunti ang value na itinalaga sa mga parameter ng event. Dapat may 300 character o mas kaunti ang parameter na page_title. Dapat na 420 character o mas kaunti ang parameter na page_referrer. Dapat na 1,000 character o mas kaunti ang parameter na page_location.
Kung io-override mo ang parameter na page_location, tiyaking valid ang URL path. Kung magtatalaga ka ng invalid na URL path, magiging walang laman ang dimensyong Lokasyon ng page. Puwede mong gamitin ang Tagabuo ng URL ng Campaign para suriin kung valid ang isang URL path.
Awtomatikong kinokolekta ang mga parameter na firebase_screen_id at firebase_screen_class, maliban na lang kung idi-disable mo ang pag-track ng view ng screen.
| Event | Awtomatikong nati-trigger... | Mga Parameter |
|---|---|---|
|
ad_click (app) |
kapag nag-click ng ad ang isang user Mga event ng publisher na mula sa AdMob sa pamamagitan ng Google Mobile Ads SDK o Ad Manager sa pamamagitan ng pag-integrate ng Ad Manager Hindi ine-export ang event na ito sa BigQuery. |
ad_event_id |
|
ad_exposure (app) |
kapag nasa screen ang kahit man lang isang ad na inihatid ng Mobile Ads SDK Hindi lumalabas ang event na ito sa mga ulat at hindi ito na-export sa BigQuery. |
firebase_screen, firebase_screen_id, firebase_screen_class, exposure_time |
|
ad_impression (app) |
kapag may nakitang ad impression ang isang user Mga event ng publisher na mula sa AdMob sa pamamagitan ng Google Mobile Ads SDK o Ad Manager sa pamamagitan ng pag-integrate ng Ad Manager Hindi ine-export ang event na ito sa BigQuery. Tandaan: Ipinapasa ang value o currency ng |
ad_event_id, value |
|
ad_query (app) |
kapag may ginawang kahilingan sa ad ang Mobile Ads SDK Hindi lumalabas ang event na ito sa mga ulat at hindi ito na-export sa BigQuery. |
ad_event_id |
|
ad_reward (app) |
kapag may ibinigay na reward ang isang rewarded ad na inihatid ng Mobile Ads SDK | ad_unit_code, reward_type, reward_value |
|
adunit_exposure (app) |
kapag nasa screen ang isang unit ng ad na inihatid ng Mobile Ads SDK Hindi lumalabas ang event na ito sa mga ulat at hindi ito na-export sa BigQuery. |
firebase_screen, firebase_screen_id, firebase_screen_class, exposure_time |
|
app_clear_data (app) |
kapag na-reset/na-clear ng user ang data ng app, na mag-aalis ng lahat ng setting at data sa pag-sign in Android lang |
|
|
app_exception (app) |
kapag nag-crash o nagkaroon ng exception ang app Ipinapadala ang event kapag na-integrate mo ang Firebase Crashlytics. |
fatal, timestamp, engagement_time_msec |
|
app_remove (app) |
kapag may inalis (na-uninstall) na package ng application sa Android device Android lang |
|
|
app_store_refund (app) |
kapag na-refund ng Google Play ang isang in-app na pagbili Android lang Hindi ine-export ang event na ito sa BigQuery. |
product_id, value, currency, quantity |
|
app_store_subscription_cancel (app) |
kapag nakansela ang isang binabayarang subscription sa Google Play Android lang Kailangang may panimulang subscription na ginawa noong Hulyo 1, 2019 o pagkatapos ng petsang ito. Hindi ine-export ang event na ito sa BigQuery. |
product_id, price, value, currency, cancellation_reason |
|
app_store_subscription_convert (app) |
kapag naging binabayarang subscription ang isang libreng trial na subscription Nakatakda ang event na ito bilang default na pangunahing event Kailangang may panimulang subscription na ginawa noong Hulyo 1, 2019 o pagkatapos ng petsang ito. Ila-log ang isang panimulang libreng trial na subscription bilang in_app_purchase na may parameter ng subscription na nakatakda sa true. Hindi ine-export ang event na ito sa BigQuery. |
product_id, price, value, currency, quantity |
|
app_store_subscription_renew (app) |
kapag na-renew ang isang binabayarang subscription Nakatakda ang event na ito bilang default na pangunahing event Kailangang may panimulang subscription na ginawa noong Hulyo 1, 2019 o pagkatapos ng petsang ito. Hindi ine-export ang event na ito sa BigQuery. |
product_id, price, value, currency, quantity, renewal_count |
|
app_update (app) |
kapag na-update ang app sa bagong bersyon at inilunsad ulit ito Ipapasa bilang parameter ang nakaraang version id ng app. Iba ang konsepto ng event na ito sa sukatang Mga pang-araw-araw na pag-upgrade ayon sa device, na inuulat sa pamamagitan ng Google Play Developer Console. Tumutukoy ang upgrade sa pag-update ng binary ng application, samantalang nati-trigger ang event na app_update sa kasunod na paglunsad ng na-upgrade na app. |
previous_app_version |
|
click (web) |
sa tuwing may user na magki-click sa isang link na paalis sa kasalukuyang domain Bilang default, mangyayari ang mga event na palabas na pag-click para sa lahat ng link na palabas sa kasalukuyang domain. Hindi magti-trigger ng mga event na outbound na pag-click ang mga link na papunta sa mga domain na na-configure para sa cross-domain na pagsukat. Pino-populate ng mga parameter ang mga sumusunod na dimensyon:
Kinokolekta bilang default sa pamamagitan ng pinahusay na pagsukat. |
link_classes, link_domain, link_id, link_url, outbound (boolean) |
|
dynamic_link_app_open (app) |
kapag binuksan ulit ng user ang app sa pamamagitan ng dynamic link Tandaan: Inaalis na ang event na ito dahil hindi na ginagamit ang Mga Dynamic Link ng Firebase sa kasalukuyan. Matuto pa tungkol sa mga pagbabagong ito. |
source, medium, campaign, link_id, accept_time |
|
dynamic_link_app_update (app) |
kapag na-update ang app sa bagong bersyon at binuksan ito sa pamamagitan ng dynamic link Android lang Tandaan: Inaalis na ang event na ito dahil hindi na ginagamit ang Mga Dynamic Link ng Firebase sa kasalukuyan. Matuto pa tungkol sa mga pagbabagong ito. |
source, medium, campaign, link_id, accept_time |
|
dynamic_link_first_open (app) |
kapag binuksan ng isang user ang app sa unang pagkakataon sa pamamagitan ng dynamic link Tandaan: Inaalis na ang event na ito dahil hindi na ginagamit ang Mga Dynamic Link ng Firebase sa kasalukuyan. Matuto pa tungkol sa mga pagbabagong ito. |
source, medium, campaign, link_id, accept_time |
|
error (app) |
nila-log sa halip na isang event na hindi ma-log dahil invalid ito sa anumang dahilan Hindi lumalabas ang event na ito sa mga ulat at hindi ito na-export sa BigQuery. |
firebase_error, firebase_error_value |
|
file_download (web) |
kapag may user na nag-click sa isang link na humahantong sa isang file (na may karaniwang extension ng file) na ang uri ay isa sa mga sumusunod:
Kinolekta ang event na ito bilang default sa pamamagitan ng pinahusay na pagsukat. Tingnan ang mga file extension na nagti-trigger sa event |
file_extension, file_name link_classes, link_id, link_text, link_url |
|
firebase_campaign (app) |
kapag inilunsad ang app gamit ang mga parameter ng campaign |
source, medium, campaign, term, content, gclid, aclid, cp1, anid, click_timestamp, campaign_info_source |
|
firebase_in_app_message_action (iOS) fiam_action (Android) |
kapag may user na umaksyon sa isang In-App na Mensahe sa Firebase | message_name, message_device_time, message_id |
|
firebase_in_app_message_dismiss (iOS) fiam_dismiss (Android) |
kapag may user na nag-dismiss ng In-App na Mensahe sa Firebase | message_name, message_device_time, message_id |
|
firebase_in_app_message_impression (iOS)
fiam_impression (Android) |
kapag may user na nakakita ng In-App na Mensahe sa Firebase | message_name, message_device_time, message_id |
|
first_open (app) |
sa unang beses na inilunsad ng isang user ang isang app pagkatapos niya itong i-install o i-install ulit Hindi nati-trigger ang event na ito kapag na-download ng isang user ang app sa isang device, sa halip, mati-trigger ito kapag ginamit niya ito sa unang pagkakataon. Para makita ang mga raw na bilang ng pag-download, tingnan sa Google Play Console o sa iTunesConnect. Sinusuportahan ang pagsukat ng mga pangunahing event na first_open para sa mga user na tumanggap sa prompt sa pagsubaybay ng app ng iOS 14 ng 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 (app, web) |
sa unang beses na bumisita ang isang user sa isang website o naglunsad siya ng Android instant app nang naka-enable ang Analytics | client_id, ga_session_id, ga_session_number, ignore_referrer, page_location, page_referrer, page_title, traffic_type |
|
form_start (web) |
sa unang beses na mag-interact ang user sa isang form sa session Kinokolekta bilang default sa pamamagitan ng pinahusay na pagsukat. |
form_id, form_name, form_destination |
|
form_submit (web) |
kapag nagsumite ng form ang user Kinokolekta bilang default sa pamamagitan ng pinahusay na pagsukat. |
form_id, form_name, form_destination, form_submit_text |
|
in_app_purchase (app) |
kapag nakakumpleto ang isang user ng in-app na pagbili, kasama ang paunang subscription, na pinoproseso ng Apple App Store o Google Play Store Ipapasa bilang mga parameter ang product ID, pangalan ng produkto, currency, at dami. Nati-trigger lang ang event na ito ng mga bersyon ng iyong app na may kasamang SDK ng Google Analytics para sa Firebase. Android: Para makakita ng data ng in-app na pagbili para sa mga Android app, i-link ang Analytics sa Google Play. Tandaang hindi awtomatikong sinusukat ng Analytics ang kita sa pagbili ng bayad na app. Puwede ring iba ang iniulat mong kita sa Google Analytics sa mga value na nakikita mo sa Google Play Developer Console. Binabalewala ng Analytics ang mga event na na-flag bilang invalid o mga pagsubok. Matuto pa tungkol sa pagsubok sa pagsingil sa Google Play. iOS: Tandaang hindi awtomatikong sinusukat ng Analytics ang kita at mga pag-refund sa pagbili ng bayad na app. Binabalewala ng Analytics ang mga event na na-flag bilang invalid o sandbox. |
product_id, price, value, currency, quantity, subscription, free_trial, introductory_price |
|
notification_dismiss (app) |
kapag nag-dismiss ang isang user ng notification na ipinadala ng Firebase Cloud Messaging (FCM) Android lang |
message_name, message_time, message_device_time, message_id, topic, label, message_channel |
|
notification_foreground (app) |
kapag may natanggap na notification na ipinadala ng FCM habang nasa foreground ang app | message_name, message_time, message_device_time, message_id, topic, label, message_channel, message_type |
|
notification_open (app) |
kapag nagbukas ang isang user ng notification na ipinadala ng FCM | message_name, message_time, message_device_time, message_id, topic, label, message_channel |
|
notification_receive (app) |
kapag may natanggap na notification na ipinadala ng FCM ang isang device kapag nasa background ang app Android lang |
message_name, message_time, message_device_time, message_id, topic, label, message_channel, message_type |
|
os_update (app) |
kapag na-update sa bagong bersyon ang operating system ng device. Ipapasa bilang parameter ang nakaraang version id ng operating system | previous_os_version |
|
page_view (web) |
sa tuwing maglo-load ang page o babaguhin ng aktibong site ang status ng history ng browser Kinokolekta bilang default sa pamamagitan ng pinahusay na pagsukat. |
page_location (URL ng page), page_referrer (URL ng nakaraang page), engagement_time_msec |
|
screen_view (app) |
kapag may nangyaring transition ng screen at natugunan ang alinman sa mga sumusunod na pamantayan:
|
firebase_screen, firebase_screen_class, firebase_screen_id, firebase_previous_screen, firebase_previous_class, firebase_previous_id, engagement_time_msec |
|
scroll (web) |
sa unang pagkakataong maabot ng isang user ang ibaba ng bawat page (ibig sabihin, kapag nakita na ang 90% patayong lalim) Kinokolekta bilang default sa pamamagitan ng pinahusay na pagsukat. |
engagement_time_msec |
|
session_start (app, web) |
kapag nakipag-ugnayan ang isang user sa app o website Awtomatikong bubuo ng session ID at bilang ng session sa bawat session at iuugnay ang mga ito sa bawat event sa session. Matuto pa |
client_id, ga_session_id, ga_session_number, ignore_referrer, page_location, page_referrer, page_title, traffic_type |
|
user_engagement (app, web) |
kapag nasa foreground ang app o pinagtutuunan ang webpage sa loob ng kahit isang segundo lang. Matuto pa |
engagement_time_msec |
|
video_complete (web) |
kapag natapos ang video Para sa mga naka-embed na video sa YouTube na may naka-enable na suporta sa JS API. Kinokolekta bilang default sa pamamagitan ng pinahusay na pagsukat. |
video_current_time, video_duration, video_percent, video_provider, video_title, video_url, visible (boolean) |
|
video_progress (web) |
kapag lumampas sa 10%, 25%, 50%, at 75% ng tagal ang pag-usad ng video Para sa mga naka-embed na video sa YouTube na may naka-enable na suporta sa JS API. Kinokolekta bilang default sa pamamagitan ng pinahusay na pagsukat. |
video_current_time, video_duration, video_percent, video_provider, video_title, video_url, visible (boolean) |
|
video_start (web) |
kapag nagsimulang mag-play ang video Para sa mga naka-embed na video sa YouTube na may naka-enable na suporta sa JS API. Kinokolekta bilang default sa pamamagitan ng pinahusay na pagsukat. |
video_current_time, video_duration, video_percent, video_provider, video_title, video_url, visible (boolean) |
|
view_search_results (web) |
sa tuwing maghahanap sa site ang isang user, na isinasaad ng pagkakaroon ng parameter ng query ng URL Kinokolekta bilang default sa pamamagitan ng pinahusay na pagsukat. |
search_term, opsyonal, ‘q_<additional key="">’ (kung saan tumutugma ang <additional key=""> sa isang karagdagang parameter ng query na tinukoy mong dapat kolektahin sa ilalim ng mga advanced na setting) Tandaan: Ipinapadala lang ng event na ito ang parameter na unique_search_term kapag mayroon itong value na 1 (ibig sabihin, kapag natatangi sa session na iyon ang string). |
Tandaan: Mati-trigger ang event na file_download ng mga file extension na tumutugma sa sumusunod na regex:
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