Automatiškai renkamus įvykius suaktyvina svarbiausios sąveikos su programa ir (arba) svetaine (kaip nurodyta toliau pateiktos lentelės stulpelyje „Įvykio pavadinimas“). Jei naudojate „Google“ žymą arba „Google Analytics“, skirtos „Firebase“, SDK, norint rinkti šiuos įvykius, papildomo kodo rašyti nereikia.
Jei nenurodyta kitaip, „Analytics“ renka šiuos įvykius „Android“ ir „iOS“ programose. Šių įvykių pavadinimai ir parametrai gali būti naudingi pasiekiant neapdorotus įvykių duomenis sistemoje BigQuery.
Jei norite suprasti kiekvieną toliau pateiktą įvykio parametrą ir kaip kiekvienas parametras atnaujina aspektą ar metriką sistemoje „Google Analytics“, skaitykite straipsnį „Google Analytics“ įvykių parametrai“.
Pastaba.
Toliau pateikti keli parametrai, kurie pagal numatytuosius nustatymus renkami su kiekvienu įvykiu, įskaitant tinkintus įvykius.
- Žiniatinklio srautas:
- language
- page_location
- page_referrer
- page_title
- screen_resolution
- Programos srautas:
- app_version
- firebase_screen_id
- firebase_screen_class
Įvykio parametrams priskirta vertė turi būti ne ilgesnė nei 100 simbolių. Parametras page_title turi būti ne ilgesnis nei 300 simbolių. Parametras page_referrer turi būti ne ilgesnis nei 420 simbolių. Parametras page_location turi būti ne ilgesnis nei 1 000 simbolių.
Jei nepaisysite parametro page_location, įsitikinkite, kad URL kelias tinkamas. Jei priskirsite netinkamą URL kelią, puslapio vietos aspektas bus tuščias. Naudodami Kampanijos URL kūrimo priemonę galite patikrinti, ar URL kelias tinkamas.
Parametrai firebase_screen_id ir firebase_screen_class renkami automatiškai, nebent išjungiate ekrano peržiūros stebėjimą.
Įvykis | Automatiškai suaktyvinama... | Parametrai |
---|---|---|
ad_click (programa) |
naudotojui spustelėjus skelbimą; leidėjo įvykiai, gaunami iš „AdMob“ per „Google“ skelbimų mobiliesiems SDK arba „Ad Manager“, naudojant „Ad Manager“ integravimą. Šis įvykis neeksportuojamas į „BigQuery“. |
ad_event_id |
ad_exposure (programa) |
kai ekrane yra bent vienas skelbimų mobiliesiems SDK teikiamas skelbimas; Šis įvykis nerodomas ataskaitose ir nėra eksportuojamas į „BigQuery“. |
firebase_screen, firebase_screen_id, firebase_screen_class, exposure_time |
ad_impression (programa) |
kai naudotojas mato skelbimo parodymą; leidėjo įvykiai, gaunami iš „AdMob“ per „Google“ skelbimų mobiliesiems SDK arba „Ad Manager“, naudojant „Ad Manager“ integravimą. Šis įvykis neeksportuojamas į „BigQuery“. Pastaba: naudojant numatytąjį integravimą neperduodama jokia |
ad_event_id, value |
ad_query (programa) |
kai skelbimų mobiliesiems SDK pateikia skelbimo užklausą; Šis įvykis nerodomas ataskaitose ir nėra eksportuojamas į „BigQuery“. |
ad_event_id |
ad_reward (programa) |
kai skelbimų mobiliesiems SDK teikiamas atlyginamas skelbimas suteikia premiją; | ad_unit_code, reward_type, reward_value |
adunit_exposure (programa) |
kai ekrane yra skelbimų mobiliesiems SDK teikiamas skelbimų rinkinys; Šis įvykis nerodomas ataskaitose ir nėra eksportuojamas į „BigQuery“. |
firebase_screen, firebase_screen_id, firebase_screen_class, exposure_time |
app_clear_data (programa) |
kai naudotojas iš naujo nustato ar išvalo programos duomenis, pašalindamas visus nustatymus ir prisijungimo duomenis. Tik „Android“ |
|
app_exception (programa) |
kai programa užstringa arba pateikia išimties pranešimą; Įvykis siunčiamas, kai integruojate „Firebase Crashlytics“. |
fatal, timestamp, engagement_time_msec |
app_remove (programa) |
kai iš „Android“ įrenginio pašalinamas programos paketas Tik „Android“. |
|
app_store_refund (programa) |
kai „Google Play“ grąžina lėšas už pirkimą programoje. Tik „Android“ Šis įvykis neeksportuojamas į „BigQuery“. |
product_id, value, currency, quantity |
app_store_ subscription_cancel (programa) |
kai sistemoje „Google Play“ atšaukiama mokama prenumerata. Tik „Android“ Būtina pradinė prenumerata, užregistruota 2019 m. liepos 1 d. arba vėliau. Šis įvykis neeksportuojamas į „BigQuery“. |
product_id, price, value, currency, cancellation_reason |
app_store_ subscription_convert (programa) |
kai nemokamas bandomasis prenumeratos laikotarpis paverčiamas mokama prenumerata. Šis įvykis nustatytas kaip numatytasis pagrindinis įvykis. Būtina pradinė prenumerata, užregistruota 2019 m. liepos 1 d. arba vėliau. Pradinis nemokamas bandomasis prenumeratos laikotarpis įrašomas žurnale kaip „in_app_purchase“ ir nustatomas prenumeratos parametras „true“ (teisingas). Šis įvykis neeksportuojamas į „BigQuery“. |
product_id, price, value, currency, quantity |
app_store_ subscription_renew (programa) |
kai atnaujinama mokama prenumerata. Šis įvykis nustatytas kaip numatytasis pagrindinis įvykis. Būtina pradinė prenumerata, užregistruota 2019 m. liepos 1 d. arba vėliau. Šis įvykis neeksportuojamas į „BigQuery“. |
product_id, price, value, currency, quantity, renewal_count |
app_update (programa) |
kai programa atnaujinama įdiegiant naują jos versiją ir paleidžiama iš naujo. Kaip parametras perduodamas ankstesnės programos versijos ID. Šis įvykis savo esme skiriasi nuo naujovinimų per dieną pagal įrenginį metrikos, kurią pateikia „Google Play Console“. Naujovinimas nurodo dvejetainės programos atnaujinimą, o įvykis „app_update“ suaktyvinamas kitą kartą paleidus naujovintą programą; |
previous_app_version |
click (žiniatinklis) |
Kiekvieną kartą naudotojui spustelėjus nuorodą, nukreipiančią nuo dabartinio domeno. Pagal numatytuosius nustatymus į išorines svetaines nukreipiančių paspaudimų įvykiai įvyks naudojant visas nuo dabartinio domeno nukreipiančias nuorodas. Nuorodos į domenus, sukonfigūruotus kryžminiam domenų vertinimui atlikti, nesuaktyvins į išorines svetaines nukreipiančių paspaudimų įvykių. Naudojant šiuos parametrus užpildomos toliau nurodytų aspektų vertės.
Renkamas pagal numatytuosius nustatymus naudojant patobulintą įvertinimą; |
„link_classes“, „link_domain“, „link_id“, „link_url“, „outbound“ (loginis) |
dynamic_link_app_open (programa) |
kai naudotojas pakartotinai atidaro programą palietęs dinaminę nuorodą; Pastaba: šio įvykio naudojimas palaipsniui nutraukiamas, nes šiuo metu „Firebase“ dinaminių nuorodų naudojimas nutraukiamas. Sužinokite daugiau apie šiuos pakeitimus. |
source, medium, campaign, link_id, accept_time |
dynamic_link_ app_update (programa) |
kai programa atnaujinama įdiegiant naują jos versiją ir atidaroma palietus dinaminę nuorodą. Tik „Android“ Pastaba: šio įvykio naudojimas palaipsniui nutraukiamas, nes šiuo metu „Firebase“ dinaminių nuorodų naudojimas nutraukiamas. Sužinokite daugiau apie šiuos pakeitimus. |
source, medium, campaign, link_id, accept_time |
dynamic_link_ first_open (programa) |
kai naudotojas pirmą kartą atidaro programą palietęs dinaminę nuorodą; Pastaba: šio įvykio naudojimas palaipsniui nutraukiamas, nes šiuo metu „Firebase“ dinaminių nuorodų naudojimas nutraukiamas. Sužinokite daugiau apie šiuos pakeitimus. |
source, medium, campaign, link_id, accept_time |
error (programa) |
įrašytas į vietą tokio įvykio, kuris negali būti įrašytas, nes vienaip ar kitaip yra netinkamas. Šis įvykis nerodomas ataskaitose ir nėra eksportuojamas į „BigQuery“. |
firebase_error, firebase_error_value |
file_download (žiniatinklis) |
kai naudotojas spustelėja nuorodą, nukreipiančią į toliau nurodytų tipų failą (su bendru failo plėtiniu):
Pagal numatytuosius nustatymus šis įvykis renkamas naudojant patobulintą matavimą. Peržiūrėkite failų plėtinius, kurie suaktyvina įvykį |
file_extension, file_name, link_classes, link_id, link_text, link_url |
firebase_campaign (programa) |
kai programa paleidžiama su kampanijos parametrais; |
source, medium, campaign, term, content, gclid, aclid, cp1, anid, click_timestamp, campaign_info_source |
firebase_in_app_ message_action (programa) |
kai naudotojas atlieka veiksmą su „Firebase“ pranešimu programoje; | message_name, message_device_time, message_id |
firebase_in_app_ message_dismiss (programa) |
kai naudotojas atsisako peržiūrėti „Firebase“ pranešimą programoje; | message_name, message_device_time, message_id |
firebase_in_app_ message_impression (programa) |
kai naudotojas peržiūri „Firebase“ pranešimą programoje; | message_name, message_device_time, message_id |
first_open (programa) |
naudotojui pirmą kartą paleidus programą, kai jis įdiegia arba iš naujo ją įdiegia. Šis įvykis suaktyvinamas ne tada, kai naudotojas atsisiunčia programą į įrenginį, o kai pirmą kartą ją naudoja. Jei norite pamatyti neapdorotą atsisiuntimų skaičių, žr. „Google Play Console“ arba „iTunesConnect“. Palaikomas naudotojų, kurie sutinka su „Apple“ 14 versijos „iOS“ programos stebėjimo raginimu, „first_open“ pagrindinių įvykių vertinimas. |
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 (programa, žiniatinklis) |
naudotojui pirmą kartą apsilankius svetainėje arba paleidus „Android“ akimirksniu įkeliamą programą, kurioje įgalinta „Analytics“ | |
form_start (žiniatinklis) |
pirmą kartą naudotojui sąveikaujant su forma per seansą Renkamas pagal numatytuosius nustatymus naudojant patobulintą įvertinimą; |
form_id, form_name, form_destination |
form_submit (žiniatinklis) |
kai naudotojas pateikia formą Renkamas pagal numatytuosius nustatymus naudojant patobulintą įvertinimą; |
form_id, form_name, form_destination, form_submit_text |
in_app_purchase (programa) |
kai naudotojas užbaigia pirkimą programoje (įskaitant pradinę prenumeratą), kurį apdoroja „Apple App Store“ arba „Google Play“ parduotuvė. Kaip parametrai perduodami produkto ID, produkto pavadinimas, valiuta ir kiekis. Šį įvykį suaktyvina tik programos versijos, į kurias įtrauktas „Google Analytics“, skirtos „Firebase“, SDK. „Android“: Jei norite peržiūrėti pirkimo „Android“ programose duomenis, susiekite „Analytics“ su „Google Play“. Atminkite, kad „Analytics“ automatiškai neskaičiuoja pajamų iš mokamos programos pirkimo. Be to, „Google Analytics“ ataskaitoje pateikiamos pajamos gali skirtis nuo verčių, kurias matote „Google Play Console“. „Analytics“ nepaiso įvykių, kurie pažymėti kaip netinkami arba bandymai. Sužinokite daugiau apie „Google Play“ atsiskaitymo testavimą. „iOS“: Atminkite, kad „Analytics“ automatiškai neskaičiuoja pajamų iš mokamos programos pirkimo ir lėšų grąžinimo. „Analytics“ nepaiso įvykių, kurie pažymėti kaip netinkami arba „sandbox“ (smėlio dėžė). |
product_id, price, value, currency, quantity, subscription, free_trial, introductory_price |
notification_dismiss (programa) |
kai naudotojas atsisako „Firebase“ pranešimų siuntimo per debesį (angl. „Firebase Cloud Messaging“, FCM) funkcijos išsiųsto pranešimo. Tik „Android“ |
message_name, message_time, message_device_time, message_id, topic, label, message_channel |
notification_foreground (programa) |
kai gaunamas FCM išsiųstas pranešimas, o programa veikia priekiniame plane; | message_name, message_time, message_device_time, message_id, topic, label, message_channel, message_type |
notification_open (programa) |
kai naudotojas atidaro FCM išsiųstą pranešimą; | message_name, message_time, message_device_time, message_id, topic, label, message_channel |
notification_receive (programa) |
kai įrenginys gauna FCM išsiųstą pranešimą, o programa veikia fone. Tik „Android“ |
message_name, message_time, message_device_time, message_id, topic, label, message_channel, message_type |
os_update (programa) |
kai įrenginio operacinė sistema atnaujinama įdiegiant naują jos versiją. Ankstesnės operacinės sistemos versijos ID perduodamas kaip parametras; | previous_os_version |
page_view (žiniatinklis) |
kiekvieną kartą, kai įkeliamas puslapis arba aktyvioje svetainėje pakeičiama naršyklės istorijos būsena. Renkamas pagal numatytuosius nustatymus naudojant patobulintą įvertinimą; |
page_location (puslapio URL), page_referrer (ankstesnio puslapio URL), engagement_time_msec |
screen_view (programa) |
kai perkeliamas ekranas ir atitinka bet kurie iš šių kriterijų:
|
firebase_screen, firebase_screen_class, firebase_screen_id, firebase_previous_screen, firebase_previous_class, firebase_previous_id, engagement_time_msec |
scroll (žiniatinklis) |
pirmą kartą naudotojui pasiekus kiekvieno puslapio apačią (t. y. kai tampa matomas 90 proc. vertikalus gylis). Renkamas pagal numatytuosius nustatymus naudojant patobulintą įvertinimą; |
engagement_time_msec |
session_start (programa, žiniatinklis) |
Kai naudotojas įsitraukia į programą ar svetainę. Seanso ID ir seanso numeris generuojami automatiškai su kiekvienu seansu ir susiejami su kiekvienu seanso įvykiu. Sužinokite daugiau |
|
user_engagement (programa, žiniatinklis) |
kai programa veikia priekiniame plane arba tinklalapis yra aktyvus bent vieną sekundę. Sužinokite daugiau |
engagement_time_msec |
video_complete (žiniatinklis) |
kai vaizdo įrašas pasibaigia. Skirta įterptiems „YouTube“ vaizdo įrašams, kuriuose įgalintas JS API palaikymas. Renkamas pagal numatytuosius nustatymus naudojant patobulintą įvertinimą; |
video_current_time, video_duration, video_percent, video_provider, video_title, video_url, visible (loginis) |
video_progress (žiniatinklis) |
kai vaizdo įrašo progresas peržengia 10 proc., 25 proc., 50 proc. ir 75 proc. vaizdo įrašo trukmės ribą. Skirta įterptiems „YouTube“ vaizdo įrašams, kuriuose įgalintas JS API palaikymas. Renkamas pagal numatytuosius nustatymus naudojant patobulintą įvertinimą; |
video_current_time, video_duration, video_percent, video_provider, video_title, video_url, visible (loginis) |
video_start (žiniatinklis) |
kai vaizdo įrašas paleidžiamas. Skirta įterptiems „YouTube“ vaizdo įrašams, kuriuose įgalintas JS API palaikymas. Renkamas pagal numatytuosius nustatymus naudojant patobulintą įvertinimą; |
video_current_time, video_duration, video_percent, video_provider, video_title, video_url, visible (loginis) |
view_search_results (žiniatinklis) |
kiekvieną kartą naudotojui atlikus svetainės paiešką, kurios indikatorius yra URL užklausos parametrų rodymas. Renkamas pagal numatytuosius nustatymus naudojant patobulintą įvertinimą; |
„search_term“, pasirinktinai „q_<additional key="">“ (kai „<additional key="">“ atitinka papildomą užklausos parametrą, kurį nurodote rinkti pagal išplėstinius nustatymus) Pastaba: šio įvykio parametras „Unique_search_term“ siunčiamas, tik kai jo vertė yra 1 (t. y. kai eilutė yra unikali to seanso eilutė). |
Pastaba: failų plėtiniai, atitinkantys toliau nurodytą reguliarųjį reiškinį, suaktyvins įvykį 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