Τα συμβάντα που συλλέγονται αυτόματα ενεργοποιούνται από βασικές αλληλεπιδράσεις με την εφαρμογή ή/και τον ιστότοπό σας (όπως υποδεικνύεται κάτω από το όνομα του συμβάντος στον παρακάτω πίνακα). Εφόσον χρησιμοποιείτε την ετικέτα Google ή το SDK του Google Analytics για Firebase, δεν χρειάζεται να συντάξετε επιπλέον κώδικα για τη συλλογή αυτών των συμβάντων.
Το Analytics συλλέγει τα συμβάντα για εφαρμογές Android και iOS, εκτός αν δηλώνεται κάτι διαφορετικό. Τα ονόματα και οι παράμετροι αυτών των συμβάντων μπορούν να είναι χρήσιμα κατά την πρόσβαση σε μη επεξεργασμένα δεδομένα συμβάντων στο BigQuery.
Για να κατανοήσετε κάθε παράμετρο συμβάντος που αναφέρεται παρακάτω και τον τρόπο με τον οποίο κάθε παράμετρος ενημερώνει μια ιδιότητα ή μια μέτρηση στο Google Analytics, ανατρέξτε στην ενότητα Παράμετροι συμβάντων του Google Analytics.
Σημείωση:
Ακολουθούν ορισμένες από τις παραμέτρους που συλλέγονται από προεπιλογή με κάθε συμβάν, συμπεριλαμβανομένων των προσαρμοσμένων συμβάντων:
- Ροή ιστού:
- γλώσσα
- 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 πρέπει να περιέχει 1.000 χαρακτήρες ή λιγότερους.
Αν παρακάμψετε την παράμετρο page_location, βεβαιωθείτε ότι η διαδρομή URL είναι έγκυρη. Αν εκχωρήσετε μια μη έγκυρη διαδρομή URL, η ιδιότητα Τοποθεσία σελίδας θα είναι κενή. Μπορείτε να χρησιμοποιήσετε το Εργαλείο δημιουργίας URL καμπανιών, για να ελέγξετε αν μια διαδρομή URL είναι έγκυρη.
Οι παράμετροι firebase_screen_id και firebase_screen_class συλλέγονται αυτόματα, εκτός αν απενεργοποιήσετε την παρακολούθηση προβολών οθόνης.
| Συμβάν | Ενεργοποιείται αυτόματα... | Παράμετροι |
|---|---|---|
|
ad_click (εφαρμογή) |
όταν ένας χρήστης κάνει κλικ σε μια διαφήμιση Συμβάντα εκδοτών που προέρχονται από το AdMob μέσω του SDK διαφημίσεων Google για κινητά ή από το Ad Manager μέσω της ενσωμάτωσης του Ad Manager Αυτό το συμβάν δεν εξάγεται στο BigQuery. |
ad_event_id |
|
ad_exposure (εφαρμογή) |
όταν στην οθόνη εμφανίζεται τουλάχιστον μία διαφήμιση που προβάλλεται από το SDK διαφημίσεων για κινητά Αυτό το συμβάν δεν εμφανίζεται στις αναφορές και δεν εξάγεται στο BigQuery. |
firebase_screen, firebase_screen_id, firebase_screen_class, exposure_time |
|
ad_impression (εφαρμογή) |
όταν ένας χρήστης βλέπει μια εμφάνιση διαφήμισης Συμβάντα εκδοτών που προέρχονται από το AdMob μέσω του SDK διαφημίσεων Google για κινητά ή από το Ad Manager μέσω της ενσωμάτωσης του Ad Manager Αυτό το συμβάν δεν εξάγεται στο BigQuery. Σημείωση: Δεν διαβιβάζεται η τιμή |
ad_event_id, value |
|
ad_query (εφαρμογή) |
όταν υποβάλλεται ένα αίτημα για διαφήμιση από το SDK διαφημίσεων για κινητά Αυτό το συμβάν δεν εμφανίζεται στις αναφορές και δεν εξάγεται στο BigQuery. |
ad_event_id |
|
ad_reward (εφαρμογή) |
όταν παρέχεται μια επιβράβευση από μια διαφήμιση με επιβράβευση η οποία προβάλλεται από το SDK διαφημίσεων για κινητά | ad_unit_code, reward_type, reward_value |
|
adunit_exposure (εφαρμογή) |
όταν στην οθόνη εμφανίζεται ένα στοιχείο διαφημίσεων που προβάλλεται από το 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 και η παράμετρος συνδρομής ορίζεται σε 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 |
|
κλικ (ιστός) |
κάθε φορά που κάποιος επισκέπτης κάνει κλικ σε έναν σύνδεσμο που οδηγεί εκτός του τρέχοντα τομέα Από προεπιλογή, τα συμβάντα εξερχόμενων κλικ θα λαμβάνουν χώρα για όλους τους συνδέσμους που οδηγούν εκτός του τρέχοντος τομέα. Οι σύνδεσμοι προς τομείς που έχουν διαμορφωθεί για μέτρηση μεταξύ τομέων δεν θα ενεργοποιούν συμβάντα εξερχόμενων κλικ. Οι παράμετροι συμπληρώνουν τις παρακάτω ιδιότητες:
Συλλέγεται από προεπιλογή μέσω της βελτιωμένης μέτρησης. |
link_classes, link_domain, link_id, link_url, outbound (boolean) |
|
dynamic_link_app_open (εφαρμογή) |
όταν ένας χρήστης ανοίγει ξανά την εφαρμογή μέσω δυναμικού συνδέσμου Σημείωση: Αυτό το συμβάν καταργείται σταδιακά, καθώς η προσθήκη Firebase Dynamic Links έχει καταργηθεί. Μάθετε περισσότερα σχετικά με αυτές τις αλλαγές. |
source, medium, campaign, link_id, accept_time |
|
dynamic_link_ app_update (εφαρμογή) |
όταν η εφαρμογή ενημερώνεται σε νέα έκδοση και ανοίγει μέσω δυναμικού συνδέσμου Μόνο Android Σημείωση: Αυτό το συμβάν καταργείται σταδιακά, καθώς η προσθήκη Firebase Dynamic Links έχει καταργηθεί. Μάθετε περισσότερα σχετικά με αυτές τις αλλαγές. |
source, medium, campaign, link_id, accept_time |
|
dynamic_link_ first_open (εφαρμογή) |
όταν ο χρήστης ανοίγει την εφαρμογή για πρώτη φορά μέσω δυναμικού συνδέσμου Σημείωση: Αυτό το συμβάν καταργείται σταδιακά, καθώς η προσθήκη Firebase Dynamic Links έχει καταργηθεί. Μάθετε περισσότερα σχετικά με αυτές τις αλλαγές. |
source, medium, campaign, link_id, accept_time |
|
σφάλμα (εφαρμογή) |
καταγράφεται στη θέση ενός συμβάντος που δεν μπορεί να καταγραφεί, επειδή με κάποιον τρόπο δεν είναι έγκυρο Αυτό το συμβάν δεν εμφανίζεται στις αναφορές και δεν εξάγεται στο 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 (εφαρμογή, ιστός) |
την πρώτη φορά που κάποιος χρήστης επισκέπτεται έναν ιστότοπο ή εκκινεί μια instant εφαρμογή για 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 Store Το αναγνωριστικό προϊόντος, το όνομα προϊόντος, το νόμισμα και η ποσότητα παρέχονται ως παράμετροι. Αυτό το συμβάν ενεργοποιείται μόνο από εκδόσεις της εφαρμογής σας που περιλαμβάνουν το SDK του Google Analytics για Firebase. Android: Για να δείτε δεδομένα αγορών εντός εφαρμογής για εφαρμογές Android, συνδέστε το Analytics με το Google Play. Λάβετε υπόψη ότι το Analytics δεν μετρά αυτόματα τα έσοδα από αγορές εφαρμογών επί πληρωμή. Επίσης, τα έσοδα που αναφέρονται στο Google Analytics ενδέχεται να διαφέρουν από τις τιμές που βλέπετε στο Google Play Console. Το Analytics παραβλέπει συμβάντα που έχουν επισημανθεί ως μη έγκυρα ή ως δοκιμές. Μάθετε περισσότερα σχετικά με τη δοκιμή της χρέωσης του Google Play. iOS: Λάβετε υπόψη ότι το Analytics δεν μετρά αυτόματα τα έσοδα από αγορές εφαρμογών επί πληρωμή και τις επιστροφές χρημάτων. Το Analytics παραβλέπει συμβάντα που έχουν επισημανθεί ως μη έγκυρα ή ως ευρισκόμενα σε περιβάλλον δοκιμών (sandbox). |
product_id, price, value, currency, quantity, subscription, free_trial, introductory_price |
|
notification_dismiss (εφαρμογή) |
όταν ένας χρήστης παραβλέπει μια ειδοποίηση που έχει σταλεί από το Firebase Cloud Messaging (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 |
|
πάπυρος (ιστός) |
την πρώτη φορά που ένας χρήστης φτάνει στο κάτω μέρος κάθε σελίδας (δηλαδή όταν γίνει ορατό το 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 (δηλαδή, όταν η συμβολοσειρά είναι μοναδική για τη συγκεκριμένη περίοδο σύνδεσης). |
Σημείωση: Οι επεκτάσεις αρχείων που αντιστοιχούν στο παρακάτω regex θα ενεργοποιήσουν το συμβάν 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