[GA4] Schéma funkcie BigQuery Export

V tomto článku nájdete informácie o formáte a schéme údajov vlastníctva v službe Google Analytics 4 a údajov zo služby Google Analytics for Firebase, ktoré sa exportujú do nástroja BigQuery.

Množiny údajov

Pre každé vlastníctvo v službe Google Analytics 4 a každý projekt platformy Firebase, ktorý je prepojený s nástrojom BigQuery, sa do vášho projektu v nástroji BigQuery pridá jedna množina údajov s názvom analytics_<property_id>. Property ID predstavuje identifikátor vlastníctva v službe Analytics, ktorý nájdete v nastaveniach vlastníctva v službe Google Analytics 4 a v nastaveniach analytiky aplikácií v účte Firebase. Každé vlastníctvo v službe Google Analytics 4 a každá aplikácia, pre ktorú je povolený export do nástroja BigQuery, bude exportovať údaje do tejto jednej množiny údajov.

Tabuľky

Ak je povolená možnosť denného exportu, v rámci každej množiny údajov sa každý deň vytvorí tabuľka s názvom events_YYYYMMDD.

Ak je povolená možnosť exportu streamovaním údajov, vytvorí sa tabuľka events_intraday_YYYYMMDD. Táto tabuľka sa neustále vypĺňa, ako sa počas dňa udalosti zaznamenávajú. Táto tabuľka sa na konci každého dňa odstráni po dokončení tabuľky events_YYYYMMDD.

Nie všetky zariadenia, v ktorých sa spúšťajú udalosti, odosielajú údaje do služby Analytics v ten istý deň, ako sa udalosti spustia. Analytics bude zohľadňovať túto latenciu, takže bude aktualizovať denné tabuľky (events_YYYYMMDD) o udalosti pre tieto dátumy až tri dni od dátumov udalostí. Udalosti budú mať správnu časovú pečiatku bez ohľadu na to, či sa odošlú neskôr. Udalosti, ktoré sa odošlú po uplynutí tohto trojdňového obdobia, sa nezaznamenávajú.

Ak používate karanténu BigQuery, udalosti sa neimportujú v priebehu dňa a uplatňujú sa ďalšie obmedzenia.

Inovujte z karantény, ak chcete dostávať importy v priebehu dňa.

Stĺpce

Každý stĺpec v tabuľke events_YYYYMMDD predstavuje parameter konkrétnej udalosti. Upozorňujeme, že niektoré parametre sú vnorené do položiek typu RECORD a niektoré položky typu RECORD, napríklad items a event_params, sú opakovateľné. Stĺpce tabuľky sú opísané nižšie.

event
Polia event obsahujú informácie, ktoré jedinečným spôsobom identifikujú udalosť
Názov poľa Typ údajov Opis
batch_event_index INTEGER Číslo označujúce poradie jednotlivých udalostí v rámci skupiny na základe poradia ich výskytu v zariadení
batch_ordering_id INTEGER Monotónne rastúce číslo, ktoré sa zvyšuje pri každom odoslaní sieťovej požiadavky z určitej stránky
batch_page_id INTEGER Poradové číslo priradené k stránke, ktoré sa zvyšuje pri každej ďalšej stránke v rámci zapojenia
event_date STRING Dátum zaznamenania udalosti (vo formáte RRRRMMDD v registrovanom časovom pásme aplikácie)
event_timestamp INTEGER Čas zaznamenania udalosti v kliente (v mikrosekundách, UTC)
event_previous_timestamp INTEGER Čas predchádzajúceho zaznamenania udalosti v kliente (v mikrosekundách, UTC)
event_name STRING Názov udalosti
event_value_in_usd FLOAT Hodnota parametra „value“ danej udalosti skonvertovaná na menu (USD).
event_bundle_sequence_id INTEGER Sekvenčný identifikátor balíka, v rámci ktorého boli tieto udalosti nahrané
event_server_timestamp_offset INTEGER Rozdiel časových pečiatok medzi časom zhromaždenia a časom nahrania v mikrosekundách

event_params RECORD

V poli event_params RECORD sa môžu ukladať parametre udalostí na úrovni kampane a kontextové parametre udalostí, ako aj všetky parametre udalostí definované používateľom. Položka event_params RECORD sa opakuje v prípade každého kľúča spojeného s udalosťou.

Množina parametrov uložených v položke event_params RECORD je pre každú implementáciu jedinečná. Ak si chcete pozrieť úplný zoznam parametrov udalostí danej implementácie, zadajte dopyt na zoznam parametrov udalostí.

Názov poľa Typ údajov Opis
event_params.key STRING Názov parametra udalosti
event_params.value RECORD Záznam s hodnotou parametra udalosti
event_params.value.string_value STRING Ak je parameter udalosti vyjadrený ako reťazec, napríklad webová adresa alebo názov kampane, vyplní sa v tomto poli
event_params.value.int_value INTEGER Ak je parameter udalosti vyjadrený ako celé číslo, vyplní sa v tomto poli
event_params.value.double_value FLOAT Ak je parameter udalosti vyjadrený ako dvojitá hodnota, vyplní sa v tomto poli
event_params.value.float_value FLOAT Ak je parameter udalosti vyjadrený ako hodnota s pohyblivou rádovou čiarkou, vyplní sa v tomto poli. Toto pole sa momentálne nepoužíva.

item_params RECORD

V poli item_params RECORD sa môžu ukladať parametre položky, ako aj všetky parametre položky definované používateľom. Množina parametrov uložených v položke item_params RECORD je pre každú implementáciu jedinečná.

