[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_RRRRMMDD.

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

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_RRRRMMDD) 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_RRRRMMDD 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ú vysvetlené nižšie.

Rozbaliť všetko Zbaliť všetko

event

Názov poľa	Typ údajov	Opis
Polia event obsahujú informácie, ktoré jedinečným spôsobom identifikujú udalosť
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

Názov poľa	Typ údajov	Opis
Položka event_params RECORD môže 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, vyžiadajte zoznam parametrov udalostí.
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

Názov poľa	Typ údajov	Opis
Položka item_params RECORD môže ukladať parametre položky, ako aj akékoľvek 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á.
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

Názov poľa	Typ údajov	Opis
Polia user obsahujú informácie, ktoré jedinečným spôsobom identifikujú používateľa spojeného s danou udalosťou
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

Názov poľa	Typ údajov	Opis
Polia privacy_info obsahujú informácie založené na stave súhlasu používateľa pri aktivovanom režime súhlasu
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

Názov poľa	Typ údajov	Opis
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.
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

Názov poľa	Typ údajov	Opis
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.
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

Názov poľa	Typ údajov	Opis
Položka device RECORD obsahuje informácie o zariadení, z ktorého udalosť pochádza.
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

Názov poľa	Typ údajov	Opis
Položka geo RECORD obsahuje informácie o geografickej polohe, v ktorej sa udalosť spustila
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

Názov poľa	Typ údajov	Opis
Položka app_info RECORD obsahuje informácie o aplikácii, v ktorej sa udalosť spustila
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

Názov poľa	Typ údajov	Opis
Položka collected_traffic_source RECORD obsahuje údaje o zdroji návštevnosti, ktoré boli zhromaždené s udalosťou.
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	Manuálny zdroj kampane (utm_source), ktorý bol zhromaždený s udalosťou. Zahŕňa aj analyzované parametre z parametrov sprostredkovania, nielen hodnoty UTM.
manual_medium	STRING	Manuálne médium kampane (utm_medium), ktoré bolo zhromaždené s udalosťou. Zahŕňa aj analyzované parametre z parametrov sprostredkovania, 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 manuálne metadáta kampane (utm_content), ktoré boli zhromaždené s udalosťou.
gclid	STRING	Identifikátor kliknutia Google, ktorý bol zhromaždený s udalosťou.
dclid	STRING	Identifikátor súpravy služieb Google Marketing Platform, ktorý bol zhromaždený s udalosťou.
srsltid	STRING	Identifikátor služby Google Merchant Center, ktorý bol zhromaždený s udalosťou.

traffic_source

Názov poľa	Typ údajov	Opis
Položka traffic_source RECORD obsahuje informácie o zdroji návštevnosti, ktorý pôvodne získal používateľa. Tento záznam 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.
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

Názov poľa	Typ údajov	Opis
Polia stream a platform obsahujú informácie o streame a platforme aplikácie
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

Názov poľa	Typ údajov	Opis
Položka ecommerce RECORD obsahuje informácie o udalostiach elektronického obchodu, ktoré boli nastavené na webe alebo v aplikácii
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

Názov poľa	Typ údajov	Opis
Položka items RECORD obsahuje informácie o položkách, ktoré sú súčasťou udalosti. Opakuje sa pri každej položke.
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

Názov poľa	Typ údajov	Opis
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ú implementáciu 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.
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

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

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é prostredie, 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.

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

Otvorte nové prostredie 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

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 posledného nastavenia vlastnosti používateľa (v mikrosekundách)
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 predchádzajúceho zaznamenania tejto udalosti v kliente (v mikrosekundách, UTC)

Pomohlo vám to?

Ako ju môžeme zlepšiť?

[GA4] Schéma funkcie BigQuery Export

Množiny údajov

Tabuľky

Stĺpce

event_params RECORD

item_params RECORD

privacy_info fields

user_properties RECORD

user_ltv RECORD

geo

item_params RECORD

Riadky

user_dim

event_dim

Pomohlo vám to?

Potrebujete ďalšiu pomoc?

Vyskúšajte tieto ďalšie kroky: