[GA4] Σχήμα του BigQuery Export

Αυτό το άρθρο εξηγεί τη μορφή και το σχήμα των δεδομένων ιδιοκτησίας 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 (συμβάν) περιέχουν πληροφορίες που προσδιορίζουν με μοναδικό τρόπο ένα συμβάν.
Όνομα πεδίου Τύπος δεδομένων Περιγραφή
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
Τα πεδία user (χρήστης) περιέχουν πληροφορίες οι οποίες προσδιορίζουν με μοναδικό τρόπο τον χρήστη που συσχετίζεται με το συμβάν.
Όνομα πεδίου Τύπος δεδομένων Περιγραφή
is_active_user BOOLEAN

Αν ο χρήστης ήταν ενεργός (αληθές) ή ανενεργός (ψευδές) σε οποιοδήποτε σημείο της ημερολογιακής ημέρας

Περιλαμβάνεται μόνο στους ημερήσιους πίνακες (events_YYYYMMDD).

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
Το στοιχείο 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) ή η σύντομη έκδοση ομάδας της εφαρμογής.
collected_traffic_source

Το στοιχείο 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

Το στοιχείο traffic_source RECORD περιέχει πληροφορίες σχετικά με την πηγή επισκεψιμότητας που απέκτησε πρώτη τον χρήστη. Αυτή η εγγραφή δεν συμπληρώνεται σε ενδοημερήσιους πίνακες.

Σημείωση: Οι τιμές traffic_source δεν αλλάζουν, αν ο χρήστης αλληλεπιδράσει με επόμενες καμπάνιες μετά την εγκατάσταση.

Όνομα πεδίου Τύπος δεδομένων Περιγραφή
traffic_source.name STRING Το όνομα της καμπάνιας μάρκετινγκ που απέκτησε πρώτη τον χρήστη. Αυτό το πεδίο δεν συμπληρώνεται σε ενδοημερήσιους πίνακες.
traffic_source.medium STRING Το όνομα του μέσου (πληρωμένη αναζήτηση, οργανική αναζήτηση, ηλεκτρονικό ταχυδρομείο κ.λπ.) που απέκτησε πρώτο τον χρήστη. Αυτό το πεδίο δεν συμπληρώνεται σε ενδοημερήσιους πίνακες.
traffic_source.source STRING Το όνομα του δικτύου που απέκτησε πρώτο τον χρήστη. Αυτό το πεδίο δεν συμπληρώνεται σε ενδοημερήσιους πίνακες.
stream and platform
Τα πεδία stream (ροή) και platform (πλατφόρμα) περιέχουν πληροφορίες σχετικά με τη ροή και την πλατφόρμα της εφαρμογής.
Όνομα πεδίου Τύπος δεδομένων Περιγραφή
stream_id STRING Το αριθμητικό αναγνωριστικό της ροής δεδομένων από την οποία προήλθε το συμβάν.
platform STRING Η πλατφόρμα ροής δεδομένων (ιστός, IOS ή Android) από την οποία προήλθε το συμβάν.
ecommerce
Αυτό το στοιχείο 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
Το στοιχείο 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 Αρχική σελίδα
      μέσο παραπομπή
      πηγή google
      page_referrer https://www.google.com
      <parameters...> <values...>

 

Αυτά τα δεδομένα συμβάντος εμφανίζονται ως εξής στη διεπαφή χρήστη του GA4.

Στοιχεία που πρέπει να λάβετε υπόψη για την ενημέρωση των SDK σε Android 17.2.5 (ή μεταγενέστερη έκδοση) ή/και σε iOS: 16.20.0 (ή μεταγενέστερη έκδοση)

Αν χρησιμοποιείτε προγενέστερες εκδόσεις για οποιοδήποτε SDK και σκοπεύετε να αναβαθμίσετε σε Android 17.2.5 (ή μεταγενέστερη έκδοση) ή/και σε iOS 16.20.0 (ή μεταγενέστερη έκδοση), πρέπει να λάβετε υπόψη τα εξής:

  • Για να χρησιμοποιήσετε το τρέχον σχήμα εξαγωγής BigQuery, πρέπει να αναβαθμίσετε το SDK σε Android 17.2.5 (ή μεταγενέστερη έκδοση) ή/και σε iOS 16.20.0 (ή μεταγενέστερη έκδοση).Όταν χρησιμοποιείτε παλαιότερες εκδόσεις SDK, τα εξαγόμενα δεδομένα θα αντικατοπτρίζουν το παλιό σχήμα
  • Από την αναβάθμιση και έπειτα, θα μπορείτε να έχετε πρόσβαση μόνο σε δεδομένα στοιχείου εντός του συνόλου επαναλαμβανόμενων στοιχείων. Τα δεδομένα στοιχείου δεν θα είναι πλέον διαθέσιμα σε βασικές παραμέτρους συμβάντων, όπως ίσχυε πριν από αυτές τις εκδόσεις SDK.
  • Αυτή η αλλαγή πραγματοποιήθηκε με σκοπό την υποστήριξη της ανάλυσης πολλών προϊόντων.
  • Επομένως, μπορεί να χρειαστεί να προσαρμόσετε τις αναφορές σας στα δεδομένα στοιχείου/προϊόντος.
Χρησιμοποιήστε αυτό το σενάριο για τη μετεγκατάσταση των υπαρχόντων συνόλων δεδομένων BigQuery από το παλιό σχήμα εξαγωγής στο νέο σχήμα εξαγωγής
  1. Συνδεθείτε στο Cloud Platform Console >: σελίδα Manager resources.
  2. Ανοίξτε το έργο του οποίου τα δεδομένα θέλετε να μετεγκατασταθούν και κάντε κλικ στην επιλογή Activate Google Cloud Shell, στο επάνω μέρος της σελίδας.
  3. Όταν ανοίξει το κέλυφος, αντιγράψτε το παρακάτω σενάριο σε ένα αρχείο που ονομάζεται migration_script.sql:
    1. Δώστε την εντολή cat > migration_script.sql
    2. Αντιγράψτε και επικολλήστε το παρακάτω σενάριο στο κέλυφος.
    3. Πατήστε Ctrl+D για αποθήκευση και έξοδο.
    Σενάριο (migration_script.sql):
      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
      
  4. Ανοίξτε ένα νέο κέλυφος και αντιγράψτε το παρακάτω σενάριο bash σε ένα αρχείο που ονομάζεται migration.sh:
    1. Δώστε την εντολή cat > migration.sh
    2. Αντιγράψτε και επικολλήστε το παρακάτω σενάριο στο κέλυφος.
    3. Πατήστε 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
    
    # ΤΕΛΟΣ ΣΕΝΑΡΙΟΥ
    
    
  5. Ανοίξτε ένα νέο κέλυφος και δώστε την εντολή 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) κατά την οποία αυτό το συμβάν καταγράφηκε προηγουμένως στην εφαρμογή πελάτη.

Σας βοήθησε αυτό;

Με ποιον τρόπο μπορούμε να το βελτιώσουμε;
Αναζήτηση
Διαγραφή αναζητήσεων
Κλείσιμο αναζήτησης
Κύριο μενού
8341835451120992100
true
Αναζήτηση στο Κέντρο Βοήθειας
true
true
true
true
true
69256
false
false