Názov poľa Typ údajov Opis
item_params.key STRING Názov parametra položky
item_params.value RECORD Záznam s hodnotou parametra položky
item_params.value.string_value STRING Ak je parameter položky vyjadrený ako reťazec, vyplní sa v tomto poli
item_params.value.int_value INTEGER Ak je parameter položky vyjadrený ako celé číslo, vyplní sa v tomto poli
item_params.value.double_value FLOAT Ak je parameter položky vyjadrený ako dvojitá hodnota, vyplní sa v tomto poli
item_params.value.float_value FLOAT Ak je parameter položky vyjadrený ako hodnota s pohyblivou rádovou čiarkou, vyplní sa v tomto poli
user
Polia user obsahujú informácie, ktoré jedinečným spôsobom identifikujú používateľa spojeného s danou udalosťou
Názov poľa Typ údajov Opis
is_active_user BOOLEAN

Či bol používateľ aktívny (pravda) alebo neaktívny (nepravda) v ktoromkoľvek okamihu kalendárneho dňa.

Zahrnuté iba v denných tabuľkách (events_YYYYMMDD).

user_id STRING Jedinečný identifikátor pridelený používateľovi.
user_pseudo_id STRING Pseudonymný identifikátor (napr. identifikátor inštancie aplikácie) používateľa
user_first_touch_timestamp INTEGER Čas prvého otvorenia aplikácie alebo prvej návštevy webu používateľom (v mikrosekundách)

privacy_info fields

Polia privacy_info obsahujú informácie založené na stave súhlasu používateľa pri aktivovanom režime súhlasu
Názov poľa Typ údajov Opis
privacy_info.ads_storage STRING

Určuje, či je pre používateľa povolené zacielenie reklamy.

Možné hodnoty: Yes (Áno), No (Nie), Unset (Nenastavené).

privacy_info.analytics_storage STRING

Určuje, či je pre používateľa povolený ukladací priestor služby Analytics.

Možné hodnoty: Yes (Áno), No (Nie), Unset (Nenastavené).

privacy_info.uses_transient_token STRING

Určuje, či používateľ webu zamietol ukladací priestor služby Analytics a vývojár povolil meranie bez súborov cookie na základe dočasných tokenov v údajoch servera.

Možné hodnoty: Yes (Áno), No (Nie), Unset (Nenastavené).

user_properties RECORD

Položka user_properties RECORD obsahuje všetky vlastnosti používateľa, ktoré ste nastavili. Opakuje sa pri každom kľúči spojenom s používateľom.
Názov poľa Typ údajov Opis
user_properties.key STRING Názov vlastnosti používateľa.
user_properties.value RECORD Záznam s hodnotou vlastnosti používateľa.
user_properties.value.string_value STRING Hodnota vo forme reťazca vyjadrujúca vlastnosť používateľa.
user_properties.value.int_value INTEGER Celočíselná hodnota vyjadrujúca vlastnosť používateľa.
user_properties.value.double_value FLOAT Hodnota vlastnosti používateľa vo forme desatinného čísla.
user_properties.value.float_value FLOAT Toto pole sa momentálne nepoužíva.
user_properties.value.set_timestamp_micros INTEGER Čas posledného nastavenia vlastnosti používateľa (v mikrosekundách)

user_ltv RECORD

Položka user_ltv RECORD obsahuje informácie o kumulovanej hodnote používateľa. Táto položka RECORD sa v tabuľkách s údajmi z rovnakého dňa nevypĺňa.
Názov poľa Typ údajov Opis
user_ltv.revenue FLOAT Kumulovaná hodnota (výnosy) používateľa. Toto pole sa v priebežne aktualizovaných tabuľkách s údajmi z daného dňa nevypĺňa.
user_ltv.currency STRING Kumulovaná hodnota (mena) používateľa. Toto pole sa v tabuľkách s údajmi z rovnakého dňa nevypĺňa.
device
Položka device RECORD obsahuje informácie o zariadení, z ktorého udalosť pochádza
Názov poľa Typ údajov Opis
device.category STRING Kategória zariadenia (mobil, tablet, počítač).
device.mobile_brand_name STRING Názov značky zariadenia.
device.mobile_model_name STRING Názov modelu zariadenia.
device.mobile_marketing_name STRING Marketingový názov zariadenia.
device.mobile_os_hardware_model STRING Informácie o modeli zariadenia získané priamo z operačného systému.
device.operating_system STRING Operačný systém zariadenia.
device.operating_system_version STRING Verzia operačného systému.
device.vendor_id STRING Identifikátor IDFV (uvádza sa, len ak sa nezíska identifikátor IDFA).
device.advertising_id STRING Reklamný identifikátor/IDFA.
device.language STRING Jazyk operačného systému.
device.time_zone_offset_seconds INTEGER Posun oproti GMT v sekundách.
device.is_limited_ad_tracking BOOLEAN

Nastavenie obmedzenia sledovania reklamy v zariadení.

V systéme iOS14+ vráti hodnotu false, ak IDFA nie je nula.

device.web_info.browser STRING Prehliadač, v ktorom si používateľ pozeral obsah
device.web_info.browser_version STRING Verzia prehliadača, v ktorom si používateľ pozeral obsah
device.web_info.hostname STRING Názov hostiteľa spojený so zaznamenanou udalosťou

geo

