În acest articol sunt explicate formatul și schema datelor din proprietățile Google Analytics 4 și ale datelor Google Analytics pentru Firebase exportate în BigQuery.
Seturi de date
Pentru fiecare proprietate Google Analytics 4 și fiecare proiect Firebase conectat la BigQuery, va fi adăugat un singur set de date numit „analytics_<property_id>” la proiectul BigQuery. Codul proprietății se referă la codul proprietății Analytics, care poate fi găsit în setările proprietății pentru proprietatea Google Analytics 4 și în setările datelor statistice privind aplicația Analytics din Firebase. Fiecare proprietate Google Analytics 4 și fiecare aplicație care are activat BigQuery Export va exporta propriile date în setul de date respectiv.
Tabele
În fiecare set de date, este creat zilnic un tabel denumit events_YYYYMMDD
, dacă este activată opțiunea Export zilnic.
Dacă este activată opțiunea Export în flux, se creează un tabel denumit events_intraday_YYYYMMDD
. Acest tabel este completat în mod continuu, pe măsură ce evenimentele sunt înregistrate pe parcursul zilei. Tabelul este șters la sfârșitul fiecărei zile, după ce se încheie events_YYYYMMDD
.
Nu toate dispozitivele de pe care sunt declanșate evenimente își trimit datele la Analytics în aceeași zi în care sunt declanșate evenimentele. Pentru a ține cont de această latență, Google Analytics va actualiza tabelele zilnice (events_YYYYMMDD
) cu evenimentele asociate datelor respective, timp de maximum trei zile după datele evenimentelor. Evenimentele vor avea marcajul temporal corect, indiferent dacă ajung cu întârziere. Evenimentele care sosesc după fereastra de trei zile nu sunt înregistrate.
Dacă folosiți mediul de testare BigQuery, evenimentele nu vor fi importate pe parcursul zilei și se aplică limite suplimentare.
Faceți upgrade pentru a nu mai folosi mediul de testare dacă doriți să faceți importuri pe parcursul zilei.
Coloane
Fiecare coloană din tabelul events_YYYYMMDD
reprezintă un parametru pentru eveniment. Rețineți că anumiți parametri sunt imbricați în ÎNREGISTRĂRI, iar unele ÎNREGISTRĂRI, cum ar fi items
și event_params
, sunt repetabile. Coloanele din tabel sunt descrise mai jos.
Câmpurile event conțin informații care identifică în mod unic un eveniment. | ||
Numele câmpului | Tip de date | Descriere |
---|---|---|
batch_event_index | NUMĂR ÎNTREG | Un număr care indică ordinea secvențială a fiecărui eveniment dintr-un lot, în funcție de ordinea apariției acestuia pe dispozitiv. |
batch_ordering_id | NUMĂR ÎNTREG | Un număr care crește monoton și care este incrementat de fiecare dată când se trimite o solicitare către rețea dintr-o anumită pagină. |
batch_page_id | NUMĂR ÎNTREG | Un număr secvențial atribuit unei pagini, care crește pentru fiecare pagină ulterioară dintr-o interacțiune. |
event_date | STRING | Data la care a fost înregistrat evenimentul (formatul YYYYMMDD în fusul orar înregistrat al aplicației). |
event_timestamp | NUMĂR ÎNTREG | Momentul (în microsecunde, UTC) în care evenimentul a fost înregistrat la client. |
event_previous_timestamp | NUMĂR ÎNTREG | Momentul (în microsecunde, UTC) în care evenimentul a fost înregistrat anterior în client. |
event_name | STRING | Numele evenimentului. |
event_value_in_usd | NUMĂR ÎN VIRGULĂ MOBILĂ | Valoarea convertită în monedă (în USD) a parametrului „value” al evenimentului. |
event_bundle_sequence_id | NUMĂR ÎNTREG | Codul secvențial al grupului în care au fost încărcate aceste evenimente. |
event_server_timestamp_offset | NUMĂR ÎNTREG | Decalajul temporal dintre momentul colectării și momentul încărcării, în microsecunde. |
ÎNREGISTRAREA event_params
ÎNREGISTRAREA event_params poate stoca parametri la nivel de campanie și contextuali, precum și orice parametri de eveniment definiți de utilizator. ÎNREGISTRAREA event_params este repetată pentru fiecare cheie asociată cu un eveniment. Setul de parametri stocat în ÎNREGISTRAREA event_params este unic pentru fiecare implementare. Pentru a vedea lista completă a parametrilor de eveniment pentru implementare, interogați lista parametrilor de eveniment. |
||
Numele câmpului | Tip de date | Descriere |
---|---|---|
event_params.key | STRING | Numele parametrului de eveniment. |
event_params.value | ÎNREGISTRARE | O înregistrare care conține valoarea parametrului evenimentului. |
event_params.value.string_value | STRING | Dacă parametrul de eveniment este reprezentat de un șir, cum ar fi adresa URL sau numele unei campanii, acesta este completat în acest câmp. |
event_params.value.int_value | NUMĂR ÎNTREG | Dacă parametrul de eveniment este reprezentat de un număr întreg, acesta este completat în acest câmp. |
event_params.value.double_value | NUMĂR ÎN VIRGULĂ MOBILĂ | Dacă parametrul de eveniment este reprezentat de o valoare dublă, aceasta este completată în acest câmp. |
event_params.value.float_value | NUMĂR ÎN VIRGULĂ MOBILĂ | Dacă parametrul de eveniment este reprezentat de o valoare cu virgulă mobilă, aceasta este completată în acest câmp. Momentan, acest câmp nu este folosit. |
ÎNREGISTRAREA item_params
ÎNREGISTRAREA item_params poate stoca parametrii articolului, precum și orice parametru al articolului definit de utilizator. Setul de parametri stocat în ÎNREGISTRAREA item_params este unic pentru fiecare implementare. |
||
Numele câmpului | Tip de date | Descriere |
---|---|---|
item_params.key | STRING | Numele parametrului de articol. |
item_params.value | ÎNREGISTRARE | O înregistrare care conține valoarea parametrului de articol. |
item_params.value.string_value | STRING | Dacă parametrul de articol este reprezentat de un șir, acesta este completat în acest câmp. |
item_params.value.int_value | NUMĂR ÎNTREG | Dacă parametrul de articol este reprezentat de un număr întreg, acesta este completat în acest câmp. |
item_params.value.double_value | NUMĂR ÎN VIRGULĂ MOBILĂ | Dacă parametrul de articol este reprezentat de o valoare dublă, aceasta este completată în acest câmp. |
item_params.value.float_value | NUMĂR ÎN VIRGULĂ MOBILĂ | Dacă parametrul de articol este reprezentat de o valoare cu virgulă mobilă, aceasta este completată în acest câmp. |
Câmpurile user conțin informații care identifică în mod unic utilizatorul asociat evenimentului. | ||
Numele câmpului | Tip de date | Descriere |
---|---|---|
is_active_user | BOOLEAN |
Dacă utilizatorul a fost activ (Adevărat) sau inactiv (Fals) în orice moment al zilei calendaristice Inclus numai în tabelele zilnice ( |
user_id | STRING | ID-ul unic atribuit unui utilizator. |
user_pseudo_id | STRING | Codul pseudonim (de exemplu, codul instanței aplicației) al utilizatorului. Un identificator unic care este atribuit unui utilizator când deschide aplicația sau accesează site-ul pentru prima dată. |
user_first_touch_timestamp | NUMĂR ÎNTREG | Ora (în microsecunde) la care utilizatorul a deschis prima dată aplicația sau a accesat site-ul. |
Câmpurile privacy_info
Câmpurile privacy_info conțin informații bazate pe starea consimțământului unui utilizator atunci când modul de consimțământ este activat. | ||
Numele câmpului | Tip de date | Descriere |
---|---|---|
privacy_info.ads_storage | STRING |
Dacă direcționarea anunțurilor este activată pentru un anumit utilizator. Valori posibile: Da, Nu, Nesetat |
privacy_info.analytics_storage | STRING |
Dacă stocarea în Google Analytics este activată pentru utilizator. Valori posibile: Da, Nu, Nesetat |
privacy_info.uses_transient_token | STRING |
Dacă un utilizator de internet a refuzat stocarea în Analytics și dezvoltatorul a activat măsurarea fără cookie-uri pe baza tokenurilor temporare în datele de pe server. Valori posibile: Da, Nu, Nesetat |
ÎNREGISTRAREA user_properties
ÎNREGISTRAREA user_properties conține toate proprietățile utilizatorului pe care le-ați setat. Se repetă pentru fiecare cheie asociată cu un utilizator. | ||
Numele câmpului | Tip de date | Descriere |
---|---|---|
user_properties.key | STRING | Numele proprietății utilizatorului. |
user_properties.value | ÎNREGISTRARE | O înregistrare pentru valoarea proprietății utilizatorului. |
user_properties.value.string_value | STRING | Valoarea ca șir a proprietății utilizatorului. |
user_properties.value.int_value | NUMĂR ÎNTREG | Valoarea ca întreg a proprietății utilizatorului. |
user_properties.value.double_value | NUMĂR ÎN VIRGULĂ MOBILĂ | Valoarea în dublă precizie a proprietății utilizatorului. |
user_properties.value.float_value | NUMĂR ÎN VIRGULĂ MOBILĂ | Momentan, acest câmp nu este folosit. |
user_properties.value.set_timestamp_micros | NUMĂR ÎNTREG | Momentul (în microsecunde) în care a fost setată ultima dată proprietatea utilizatorului. |
ÎNREGISTRAREA user_ltv
ÎNREGISTRAREA user_ltv conține informațiile despre valoarea clientului asociate utilizatorului. ÎNREGISTRAREA nu este completată în tabelele din cursul zilei. | ||
Numele câmpului | Tip de date | Descriere |
---|---|---|
user_ltv.revenue | NUMĂR ÎN VIRGULĂ MOBILĂ | Valoarea clientului (venit) a utilizatorului. Câmpul nu este completat în tabelele din aceeași zi. |
user_ltv.currency | STRING | Valoarea clientului (monedă) a utilizatorului. Câmpul nu este completat în tabelele din aceeași zi. |
ÎNREGISTRAREA device conține informații despre dispozitivul de la care a provenit evenimentul. | ||
Numele câmpului | Tip de date | Descriere |
---|---|---|
device.category | STRING | Categoria dispozitivului (mobil, tabletă, computer). |
device.mobile_brand_name | STRING | Numele mărcii dispozitivului. |
device.mobile_model_name | STRING | Numele modelului dispozitivului. |
device.mobile_marketing_name | STRING | Numele de marketing al dispozitivului. |
device.mobile_os_hardware_model | STRING | Informații despre modelul dispozitivului, preluate direct din sistemul de operare. |
device.operating_system | STRING | Sistemul de operare al dispozitivului. |
device.operating_system_version | STRING | Versiunea sistemului de operare. |
device.vendor_id | STRING | IDFV (doar dacă IDFA nu este cules). |
device.advertising_id | STRING | ID-ul publicitar/IDFA. |
device.language | STRING | Limba sistemului de operare. |
device.time_zone_offset_seconds | NUMĂR ÎNTREG | Decalajul față de GMT în secunde. |
device.is_limited_ad_tracking | BOOLEAN |
Setarea Limitați urmărirea anunțurilor a dispozitivului. Pe iOS 14 sau versiunile ulterioare, returnează valoarea „false” dacă IDFA este diferit de zero. |
device.web_info.browser | STRING | Browserul în care utilizatorul a vizualizat conținutul. |
device.web_info.browser_version | STRING | Versiunea browserului în care utilizatorul a vizualizat conținutul. |
device.web_info.hostname | STRING | Numele de gazdă asociat evenimentului înregistrat. |
criterii geografice
ÎNREGISTRAREA geo conține informații despre locația geografică unde a fost inițiat evenimentul. | ||
Numele câmpului | Tip de date | Descriere |
---|---|---|
geo.continent | STRING | Continentul din care au fost raportate evenimentele, în funcție de adresa IP. |
geo.sub_continent | STRING | Subcontinentul din care au fost raportate evenimentele, în funcție de adresa IP. |
geo.country | STRING | Țara din care au fost raportate evenimentele, în funcție de adresa IP. |
geo.region | STRING | Regiunea din care au fost raportate evenimentele, în funcție de adresa IP. |
geo.metro | STRING | Zona metropolitană din care au fost raportate evenimentele, în funcție de adresa IP. |
geo.city | STRING | Orașul din care au fost raportate evenimentele, în funcție de adresa IP. |
ÎNREGISTRAREA _app_info conține informații despre aplicația în care a fost inițiat evenimentul. | ||
Numele câmpului | Tip de date | Descriere |
---|---|---|
app_info.id | STRING | Numele pachetului sau codul de pachet al aplicației. |
app_info.firebase_app_id | STRING | ID-ul aplicației Firebase asociat aplicației. |
app_info.install_source | STRING | Magazinul care a instalat aplicația. |
app_info.version | STRING | versionName (Android) sau versiunea scurtă de grup. |
ÎNREGISTRAREA collected_traffic_source conține datele din sursele de trafic colectate împreună cu primul eveniment al paginii. |
||
Numele câmpului | Tip de date | Descriere |
---|---|---|
manual_campaign_id | STRING | Codul campaniei manuale (utm_id) colectat împreună cu evenimentul. |
manual_campaign_name | STRING | Numele campaniei manuale (utm_campaign) colectat împreună cu evenimentul. |
manual_source | STRING | Sursa campaniei manuale (utm_source) colectată împreună cu evenimentul. Include și parametrii analizați din parametrii de recomandare, nu doar valorile UTM. |
manual_medium | STRING | Modalitatea campaniei manuale (utm_medium) colectată împreună cu evenimentul. Include și parametrii analizați din parametrii de recomandare, nu doar valorile UTM. |
manual_term | STRING | Cuvântul cheie / termenul campaniei manuale (utm_term) colectat împreună cu evenimentul. |
manual_content | STRING | Metadatele suplimentare ale campaniei manuale (utm_content) colectate împreună cu evenimentul. |
manual_creative_format | STRING | Formatul reclamei din campania manuală (utm_creative_format) colectat împreună cu evenimentul. |
manual_marketing_tactic | STRING | Tactica de marketing a campaniei manuale (utm_marketing_tactic) colectată împreună cu evenimentul. |
manual_source_platform | STRING | Platforma sursă a campaniei manuale (utm_source_platform) colectată împreună cu evenimentul. |
gclid | STRING | Identificatorul de clicuri Google colectat împreună cu evenimentul. |
dclid | STRING | Identificatorul de clicuri DoubleClick pentru Display & Video 360 și Campaign Manager 360 colectat împreună cu evenimentul. |
srsltid | STRING | Identificatorul Google Merchant Center colectat împreună cu evenimentul. |
ÎNREGISTRAREA session_traffic_source_last_click conține datele sursei de trafic din sesiunea atribuită ultimului clic din anunțurile Google și contextele manuale, dacă sunt disponibile. |
||
Numele câmpului | Tip de date | Descriere |
---|---|---|
session_traffic_source_last_click. manual_campaign.campaign_id | STRING | Codul campaniei manuale pe care s-a dat ultimul clic |
session_traffic_source_last_click. manual_campaign.campaign_name | STRING | Numele campaniei manuale pe care s-a dat ultimul clic |
session_traffic_source_last_click. manual_campaign.medium | STRING | Modalitatea campaniei manuale pe care s-a dat ultimul clic (de exemplu, căutare plătită, căutare organică, e-mail) |
session_traffic_source_last_click. manual_campaign.term | STRING | Cuvântul cheie / termenul de căutare din campania manuală pe care s-a dat ultimul clic |
session_traffic_source_last_click. manual_campaign.content | STRING | Metadate suplimentare ale campaniei manuale pe care s-a dat ultimul clic |
session_traffic_source_last_click. manual_campaign.source_platform | STRING | Platforma campaniei manuale pe care s-a dat ultimul clic (de exemplu, motor de căutare, rețea socială) |
session_traffic_source_last_click. manual_campaign.source | STRING | Sursa de pe platforma campaniei manuale pe care s-a dat ultimul clic |
session_traffic_source_last_click. manual_campaign.creative_format | STRING | Formatul materialului publicitar din campania manuală pe care s-a dat ultimul clic |
session_traffic_source_last_click. manual_campaign.marketing_tactic | STRING | Tactica de marketing a campaniei manuale pe care s-a dat ultimul clic |
session_traffic_source_last_click. google_ads_campaign.customer_id | STRING | Codul clientului asociat contului Google Ads |
session_traffic_source_last_click. google_ads_campaign.account_name | STRING | Numele contului Google Ads |
session_traffic_source_last_click. google_ads_campaign.campaign_id | STRING | Codul campaniei Google Ads |
session_traffic_source_last_click. google_ads_campaign.campaign_name | STRING | Numele campaniei Google Ads |
session_traffic_source_last_click. google_ads_campaign.ad_group_id | STRING | Codul grupului de anunțuri din campania Google Ads |
session_traffic_source_last_click. google_ads_campaign.ad_group_name | STRING | Numele grupului de anunțuri din campania Google Ads |
session_traffic_source_last_click. cross_channel_campaign.campaign_name |
STRING | Numele campaniei pe mai multe canale pe care s-a dat ultimul clic |
session_traffic_source_last_click. cross_channel_campaign.campaign_id |
STRING | Codul campaniei pe mai multe canale pe care s-a dat ultimul clic |
session_traffic_source_last_click. cross_channel_campaign.source_platform |
STRING | Platforma campaniei pe mai multe canale pe care s-a dat ultimul clic |
session_traffic_source_last_click. cross_channel_campaign.source |
STRING | Sursa de pe platforma campaniei pe mai multe canale pe care s-a dat ultimul clic |
session_traffic_source_last_click. cross_channel_campaign.medium |
STRING | Modalitatea campaniei pe mai multe canale pe care s-a dat ultimul clic |
session_traffic_source_last_click. sa360_campaign.campaign_name |
STRING | Numele campaniei SA360 pe care s-a dat ultimul clic |
session_traffic_source_last_click. sa360_campaign.source |
STRING | Sursa de pe platforma campaniei SA360 pe care s-a dat ultimul clic |
session_traffic_source_last_click. sa360_campaign.medium |
STRING | Modalitatea campaniei SA360 pe care s-a dat ultimul clic |
session_traffic_source_last_click. sa360_campaign.ad_group_id |
STRING | Codul grupului de anunțuri din campania SA360 |
session_traffic_source_last_click. sa360_campaign.ad_group_name |
STRING | Numele grupului de anunțuri din campania SA360 |
session_traffic_source_last_click. sa360_campaign.campaign_id |
STRING | Codul campaniei SA360 pe care s-a dat ultimul clic |
session_traffic_source_last_click. sa360_campaign.creative_format |
STRING | Formatul materialului publicitar din campania SA360 pe care s-a dat ultimul clic |
session_traffic_source_last_click. sa360_campaign.engine_account_name |
STRING | Numele contului pentru motorul de căutare SA360 |
session_traffic_source_last_click. sa360_campaign.engine_account_type |
STRING | Tipul de cont pentru motorul de căutare care conține campania SA360 |
session_traffic_source_last_click. sa360_campaign.manager_account_name |
STRING | Numele contului de manager SA360 |
session_traffic_source_last_click. dv360_campaign.advertiser_id |
STRING | Codul advertiserului DV360 |
session_traffic_source_last_click. dv360_campaign.advertiser_name |
STRING | Numele advertiserului DV360 |
session_traffic_source_last_click. dv360_campaign.campaign_id |
STRING | Codul campaniei DV360 pe care s-a dat ultimul clic |
session_traffic_source_last_click. dv360_campaign.campaign_name |
STRING | Numele campaniei DV360 pe care s-a dat ultimul clic |
session_traffic_source_last_click. dv360_campaign.creative_id |
STRING | Codul materialului publicitar din campania DV360 pe care s-a dat ultimul clic |
session_traffic_source_last_click. dv360_campaign.creative_format |
STRING | Formatul materialului publicitar din campania DV360 pe care s-a dat ultimul clic |
session_traffic_source_last_click. dv360_campaign.creative_name |
STRING | Numele materialului publicitar din campania DV360 pe care s-a dat ultimul clic |
session_traffic_source_last_click. dv360_campaign.marketing_tactic |
STRING | Tactica de marketing a campaniei DV360 pe care s-a dat ultimul clic |
session_traffic_source_last_click. dv360_campaign.exchange_id |
STRING | Codul schimbului din campania DV360 pe care s-a dat ultimul clic |
session_traffic_source_last_click. dv360_campaign.exchange_name |
STRING | Numele schimbului din campania DV360 pe care s-a dat ultimul clic |
session_traffic_source_last_click. dv360_campaign.insertion_order_id |
STRING | Codul comenzii de inserare din campania DV360 pe care s-a dat ultimul clic |
session_traffic_source_last_click. dv360_campaign.insertion_order_name |
STRING | Numele comenzii de inserare din campania DV360 pe care s-a dat ultimul clic |
session_traffic_source_last_click. dv360_campaign.line_item_id |
STRING | Codul elementului rând din campania DV360 pe care s-a dat ultimul clic |
session_traffic_source_last_click. dv360_campaign.line_item_name |
STRING | Numele elementului rând din campania DV360 pe care s-a dat ultimul clic |
session_traffic_source_last_click. dv360_campaign.partner_id |
STRING | Codul partenerului DV360 |
session_traffic_source_last_click. dv360_campaign.partner_name |
STRING | Numele partenerului DV360 |
session_traffic_source_last_click. dv360_campaign.source |
STRING | Sursa de pe platforma campaniei DV360 pe care s-a dat ultimul clic |
session_traffic_source_last_click. dv360_campaign.medium |
STRING | Modalitatea campaniei DV360 pe care s-a dat ultimul clic |
session_traffic_source_last_click. cm360_campaign.account_id |
STRING | Codul contului CM360 |
session_traffic_source_last_click. cm360_campaign.account_name |
STRING | Numele contului CM360 |
session_traffic_source_last_click. cm360_campaign.advertiser_id |
STRING | Codul advertiserului CM360 |
session_traffic_source_last_click. cm360_campaign.advertiser_name |
STRING | Numele advertiserului CM360 |
session_traffic_source_last_click. cm360_campaign.campaign_id |
STRING | Codul campaniei CM360 pe care s-a dat ultimul clic |
session_traffic_source_last_click. cm360_campaign.campaign_name |
STRING | Numele campaniei CM360 pe care s-a dat ultimul clic |
session_traffic_source_last_click. cm360_campaign.creative_id |
STRING | Codul materialului publicitar din campania CM360 pe care s-a dat ultimul clic |
session_traffic_source_last_click. cm360_campaign.creative_format |
STRING | Formatul materialului publicitar din campania CM360 pe care s-a dat ultimul clic |
session_traffic_source_last_click. cm360_campaign.creative_name |
STRING | Numele materialului publicitar din campania CM360 pe care s-a dat ultimul clic |
session_traffic_source_last_click. cm360_campaign.creative_type |
STRING | Tipul materialului publicitar din campania CM360 pe care s-a dat ultimul clic |
session_traffic_source_last_click. cm360_campaign.creative_type_id |
STRING | Codul tipului de material publicitar pentru campania CM360 pe care s-a dat ultimul clic |
session_traffic_source_last_click. cm360_campaign.creative_version |
STRING | Versiunea materialului publicitar din campania CM360 pe care s-a dat ultimul clic |
session_traffic_source_last_click. cm360_campaign.placement_id |
STRING | Codul destinației de plasare din campania CM360 pe care s-a dat ultimul clic |
session_traffic_source_last_click.cm360 _campaign.placement_cost_structure |
STRING | Structura de cost a destinației de plasare din campania CM360 pe care s-a dat ultimul clic |
session_traffic_source_last_click. cm360_campaign.placement_name |
STRING | Numele destinației de plasare din campania CM360 pe care s-a dat ultimul clic |
session_traffic_source_last_click. cm360_campaign.rendering_id |
STRING | Codul de redare al campaniei CM360 pe care s-a dat ultimul clic |
session_traffic_source_last_click. cm360_campaign.site_id |
STRING | Codul site-ului din campania CM360 pe care s-a dat ultimul clic |
session_traffic_source_last_click. cm360_campaign.site_name |
STRING | Numele site-ului din campania CM360 pe care s-a dat ultimul clic |
session_traffic_source_last_click. cm360_campaign.source |
STRING | Sursa campaniei CM360 pe care s-a dat ultimul clic |
session_traffic_source_last_click. cm360_campaign.medium |
STRING | Modalitatea campaniei CM360 pe care s-a dat ultimul clic |
ÎNREGISTRAREA traffic_source conține informații despre sursa de trafic care a atras prima dată utilizatorul. Înregistrarea nu este completată în tabelele din cursul zilei. Notă: valorile traffic_source nu se modifică dacă utilizatorul interacționează cu campaniile ulterioare după instalare. |
||
Numele câmpului | Tip de date | Descriere |
---|---|---|
traffic_source.name | STRING | Numele primei campanii de marketing care a atras utilizatorul. Câmpul nu este completat în tabelele din aceeași zi. |
traffic_source.medium | STRING | Numele primei modalități (căutare plătită, căutare organică, e-mail etc.) care a atras utilizatorul. Câmpul nu este completat în tabelele din aceeași zi. |
traffic_source.source | STRING | Numele primei rețele care a atras utilizatorul. Câmpul nu este completat în tabelele din aceeași zi. |
Câmpurile stream și platform conțin informații despre fluxul și platforma aplicației. | ||
Numele câmpului | Tip de date | Descriere |
---|---|---|
stream_id | STRING | Codul numeric al fluxului de date din care a provenit evenimentul. |
platformă | STRING | Platforma fluxului de date (web, IOS sau Android) din care a provenit evenimentul. |
ÎNREGISTRAREA ecommerce conține informații despre toate evenimentele de comerț electronic care au fost configurate pe un site sau într-o aplicație. | ||
Numele câmpului | Tip de date | Descriere |
---|---|---|
ecommerce.total_item_quantity | NUMĂR ÎNTREG | Numărul total de articole din acest eveniment, care reprezintă suma items.quantity. |
ecommerce.purchase_revenue_in_usd | NUMĂR ÎN VIRGULĂ MOBILĂ | Venitul din achiziții al acestui eveniment, exprimat în USD ca unitate standard. Completat numai pentru evenimentul de achiziție. |
ecommerce.purchase_revenue | NUMĂR ÎN VIRGULĂ MOBILĂ | Venitul din achiziții al acestui eveniment, exprimat în moneda locală ca unitate standard. Completat numai pentru evenimentul de achiziție. |
ecommerce.refund_value_in_usd | NUMĂR ÎN VIRGULĂ MOBILĂ | Suma rambursată în cadrul acestui eveniment, exprimată în USD ca unitate standard. Completată numai pentru evenimentul de rambursare. |
ecommerce.refund_value | NUMĂR ÎN VIRGULĂ MOBILĂ | Suma rambursată în cadrul acestui eveniment, exprimată în moneda locală ca unitate standard. Completată numai pentru evenimentul de rambursare. |
ecommerce.shipping_value_in_usd | NUMĂR ÎN VIRGULĂ MOBILĂ | Costul de expediere în cadrul acestui eveniment, exprimat în USD ca unitate standard. |
ecommerce.shipping_value | NUMĂR ÎN VIRGULĂ MOBILĂ | Costul de expediere în cadrul acestui eveniment, exprimat în moneda locală. |
ecommerce.tax_value_in_usd | NUMĂR ÎN VIRGULĂ MOBILĂ | Valoarea taxelor în cadrul acestui eveniment, exprimată în USD ca unitate standard. |
ecommerce.tax_value | NUMĂR ÎN VIRGULĂ MOBILĂ | Valoarea taxelor din acest eveniment, exprimată în moneda locală, ca unitate standard. |
ecommerce.transaction_id | STRING | Codul tranzacției pentru tranzacția de comerț electronic. |
ecommerce.unique_items | NUMĂR ÎNTREG | Numărul de articole unice din acest eveniment, pe baza atributelor item_id, item_name și item_brand. |
ÎNREGISTRAREA items conține informații despre elementele incluse într-un eveniment. Se repetă pentru fiecare element. | ||
Numele câmpului | Tip de date | Descriere |
---|---|---|
items.item_id | STRING | Codul elementului. |
items.item_name | STRING | Numele articolului. |
items.item_brand | STRING | Marca articolului. |
items.item_variant | STRING | Varianta articolului. |
items.item_category | STRING | Categoria articolului. |
items.item_category2 | STRING | Subcategoria articolului. |
items.item_category3 | STRING | Subcategoria articolului. |
items.item_category4 | STRING | Subcategoria articolului. |
items.item_category5 | STRING | Subcategoria articolului. |
items.price_in_usd | NUMĂR ÎN VIRGULĂ MOBILĂ | Prețul articolului în USD ca unitate standard. |
items.price | NUMĂR ÎN VIRGULĂ MOBILĂ | Prețul articolului în moneda locală. |
items.quantity | NUMĂR ÎNTREG | Cantitatea articolului. Dacă nu este specificată, cantitatea este setată la valoarea 1. |
items.item_revenue_in_usd | NUMĂR ÎN VIRGULĂ MOBILĂ | Venitul din acest articol, calculat cu formula price_in_usd * quantity. Acesta este completat numai pentru evenimentele de achiziție, în USD ca unitate standard. |
items.item_revenue | NUMĂR ÎN VIRGULĂ MOBILĂ | Venitul din acest articol, calculat cu formula price * quantity. Acesta este completat numai pentru evenimentele de achiziție, în moneda locală ca unitate standard. |
items.item_refund_in_usd | NUMĂR ÎN VIRGULĂ MOBILĂ | Suma rambursată pentru acest articol, calculată cu formula price_in_usd * quantity. Aceasta este completată numai pentru evenimentele de rambursare, în USD ca unitate standard. |
items.item_refund | NUMĂR ÎN VIRGULĂ MOBILĂ | Suma rambursată pentru acest articol, calculată cu formula price * quantity. Aceasta este completată numai pentru evenimentele de rambursare, în moneda locală ca unitate standard. |
items.coupon | STRING | Codul de cupon aplicat pentru acest articol. |
items.affiliation | STRING | Afiliere pentru un produs, care desemnează o companie furnizoare sau locația unui magazin fizic. |
items.location_id | STRING | Locația asociată articolului. |
items.item_list_id | STRING | Codul listei în care este afișat articolul pentru utilizator. |
items.item_list_name | STRING | Numele listei în care este afișat articolul pentru utilizator. |
Items.item_list_index | STRING | Poziția articolului într-o listă. |
items.promotion_id | STRING | Codul unei promoții pentru produs. |
items.promotion_name | STRING | Numele unei promoții pentru produs. |
items.creative_name | STRING | Numele unui material publicitar folosit într-un spot promoțional. |
items.creative_slot | STRING | Numele unui spațiu publicitar. |
ÎNREGISTRAREA item_params
ÎNREGISTRAREA item_params stochează parametrii de articol personalizați pe care i-ați definit. Rețineți că parametrii de articol predefiniți, cum ar fi item_id, item_name etc., nu sunt incluși aici, ci sunt exportați sub formă de câmpuri explicite. Setul de parametri stocat în ÎNREGISTRAREA item_params este unic pentru fiecare implementare. Pentru a afla mai multe despre implementările de comerț electronic și vectorul de articole Google Analytics 4, consultați Măsurați comerțul electronic. |
||
Numele câmpului | Tip de date | Descriere |
---|---|---|
items.item_params.key | STRING | Numele parametrului de articol. |
items.item_params.value | ÎNREGISTRARE | O înregistrare care conține valoarea parametrului de articol. |
items.item_params.value.string_value | STRING | Dacă parametrul de articol este reprezentat de un șir, acesta este completat în acest câmp. |
items.item_params.value.int_value | NUMĂR ÎNTREG | Dacă parametrul de articol este reprezentat de un număr întreg, acesta este completat în acest câmp. |
items.item_params.value.double_value | NUMĂR ÎN VIRGULĂ MOBILĂ | Dacă parametrul de articol este reprezentat de o valoare dublă, aceasta este completată în acest câmp. |
items.item_params.value.float_value | NUMĂR ÎN VIRGULĂ MOBILĂ | Dacă parametrul de articol este reprezentat de o valoare cu virgulă mobilă, aceasta este completată în acest câmp. |
ÎNREGISTRAREA editor conține informații despre evenimentele provenite dintr-o integrare cu editorul referitoare la afișarea anunțurilor, adică AdMob. | ||
Numele câmpului | Tip de date | Descriere |
---|---|---|
editor | ÎNREGISTRARE | O înregistrare a datelor editorului care vin din AdMob. |
publisher.ad_revenue_in_usd | NUMĂR ÎN VIRGULĂ MOBILĂ | Venitul estimat din anunțuri rezultat din acest eveniment, exprimat în USD. Completat numai pentru evenimente de afișare a anunțurilor. |
publisher.ad_format | STRING | Descrie modul în care au apărut anunțurile și unde erau localizate. Printre formatele obișnuite se numără „Interstițial”, „Banner”, „Cu recompensă” și „Adaptat avansat”. |
publisher.ad_source_name | STRING | Rețeaua sursă care a difuzat un anunț. Între sursele obișnuite se numără „Rețeaua AdMob”, „rețeaua Meta Audience Network” și „Anunțuri interne mediate”. |
publisher.ad_unit_id | STRING | Numele pe care l-ați ales pentru a descrie această unitate de anunțuri. Unitățile de anunțuri sunt containere pe care le plasați în aplicații pentru a afișa anunțuri utilizatorilor. |
Rânduri
Datele pentru un singur eveniment pot fi reprezentate pe unul sau mai multe rânduri, dacă conțin sau nu ÎNREGISTRĂRI repetate. Un eveniment page_view
cu mai mulți parametri event_params
, de exemplu, ar arăta similar cu următorul tabel. Rândul inițial conține numele evenimentului, data, marcajul temporal și alte elemente de date care nu se repetă. ÎNREGISTRAREA event_params
se repetă pentru fiecare parametru asociat evenimentului. ÎNREGISTRĂRILE repetate sunt completate pe rândurile următoare, direct sub rândul inițial de eveniment.
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 | Acasă | |||
mediu | recomandare | |||
sursă | ||||
page_referrer | https://www.google.com | |||
<parameters...> | <values...> |
Aceste date despre evenimente sunt afișate după cum urmează în interfața de utilizare GA4.
Dacă ați folosit versiuni anterioare ale acestor SDK-uri și intenționați să faceți upgrade la Android 17.2.5 (sau o versiune ulterioară) și/sau la iOS 16.20.0 (sau o versiune ulterioară), trebuie să luați în considerare următoarele lucruri:
- pentru a folosi schema actuală BigQuery Export, trebuie să faceți upgrade SDK-ului pentru Android la versiunea 17.2.5 (sau o versiune ulterioară) și/sau pentru iOS la versiunea 16.20.0 (sau o versiune ulterioară). Când folosiți versiuni SDK anterioare, datele exportate vor reflecta schema veche.
- după ce faceți upgrade, veți putea să accesați datele despre articole numai din vectorul pentru articole care se repetă. Datele despre articole nu vor mai fi disponibile în parametrii de eveniment standard, așa cum erau în versiunile SDK anterioare.
- Această modificare a fost făcută pentru a permite analiza mai multor produse.
- Drept urmare, poate fi necesar să ajustați referirile la datele despre articole/produse.
- Conectați-vă la pagina Consolă Cloud Platform >: Resurse pentru manageri.
- Deschideți proiectul ale cărui date doriți să le transferați și dați clic pe Activați Google Cloud Shell în partea de sus a paginii.
- Când se deschide shell-ul, copiați scriptul de mai jos într-un fișier denumit
migration_script.sql
:- lansați comanda
cat > migration_script.sql
; - copiați și inserați scriptul de mai jos în shell;
- apăsați Ctrl + D pentru a salva și a ieși.
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
- lansați comanda
- Deschideți un shell nou și copiați scriptul bash de mai jos într-un fișier denumit
migration.sh
:- lansați comanda
cat > migration.sh
; - copiați și inserați scriptul de mai jos în shell;
- apăsați Ctrl + D pentru a salva și a ieși.
Modificați următorul script astfel încât să includă codul proprietății Analytics, codul proiectului BigQuery, codul aplicației Firebase, numele setului de date BigQuery și datele de începere și de încheiere pentru datele care vă interesează.Script (migration.sh):# Codul proprietății Analytics pentru proiect. Îl puteți găsi în Setările Analytics din Firebase. PROPERTY_ID=ID-ul proprietății dvs. Analytics # Proiect BigQuery Export. BQ_PROJECT_ID=„ID-ul proiectului dvs. BigQuery” (de ex., „proiect-public-firebase”) # Codul aplicației Firebase. FIREBASE_APP_ID=„codul aplicației Firebase” (de ex., „1:300830567303:ios:09b1ab1d3ca29bda”) # Setul de date de la care doriți să importați. BQ_DATASET=„numele setului de date BigQuery de la care doriți să importați” (de ex., „com_firebase_demo_IOS”) # Platforma. PLATFORM=„platforma aplicației. ANDROID sau IOS” # Intervalul de date pentru care doriți să faceți transferul, care include [START_DATE,END_DATE]. START_DATE=20180324 END_DATE=20180327 # Nu modificați scriptul de mai jos decât dacă știți exact ce faceți :) startdate=$(date -d"$START_DATE" +%Y%m%d) || exit -1 enddate=$(date -d"$END_DATE" +%Y%m%d) || exit -1 # Repetați pentru date. DATE="$startdate" while [ "$DATE" -le "$enddate" ]; do # Tabelul BQ creat cu ajutorul parametrilor de mai sus. 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 # FINALUL SCRIPTULUI
- lansați comanda
- Deschideți un shell nou și lansați comanda
bash migration.sh
user_dim
Numele câmpului | Tip de date | Descriere |
---|---|---|
user_dim | ÎNREGISTRARE | O înregistrare a parametrilor utilizatorului. |
user_dim.user_id | STRING | Codul utilizatorului, setat folosind API-ul setUserId. |
user_dim.first_open_timestamp_micros | NUMĂR ÎNTREG | Momentul (în microsecunde) în care utilizatorul a deschis prima dată aplicația. |
user_dim.user_properties | ÎNREGISTRARE | O înregistrare repetată a proprietăților utilizatorului, setată folosind API-ul setUserProperty. |
user_dim.user_properties.key | STRING | Numele proprietății utilizatorului. |
user_dim.user_properties.value | ÎNREGISTRARE | O înregistrare pentru informații despre proprietatea utilizatorului. |
user_dim.user_properties.value.value | ÎNREGISTRARE | O înregistrare pentru valoarea proprietății utilizatorului. |
user_dim.user_properties.value.value.string_value | STRING | Valoarea ca șir a proprietății utilizatorului. |
user_dim.user_properties.value.value.int_value | NUMĂR ÎNTREG | Valoarea ca întreg a proprietății utilizatorului. |
user_dim.user_properties.value.value.double_value | NUMĂR ÎN VIRGULĂ MOBILĂ | Valoarea în dublă precizie a proprietății utilizatorului. |
user_dim.user_properties.value.set_timestamp_usec | NUMĂR ÎNTREG | Momentul (în microsecunde) în care a fost setată ultima dată proprietatea utilizatorului. |
user_dim.user_properties.value.index | NUMĂR ÎNTREG | Indexul (0-24) proprietății utilizatorului. |
user_dim.device_info | ÎNREGISTRARE | O înregistrare a informațiilor despre dispozitiv. |
user_dim.device_info.device_category | STRING | Categoria dispozitivului (mobil, tabletă, computer). |
user_dim.device_info.mobile_brand_name | STRING | Numele mărcii dispozitivului. |
user_dim.device_info.mobile_model_name | STRING | Numele modelului dispozitivului. |
user_dim.device_info.mobile_marketing_name | STRING | Numele de marketing al dispozitivului. |
user_dim.device_info.device_model | STRING | Modelul dispozitivului. |
user_dim.device_info.platform_version | STRING | Versiunea sistemului de operare. |
user_dim.device_info.device_id | STRING | IDFV (doar dacă IDFA nu este disponibil). |
user_dim.device_info.resettable_device_id | STRING | ID-ul publicitar/IDFA. |
user_dim.device_info.user_default_language | STRING | Limba sistemului de operare. |
user_dim.device_info.device_time_zone_offset_seconds | NUMĂR ÎNTREG | Decalajul față de GMT în secunde. |
user_dim.device_info.limited_ad_tracking | BOOLEAN | Setarea Limitați urmărirea anunțurilor a dispozitivului. |
user_dim.geo_info | ÎNREGISTRARE | O înregistrare a informațiilor geografice ale utilizatorului. |
user_dim.geo_info.continent | STRING | Continentul din care au fost raportate evenimentele, în funcție de adresa IP. |
user_dim.geo_info.country | STRING | Țara din care au fost raportate evenimentele, în funcție de adresa IP. |
user_dim.geo_info.region | STRING | Regiunea din care au fost raportate evenimentele, în funcție de adresa IP. |
user_dim.geo_info.city | STRING | Orașul din care au fost raportate evenimentele, în funcție de adresa IP. |
user_dim.app_info | ÎNREGISTRARE | O înregistrare a informațiilor despre aplicație. |
user_dim.app_info.app_version | STRING | versionName (Android) sau versiunea scurtă de grup. |
user_dim.app_info.app_instance_id | STRING | ID-ul unic pentru acest exemplar al aplicației. |
user_dim.app_info.app_store | STRING | Magazinul care a instalat aplicația. |
user_dim.app_info.app_platform | STRING | Platforma pe care rulează aplicația. |
user_dim.traffic_source | ÎNREGISTRARE | Numele sursei de trafic folosite pentru a atrage utilizatorul. Câmpul nu este completat în tabelele din aceeași zi. |
user_dim.traffic_source.user_acquired_campaign | STRING | Numele campaniei de marketing care a atras utilizatorul. Câmpul nu este completat în tabelele din aceeași zi. |
user_dim.traffic_source.user_acquired_medium | STRING | Numele modalității (căutare plătită, căutare organică, e-mail etc.) prin care a fost atras utilizatorul. Câmpul nu este completat în tabelele din aceeași zi. |
user_dim.traffic_source.user_acquired_source | STRING | Numele rețelei care a atras utilizatorul. Câmpul nu este completat în tabelele din aceeași zi. |
user_dim.bundle_info | ÎNREGISTRARE | O înregistrare a informațiilor privind grupul în care au fost încărcate aceste evenimente. |
user_dim.bundle_info.bundle_sequence_id | NUMĂR ÎNTREG | Codul secvențial al grupului în care au fost încărcate aceste evenimente. |
user_dim.ltv_info | ÎNREGISTRARE | O înregistrare a informațiilor Valoarea clientului pentru acest utilizator. Câmpul nu este completat în tabelele din aceeași zi. |
user_dim.ltv_info.revenue | NUMĂR ÎN VIRGULĂ MOBILĂ | Valoarea clientului (venit) pentru acest utilizator. Câmpul nu este completat în tabelele din aceeași zi. |
user_dim.ltv_info.currency | STRING | Valoarea clientului (monedă) pentru acest utilizator. Câmpul nu este completat în tabelele din aceeași zi. |
event_dim
Numele câmpului | Tip de date | Descriere |
---|---|---|
event_dim | ÎNREGISTRARE | O înregistrare repetată a informațiilor legate de evenimentele din grup. |
event_dim.date | STRING | Data la care a fost înregistrat evenimentul (formatul YYYYMMDD în fusul orar înregistrat al aplicației). |
event_dim.name | STRING | Numele evenimentului. |
event_dim.params | ÎNREGISTRARE | O înregistrare repetată a parametrilor asociați evenimentului. |
event_dim.params.key | STRING | Cheia parametrului evenimentului. |
event_dim.params.value | ÎNREGISTRARE | O înregistrare a valorii parametrului evenimentului. |
event_dim.params.value.string_value | STRING | Valoarea ca șir a parametrului evenimentului. |
event_dim.params.value.int_value | NUMĂR ÎNTREG | Valoarea ca întreg a parametrului evenimentului. |
event_dim.params.value.double_value | NUMĂR ÎN VIRGULĂ MOBILĂ | Valoarea în dublă precizie a parametrului evenimentului. |
event_dim.timestamp_micros | NUMĂR ÎNTREG | Momentul (în microsecunde, UTC) în care evenimentul a fost înregistrat la client. |
event_dim.previous_timestamp_micros | NUMĂR ÎNTREG | Momentul (în microsecunde, UTC) în care evenimentul a fost înregistrat anterior la client. |