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.
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 |
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 ( |
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. |
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 |
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 |
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 |
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 |
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. |
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 |
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 |
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 |
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 | ||||
page_referrer | https://www.google.com | |||
<parameters...> | <hodnoty…> |
Tieto údaje udalostí sa v používateľskom rozhraní služby GA4 zobrazujú takto.
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.
- Prihláste sa na stránke Cloud Platform Console >: Manager resources (Konzola služby Cloud Platform > Zdroje správcu).
- Otvorte projekt, ktorého údaje chcete migrovať, a v hornej časti stránky kliknite na Activate Google Cloud Shell (Aktivovať Google Cloud Shell).
- Keď sa otvorí príslušné rozhranie, do súboru s názvom
migration_script.sql
skopírujte skript zobrazený nižšie:- Zadajte príkaz
cat > migration_script.sql
. - Skopírujte a prilepte do tohto prostredia skript zobrazený nižšie.
- Stlačením kombinácie klávesov Ctrl + D projekt uložte a ukončite.
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
- Zadajte príkaz
- Otvorte nové rozhranie a do súboru s názvom
migration.sh
skopírujte skript v jazyku Bash zobrazený nižšie:- Zadajte príkaz
cat > migration.sh
. - Skopírujte a prilepte do tohto prostredia skript zobrazený nižšie.
- 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
- Zadajte príkaz
- Otvorte nové prostredie a zadajte príkaz
bash migration.sh
.
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. |