Položka geo RECORD obsahuje informácie o geografickej polohe, v ktorej sa udalosť spustila
Názov poľa Typ údajov Opis
geo.continent STRING Kontinent, z ktorého boli udalosti nahlásené, na základe adresy IP.
geo.sub_continent STRING Subkontinent, z ktorého boli udalosti nahlásené, na základe adresy IP.
geo.country STRING Krajina, z ktorej boli udalosti nahlásené, na základe adresy IP.
geo.region STRING Región, z ktorého boli udalosti nahlásené, na základe adresy IP.
geo.metro STRING Metropolitná oblasť, z ktorej boli udalosti nahlásené, na základe adresy IP.
geo.city STRING Mesto, z ktorého boli udalosti nahlásené, na základe adresy IP
app_info
Položka app_info RECORD obsahuje informácie o aplikácii, v ktorej sa udalosť spustila
Názov poľa Typ údajov Opis
app_info.id STRING Názov balíka alebo identifikátor balíka aplikácie
app_info.firebase_app_id STRING Identifikátor aplikácie na platforme Firebase pridružený k aplikácii.
app_info.install_source STRING Obchod, ktorý nainštaloval aplikáciu.
app_info.version STRING Parameter versionName (Android) alebo krátka verzia balíka aplikácie
collected_traffic_source

Položka collected_traffic_source RECORD obsahuje údaje o zdroji návštevnosti, ktoré boli zhromaždené s udalosťou.

Názov poľa Typ údajov Opis
manual_campaign_id STRING Manuálny identifikátor kampane (utm_id), ktorý bol zhromaždený s udalosťou.
manual_campaign_name STRING Manuálny názov kampane (utm_campaign), ktorý bol zhromaždený s udalosťou.
manual_source STRING Zdroj manuálnej kampane (utm_source), ktorý bol zhromaždený s udalosťou. Zahŕňa aj analyzované parametre z parametrov odkazujúcich zdrojov, nielen hodnoty UTM.
manual_medium STRING Médium manuálnej kampane (utm_medium), ktoré bolo zhromaždené s udalosťou. Zahŕňa aj analyzované parametre z parametrov odkazujúcich zdrojov, nielen hodnoty UTM.
manual_term STRING Manuálne kľúčové slovo alebo výraz kampane (utm_term), ktoré boli zhromaždené s udalosťou.
manual_content STRING Ďalšie metadáta manuálnej kampane (utm_content), ktoré boli zhromaždené s udalosťou
manual_creative_format STRING Formát kreatívy manuálnej kampane (utm_creative_format), ktorý bol zhromaždený s udalosťou
manual_marketing_tactic STRING Marketingová taktika manuálnej kampane (utm_marketing_tactic), ktorá bola zhromaždená s udalosťou
manual_source_platform STRING Platforma zdroja manuálnej kampane (utm_source_platform), ktorá bola zhromaždená s udalosťou
gclid STRING Identifikátor kliknutia Google, ktorý bol zhromaždený s udalosťou.
dclid STRING Identifikátor kliknutia v službe DoubleClick pre služby Display & Video 360 a Campaign Manager 360, ktorý bol zhromaždený s udalosťou
srsltid STRING Identifikátor služby Google Merchant Center, ktorý bol zhromaždený s udalosťou
session_traffic_source_last_click

Položka session_traffic_source_last_click RECORD obsahuje údaje o zdroji návštevnosti relácie, ktorej je pripísané posledné kliknutie, v službe Google Ads a manuálnych kontextoch (ak sú k dispozícii).

