Αυτό το άρθρο εξηγεί τη μορφή και το σχήμα των δεδομένων ιδιοκτησίας Google Analytics 4 και των δεδομένων του Google Analytics για Firebase που εξάγονται στο BigQuery.
Σύνολα δεδομένων
Για κάθε ιδιοκτησία Google Analytics 4 και κάθε έργο Firebase που συνδέεται με το BigQuery, ένα μόνο σύνολο δεδομένων με το όνομα analytics_<property_id> προστίθεται στο έργο BigQuery. Ο όρος "αναγνωριστικό ιδιοκτησίας" αναφέρεται στο αναγνωριστικό της ιδιοκτησίας σας στο Analytics, το οποίο μπορείτε να βρείτε στις ρυθμίσεις ιδιοκτησίας για την ιδιοκτησία Google Analytics 4 και στις Ρυθμίσεις των αναλυτικών στοιχείων εφαρμογών στο Firebase. Κάθε ιδιοκτησία Google Analytics 4 και κάθε εφαρμογή για την οποία έχει ενεργοποιηθεί η εξαγωγή δεδομένων στο BigQuery θα εξάγει τα δεδομένα της στο συγκεκριμένο σύνολο δεδομένων.
Πίνακες
Σε κάθε σύνολο δεδομένων, δημιουργείται καθημερινά ένας πίνακας με το όνομα events_YYYYMMDD
, αν είναι ενεργοποιημένη η επιλογή Ημερήσια εξαγωγή.
Αν η επιλογή Εξαγωγή ροής είναι ενεργοποιημένη, δημιουργείται ένας πίνακας με το όνομα events_intraday_YYYYMMDD
. Αυτός ο πίνακας συμπληρώνεται συνεχώς, καθώς τα συμβάντα καταγράφονται κατά τη διάρκεια της ημέρας. Αυτός ο πίνακας διαγράφεται στο τέλος κάθε ημέρας, αφού συμπληρωθεί ο πίνακας events_YYYYMMDD
.
Δεν αποστέλλουν όλες οι συσκευές στις οποίες ενεργοποιούνται συμβάντα τα δεδομένα τους στο Analytics την ίδια ημέρα που ενεργοποιούνται τα συμβάντα. Προκειμένου να λαμβάνεται υπόψη αυτός ο λανθάνων χρόνος, το Analytics θα ενημερώνει τους ημερήσιους πίνακες (events_YYYYMMDD
) με τα συμβάντα που αφορούν αυτές τις ημερομηνίες, για έως και τρεις ημέρες μετά τις ημερομηνίες των συμβάντων. Τα συμβάντα θα έχουν τη σωστή χρονική σήμανση, ανεξάρτητα από το αν φτάνουν με καθυστέρηση. Τα συμβάντα που φτάνουν μετά από αυτό το παράθυρο των τριών ημερών δεν καταγράφονται.
Αν χρησιμοποιείτε το περιβάλλον δοκιμών (sandbox) του BigQuery, δεν υπάρχει εισαγωγή συμβάντων εντός της ημέρας και ισχύουν επιπλέον όρια.
Κάντε αναβάθμιση από το περιβάλλον δοκιμών (sandbox), αν θέλετε εισαγωγές εντός της ημέρας.
Στήλες
Κάθε στήλη στον πίνακα events_YYYYMMDD
αντιπροσωπεύει μια παράμετρο για συγκεκριμένο συμβάν. Λάβετε υπόψη ότι ορισμένες παράμετροι είναι ενσωματωμένες στα στοιχεία RECORD, ενώ ορισμένα στοιχεία RECORD, όπως τα items
και τα event_params
, είναι επαναλαμβανόμενα. Οι στήλες του πίνακα περιγράφονται παρακάτω.
Τα πεδία event (συμβάν) περιέχουν πληροφορίες που προσδιορίζουν με μοναδικό τρόπο ένα συμβάν. | ||
Όνομα πεδίου | Τύπος δεδομένων | Περιγραφή |
---|---|---|
event_date | STRING | Η ημερομηνία κατά την οποία καταγράφηκε το συμβάν (μορφή ΕΕΕΕΜΜΗΗ στην καταχωρισμένη ζώνη ώρας της εφαρμογής σας). |
event_timestamp | INTEGER | Η ώρα (σε μικροδευτερόλεπτα, UTC) κατά την οποία το συμβάν καταγράφηκε στην εφαρμογή πελάτη. |
event_previous_timestamp | INTEGER | Η ώρα (σε μικροδευτερόλεπτα, UTC) κατά την οποία το συμβάν είχε καταγραφεί στο παρελθόν στην εφαρμογή πελάτη. |
event_name | STRING | Το όνομα του συμβάντος. |
event_value_in_usd | FLOAT | Η τιμή της παραμέτρου "value" του συμβάντος, η οποία έχει μετατραπεί σε νόμισμα (δολάρια HΠΑ). |
event_bundle_sequence_id | INTEGER | Το διαδοχικό αναγνωριστικό της ομάδας στην οποία έγινε μεταφόρτωση αυτών των συμβάντων. |
event_server_timestamp_offset | INTEGER | Η διαφορά χρονικής σήμανσης μεταξύ του χρόνου συλλογής και του χρόνου μεταφόρτωσης, σε μικροδευτερόλεπτα. |
event_params RECORD
Το στοιχείο event_params RECORD μπορεί να αποθηκεύσει παραμέτρους συμβάντος σε επίπεδο καμπάνιας και παραμέτρους συμβάντος με βάση τα συμφραζόμενα, καθώς και τυχόν παραμέτρους συμβάντος που καθορίζονται από τον χρήστη. Το στοιχείο event_params RECORD επαναλαμβάνεται για κάθε κλειδί που συσχετίζεται με ένα συμβάν. Το σύνολο των παραμέτρων που αποθηκεύονται στο στοιχείο event_params RECORD είναι μοναδικό για κάθε υλοποίηση. Για να δείτε την πλήρη λίστα παραμέτρων συμβάντος για την υλοποίησή σας, υποβάλετε ερώτημα για τη λίστα παραμέτρων συμβάντος. |
||
Όνομα πεδίου | Τύπος δεδομένων | Περιγραφή |
---|---|---|
event_params.key | STRING | Το όνομα της παραμέτρου συμβάντος. |
event_params.value | RECORD | Εγγραφή που περιέχει την τιμή της παραμέτρου συμβάντος. |
event_params.value.string_value | STRING | Αν η παράμετρος συμβάντος δηλώνεται με συμβολοσειρά, όπως URL ή όνομα καμπάνιας, συμπληρώνεται σε αυτό το πεδίο. |
event_params.value.int_value | INTEGER | Αν η παράμετρος συμβάντος δηλώνεται με ακέραιο, συμπληρώνεται σε αυτό το πεδίο. |
event_params.value.double_value | FLOAT | Αν η παράμετρος συμβάντος δηλώνεται με διπλή τιμή, συμπληρώνεται σε αυτό το πεδίο. |
event_params.value.float_value | FLOAT | Αν η παράμετρος συμβάντος δηλώνεται με τιμή κινητής υποδιαστολής, συμπληρώνεται σε αυτό το πεδίο. Αυτό το πεδίο δεν χρησιμοποιείται επί του παρόντος. |
Εγγραφή item_params RECORD
Η εγγραφή item_params RECORD μπορεί να αποθηκεύσει παραμέτρους στοιχείου, καθώς και τυχόν παραμέτρους στοιχείου που καθορίζονται από τον χρήστη. Το σύνολο των παραμέτρων που αποθηκεύονται στην εγγραφή item_params RECORD είναι μοναδικό για κάθε υλοποίηση. |
||
Όνομα πεδίου | Τύπος δεδομένων | Περιγραφή |
---|---|---|
item_params.key | STRING | Το όνομα της παραμέτρου στοιχείου. |
item_params.value | RECORD | Εγγραφή που περιέχει την τιμή της παραμέτρου στοιχείου. |
item_params.value.string_value | STRING | Αν η παράμετρος στοιχείου δηλώνεται με συμβολοσειρά, συμπληρώνεται σε αυτό το πεδίο. |
item_params.value.int_value | INTEGER | Αν η παράμετρος στοιχείου δηλώνεται με ακέραιο, συμπληρώνεται σε αυτό το πεδίο. |
item_params.value.double_value | FLOAT | Αν η παράμετρος στοιχείου δηλώνεται με διπλή τιμή, συμπληρώνεται σε αυτό το πεδίο. |
item_params.value.float_value | FLOAT | Αν η παράμετρος στοιχείου δηλώνεται με τιμή κινητής υποδιαστολής, συμπληρώνεται σε αυτό το πεδίο. |
Τα πεδία user (χρήστης) περιέχουν πληροφορίες οι οποίες προσδιορίζουν με μοναδικό τρόπο τον χρήστη που συσχετίζεται με το συμβάν. | ||
Όνομα πεδίου | Τύπος δεδομένων | Περιγραφή |
---|---|---|
is_active_user | BOOLEAN |
Αν ο χρήστης ήταν ενεργός (αληθές) ή ανενεργός (ψευδές) σε οποιοδήποτε σημείο της ημερολογιακής ημέρας Περιλαμβάνεται μόνο στους ημερήσιους πίνακες ( |
user_id | STRING | Το μοναδικό αναγνωριστικό που έχει εκχωρηθεί σε έναν χρήστη. |
user_pseudo_id | STRING | Το ψευδώνυμο αναγνωριστικό (π.χ. το αναγνωριστικό παρουσίας εφαρμογής) για τον χρήστη. |
user_first_touch_timestamp | INTEGER | Η ώρα (σε μικροδευτερόλεπτα) κατά την οποία ο χρήστης άνοιξε για πρώτη φορά την εφαρμογή ή επισκέφτηκε τον ιστότοπο. |
πεδία privacy_info
Τα πεδία privacy_info περιέχουν πληροφορίες με βάση την κατάσταση συναίνεσης ενός χρήστη όταν είναι ενεργοποιημένη η λειτουργία συναίνεσης. | ||
Όνομα πεδίου | Τύπος δεδομένων | Περιγραφή |
---|---|---|
privacy_info.ads_storage | STRING |
Αν η στόχευση διαφημίσεων είναι ενεργοποιημένη για κάποιον χρήστη. Πιθανές τιμές: Ναι, Όχι, Δεν έχει οριστεί |
privacy_info.analytics_storage | STRING |
Αν ο αποθηκευτικός χώρος Analytics έχει ενεργοποιηθεί για τον χρήστη. Πιθανές τιμές: Ναι, Όχι, Δεν έχει οριστεί |
privacy_info.uses_transient_token | STRING |
Αν κάποιος χρήστης ιστού απέρριψε τον αποθηκευτικό χώρο του Analytics και ο προγραμματιστής έχει ενεργοποιήσει τη μέτρηση χωρίς cookie, με βάση τα προσωρινά διακριτικά στα δεδομένα διακομιστή. Πιθανές τιμές: Yes, No, Unset |
user_properties RECORD
Το στοιχείο user_properties RECORD περιέχει οποιεσδήποτε ιδιότητες χρήστη έχετε ορίσει. Επαναλαμβάνεται για κάθε κλειδί που συσχετίζεται με έναν χρήστη. | ||
Όνομα πεδίου | Τύπος δεδομένων | Περιγραφή |
---|---|---|
user_properties.key | STRING | Το όνομα της ιδιότητας χρήστη. |
user_properties.value | RECORD | Εγγραφή για την τιμή της ιδιότητας χρήστη. |
user_properties.value.string_value | STRING | Η τιμή συμβολοσειράς της ιδιότητας χρήστη. |
user_properties.value.int_value | INTEGER | Η ακέραια τιμή της ιδιότητας χρήστη. |
user_properties.value.double_value | FLOAT | Η διπλή τιμή της ιδιότητας χρήστη. |
user_properties.value.float_value | FLOAT | Αυτό το πεδίο δεν χρησιμοποιείται προς το παρόν. |
user_properties.value.set_timestamp_micros | INTEGER | Η ώρα (σε μικροδευτερόλεπτα) κατά την οποία ορίστηκε τελευταία φορά η ιδιότητα χρήστη. |
user_ltv RECORD
Το στοιχείο user_ltv RECORD περιέχει πληροφορίες Αξίας χρόνου ζωής σχετικά με τον χρήστη. Αυτό το στοιχείο RECORD δεν συμπληρώνεται σε ενδοημερήσιους πίνακες. | ||
Όνομα πεδίου | Τύπος δεδομένων | Περιγραφή |
---|---|---|
user_ltv.revenue | FLOAT | Η Αξία χρόνου ζωής (έσοδα) του χρήστη. Αυτό το πεδίο δεν συμπληρώνεται σε ενδοημερήσιους πίνακες. |
user_ltv.currency | STRING | Η Αξία χρόνου ζωής (νόμισμα) του χρήστη. Αυτό το πεδίο δεν συμπληρώνεται σε ενδοημερήσιους πίνακες. |
Το στοιχείο device RECORD περιέχει πληροφορίες σχετικά με τη συσκευή από την οποία προήλθε το συμβάν. | ||
Όνομα πεδίου | Τύπος δεδομένων | Περιγραφή |
---|---|---|
device.category | STRING | Η κατηγορία της συσκευής (κινητό, tablet, υπολογιστής). |
device.mobile_brand_name | STRING | Η επωνυμία της συσκευής. |
device.mobile_model_name | STRING | Το όνομα μοντέλου της συσκευής. |
device.mobile_marketing_name | STRING | Το όνομα μάρκετινγκ της συσκευής. |
device.mobile_os_hardware_model | STRING | Οι πληροφορίες μοντέλου συσκευής που έχουν ανακτηθεί απευθείας από το λειτουργικό σύστημα. |
device.operating_system | STRING | Το λειτουργικό σύστημα της συσκευής. |
device.operating_system_version | STRING | Η έκδοση του λειτουργικού συστήματος. |
device.vendor_id | STRING | Το IDFV (εμφανίζεται μόνο αν δεν έχει συλλεχθεί το IDFA). |
device.advertising_id | STRING | Αναγνωριστικό διαφήμισης/IDFA. |
device.language | STRING | Η γλώσσα του λειτουργικού συστήματος. |
device.time_zone_offset_seconds | INTEGER | Η μετατόπιση από την ώρα GMT σε δευτερόλεπτα. |
device.is_limited_ad_tracking | BOOLEAN |
Η ρύθμιση περιορισμού παρακολούθησης διαφημίσεων της συσκευής. Στο iOS14+, εμφανίζει την τιμή ψευδές αν το IDFA δεν είναι μηδέν. |
device.web_info.browser | STRING | Το πρόγραμμα περιήγησης στο οποίο ο χρήστης είδε περιεχόμενο. |
device.web_info.browser_version | STRING | Η έκδοση του προγράμματος περιήγησης στο οποίο ο χρήστης είδε περιεχόμενο. |
device.web_info.hostname | STRING | Το όνομα κεντρικού υπολογιστή που συσχετίζεται με το καταγεγραμμένο συμβάν. |
geo
Το στοιχείο geo RECORD περιέχει πληροφορίες σχετικά με τη γεωγραφική τοποθεσία όπου ξεκίνησε το συμβάν. | ||
Όνομα πεδίου | Τύπος δεδομένων | Περιγραφή |
---|---|---|
geo.continent | STRING | Η ήπειρος από την οποία αναφέρθηκαν τα συμβάντα, βάσει της διεύθυνσης IP. |
geo.sub_continent | STRING | Η υποήπειρος από την οποία αναφέρθηκαν τα συμβάντα, βάσει της διεύθυνσης IP. |
geo.country | STRING | Η χώρα από την οποία αναφέρθηκαν τα συμβάντα, βάσει της διεύθυνσης IP. |
geo.region | STRING | Η περιοχή από την οποία αναφέρθηκαν τα συμβάντα, βάσει της διεύθυνσης IP. |
geo.metro | STRING | Η μητροπολιτική περιοχή από την οποία αναφέρθηκαν τα συμβάντα, βάσει της διεύθυνσης IP. |
geo.city | STRING | Η πόλη από την οποία αναφέρθηκαν τα συμβάντα, βάσει της διεύθυνσης IP. |
Το στοιχείο app_info RECORD περιέχει πληροφορίες σχετικά με την εφαρμογή στην οποία ξεκίνησε το συμβάν. | ||
Όνομα πεδίου | Τύπος δεδομένων | Περιγραφή |
---|---|---|
app_info.id | STRING | Το όνομα πακέτου ή το αναγνωριστικό πακέτου της εφαρμογής. |
app_info.firebase_app_id | STRING | Το αναγνωριστικό εφαρμογής Firebase που σχετίζεται με την εφαρμογή |
app_info.install_source | STRING | Το app store από το οποίο έγινε η εγκατάσταση της εφαρμογής. |
app_info.version | STRING | Η έκδοση versionName (Android) ή η σύντομη έκδοση ομάδας της εφαρμογής. |
Το στοιχείο collection_traffic_source RECORD περιέχει τα δεδομένα της πηγής επισκεψιμότητας που συλλέχθηκαν με το συμβάν. |
||
Όνομα πεδίου | Τύπος δεδομένων | Περιγραφή |
---|---|---|
manual_campaign_id | STRING | Το μη αυτόματο αναγνωριστικό καμπάνιας (utm_id) που συλλέχθηκε με το συμβάν. |
manual_campaign_name | STRING | Το μη αυτόματο όνομα καμπάνιας (utm_campaign) που συλλέχθηκε με το συμβάν. |
manual_source | STRING | Η μη αυτόματη πηγή καμπάνιας (utm_source) που συλλέχθηκε με το συμβάν. Περιλαμβάνει επίσης παραμέτρους που έχουν αναλυθεί από παραμέτρους παραπομπής και όχι μόνο από τιμές UTM. |
manual_medium | STRING | Το μη αυτόματο μέσο καμπάνιας (utm_medium) που συλλέχθηκε με το συμβάν. Περιλαμβάνει επίσης παραμέτρους που έχουν αναλυθεί από παραμέτρους παραπομπής και όχι μόνο από τιμές UTM. |
manual_term | STRING | Η μη αυτόματη λέξη-κλειδί/όρος καμπάνιας (utm_term) που συλλέχθηκε με το συμβάν. |
manual_content | STRING | Τα επιπλέον μεταδεδομένα μη αυτόματης καμπάνιας (utm_content) που συλλέχθηκαν με το συμβάν. |
gclid | STRING | Το αναγνωριστικό κλικ Google που συλλέχθηκε με το συμβάν. |
dclid | STRING | Το αναγνωριστικό Google Marketing Platform (GMP) που συλλέχθηκε με το συμβάν. |
srsltid | STRING | Το αναγνωριστικό του Google Merchant Center που συλλέχθηκε με το συμβάν. |
Το στοιχείο traffic_source RECORD περιέχει πληροφορίες σχετικά με την πηγή επισκεψιμότητας που απέκτησε πρώτη τον χρήστη. Αυτή η εγγραφή δεν συμπληρώνεται σε ενδοημερήσιους πίνακες. Σημείωση: Οι τιμές traffic_source δεν αλλάζουν, αν ο χρήστης αλληλεπιδράσει με επόμενες καμπάνιες μετά την εγκατάσταση. |
||
Όνομα πεδίου | Τύπος δεδομένων | Περιγραφή |
---|---|---|
traffic_source.name | STRING | Το όνομα της καμπάνιας μάρκετινγκ που απέκτησε πρώτη τον χρήστη. Αυτό το πεδίο δεν συμπληρώνεται σε ενδοημερήσιους πίνακες. |
traffic_source.medium | STRING | Το όνομα του μέσου (πληρωμένη αναζήτηση, οργανική αναζήτηση, ηλεκτρονικό ταχυδρομείο κ.λπ.) που απέκτησε πρώτο τον χρήστη. Αυτό το πεδίο δεν συμπληρώνεται σε ενδοημερήσιους πίνακες. |
traffic_source.source | STRING | Το όνομα του δικτύου που απέκτησε πρώτο τον χρήστη. Αυτό το πεδίο δεν συμπληρώνεται σε ενδοημερήσιους πίνακες. |
Τα πεδία stream (ροή) και platform (πλατφόρμα) περιέχουν πληροφορίες σχετικά με τη ροή και την πλατφόρμα της εφαρμογής. | ||
Όνομα πεδίου | Τύπος δεδομένων | Περιγραφή |
---|---|---|
stream_id | STRING | Το αριθμητικό αναγνωριστικό της ροής δεδομένων από την οποία προήλθε το συμβάν. |
platform | STRING | Η πλατφόρμα ροής δεδομένων (ιστός, IOS ή Android) από την οποία προήλθε το συμβάν. |
Αυτό το στοιχείο ecommerce RECORD περιέχει πληροφορίες σχετικά με τυχόν συμβάντα ηλεκτρονικού εμπορίου που έχουν ρυθμιστεί σε έναν ιστότοπο ή μια εφαρμογή. | ||
Όνομα πεδίου | Τύπος δεδομένων | Περιγραφή |
---|---|---|
ecommerce.total_item_quantity | INTEGER | Συνολικός αριθμός στοιχείων σε αυτό το συμβάν, που είναι το άθροισμα του items.quantity. |
ecommerce.purchase_revenue_in_usd | FLOAT | Έσοδα από αγορές αυτού του συμβάντος, σε δολάρια ΗΠΑ με τυπική μονάδα. Συμπληρώνεται μόνο για συμβάν αγοράς. |
ecommerce.purchase_revenue | FLOAT | Έσοδα από αγορές αυτού του συμβάντος, σε τοπικό νόμισμα με τυπική μονάδα. Συμπληρώνεται μόνο για συμβάν αγοράς. |
ecommerce.refund_value_in_usd | FLOAT | Το ποσό της επιστροφής χρημάτων σε αυτό το συμβάν, σε δολάρια ΗΠΑ με βασική μονάδα. Συμπληρώνεται μόνο για συμβάν επιστροφής χρημάτων. |
ecommerce.refund_value | FLOAT | Το ποσό της επιστροφής χρημάτων σε αυτό το συμβάν, σε τοπικό νόμισμα με τυπική μονάδα. Συμπληρώνεται μόνο για συμβάν επιστροφής χρημάτων. |
ecommerce.shipping_value_in_usd | FLOAT | Το κόστος αποστολής σε αυτό το συμβάν, σε δολάρια ΗΠΑ με τυπική μονάδα. |
ecommerce.shipping_value | FLOAT | Το κόστος αποστολής σε αυτό το συμβάν, σε τοπικό νόμισμα. |
ecommerce.tax_value_in_usd | FLOAT | Η τιμή φόρου σε αυτό το συμβάν, σε δολάρια ΗΠΑ με τυπική μονάδα. |
ecommerce.tax_value | FLOAT | Η τιμή φόρου σε αυτό το συμβάν, σε τοπικό νόμισμα με βασική μονάδα. |
ecommerce.transaction_id | STRING | Το αναγνωριστικό συναλλαγής της συναλλαγής ηλεκτρονικού εμπορίου. |
ecommerce.unique_items | INTEGER | Ο αριθμός των μοναδικών στοιχείων σε αυτό το συμβάν με βάση τα item_id, item_name και item_brand. |
Το στοιχείο items RECORD περιέχει πληροφορίες σχετικά με τα στοιχεία που περιλαμβάνονται σε ένα συμβάν. Επαναλαμβάνεται για κάθε στοιχείο. | ||
Όνομα πεδίου | Τύπος δεδομένων | Περιγραφή |
---|---|---|
items.item_id | STRING | Το αναγνωριστικό του στοιχείου. |
items.item_name | STRING | Το όνομα του στοιχείου. |
items.item_brand | STRING | Η επωνυμία του στοιχείου. |
items.item_variant | STRING | Η παραλλαγή του στοιχείου. |
items.item_category | STRING | Η κατηγορία του στοιχείου. |
items.item_category2 | STRING | Η υποκατηγορία του στοιχείου. |
items.item_category3 | STRING | Η υποκατηγορία του στοιχείου. |
items.item_category4 | STRING | Η υποκατηγορία του στοιχείου. |
items.item_category5 | STRING | Η υποκατηγορία του στοιχείου. |
items.price_in_usd | FLOAT | Η τιμή του στοιχείου, σε δολάρια ΗΠΑ με τυπική μονάδα. |
items.price | FLOAT | Η τιμή του στοιχείου στο τοπικό νόμισμα. |
items.quantity | INTEGER | Η ποσότητα του στοιχείου. Η ποσότητα ορίζεται σε 1, αν δεν έχει καθοριστεί. |
items.item_revenue_in_usd | FLOAT | Τα έσοδα αυτού του στοιχείου, υπολογισμένα ως price_in_usd * ποσότητα. Συμπληρώνεται μόνο για συμβάντα αγοράς, σε δολάρια ΗΠΑ με τυπική μονάδα. |
items.item_revenue | FLOAT | Τα έσοδα αυτού του στοιχείου, υπολογισμένα ως τιμή * ποσότητα. Συμπληρώνεται μόνο για συμβάντα αγοράς, σε τοπικό νόμισμα με τυπική μονάδα. |
items.item_refund_in_usd | FLOAT | Η τιμή επιστροφής χρημάτων αυτού του στοιχείου, υπολογισμένη ως price_in_usd * ποσότητα. Συμπληρώνεται μόνο για συμβάντα επιστροφής χρημάτων, σε δολάρια ΗΠΑ με τυπική μονάδα. |
items.item_refund | FLOAT | Η τιμή επιστροφής χρημάτων αυτού του στοιχείου, υπολογισμένη ως τιμή * ποσότητα. Συμπληρώνεται μόνο για συμβάντα επιστροφής, σε τοπικό νόμισμα με τυπική μονάδα. |
items.coupon | STRING | Ο κωδικός κουπονιού που εφαρμόστηκε σε αυτό το στοιχείο. |
items.affiliation | STRING | Μια συνεργασία προϊόντος που υποδηλώνει την τοποθεσία μιας εταιρείας προμηθειών ή ενός φυσικού (μη διαδικτυακού) καταστήματος. |
items.location_id | STRING | Η τοποθεσία που έχει συσχετιστεί με το στοιχείο. |
items.item_list_id | STRING | Το αναγνωριστικό της λίστας στην οποία το στοιχείο παρουσιάστηκε στον χρήστη. |
items.item_list_name | STRING | Το όνομα της λίστας στην οποία το στοιχείο παρουσιάστηκε στον χρήστη. |
Items.item_list_index | STRING | Η θέση του στοιχείου σε μια λίστα. |
items.promotion_id | STRING | Το αναγνωριστικό μιας προώθησης προϊόντος. |
items.promotion_name | STRING | Το όνομα μιας προώθησης προϊόντος. |
items.creative_name | STRING | Το όνομα κάποιου δημιουργικού που χρησιμοποιείται σε ένα διαφημιστικό σποτ. |
items.creative_slot | STRING | Το όνομα μιας υποδοχής δημιουργικού. |
Εγγραφή item_params RECORD
Η εγγραφή item_params RECORD αποθηκεύει τις προσαρμοσμένες παραμέτρους στοιχείου που ορίσατε. Λάβετε υπόψη ότι οι προκαθορισμένες παράμετροι στοιχείου, όπως item_id, item_name κ.λπ., δεν περιλαμβάνονται εδώ, αλλά εξάγονται ως σαφή πεδία. Το σύνολο των παραμέτρων που αποθηκεύονται στην εγγραφή item_params RECORD είναι μοναδικό για κάθε υλοποίηση. Για να μάθετε περισσότερα σχετικά με τις υλοποιήσεις ηλεκτρονικού εμπορίου και τον πίνακα στοιχείων του Google Analytics 4, ανατρέξτε στην ενότητα Μέτρηση ηλεκτρονικού εμπορίου. |
||
Όνομα πεδίου | Τύπος δεδομένων | Περιγραφή |
---|---|---|
items.item_params.key | STRING | Το όνομα της παραμέτρου στοιχείου. |
items.item_params.value | RECORD | Εγγραφή που περιέχει την τιμή της παραμέτρου στοιχείου. |
items.item_params.value.string_value | STRING | Αν η παράμετρος στοιχείου δηλώνεται με συμβολοσειρά, συμπληρώνεται σε αυτό το πεδίο. |
items.item_params.value.int_value | INTEGER | Αν η παράμετρος στοιχείου δηλώνεται με ακέραιο, συμπληρώνεται σε αυτό το πεδίο. |
items.item_params.value.double_value | FLOAT | Αν η παράμετρος στοιχείου δηλώνεται με διπλή τιμή, συμπληρώνεται σε αυτό το πεδίο. |
items.item_params.value.float_value | FLOAT | Αν η παράμετρος στοιχείου δηλώνεται με τιμή κινητής υποδιαστολής, συμπληρώνεται σε αυτό το πεδίο. |
Σειρές
Τα δεδομένα για ένα μεμονωμένο συμβάν μπορούν να δηλώνονται σε μία ή περισσότερες σειρές, ανάλογα με το αν περιέχουν επαναλαμβανόμενα στοιχεία RECORD. Για παράδειγμα, ένα συμβάν page_view
με πολλά στοιχεία event_params
θα είχε μορφή παρόμοια με τον παρακάτω πίνακα. Η αρχική σειρά περιέχει το όνομα συμβάντος, την ημερομηνία, τη χρονική σήμανση και άλλα μη επαναλαμβανόμενα στοιχεία δεδομένων. Το στοιχείο event_params
RECORD επαναλαμβάνεται για κάθε παράμετρο που συσχετίζεται με το συμβάν. Αυτά τα επαναλαμβανόμενα στοιχεία RECORD συμπληρώνονται στις επόμενες σειρές ακριβώς κάτω από την αρχική σειρά του συμβάντος.
event_date | event_timestamp | event_name | event_params.key | event_params_value.string_value |
---|---|---|---|---|
20220222 | 1643673600483790 | page_view | page_location | https://example.com |
page_title | Αρχική σελίδα | |||
μέσο | παραπομπή | |||
πηγή | ||||
page_referrer | https://www.google.com | |||
<parameters...> | <values...> |
Αυτά τα δεδομένα συμβάντος εμφανίζονται ως εξής στη διεπαφή χρήστη του GA4.
Αν χρησιμοποιείτε προγενέστερες εκδόσεις για οποιοδήποτε SDK και σκοπεύετε να αναβαθμίσετε σε Android 17.2.5 (ή μεταγενέστερη έκδοση) ή/και σε iOS 16.20.0 (ή μεταγενέστερη έκδοση), πρέπει να λάβετε υπόψη τα εξής:
- Για να χρησιμοποιήσετε το τρέχον σχήμα εξαγωγής BigQuery, πρέπει να αναβαθμίσετε το SDK σε Android 17.2.5 (ή μεταγενέστερη έκδοση) ή/και σε iOS 16.20.0 (ή μεταγενέστερη έκδοση).Όταν χρησιμοποιείτε παλαιότερες εκδόσεις SDK, τα εξαγόμενα δεδομένα θα αντικατοπτρίζουν το παλιό σχήμα.
- Από την αναβάθμιση και έπειτα, θα μπορείτε να έχετε πρόσβαση μόνο σε δεδομένα στοιχείου εντός του συνόλου επαναλαμβανόμενων στοιχείων. Τα δεδομένα στοιχείου δεν θα είναι πλέον διαθέσιμα σε βασικές παραμέτρους συμβάντων, όπως ίσχυε πριν από αυτές τις εκδόσεις SDK.
- Αυτή η αλλαγή πραγματοποιήθηκε με σκοπό την υποστήριξη της ανάλυσης πολλών προϊόντων.
- Επομένως, μπορεί να χρειαστεί να προσαρμόσετε τις αναφορές σας στα δεδομένα στοιχείου/προϊόντος.
- Συνδεθείτε στο Cloud Platform Console >: σελίδα Manager resources.
- Ανοίξτε το έργο του οποίου τα δεδομένα θέλετε να μετεγκατασταθούν και κάντε κλικ στην επιλογή Activate Google Cloud Shell, στο επάνω μέρος της σελίδας.
- Όταν ανοίξει το κέλυφος, αντιγράψτε το παρακάτω σενάριο σε ένα αρχείο που ονομάζεται
migration_script.sql
:- Δώστε την εντολή
cat > migration_script.sql
- Αντιγράψτε και επικολλήστε το παρακάτω σενάριο στο κέλυφος.
- Πατήστε Ctrl+D για αποθήκευση και έξοδο.
SELECT @date AS event_date, event.timestamp_micros AS event_timestamp, event.previous_timestamp_micros AS event_previous_timestamp, event.name AS event_name, event.value_in_usd AS event_value_in_usd, user_dim.bundle_info.bundle_sequence_id AS event_bundle_sequence_id, user_dim.bundle_info.server_timestamp_offset_micros as event_server_timestamp_offset, ( SELECT ARRAY_AGG(STRUCT(event_param.key AS key, STRUCT(event_param.value.string_value AS string_value, event_param.value.int_value AS int_value, event_param.value.double_value AS double_value, event_param.value.float_value AS float_value) AS value)) FROM UNNEST(event.params) AS event_param) AS event_params, user_dim.first_open_timestamp_micros AS user_first_touch_timestamp, user_dim.user_id AS user_id, user_dim.app_info.app_instance_id AS user_pseudo_id, "" AS stream_id, user_dim.app_info.app_platform AS platform, STRUCT( user_dim.ltv_info.revenue AS revenue, user_dim.ltv_info.currency AS currency ) AS user_ltv, STRUCT( user_dim.traffic_source.user_acquired_campaign AS name, user_dim.traffic_source.user_acquired_medium AS medium, user_dim.traffic_source.user_acquired_source AS source ) AS traffic_source, STRUCT( user_dim.geo_info.continent AS continent, user_dim.geo_info.country AS country, user_dim.geo_info.region AS region, user_dim.geo_info.city AS city ) AS geo, STRUCT( user_dim.device_info.device_category AS category, user_dim.device_info.mobile_brand_name, user_dim.device_info.mobile_model_name, user_dim.device_info.mobile_marketing_name, user_dim.device_info.device_model AS mobile_os_hardware_model, @platform AS operating_system, user_dim.device_info.platform_version AS operating_system_version, user_dim.device_info.device_id AS vendor_id, user_dim.device_info.resettable_device_id AS advertising_id, user_dim.device_info.user_default_language AS language, user_dim.device_info.device_time_zone_offset_seconds AS time_zone_offset_seconds, IF(user_dim.device_info.limited_ad_tracking, "Yes", "No") AS is_limited_ad_tracking ) AS device, STRUCT( user_dim.app_info.app_id AS id, @firebase_app_id AS firebase_app_id, user_dim.app_info.app_version AS version, user_dim.app_info.app_store AS install_source ) AS app_info, ( SELECT ARRAY_AGG(STRUCT(user_property.key AS key, STRUCT(user_property.value.value.string_value AS string_value, user_property.value.value.int_value AS int_value, user_property.value.value.double_value AS double_value, user_property.value.value.float_value AS float_value, user_property.value.set_timestamp_usec AS set_timestamp_micros ) AS value)) FROM UNNEST(user_dim.user_properties) AS user_property) AS user_properties FROM `SCRIPT_GENERATED_TABLE_NAME`, UNNEST(event_dim) AS event
- Δώστε την εντολή
- Ανοίξτε ένα νέο κέλυφος και αντιγράψτε το παρακάτω σενάριο bash σε ένα αρχείο που ονομάζεται
migration.sh
:- Δώστε την εντολή
cat > migration.sh
- Αντιγράψτε και επικολλήστε το παρακάτω σενάριο στο κέλυφος.
- Πατήστε Ctrl+D για αποθήκευση και έξοδο.
Τροποποιήστε το ακόλουθο σενάριο, προκειμένου να συμπεριλάβετε το αναγνωριστικό ιδιοκτησίας Analytics, το αναγνωριστικό έργου BigQuery, το αναγνωριστικό εφαρμογής Firebase, το όνομα του συνόλου δεδομένων BigQuery, καθώς και τις ημερομηνίες έναρξης και λήξης των δεδομένων που θέλετε.Σενάριο (migration.sh):# Αναγνωριστικό ιδιοκτησίας Analytics για το Έργο. Βρείτε το στις ρυθμίσεις του Analytics στο Firebase. PROPERTY_ID=το αναγνωριστικό ιδιοκτησίας του Analytics # Έργο BigQuery Export. BQ_PROJECT_ID="το αναγνωριστικό έργου BigQuery" (π.χ. "firebase-public-project") # Το αναγνωριστικό εφαρμογής Firebase για την εφαρμογή. FIREBASE_APP_ID="το αναγνωριστικό εφαρμογής Firebase" (π.χ. "1:300830567303:ios:09b1ab1d3ca29bda") # Σύνολο δεδομένων από το οποίο θα γίνει εισαγωγή. BQ_DATASET="το όνομα του συνόλου δεδομένων BigQuery από το οποίο θέλετε να κάνετε εισαγωγή" (π.χ. "com_firebase_demo_IOS") # Πλατφόρμα PLATFORM="η πλατφόρμα της εφαρμογής. ANDROID ή IOS" # Εύρος ημερομηνιών για το οποίο θέλετε να εκτελεστεί η μετεγκατάσταση, συμπεριλαμβανομένων των παραμέτρων [START_DATE,END_DATE]. START_DATE=20180324 END_DATE=20180327 # Μην τροποποιείτε το παρακάτω σενάριο, εκτός αν γνωρίζετε τι κάνετε :) startdate=$(date -d"$START_DATE" +%Y%m%d) || exit -1 enddate=$(date -d"$END_DATE" +%Y%m%d) || exit -1 # Επαναλάβετε τη διαδικασία για τις ημερομηνίες. DATE="$startdate" while [ "$DATE" -le "$enddate" ]; do # Πίνακας BigQuery που αποτελείται από τις παραπάνω παραμέτρους. BQ_TABLE="$BQ_PROJECT_ID.$BQ_DATASET.app_events_$DATE" echo "Migrating $BQ_TABLE" cat migration_script.sql | sed -e "s/SCRIPT_GENERATED_TABLE_NAME/$BQ_TABLE/g" | bq query \ --debug_mode \ --allow_large_results \ --noflatten_results \ --use_legacy_sql=False \ --destination_table analytics_$PROPERTY_ID.events_$DATE \ --batch \ --append_table \ --parameter=firebase_app_id::$FIREBASE_APP_ID \ --parameter=date::$DATE \ --parameter=platform::$PLATFORM \ --project_id=$BQ_PROJECT_ID temp=$(date -I -d "$DATE + 1 day") DATE=$(date -d "$temp" +%Y%m%d) done exit # ΤΕΛΟΣ ΣΕΝΑΡΙΟΥ
- Δώστε την εντολή
- Ανοίξτε ένα νέο κέλυφος και δώστε την εντολή
bash migration.sh
user_dim
Όνομα πεδίου | Τύπος δεδομένων | Περιγραφή |
---|---|---|
user_dim | RECORD | Εγγραφή των ιδιοτήτων χρήστη. |
user_dim.user_id | STRING | Το User ID που ορίστηκε μέσω του API setUserId. |
user_dim.first_open_timestamp_micros | INTEGER | Η ώρα (σε εκατομμυριοστά του δευτερολέπτου) κατά την οποία ο χρήστης άνοιξε για πρώτη φορά την εφαρμογή. |
user_dim.user_properties | RECORD | Επαναλαμβανόμενη εγγραφή των ιδιοτήτων χρήστη που ορίστηκαν με το API setUserProperty. |
user_dim.user_properties.key | STRING | Το όνομα της ιδιότητας χρήστη. |
user_dim.user_properties.value | RECORD | Εγγραφή για πληροφορίες σχετικά με την ιδιότητα χρήστη. |
user_dim.user_properties.value.value | RECORD | Εγγραφή για την τιμή της ιδιότητας χρήστη. |
user_dim.user_properties.value.value.string_value | STRING | Η τιμή συμβολοσειράς της ιδιότητας χρήστη. |
user_dim.user_properties.value.value.int_value | INTEGER | Η ακέραια τιμή της ιδιότητας χρήστη. |
user_dim.user_properties.value.value.double_value | FLOAT | Η διπλή τιμή της ιδιότητας χρήστη. |
user_dim.user_properties.value.set_timestamp_usec | INTEGER | Η ώρα (σε εκατομμυριοστά του δευτερολέπτου) κατά την οποία ορίστηκε τελευταία φορά η ιδιότητα χρήστη. |
user_dim.user_properties.value.index | INTEGER | Ο δείκτης (0-24) της ιδιότητας χρήστη. |
user_dim.device_info | RECORD | Εγγραφή των πληροφοριών της συσκευής. |
user_dim.device_info.device_category | STRING | Η κατηγορία της συσκευής (κινητό, tablet, υπολογιστής). |
user_dim.device_info.mobile_brand_name | STRING | Η επωνυμία της συσκευής. |
user_dim.device_info.mobile_model_name | STRING | Το όνομα μοντέλου της συσκευής. |
user_dim.device_info.mobile_marketing_name | STRING | Το όνομα μάρκετινγκ της συσκευής. |
user_dim.device_info.device_model | STRING | Το μοντέλο της συσκευής. |
user_dim.device_info.platform_version | STRING | Η έκδοση του λειτουργικού συστήματος. |
user_dim.device_info.device_id | STRING | Το IDFV (εμφανίζεται μόνο αν το IDFA δεν είναι διαθέσιμο). |
user_dim.device_info.resettable_device_id | STRING | Αναγνωριστικό διαφήμισης/IDFA. |
user_dim.device_info.user_default_language | STRING | Η γλώσσα του λειτουργικού συστήματος. |
user_dim.device_info.device_time_zone_offset_seconds | INTEGER | Η μετατόπιση από την ώρα GMT σε δευτερόλεπτα. |
user_dim.device_info.limited_ad_tracking | BOOLEAN | Η ρύθμιση περιορισμού παρακολούθησης διαφημίσεων της συσκευής. |
user_dim.geo_info | RECORD | Εγγραφή γεωγραφικών πληροφοριών του χρήστη. |
user_dim.geo_info.continent | STRING | Η ήπειρος από την οποία αναφέρθηκαν τα συμβάντα, βάσει της διεύθυνσης IP. |
user_dim.geo_info.country | STRING | Η χώρα από την οποία αναφέρθηκαν τα συμβάντα, βάσει της διεύθυνσης IP. |
user_dim.geo_info.region | STRING | Η περιοχή από την οποία αναφέρθηκαν τα συμβάντα, βάσει της διεύθυνσης IP. |
user_dim.geo_info.city | STRING | Η πόλη από την οποία αναφέρθηκαν τα συμβάντα, βάσει της διεύθυνσης IP. |
user_dim.app_info | RECORD | Εγγραφή πληροφοριών σχετικά με την εφαρμογή. |
user_dim.app_info.app_version | STRING | Η έκδοση versionName (Android) ή η σύντομη έκδοση ομάδας της εφαρμογής. |
user_dim.app_info.app_instance_id | STRING | Το μοναδικό αναγνωριστικό για αυτήν την παρουσία της εφαρμογής. |
user_dim.app_info.app_store | STRING | Το κατάστημα που εγκατέστησε αυτήν την εφαρμογή. |
user_dim.app_info.app_platform | STRING | Η πλατφόρμα στην οποία εκτελείται αυτή η εφαρμογή. |
user_dim.traffic_source | RECORD | Το όνομα της πηγής επισκεψιμότητας που χρησιμοποιήθηκε για την απόκτηση του χρήστη. Αυτό το πεδίο δεν συμπληρώνεται σε ενδοημερήσιους πίνακες. |
user_dim.traffic_source.user_acquired_campaign | STRING | Το όνομα της καμπάνιας μάρκετινγκ που απέκτησε τον χρήστη. Αυτό το πεδίο δεν συμπληρώνεται σε ενδοημερήσιους πίνακες. |
user_dim.traffic_source.user_acquired_medium | STRING | Το όνομα του μέσου (πληρωμένη αναζήτηση, οργανική αναζήτηση, ηλεκτρονικό ταχυδρομείο κ.λπ.) που απέκτησε τον χρήστη. Αυτό το πεδίο δεν συμπληρώνεται σε ενδοημερήσιους πίνακες. |
user_dim.traffic_source.user_acquired_source | STRING | Το όνομα του δικτύου που απέκτησε τον χρήστη. Αυτό το πεδίο δεν συμπληρώνεται σε ενδοημερήσιους πίνακες. |
user_dim.bundle_info | RECORD | Εγγραφή πληροφοριών σχετικά με την ομάδα στην οποία έγινε μεταφόρτωση αυτών των συμβάντων. |
user_dim.bundle_info.bundle_sequence_id | INTEGER | Το διαδοχικό αναγνωριστικό της ομάδας στην οποία έγινε μεταφόρτωση αυτών των συμβάντων. |
user_dim.ltv_info | RECORD | Εγγραφή των πληροφοριών αξίας χρόνου ζωής για αυτόν τον χρήστη. Αυτό το πεδίο δεν συμπληρώνεται σε ενδοημερήσιους πίνακες. |
user_dim.ltv_info.revenue | FLOAT | Η αξία χρόνου ζωής (έσοδα) αυτού του χρήστη. Αυτό το πεδίο δεν συμπληρώνεται σε ενδοημερήσιους πίνακες. |
user_dim.ltv_info.currency | STRING | Η αξία χρόνου ζωής (νόμισμα) αυτού του χρήστη. Αυτό το πεδίο δεν συμπληρώνεται σε ενδοημερήσιους πίνακες. |
event_dim
Όνομα πεδίου | Τύπος δεδομένων | Περιγραφή |
---|---|---|
event_dim | RECORD | Επαναλαμβανόμενη εγγραφή πληροφοριών σχετικά με συμβάντα σε αυτήν την ομάδα. |
event_dim.date | STRING | Η ημερομηνία κατά την οποία καταγράφηκε αυτό το συμβάν (μορφή ΕΕΕΕMMΗΗ στην καταχωρισμένη ζώνη ώρας της εφαρμογής σας). |
event_dim.name | STRING | Το όνομα αυτού του συμβάντος. |
event_dim.params | RECORD | Επαναλαμβανόμενη εγγραφή των παραμέτρων που σχετίζονται με αυτό το συμβάν. |
event_dim.params.key | STRING | Το κλειδί παραμέτρου συμβάντος. |
event_dim.params.value | RECORD | Εγγραφή της τιμής παραμέτρου συμβάντος. |
event_dim.params.value.string_value | STRING | Η τιμή συμβολοσειράς της παραμέτρου συμβάντος. |
event_dim.params.value.int_value | INTEGER | Η ακέραια τιμή της παραμέτρου συμβάντος. |
event_dim.params.value.double_value | FLOAT | Η διπλή τιμή της παραμέτρου συμβάντος. |
event_dim.timestamp_micros | INTEGER | Η ώρα (σε χιλιοστά του δευτερολέπτου, UTC) κατά την οποία αυτό το συμβάν καταγράφηκε στην εφαρμογή πελάτη. |
event_dim.previous_timestamp_micros | INTEGER | Η ώρα (σε χιλιοστά του δευτερολέπτου, UTC) κατά την οποία αυτό το συμβάν καταγράφηκε προηγουμένως στην εφαρμογή πελάτη. |