[GA4] Schema BigQuery Export

Î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.

event
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.
user
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 (events_YYYYMMDD).

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.
device
Î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.
app_info
Î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.
collected_traffic_source

Î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.
session_traffic_source_last_click

Î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
traffic_source

Î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.
stream și platform
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.
ecommerce
Î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.
items
Î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.
editor (numai cu acces anticipat)
Î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ă google
      page_referrer https://www.google.com
      <parameters...> <values...>

Aceste date despre evenimente sunt afișate după cum urmează în interfața de utilizare GA4.

Considerente pentru actualizarea SDK-urilor la Android 17.2.5 (sau o versiune ulterioară) și/sau la iOS 16.20.0 (sau o versiune ulterioară)

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.
Folosiți acest script pentru a transfera seturile de date BigQuery existente din vechea schemă de exportare în cea nouă.
  1. Conectați-vă la pagina Consolă Cloud Platform >: Resurse pentru manageri.
  2. 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.
  3. Când se deschide shell-ul, copiați scriptul de mai jos într-un fișier denumit migration_script.sql:
    1. lansați comanda cat > migration_script.sql;
    2. copiați și inserați scriptul de mai jos în shell;
    3. apăsați Ctrl + D pentru a salva și a ieși.
    Script (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. Deschideți un shell nou și copiați scriptul bash de mai jos într-un fișier denumit migration.sh:
    1. lansați comanda cat > migration.sh;
    2. copiați și inserați scriptul de mai jos în shell;
    3. 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
    
    
  5. Deschideți un shell nou și lansați comanda bash migration.sh
Vechea schemă de export

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.

A fost util?

Cum putem să îmbunătățim această pagină?
Căutare
Șterge căutarea
Închide căutarea
Meniu principal
4583245550872937461
true
Căutaţi în Centrul de ajutor
true
true
true
true
true
69256
false
false