Názov poľa Typ údajov Opis
session_traffic_source_last_click. manual_campaign.campaign_id STRING Identifikátor manuálnej kampane, na ktorú sa naposledy kliklo
session_traffic_source_last_click. manual_campaign.campaign_name STRING Názov manuálnej kampane, na ktorú sa naposledy kliklo
session_traffic_source_last_click. manual_campaign.medium STRING Médium manuálnej kampane, na ktorú sa naposledy kliklo (napr. platené vyhľadávanie, organické vyhľadávanie, e‑mail)
session_traffic_source_last_click. manual_campaign.term STRING Kľúčové slovo alebo hľadaný výraz manuálnej kampane, na ktorú sa naposledy kliklo
session_traffic_source_last_click. manual_campaign.content STRING Ďalšie metadáta manuálnej kampane, na ktorú sa naposledy kliklo
session_traffic_source_last_click. manual_campaign.source_platform STRING Platforma manuálnej kampane, na ktorú sa naposledy kliklo (napr. vyhľadávač, sociálne médiá)
session_traffic_source_last_click. manual_campaign.source STRING Konkrétny zdroj v rámci platformy manuálnej kampane, na ktorú sa naposledy kliklo
session_traffic_source_last_click. manual_campaign.creative_format STRING Formát kreatívy manuálnej kampane, na ktorú sa naposledy kliklo
session_traffic_source_last_click. manual_campaign.marketing_tactic STRING Marketingová taktika manuálnej kampane, na ktorú sa naposledy kliklo
session_traffic_source_last_click. google_ads_campaign.customer_id STRING Číslo zákazníka spojené s účtom Google Ads
session_traffic_source_last_click. google_ads_campaign.account_name STRING Názov účtu Google Ads
session_traffic_source_last_click. google_ads_campaign.campaign_id STRING Identifikátor kampane Google Ads
session_traffic_source_last_click. google_ads_campaign.campaign_name STRING Názov kampane Google Ads
session_traffic_source_last_click. google_ads_campaign.ad_group_id STRING Identifikátor reklamnej skupiny v rámci kampane Google Ads
session_traffic_source_last_click. google_ads_campaign.ad_group_name STRING Názov reklamnej skupiny v kampani Google Ads
session_traffic_source_last_click.
cross_channel_campaign.campaign_name
STRING Názov kampane naprieč kanálmi, na ktorú sa naposledy kliklo
session_traffic_source_last_click.
cross_channel_campaign.campaign_id
STRING Identifikátor kampane naprieč kanálmi, na ktorú sa naposledy kliklo
session_traffic_source_last_click.
cross_channel_campaign.source_platform
STRING Platforma kampane naprieč kanálmi, na ktorú sa naposledy kliklo
session_traffic_source_last_click.
cross_channel_campaign.source
STRING Konkrétny zdroj v rámci platformy kampane naprieč kanálmi, na ktorú sa naposledy kliklo
session_traffic_source_last_click.
cross_channel_campaign.medium
STRING Médium kampane naprieč kanálmi, na ktorú sa naposledy kliklo
session_traffic_source_last_click.
sa360_campaign.campaign_name
STRING Názov kampane SA360, na ktorú sa naposledy kliklo
session_traffic_source_last_click.
sa360_campaign.source
STRING Konkrétny zdroj v rámci platformy kampane SA360, na ktorú sa naposledy kliklo
session_traffic_source_last_click.
sa360_campaign.medium
STRING Médium kampane SA360, na ktorú sa naposledy kliklo
session_traffic_source_last_click.
sa360_campaign.ad_group_id
STRING Identifikátor reklamnej skupiny v kampani SA360
session_traffic_source_last_click.
sa360_campaign.ad_group_name
STRING Názov reklamnej skupiny v kampani SA360
session_traffic_source_last_click.
sa360_campaign.campaign_id
STRING Identifikátor kampane SA360, na ktorú sa naposledy kliklo
session_traffic_source_last_click.
sa360_campaign.creative_format
STRING Formát kreatívy kampane SA360, na ktorú sa naposledy kliklo
session_traffic_source_last_click.
sa360_campaign.engine_account_name
STRING Názov účtu vyhľadávača SA360
session_traffic_source_last_click.
sa360_campaign.engine_account_type
STRING Typ účtu vyhľadávača obsahujúceho kampaň SA360
session_traffic_source_last_click.
sa360_campaign.manager_account_name
STRING Názov účtu správcu SA360
session_traffic_source_last_click.
dv360_campaign.advertiser_id
STRING Identifikátor inzerenta v službe DV360
session_traffic_source_last_click.
dv360_campaign.advertiser_name
STRING Meno alebo názov inzerenta v službe DV360
session_traffic_source_last_click.
dv360_campaign.campaign_id
STRING Identifikátor kampane DV360, na ktorú sa naposledy kliklo
session_traffic_source_last_click.
dv360_campaign.campaign_name
STRING Názov kampane DV360, na ktorú sa naposledy kliklo
session_traffic_source_last_click.
dv360_campaign.creative_id
STRING Identifikátor kreatívy kampane DV360, na ktorú sa naposledy kliklo
session_traffic_source_last_click.
dv360_campaign.creative_format
STRING Formát kreatívy kampane DV360, na ktorú sa naposledy kliklo
session_traffic_source_last_click.
dv360_campaign.creative_name
STRING Názov kreatívy kampane DV360, na ktorú sa naposledy kliklo
session_traffic_source_last_click.
dv360_campaign.marketing_tactic
STRING Marketingová taktika kampane DV360, na ktorú sa naposledy kliklo
session_traffic_source_last_click.
dv360_campaign.exchange_id
STRING Identifikátor burzy kampane DV360, na ktorú sa naposledy kliklo
session_traffic_source_last_click.
dv360_campaign.exchange_name
STRING Názov burzy kampane DV360, na ktorú sa naposledy kliklo
session_traffic_source_last_click.
dv360_campaign.insertion_order_id
STRING Identifikátor objednávky vloženia v kampani DV360, na ktorú sa naposledy kliklo
session_traffic_source_last_click.
dv360_campaign.insertion_order_name
STRING Názov objednávky vloženia v kampani DV360, na ktorú sa naposledy kliklo
session_traffic_source_last_click.
dv360_campaign.line_item_id
STRING Identifikátor riadkovej položky v kampani DV360, na ktorú sa naposledy kliklo
session_traffic_source_last_click.
dv360_campaign.line_item_name
STRING Názov riadkovej položky v kampani DV360, na ktorú sa naposledy kliklo
session_traffic_source_last_click.
dv360_campaign.partner_id
STRING Identifikátor partnera v službe DV360
session_traffic_source_last_click.
dv360_campaign.partner_name
STRING Meno alebo názov partnera v službe DV360
session_traffic_source_last_click.
dv360_campaign.source
STRING Konkrétny zdroj v rámci platformy kampane DV360, na ktorú sa naposledy kliklo
session_traffic_source_last_click.
dv360_campaign.medium
STRING Médium kampane DV360, na ktorú sa naposledy kliklo
session_traffic_source_last_click.
cm360_campaign.account_id
STRING Číslo účtu CM360
session_traffic_source_last_click.
cm360_campaign.account_name
STRING Názov účtu CM360
session_traffic_source_last_click.
cm360_campaign.advertiser_id
STRING Identifikátor inzerenta v službe CM360
session_traffic_source_last_click.
cm360_campaign.advertiser_name
STRING Meno alebo názov inzerenta v službe CM360
session_traffic_source_last_click.
cm360_campaign.campaign_id
STRING Identifikátor kampane CM360, na ktorú sa naposledy kliklo
session_traffic_source_last_click.
cm360_campaign.campaign_name
STRING Názov kampane CM360, na ktorú sa naposledy kliklo
session_traffic_source_last_click.
cm360_campaign.creative_id
STRING Identifikátor kreatívy kampane CM360, na ktorú sa naposledy kliklo
session_traffic_source_last_click.
cm360_campaign.creative_format
STRING Formát kreatívy kampane CM360, na ktorú sa naposledy kliklo
session_traffic_source_last_click.
cm360_campaign.creative_name
STRING Názov kreatívy kampane CM360, na ktorú sa naposledy kliklo
session_traffic_source_last_click.
cm360_campaign.creative_type
STRING Typ kreatívy kampane CM360, na ktorú sa naposledy kliklo
session_traffic_source_last_click.
cm360_campaign.creative_type_id
STRING Identifikátor typu kreatívy kampane CM360, na ktorú sa naposledy kliklo
session_traffic_source_last_click.
cm360_campaign.creative_version
STRING Verzia kreatívy kampane CM360, na ktorú sa naposledy kliklo
session_traffic_source_last_click.
cm360_campaign.placement_id
STRING Identifikátor umiestnenia kampane CM360, na ktorú sa naposledy kliklo
session_traffic_source_last_click.cm360
_campaign.placement_cost_structure
STRING Štruktúra ceny za umiestnenie kampane CM360, na ktorú sa naposledy kliklo
session_traffic_source_last_click.
cm360_campaign.placement_name
STRING Názov umiestnenia kampane CM360, na ktorú sa naposledy kliklo
session_traffic_source_last_click.
cm360_campaign.rendering_id
STRING Identifikátor vykresľovania kampane CM360, na ktorú sa naposledy kliklo
session_traffic_source_last_click.
cm360_campaign.site_id
STRING Identifikátor webu kampane CM360, na ktorú sa naposledy kliklo
session_traffic_source_last_click.
cm360_campaign.site_name
STRING Názov webu kampane CM360, na ktorú sa naposledy kliklo
session_traffic_source_last_click.
cm360_campaign.source
STRING Konkrétny zdroj kampane CM360, na ktorú sa naposledy kliklo
session_traffic_source_last_click.
cm360_campaign.medium
STRING Médium kampane CM360, na ktorú sa naposledy kliklo
traffic_source

Položka traffic_source RECORD obsahuje informácie o zdroji návštevnosti, ktorý pôvodne získal používateľa. Táto položka RECORD sa v tabuľkách s údajmi z rovnakého dňa nevypĺňa.

Poznámka: Hodnoty traffic_source sa nemenia, ak používateľ interaguje po inštalácii s následnými kampaňami.

Názov poľa Typ údajov Opis
traffic_source.name STRING Názov marketingovej kampane, prostredníctvom ktorej bol prvýkrát získaný používateľ. Toto pole sa v priebežne aktualizovaných tabuľkách s údajmi z daného dňa nevypĺňa.
traffic_source.medium STRING Názov média (platené vyhľadávanie, organické vyhľadávanie, e‑mail a pod.), prostredníctvom ktorého bol prvýkrát získaný používateľ. Toto pole sa v priebežne aktualizovaných tabuľkách s údajmi z daného dňa nevypĺňa.
traffic_source.source STRING Názov siete, prostredníctvom ktorej bol prvýkrát získaný používateľ. Toto pole sa v tabuľkách s údajmi z rovnakého dňa nevypĺňa.
stream a platform
Polia stream a platform obsahujú informácie o streame a platforme aplikácie
Názov poľa Typ údajov Opis
stream_id STRING Číselný identifikátor streamu údajov, z ktorého udalosť pochádza
platform STRING Platforma streamu údajov (internet, iOS alebo Android), z ktorej udalosť pochádza
ecommerce
Položka ecommerce RECORD obsahuje informácie o udalostiach elektronického obchodu, ktoré boli nastavené na webe alebo v aplikácii
Názov poľa Typ údajov Opis
ecommerce.total_item_quantity INTEGER Celkový počet položiek v tejto udalosti, teda súčet hodnôt items.quantity
ecommerce.purchase_revenue_in_usd FLOAT Výnosy z nákupov tejto udalosti vyjadrené v mene USD so štandardnou jednotkou. Vyplnené iba pre nákupnú udalosť.
ecommerce.purchase_revenue FLOAT Výnosy z nákupov tejto udalosti vyjadrené v miestnej mene so štandardnou jednotkou. Vyplnené iba pre nákupnú udalosť.
ecommerce.refund_value_in_usd FLOAT Suma vrátených peňazí v tejto udalosti vyjadrená v mene USD so štandardnou jednotkou. Vyplnené iba pre udalosť vrátenia peňazí.
ecommerce.refund_value FLOAT Suma vrátených peňazí v tejto udalosti vyjadrená v miestnej mene so štandardnou jednotkou. Vyplnené iba pre udalosť vrátenia peňazí.
ecommerce.shipping_value_in_usd FLOAT Cena dopravy v tejto udalosti vyjadrená v mene USD so štandardnou jednotkou
ecommerce.shipping_value FLOAT Cena dopravy v tejto udalosti vyjadrená v miestnej mene
ecommerce.tax_value_in_usd FLOAT Hodnota dane v tejto udalosti vyjadrená v mene USD so štandardnou jednotkou
ecommerce.tax_value FLOAT Hodnota dane v tejto udalosti vyjadrená v miestnej mene so štandardnou jednotkou
ecommerce.transaction_id STRING Identifikátor príslušnej transakcie elektronického obchodu
ecommerce.unique_items INTEGER Počet jedinečných položiek v tejto udalosti na základe parametrov item_id, item_name a item_brand
items
Položka items RECORD obsahuje informácie o položkách, ktoré sú súčasťou udalosti. Opakuje sa pri každej položke.
Názov poľa Typ údajov Opis
items.item_id STRING Identifikátor položky
items.item_name STRING Názov položky
items.item_brand STRING Značka položky
items.item_variant STRING Variant položky
items.item_category STRING Kategória položky
items.item_category2 STRING Podkategória položky
items.item_category3 STRING Podkategória položky
items.item_category4 STRING Podkategória položky
items.item_category5 STRING Podkategória položky
items.price_in_usd FLOAT Cena položky v mene USD so štandardnou jednotkou
items.price FLOAT Cena položky v miestnej mene
items.quantity INTEGER Ide o množstvo položky. Ak množstvo nie je uvedené, nastaví sa hodnota 1.
items.item_revenue_in_usd FLOAT Výnosy z tejto položky vypočítané ako price_in_usd * quantity (cena v USD * množstvo). Vyplní sa iba v prípade nákupných udalostí v mene USD so štandardnou jednotkou.
items.item_revenue FLOAT Výnosy z tejto položky vypočítané ako price * quantity (cena * množstvo). Vyplní sa iba v prípade nákupných udalostí v miestnej mene so štandardnou jednotkou.
items.item_refund_in_usd FLOAT Hodnota vrátených peňazí pre túto položku, ktorá sa vypočíta ako price_in_usd * quantity (cena_v_usd * množstvo). Vyplní sa iba v prípade udalostí vrátenia peňazí v mene USD so štandardnou jednotkou.
items.item_refund FLOAT Hodnota vrátených peňazí pre túto položku, ktorá sa vypočíta ako price * quantity (cena * množstvo). Vyplní sa iba v prípade udalostí vrátenia peňazí v miestnej mene so štandardnou jednotkou.
items.coupon STRING Kód kupóna použitý pre túto položku
items.affiliation STRING Príslušnosť výrobku na určenie oblasti dodávateľskej firmy alebo kamennej prevádzky
items.location_id STRING Oblasť priradená k položke
items.item_list_id STRING Identifikátor zoznamu, v ktorom bola položka predstavená používateľovi
items.item_list_name STRING Názov zoznamu, v ktorom bola položka predstavená používateľovi
Items.item_list_index STRING Pozícia položky v zozname
items.promotion_id STRING Identifikátor proma výrobku
items.promotion_name STRING Názov proma výrobku
items.creative_name STRING Názov kreatívy použitej v propagačnom spote
items.creative_slot STRING Názov priestoru kreatívy

item_params RECORD

Položka item_params RECORD ukladá vlastné parametre položky, ktoré ste definovali. Upozorňujeme, že preddefinované parametre položky, ako sú item_id, item_name atď., tu nie sú zahrnuté. Namiesto toho sa exportujú ako explicitné polia.

Množina parametrov uložených v položke item_params RECORD je pre každé zavedenie jedinečná. Viac o implementáciách elektronického obchodu a poli položiek v službe Google Analytics 4 sa dozviete v článku Meranie elektronického obchodu.

Názov poľa Typ údajov Opis
items.item_params.key STRING Názov parametra položky
items.item_params.value RECORD Záznam s hodnotou parametra položky
items.item_params.value.string_value STRING Ak je parameter položky vyjadrený ako reťazec, vyplní sa v tomto poli
items.item_params.value.int_value INTEGER Ak je parameter položky vyjadrený ako celé číslo, vyplní sa v tomto poli
items.item_params.value.double_value FLOAT Ak je parameter položky vyjadrený ako dvojitá hodnota, vyplní sa v tomto poli
items.item_params.value.float_value FLOAT Ak je parameter položky vyjadrený ako hodnota s pohyblivou rádovou čiarkou, vyplní sa v tomto poli
publisher (iba prednostný prístup)
Položka publisher RECORD obsahuje informácie o udalostiach pochádzajúcich z integrácie vlastníka súvisiacich so zobrazovaním reklám, teda zo služby AdMob.
Názov poľa Typ údajov Opis
publisher RECORD Záznam údajov vlastníka pochádzajúcich zo služby AdMob
publisher.ad_revenue_in_usd FLOAT Odhadované výnosy z reklám vyplývajúce z tejto udalosti vyjadrené v USD. Vypĺňa sa iba pre udalosti zobrazenia reklamy.
publisher.ad_format STRING Opisuje, ako sa reklamy zobrazovali a kde boli umiestnené. Obvyklé formáty sú intersticiálna, bannerová, s odmenou a rozšírená natívna.
publisher.ad_source_name STRING Zdrojová sieť, ktorá zobrazila reklamu. Obvyklé zdroje sú sieť AdMob, Meta Audience Network a sprostredkované vlastné reklamy.
publisher.ad_unit_id STRING Názov, ktorý ste vybrali ako opis tejto reklamnej jednotky. Reklamné jednotky sú kontajnery, ktoré vkladáte do svojich aplikácií, aby ste používateľom zobrazovali reklamy.

Riadky

Údaje jednej udalosti môžu byť vyjadrené v jednom alebo viacerých riadkoch podľa toho, či obsahujú opakované položky RECORD. Udalosť page_view s viacerými parametrami event_params by napríklad vyzerala podobne ako nasledujúca tabuľka. Prvý riadok obsahuje názov udalosti, dátum, časovú pečiatku a iné položky údajov, ktoré sa neopakujú. Položka event_params RECORD sa opakuje v prípade každého parametra spojeného s danou udalosťou. Tieto opakované položky RECORD sa vypĺňajú v nasledujúcich riadkoch priamo pod počiatočným riadkom udalosti.

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 Domov
      medium referral
      source google
      page_referrer https://www.google.com
      <parameters...> <hodnoty…>

Tieto údaje udalostí sa v používateľskom rozhraní služby GA4 zobrazujú takto.

Čo treba zvážiť pri inovácii súpravy SDK na verziu 17.2.5 (alebo novšiu) pre Android alebo 16.20.0 (alebo novšiu) pre iOS

Ak ste používali predchádzajúcu verziu niektorej zo súprav SDK a plánujete inováciu na verziu 17.2.5 (alebo novšiu) pre Android alebo 16.20.0 (alebo novšiu) pre iOS, mali by ste zvážiť nasledujúce fakty:

  • Ak chcete používať aktuálnu schému funkcie BigQuery Export, musíte inovovať súpravu SDK na verziu 17.2.5 (alebo novšiu) pre Android alebo 16.20.0 (alebo novšiu) pre iOS. Ak budete používať staršie verzie súpravy SDK, exportované údaje budú odrážať starú schému.
  • Po inovácii budete mať prístup iba k údajom o položkách v rámci poľa opakovaných položiek. Údaje o položkách už nebudú k dispozícii v štandardných parametroch udalostí, ako to bolo v predchádzajúcich verziách súprav SDK.
  • Táto zmena bola vykonaná v záujme podpory analýzy viacerých výrobkov.
  • V dôsledku toho možno bude potrebné upraviť odkazy na údaje o položkách alebo výrobkoch.
Pomocou tohto skriptu vykonajte migráciu existujúcich množín údajov v nástroji BigQuery zo starej schémy exportu do novej
  1. Prihláste sa na stránke Cloud Platform Console >: Manager resources (Konzola služby Cloud Platform > Zdroje správcu).
  2. Otvorte projekt, ktorého údaje chcete migrovať, a v hornej časti stránky kliknite na Activate Google Cloud Shell (Aktivovať Google Cloud Shell).
  3. Keď sa otvorí príslušné rozhranie, do súboru s názvom migration_script.sql skopírujte skript zobrazený nižšie:
    1. Zadajte príkaz cat > migration_script.sql.
    2. Skopírujte a prilepte do tohto prostredia skript zobrazený nižšie.
    3. Stlačením kombinácie klávesov Ctrl + D projekt uložte a ukončite.
    Skript (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. Otvorte nové rozhranie a do súboru s názvom migration.sh skopírujte skript v jazyku Bash zobrazený nižšie:
    1. Zadajte príkaz cat > migration.sh.
    2. Skopírujte a prilepte do tohto prostredia skript zobrazený nižšie.
    3. Stlačením kombinácie klávesov Ctrl + D projekt uložte a ukončite.
    Nasledujúci skript upravte tak, aby obsahoval váš identifikátor vlastníctva v službe Analytics, identifikátor projektu v nástroji BigQuery, identifikátor aplikácie na platforme Firebase, názov množiny údajov v nástroji BigQuery a dátumy spustenia a ukončenia požadovaných údajov.
    Skript (migration.sh):
    # Identifikátor vlastníctva v službe Analytics pre daný projekt. Nájdete ho v ponuke nastavení služby Analytics na platforme Firebase.
    PROPERTY_ID=identifikátor vášho vlastníctva v službe Analytics
    
    # Projekt vo funkcii BigQuery Export.
    BQ_PROJECT_ID="identifikátor vášho projektu BigQuery" (napr. "firebase-public-project")
    
    # Identifikátor aplikácie Firebase.
    FIREBASE_APP_ID="identifikátor vašej aplikácie Firebase" (napr. "1:300830567303:ios:09b1ab1d3ca29bda")
    
    # Množina údajov, z ktorej chcete importovať.
    BQ_DATASET="názov množiny údajov BigQuery, z ktorej chcete importovať" (napr. "com_firebase_demo_IOS")
    
    # Platforma
    PLATFORM="platforma aplikácie – ANDROID alebo IOS"
    
    # Obdobie, pre ktoré chcete spustiť migráciu [START_DATE,END_DATE] (vrátane týchto dátumov).
    START_DATE=20180324
    END_DATE=20180327
    
    # Neupravujte skript nižšie, ak neviete, čo robíte :)
    startdate=$(date -d"$START_DATE"  +%Y%m%d) || exit -1
    enddate=$(date -d"$END_DATE"  +%Y%m%d) || exit -1
    
    # Opakujte pre príslušné dátumy.
    DATE="$startdate"
    while [ "$DATE" -le "$enddate" ]; do
    
            # Tabuľka BQ vytvorená na základe parametrov vyššie.
            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
    
    # KONIEC SKRIPTU
    
    
  5. Otvorte nové prostredie a zadajte príkaz bash migration.sh.
Stará schéma exportu

user_dim

Názov poľa Typ údajov Opis
user_dim RECORD Záznam o dimenziách používateľa.
user_dim.user_id STRING Identifikátor User ID nastavený pomocou rozhrania setUserId API.
user_dim.first_open_timestamp_micros INTEGER Čas (v mikrosekundách), kedy používateľ prvýkrát otvoril aplikáciu.
user_dim.user_properties RECORD Opakovaný záznam vlastností používateľa nastavený pomocou rozhrania setUserProperty API.
user_dim.user_properties.key STRING Názov vlastnosti používateľa.
user_dim.user_properties.value RECORD Záznam s informáciami o vlastnosti používateľa.
user_dim.user_properties.value.value RECORD Záznam s hodnotou vlastnosti používateľa.
user_dim.user_properties.value.value.string_value STRING Hodnota vo forme reťazca vyjadrujúca vlastnosť používateľa.
user_dim.user_properties.value.value.int_value INTEGER Celočíselná hodnota vyjadrujúca vlastnosť používateľa.
user_dim.user_properties.value.value.double_value FLOAT Hodnota vlastnosti používateľa vo forme desatinného čísla.
user_dim.user_properties.value.set_timestamp_usec INTEGER Čas (v mikrosekundách), kedy bola vlastnosť používateľa naposledy nastavená.
user_dim.user_properties.value.index INTEGER Index (0 – 24) vlastnosti používateľa.
user_dim.device_info RECORD Záznam s informáciami o zariadení.
user_dim.device_info.device_category STRING Kategória zariadenia (mobil, tablet, počítač).
user_dim.device_info.mobile_brand_name STRING Názov značky zariadenia.
user_dim.device_info.mobile_model_name STRING Názov modelu zariadenia.
user_dim.device_info.mobile_marketing_name STRING Marketingový názov zariadenia.
user_dim.device_info.device_model STRING Model zariadenia.
user_dim.device_info.platform_version STRING Verzia operačného systému.
user_dim.device_info.device_id STRING Identifikátor IDFV (uvádza sa, len ak nie je k dispozícii identifikátor IDFA).
user_dim.device_info.resettable_device_id STRING Reklamný identifikátor/IDFA.
user_dim.device_info.user_default_language STRING Jazyk operačného systému.
user_dim.device_info.device_time_zone_offset_seconds INTEGER Posun oproti GMT v sekundách.
user_dim.device_info.limited_ad_tracking BOOLEAN Nastavenie obmedzenia sledovania reklamy v zariadení.
user_dim.geo_info RECORD Záznam s geografickými informáciami používateľa.
user_dim.geo_info.continent STRING Kontinent, z ktorého boli udalosti nahlásené, na základe adresy IP.
user_dim.geo_info.country STRING Krajina, z ktorej boli udalosti nahlásené, na základe adresy IP.
user_dim.geo_info.region STRING Región, z ktorého boli udalosti nahlásené, na základe adresy IP.
user_dim.geo_info.city STRING Mesto, z ktorého boli udalosti nahlásené, na základe adresy IP.
user_dim.app_info RECORD Záznam s informáciami o aplikácii.
user_dim.app_info.app_version STRING Parameter versionName (Android) alebo krátka verzia balíka aplikácie
user_dim.app_info.app_instance_id STRING Jedinečný identifikátor danej inštancie aplikácie.
user_dim.app_info.app_store STRING Obchod, z ktorého bola aplikácia nainštalovaná.
user_dim.app_info.app_platform STRING Platforma, v ktorej je aplikácia spustená.
user_dim.traffic_source RECORD Názov zdroja návštevnosti, z ktorého bol používateľ získaný. Toto pole sa v priebežne aktualizovaných tabuľkách s údajmi z daného dňa nevypĺňa.
user_dim.traffic_source.user_acquired_campaign STRING Názov marketingovej kampane, prostredníctvom ktorej bol používateľ získaný. Toto pole sa v priebežne aktualizovaných tabuľkách s údajmi z daného dňa nevypĺňa.
user_dim.traffic_source.user_acquired_medium STRING Názov spôsobu (platené vyhľadávanie, organické vyhľadávanie, e‑mail a pod.), akým bol používateľ získaný. Toto pole sa v priebežne aktualizovaných tabuľkách s údajmi z daného dňa nevypĺňa.
user_dim.traffic_source.user_acquired_source STRING Názov siete, prostredníctvom ktorej bol používateľ získaný. Toto pole sa v priebežne aktualizovaných tabuľkách s údajmi z daného dňa nevypĺňa.
user_dim.bundle_info RECORD Záznam s informáciami o balíku, v rámci ktorého boli tieto udalosti nahrané.
user_dim.bundle_info.bundle_sequence_id INTEGER Sekvenčný identifikátor balíka, v rámci ktorého boli tieto udalosti nahrané
user_dim.ltv_info RECORD Záznam s informáciami o kumulovanej hodnote týkajúcimi sa daného používateľa. Toto pole sa v priebežne aktualizovaných tabuľkách s údajmi z daného dňa nevypĺňa.
user_dim.ltv_info.revenue FLOAT Kumulovaná hodnota (výnosy) daného používateľa. Toto pole sa v priebežne aktualizovaných tabuľkách s údajmi z daného dňa nevypĺňa.
user_dim.ltv_info.currency STRING Kumulovaná hodnota (mena) daného používateľa. Toto pole sa v priebežne aktualizovaných tabuľkách s údajmi z daného dňa nevypĺňa.

event_dim

Názov poľa Typ údajov Opis
event_dim RECORD Opakovaný záznam s informáciami o udalostiach v danom balíku.
event_dim.date STRING Dátum zaznamenania danej udalosti (vo formáte RRRRMMDD v registrovanom časovom pásme vašej aplikácie).
event_dim.name STRING Názov danej udalosti.
event_dim.params RECORD Opakovaný záznam s parametrami súvisiacimi s danou udalosťou.
event_dim.params.key STRING Kľúč parametra danej udalosti.
event_dim.params.value RECORD Záznam s hodnotou parametra udalosti.
event_dim.params.value.string_value STRING Hodnota vo forme reťazca vyjadrujúca parameter udalosti.
event_dim.params.value.int_value INTEGER Celočíselná hodnota vyjadrujúca parameter udalosti.
event_dim.params.value.double_value FLOAT Hodnota parametra udalosti vo forme desatinného čísla.
event_dim.timestamp_micros INTEGER Čas (v mikrosekundách, UTC), kedy bola daná udalosť zaznamenaná na kliente.
event_dim.previous_timestamp_micros INTEGER Čas (v mikrosekundách, UTC), kedy bola daná udalosť v minulosti zaznamenaná na kliente.

Pomohlo vám to?

Ako ju môžeme zlepšiť?
Vyhľadávanie
Vymazať vyhľadávanie
Zavrieť vyhľadávanie
Hlavná ponuka
880603382713485921
true
Vyhľadávanie v Centre pomoci
true
true
true
true
true
69256
false
false