[GA4] Schéma funkce BigQuery Export

Tento článek vysvětluje formát a schéma údajů služeb v Google Analytics 4 a Google Analytics pro Firebase importovaných do nástroje BigQuery.

Datové sady

Pro každou službu v Google Analytics 4 a projekt Firebase propojené s nástrojem BigQuery je do vašeho projektu BigQuery přidána jedna datová sada s názvem analytics_<property_id> (analytics_<ID_služby>). ID služby odkazuje na ID vaší služby v Google Analytics 4, které najdete v jejím nastavení a v nastavení analytiky pro aplikace ve službě Firebase. Všechny služby v Google Analytics 4 a aplikace, u kterých je povolen export do nástroje BigQuery, budou svá data exportovat do této datové sady.

Tabulky

Pokud je povolena možnost Denní export, v každém souboru dat se každý den vytvoří tabulka s názvem events_YYYYMMDD.

Pokud je povolena možnost Export streamovaného obsahu, vytvoří se tabulka events_intraday_YYYYMMDD. Tato tabulka se vyplňuje průběžně, jak se události zaznamenávají v průběhu dne. Tato tabulka se na konci každého dne smaže po dokončení events_YYYYMMDD.

Pouze některá zařízení, na kterých se aktivují události, odesílají data do služby Analytics ještě v den aktivace události. Aby se zohlednila tato latence, aktualizuje služba Analytics v denních tabulkách (events_YYYYMMDD) události s těmito daty až tři dny po datu událostí. Události tak budou mít správné časové razítko, i když dorazí později. Události, které dorazí po tomto třídenním období, se nezaznamenávají.

Pokud používáte izolovaný prostor BigQuery, události se v průběhu dne neimportují a platí další limity.

Importy z průběhu dne budete mít k dispozici po upgradu z izolovaného prostoru.

Sloupce

Každý sloupec v tabulce events_YYYYMMDD představuje parametr specifický pro událost. Některé parametry jsou vnořené v položkách typu RECORD a některé položky typu RECORD, například items a event_params, se mohou opakovat. Sloupce tabulky jsou popsány níže.

Rozbalit vše Sbalit vše

event

Název pole	Typ dat	Popis
Pole události obsahují informace, které příslušnou událost jednoznačně identifikují.
batch_event_index	INTEGER	Číslo udávající pořadí jednotlivých událostí v rámci dávky na základě pořadí jejich výskytu v zařízení.
batch_ordering_id	INTEGER	Monotónně rostoucí číslo, které se zvyšuje při každém odeslání síťového požadavku z dané stránky.
batch_page_id	INTEGER	Pořadové číslo přiřazené stránce, které se zvyšuje s každou následující stránkou v rámci zapojení.
event_date	STRING	Datum, kdy byla událost zaznamenána (formát RRRRMMDD v časovém pásmu registrovaném pro příslušnou aplikaci).
event_timestamp	INTEGER	Čas (v mikrosekundách, UTC), kdy byla událost na klientském zařízení zaznamenána.
event_previous_timestamp	INTEGER	Čas (v mikrosekundách, UTC), kdy byla na klientském zařízení zaznamenána předchozí taková událost.
event_name	STRING	Název události.
event_value_in_usd	FLOAT	Hodnota parametru „hodnota“ události v převodní měně (USD).
event_bundle_sequence_id	INTEGER	Pořadové číslo balíčku, v jehož rámci byly tyto události nahrány.
event_server_timestamp_offset	INTEGER	Posun časového razítka mezi časem získání dat a časem nahrání v mikrosekundách.

event_params RECORD

Název pole	Typ dat	Popis
V poli event_params typu RECORD mohou být uloženy parametry na úrovni kampaně a kontextové parametry, ale také jakékoli parametry definované uživatelem. Pole event_params typu RECORD se opakuje pro každý klíč přiřazený k události. Sada parametrů uchovávaná v poli event_params typu RECORD je pro každou implementaci jedinečná. Pokud chcete zobrazit úplný seznam parametrů události pro vaši implementaci, zadejte dotaz na seznam parametrů události.
event_params.key	STRING	Název parametru události.
event_params.value	RECORD	Záznam obsahující hodnotu parametru události.
event_params.value.string_value	STRING	Pokud je parametr události reprezentován textovým řetězcem (například adresa URL nebo název kampaně), je tento řetězec uveden zde.
event_params.value.int_value	INTEGER	Pokud je parametr události reprezentován celým číslem, je toto číslo uvedeno zde.
event_params.value.double_value	FLOAT	Pokud je parametr události reprezentován desetinným číslem typu double, je toto číslo uvedeno zde.
event_params.value.float_value	FLOAT	Pokud je parametr události reprezentován hodnotou s pohyblivou řádovou čárkou, je tato hodnota uvedena zde. Toto pole v současné době není používáno.

item_params typu RECORD

Název pole	Typ dat	Popis
Pole item_params typu RECORD může ukládat parametry položky i všechny parametry položky definované uživatelem. Sada parametrů uchovávaná v poli item_params typu RECORD je pro každou implementaci jedinečná.
item_params.key	STRING	Název parametru položky.
item_params.value	RECORD	Záznam obsahující hodnotu parametru položky.
item_params.value.string_value	STRING	Pokud je parametr položky reprezentován textovým řetězcem, je toto číslo uvedeno zde.
item_params.value.int_value	INTEGER	Pokud je parametr položky reprezentován celým číslem, je toto číslo uvedeno zde.
item_params.value.double_value	FLOAT	Pokud je parametr položky reprezentován desetinným číslem typu double, je toto číslo uvedeno zde.
item_params.value.float_value	FLOAT	Pokud je parametr položky reprezentován hodnotou s pohyblivou řádovou čárkou, je tato hodnota uvedena zde.

user

Název pole	Typ dat	Popis
Tato pole obsahují informace, které jednoznačně identifikují uživatele spojeného s událostí.
is_active_user	BOOLEAN	Zda byl uživatel v jakémkoli okamžiku daného kalendářního dne aktivní (pravda), nebo neaktivní (nepravda). Zahrnuto pouze v denních tabulkách (`events_YYYYMMDD)`.
user_id	STRING	Jedinečný identifikátor přiřazený uživateli.
user_pseudo_id	STRING	Pseudonymní ID (např. ID instance aplikace) pro uživatele. Jedinečný identifikátor přiřazený uživateli při prvním otevření aplikace nebo při první návštěvě webu.
user_first_touch_timestamp	INTEGER	Čas (v mikrosekundách), kdy uživatel poprvé spustil tuto aplikaci nebo navštívil tento web.

privacy_info fields

Název pole	Typ dat	Popis
Pokud je zapnut režim souhlasu, obsahují pole privacy_info informace týkající se stavu souhlasu uživatele.
privacy_info.ads_storage	STRING	Udává, zda je u uživatele povoleno cílení reklam. Možné hodnoty: Ano, Ne, Nenastaveno
privacy_info.analytics_storage	STRING	Udává, zda je u uživatele povoleno úložiště Analytics. Možné hodnoty: Ano, Ne, Nenastaveno
privacy_info.uses_transient_token	STRING	Udává, zda uživatel webu zamítl úložiště Analytics a vývojář povolil měření bez souborů cookie na základě přechodných tokenů v datech serveru. Možné hodnoty: Ano, Ne, Nenastaveno

user_properties RECORD

Název pole	Typ dat	Popis
Pole user_properties typu RECORD obsahuje všechny charakteristiky uživatele, které jste nastavili. Opakuje se pro každý klíč, který je k uživateli přidružen.
user_properties.key	STRING	Název charakteristiky uživatele.
user_properties.value	RECORD	Hodnota record charakteristiky uživatele.
user_properties.value.string_value	STRING	Hodnota string charakteristiky uživatele.
user_properties.value.int_value	INTEGER	Hodnota integer charakteristiky uživatele
user_properties.value.double_value	FLOAT	Hodnota double charakteristiky uživatele.
user_properties.value.float_value	FLOAT	Toto pole momentálně není používáno.
user_properties.value.set_timestamp_micros	INTEGER	Čas (v mikrosekundách), kdy byla tato charakteristika uživatele naposled nastavena.

user_ltv RECORD

Název pole	Typ dat	Popis
Pole user_ltv typu RECORD obsahuje údaje o celkové hodnotě tohoto uživatele. V průběžných denních tabulkách se tento záznam nevyplňuje.
user_ltv.revenue	FLOAT	Celková hodnota (tržby) uživatele. Toto pole není uváděno v průběžných denních tabulkách.
user_ltv.currency	STRING	Celková hodnota (měna) uživatele. V průběžných denních tabulkách se toto pole nevyplňuje.

device

Název pole	Typ dat	Popis
Pole device typu RECORD obsahuje informace o zařízení, na němž událost vznikla.
device.category	STRING	Kategorie zařízení (mobil, tablet, počítač).
device.mobile_brand_name	STRING	Značka zařízení.
device.mobile_model_name	STRING	Název modelu zařízení.
device.mobile_marketing_name	STRING	Obchodní název zařízení.
device.mobile_os_hardware_model	STRING	Informace o modelu zařízení získané přímo z operačního systému.
device.operating_system	STRING	Operační systém zařízení.
device.operating_system_version	STRING	Verze operačního systému.
device.vendor_id	STRING	Identifikátor IDFV (uvádí se pouze v případě, pokud není k dispozici identifikátor IDFA).
device.advertising_id	STRING	Inzertní ID/IDFA.
device.language	STRING	Jazyk operačního systému.
device.time_zone_offset_seconds	INTEGER	Posun proti GMT v sekundách.
device.is_limited_ad_tracking	BOOLEAN	Nastavení funkce Omezení sledování reklam u zařízení. V systému iOS14+ vrátí hodnotu false, pokud identifikátor IDFA není nula.
device.web_info.browser	STRING	Prohlížeč, v němž si uživatel prohlížel obsah.
device.web_info.browser_version	STRING	Verze prohlížeče, v němž si uživatel prohlížel obsah.
device.web_info.hostname	STRING	Název hostitele přiřazený zaznamenané události.

geo

Název pole	Typ dat	Popis
Pole geo typu RECORD obsahuje informace o zeměpisné poloze, kde k události došlo.
geo.continent	STRING	Kontinent, ze kterého byly události hlášeny (podle IP adresy).
geo.sub_continent	STRING	Subkontinent, ze kterého byly události hlášeny, (podle IP adresy).
geo.country	STRING	Země, ze které byly události hlášeny (podle IP adresy).
geo.region	STRING	Region, ze kterého byly události hlášeny (podle IP adresy).
geo.metro	STRING	Metropolitní oblast, ze které byly události hlášeny (podle IP adresy).
geo.city	STRING	Město, ze kterého byly události hlášeny (podle IP adresy).

app_info

Název pole	Typ dat	Popis
Pole app_info typu RECORD obsahuje informace o aplikaci, v níž k události došlo.
app_info.id	STRING	Název nebo ID balíčku aplikace.
app_info.firebase_app_id	STRING	ID aplikace ve Firebase.
app_info.install_source	STRING	Obchod, který aplikaci nainstaloval.
app_info.version	STRING	Název verze aplikace (Android) nebo zkrácená verze balíčku.

collected_traffic_source

Název pole	Typ dat	Popis
Pole collected_traffic_source typu RECORD obsahuje údaje o zdrojích návštěvnosti, které byly shromážděny s první událostí na stránce.
manual_campaign_id	STRING	Manuálně zadané ID kampaně (utm_id) zaznamenané spolu s událostí.
manual_campaign_name	STRING	Manuálně zadaný název kampaně (utm_campaign) zaznamenaný spolu s událostí.
manual_source	STRING	Manuálně zadaný zdroj kampaně (utm_source) zaznamenaný spolu s událostí. Zahrnuje také analyzované parametry z parametrů odkazu, nikoli pouze hodnoty UTM.
manual_medium	STRING	Manuálně zadané médium kampaně (utm_medium) zaznamenané spolu s událostí. Zahrnuje také analyzované parametry z parametrů odkazu, nikoli pouze hodnoty UTM.
manual_term	STRING	Manuálně zadané klíčové slovo nebo dotaz kampaně (utm_term) zaznamenané spolu s událostí.
manual_content	STRING	Další manuální metadata kampaně (utm_content) zaznamenaná spolu s událostí.
manual_creative_format	STRING	Manuálně zadaný formát kreativy kampaně (utm_creative_format) zaznamenaný spolu s událostí.
manual_marketing_tactic	STRING	Manuálně zadaná marketingová taktika kampaně (utm_marketing_tactic) zaznamenaná spolu s událostí.
manual_source_platform	STRING	Manuálně zadaná zdrojová platforma kampaně (utm_source_platform) zaznamenaná spolu s událostí.
gclid	STRING	Identifikátor kliknutí Google zaznamenaný spolu s událostí.
dclid	STRING	Identifikátor kliknutí DoubleClick pro Display & Video 360 a Campaign Manager 360 zaznamenaný spolu s událostí.
srsltid	STRING	Identifikátor služby Google Merchant Center zaznamenaný spolu s událostí.

session_traffic_source_last_click

Název pole	Typ dat	Popis
Pole session_traffic_source_last_click typu RECORD obsahuje data o zdroji návštěvnosti relace přiřazené poslednímu kliknutí v reklamách Google a ručních kontextech (pokud jsou k dispozici).
session_traffic_source_last_click. manual_campaign.campaign_id	STRING	ID manuálně zadané kampaně s posledním kliknutím
session_traffic_source_last_click. manual_campaign.campaign_name	STRING	Název manuálně zadané kampaně s posledním kliknutím
session_traffic_source_last_click. manual_campaign.medium	STRING	Médium manuálně zadané kampaně s posledním kliknutím (např. placené vyhledávání, organické vyhledávání, e-mail)
session_traffic_source_last_click. manual_campaign.term	STRING	Klíčové slovo nebo vyhledávací dotaz manuálně zadané kampaně s posledním kliknutím
session_traffic_source_last_click. manual_campaign.content	STRING	Další metadata manuálně zadané kampaně s posledním kliknutím
session_traffic_source_last_click. manual_campaign.source_platform	STRING	Platforma manuálně zadané kampaně s posledním kliknutím (např. vyhledávač, sociální média)
session_traffic_source_last_click. manual_campaign.source	STRING	Konkrétní zdroj v rámci platformy manuálně zadané kampaně s posledním kliknutím
session_traffic_source_last_click. manual_campaign.creative_format	STRING	Formát kreativy manuálně zadané kampaně s posledním kliknutím
session_traffic_source_last_click. manual_campaign.marketing_tactic	STRING	Marketingová taktika manuálně zadané kampaně s posledním kliknutím
session_traffic_source_last_click. google_ads_campaign.customer_id	STRING	Číslo zákazníka asociované s účtem Google Ads
session_traffic_source_last_click. google_ads_campaign.account_name	STRING	Název účtu Google Ads
session_traffic_source_last_click. google_ads_campaign.campaign_id	STRING	ID kampaně Google Ads
session_traffic_source_last_click. google_ads_campaign.campaign_name	STRING	Název kampaně Google Ads
session_traffic_source_last_click. google_ads_campaign.ad_group_id	STRING	ID reklamní sestavy v kampani Google Ads
session_traffic_source_last_click. google_ads_campaign.ad_group_name	STRING	Název reklamní sestavy v kampani Google Ads.
session_traffic_source_last_click. cross_channel_campaign.campaign_name	STRING	Název multikanálové kampaně s posledním kliknutím
session_traffic_source_last_click. cross_channel_campaign.campaign_id	STRING	ID multikanálové kampaně s posledním kliknutím
session_traffic_source_last_click. cross_channel_campaign.source_platform	STRING	Platforma multikanálové kampaně s posledním kliknutím
session_traffic_source_last_click. cross_channel_campaign.source	STRING	Konkrétní zdroj v rámci platformy multikanálové kampaně s posledním kliknutím
session_traffic_source_last_click. cross_channel_campaign.medium	STRING	Médium multikanálové kampaně s posledním kliknutím
session_traffic_source_last_click. sa360_campaign.campaign_name	STRING	Název kampaně ve službě SA360 s posledním kliknutím
session_traffic_source_last_click. sa360_campaign.source	STRING	Konkrétní zdroj v rámci platformy kampaně ve službě SA360 s posledním kliknutím
session_traffic_source_last_click. sa360_campaign.medium	STRING	Médium kampaně ve službě SA360 s posledním kliknutím
session_traffic_source_last_click. sa360_campaign.ad_group_id	STRING	ID reklamní sestavy v kampani ve službě SA360
session_traffic_source_last_click. sa360_campaign.ad_group_name	STRING	Název reklamní sestavy v kampani ve službě SA360
session_traffic_source_last_click. sa360_campaign.campaign_id	STRING	ID kampaně ve službě SA360 s posledním kliknutím
session_traffic_source_last_click. sa360_campaign.creative_format	STRING	Formát kreativy kampaně ve službě SA360 s posledním kliknutím
session_traffic_source_last_click. sa360_campaign.engine_account_name	STRING	Název účtu vyhledávače ve službě SA360
session_traffic_source_last_click. sa360_campaign.engine_account_type	STRING	Typ účtu vyhledávače obsahujícího kampaň ve službě SA360
session_traffic_source_last_click. sa360_campaign.manager_account_name	STRING	Název účtu správce ve službě SA360
session_traffic_source_last_click. dv360_campaign.advertiser_id	STRING	ID inzerenta ve službě DV360
session_traffic_source_last_click. dv360_campaign.advertiser_name	STRING	Název inzerenta ve službě DV360
session_traffic_source_last_click. dv360_campaign.campaign_id	STRING	ID kampaně ve službě DV360 s posledním kliknutím
session_traffic_source_last_click. dv360_campaign.campaign_name	STRING	Název kampaně ve službě DV360 s posledním kliknutím
session_traffic_source_last_click. dv360_campaign.creative_id	STRING	ID kreativy kampaně ve službě DV360 s posledním kliknutím
session_traffic_source_last_click. dv360_campaign.creative_format	STRING	Formát kreativy kampaně ve službě DV360s posledním kliknutím
session_traffic_source_last_click. dv360_campaign.creative_name	STRING	Název kreativy kampaně ve službě DV360 s posledním kliknutím
session_traffic_source_last_click. dv360_campaign.marketing_tactic	STRING	Marketingová taktika kampaně ve službě DV360 s posledním kliknutím
session_traffic_source_last_click. dv360_campaign.exchange_id	STRING	ID burzy kampaně ve službě DV360 s posledním kliknutím
session_traffic_source_last_click. dv360_campaign.exchange_name	STRING	Název burzy kampaně ve službě DV360 s posledním kliknutím
session_traffic_source_last_click. dv360_campaign.insertion_order_id	STRING	ID objednávky v kampani ve službě DV360 s posledním kliknutím
session_traffic_source_last_click. dv360_campaign.insertion_order_name	STRING	Název objednávky v kampani ve službě DV360 s posledním kliknutím
session_traffic_source_last_click. dv360_campaign.line_item_id	STRING	ID řádkové položky v kampani ve službě DV360 s posledním kliknutím
session_traffic_source_last_click. dv360_campaign.line_item_name	STRING	Název řádkové položky v kampani ve službě DV360 s posledním kliknutím
session_traffic_source_last_click. dv360_campaign.partner_id	STRING	ID partnera ve službě DV360
session_traffic_source_last_click. dv360_campaign.partner_name	STRING	Název partnera DV360
session_traffic_source_last_click. dv360_campaign.source	STRING	Konkrétní zdroj v rámci platformy kampaně ve službě DV360 s posledním kliknutím
session_traffic_source_last_click. dv360_campaign.medium	STRING	Médium kampaně ve službě DV360 s posledním kliknutím
session_traffic_source_last_click. cm360_campaign.account_id	STRING	ID účtu ve službě CM360
session_traffic_source_last_click. cm360_campaign.account_name	STRING	Název účtu ve službě CM360
session_traffic_source_last_click. cm360_campaign.advertiser_id	STRING	ID inzerenta ve službě CM360
session_traffic_source_last_click. cm360_campaign.advertiser_name	STRING	Název inzerenta ve službě CM360
session_traffic_source_last_click. cm360_campaign.campaign_id	STRING	ID kampaně ve službě CM360 s posledním kliknutím
session_traffic_source_last_click. cm360_campaign.campaign_name	STRING	Název kampaně ve službě CM360 s posledním kliknutím
session_traffic_source_last_click. cm360_campaign.creative_id	STRING	ID kreativy kampaně ve službě CM360s posledním kliknutím
session_traffic_source_last_click. cm360_campaign.creative_format	STRING	Formát kreativy kampaně ve službě CM360s posledním kliknutím
session_traffic_source_last_click. cm360_campaign.creative_name	STRING	Název kreativy kampaně ve službě CM360 s posledním kliknutím
session_traffic_source_last_click. cm360_campaign.creative_type	STRING	Typ kreativy kampaně ve službě CM360 s posledním kliknutím
session_traffic_source_last_click. cm360_campaign.creative_type_id	STRING	ID typu kreativy kampaně ve službě CM360 s posledním kliknutím
session_traffic_source_last_click. cm360_campaign.creative_version	STRING	Verze kreativy kampaně ve službě CM360 s posledním kliknutím
session_traffic_source_last_click. cm360_campaign.placement_id	STRING	ID umístění kampaně ve službě CM360 s posledním kliknutím
session_traffic_source_last_click.cm360 _campaign.placement_cost_structure	STRING	Struktura nákladů na umístění kampaně ve službě CM360 s posledním kliknutím
session_traffic_source_last_click. cm360_campaign.placement_name	STRING	Název umístění kampaně ve službě CM360 s posledním kliknutím
session_traffic_source_last_click. cm360_campaign.rendering_id	STRING	ID vykreslení kampaně ve službě CM360 s posledním kliknutím
session_traffic_source_last_click. cm360_campaign.site_id	STRING	ID webu kampaně ve službě CM360 s posledním kliknutím
session_traffic_source_last_click. cm360_campaign.site_name	STRING	Název webu kampaně ve službě CM360 s posledním kliknutím
session_traffic_source_last_click. cm360_campaign.source	STRING	Konkrétní zdroj kampaně ve službě CM360 s posledním kliknutím
session_traffic_source_last_click. cm360_campaign.medium	STRING	Médium kampaně ve službě CM360 s posledním kliknutím

traffic_source

Název pole	Typ dat	Popis
Pole traffic_source typu RECORD obsahuje informace o zdroji návštěvnosti, z nějž uživatel poprvé přišel. V průběžných denních tabulkách se tento záznam nevyplňuje. Poznámka: Pokud uživatel po instalaci provede interakci s následnými kampaněmi, hodnoty traffic_source se nemění.
traffic_source.name	STRING	Název marketingové kampaně, která jako první uživatele přivedla. Toto pole není uváděno v průběžných denních tabulkách.
traffic_source.medium	STRING	Název média (placené vyhledávání, organické vyhledávání, e‑mail a podobně), které jako první uživatele přivedlo. Toto pole není uváděno v průběžných denních tabulkách.
traffic_source.source	STRING	Název sítě, která uživatele jako první přivedla. V průběžných denních tabulkách se toto pole nevyplňuje.

stream and platform

Název pole	Typ dat	Popis
Pole stream a platforma obsahují informace o streamu a platformě aplikace.
stream_id	STRING	Číselné ID datového streamu, ze kterého událost pochází.
platforma	STRING	Platforma datového streamu (web, iOS nebo Android), ze které událost pochází.

ecommerce

Název pole	Typ dat	Popis
Pole ecommerce typu RECORD obsahuje informace o všech událostech elektronického obchodu, které byly na webu nebo v aplikaci definovány.
ecommerce.total_item_quantity	INTEGER	Celkový počet položek v této události, tedy součet položek.
ecommerce.purchase_revenue_in_usd	FLOAT	Tržba vztahující se k této události vyjádřená v USD se standardní jednotkou. Vyplní se pouze u nákupní události.
ecommerce.purchase_revenue	FLOAT	Tržba vztahující se k této události vyjádřená v místní měně se standardní jednotkou. Vyplní se pouze u nákupní události.
ecommerce.refund_value_in_usd	FLOAT	Vrácená částka vztahující se k této události vyjádřená v USD se standardní jednotkou. Vyplní se pouze u události vrácení platby.
ecommerce.refund_value	FLOAT	Vrácená částka vztahující se k této události vyjádřená v místní měně se standardní jednotkou. Vyplní se pouze u události vrácení platby.
ecommerce.shipping_value_in_usd	FLOAT	Náklady na dopravu vztahující se k této události vyjádřené v USD se standardní jednotkou.
ecommerce.shipping_value	FLOAT	Náklady na dopravu vztahující se k této události vyjádřené v místní měně.
ecommerce.tax_value_in_usd	FLOAT	Hodnota daně vztahující se k této události vyjádřená v USD se standardní jednotkou.
ecommerce.tax_value	FLOAT	Hodnota daně vztahující se k této události vyjádřená v místní měně se standardní jednotkou.
ecommerce.transaction_id	STRING	ID transakce elektronického obchodu.
ecommerce.unique_items	INTEGER	Počet jedinečných položek v této události na základě parametrů item_id, item_name a item_brand.

items

Název pole	Typ dat	Popis
Pole items typu RECORD obsahují informace o položkách obsažených v události. Opakuje se pro každou položku.
items.item_id	STRING	ID položky.
items.item_name	STRING	Název položky.
items.item_brand	STRING	Značka zboží.
items.item_variant	STRING	Varianta položky.
items.item_category	STRING	Kategorie položky.
items.item_category2	STRING	Podkategorie položky.
items.item_category3	STRING	Podkategorie položky.
items.item_category4	STRING	Podkategorie položky.
items.item_category5	STRING	Podkategorie položky.
items.price_in_usd	FLOAT	Cena položky v USD se standardní jednotkou.
items.price	FLOAT	Cena položky v místní měně.
items.quantity	INTEGER	Množství dané položky. Pokud není zadáno, použije se výchozí hodnota 1.
items.item_revenue_in_usd	FLOAT	Tržby za tuto položku vypočtené jako cena v USD násobená množstvím. Vyplní se pouze u nákupních událostí hodnotou v USD se standardní jednotkou.
items.item_revenue	FLOAT	Tržby za tuto položku vypočtené jako cena násobená množstvím. Vyplní se pouze u nákupních události hodnotou v místní měně se standardní jednotkou.
items.item_refund_in_usd	FLOAT	Vrácená částka za tuto položku vypočtená jako cena v USD násobená množstvím. Vyplní se pouze u událostí vrácení platby hodnotou v USD se standardní jednotkou.
items.item_refund	FLOAT	Vrácená částka za tuto položku vypočtená jako cena násobená množstvím. Vyplní se pouze u událostí vrácení platby hodnotou v místní měně se standardní jednotkou.
items.coupon	STRING	Kód kupónu uplatněný na tuto položku.
items.affiliation	STRING	Partner pro produkt označující dodavatelskou společnost nebo umístění kamenného obchodu.
items.location_id	STRING	Lokalita položky.
items.item_list_id	STRING	ID seznamu, ve kterém byla položka zobrazena uživateli.
items.item_list_name	STRING	Název seznamu, ve kterém byla položka zobrazena uživateli.
Items.item_list_index	STRING	Pozice položky v seznamu.
items.promotion_id	STRING	ID akce na produkt.
items.promotion_name	STRING	Název akce na produkt.
items.creative_name	STRING	Název kreativy použité v propagačním reklamě.
items.creative_slot	STRING	Název bloku kreativy.

item_params RECORD

Název pole	Typ dat	Popis
Pole item_params typu RECORD ukládá vámi definované vlastní parametry položky. Předdefinované parametry položek, například item_id, item_name atd., zde nejsou zahrnuty, ale exportují se jako explicitní pole. Sada parametrů uchovávaná v poli item_params typu RECORD je pro každou implementaci jedinečná. Další informace o implementacích elektronického obchodu a matici položek Google Analytics 4 najdete v článku Měření elektronického obchodu.
items.item_params.key	STRING	Název parametru položky.
items.item_params.value	RECORD	Záznam obsahující hodnotu parametru položky.
items.item_params.value.string_value	STRING	Pokud je parametr položky reprezentován textovým řetězcem, je toto číslo uvedeno zde.
items.item_params.value.int_value	INTEGER	Pokud je parametr položky reprezentován celým číslem, je toto číslo uvedeno zde.
items.item_params.value.double_value	FLOAT	Pokud je parametr položky reprezentován desetinným číslem typu double, je toto číslo uvedeno zde.
items.item_params.value.float_value	FLOAT	Pokud je parametr položky reprezentován hodnotou s pohyblivou řádovou čárkou, je tato hodnota uvedena zde.

publisher (pouze předběžný přístup)

Název pole	Typ dat	Popis
Pole publisher typu RECORD obsahuje informace o událostech pocházejících z integrace majitele obsahu související se zobrazováním reklam, tedy ze služby AdMob.
vydavatel	RECORD	Záznam dat o majiteli obsahu pocházejících ze služby AdMob.
publisher.ad_revenue_in_usd	FLOAT	Odhadované tržby z reklamy vyplývající z této události vyjádřené v USD. Vyplní se pouze u událostí typu zobrazení reklamy.
publisher.ad_format	STRING	Popisuje, jak se reklamy zobrazovaly a kde byly umístěny. Mezi typické formáty patří vsunutá reklama, banner, reklama s nabídkou odměny a pokročilá nativní reklama.
publisher.ad_source_name	STRING	Zdrojová síť, která zobrazila reklamu. Mezi typické zdroje patří síť AdMob, Meta Audience Network a zprostředkované vlastní reklamy.
publisher.ad_unit_id	STRING	Název, který jste vybrali pro tuto reklamní jednotku. Reklamní jednotky jsou kontejnery, které umístíte do aplikací, abyste mohli uživatelům zobrazovat reklamy.

Řádky

Data pro jednu událost mohou být uvedena v jednom nebo více řádcích podle toho, zda obsahují opakovaná pole typu RECORD. Například událost page_view s několika parametry event_params by mohla vypadat jako v níže uvedené tabulce. První řádek obsahuje název události, datum, časové razítko a další položky, které se neopakují. Pole event_params typu RECORD se opakuje pro každý parametr spojený s danou událostí. Tyto opakované záznamy jsou uvedeny řádcích následujících přímo pod prvním řádkem události.

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	Domovská stránka
			médium	odkazující zdroj
			zdroj	google
			page_referrer	https://www.google.com
			<parameters...>	<values...>

Níže uvedený snímek obrazovky ukazuje, jak se tato data události zobrazují v uživatelském rozhraní GA4.

Poznámky k upgradu sad SDK na Android 17.2.5 (nebo novější) a iOS: 16.20.0 (nebo novější)

Pokud jste používali předchozí verze některé z těchto sad SDK a plánujete jejich upgrade na Android 17.2.5 (nebo novější) nebo iOS 16.20.0 (nebo novější), měli byste uvážit následující aspekty:

Pokud chcete používat aktuální schéma BigQuery Export, musíte sadu SDK upgradovat na verzi pro Android 17.2.5 (nebo novější) nebo pro iOS 16.20.0 (nebo novější). Když budete používat starší verze sady SDK, exportovaná data budou odrážet staré schéma.
Po upgradu budete moci přistupovat jen k položkám dat v opakovaných polích položek. Data položek už nebudou dostupná ve standardních parametrech událostí, jak to bylo před těmito verzemi SDK.
K této změně došlo z důvodu podpory analýzy více produktů.
Možná kvůli tomu budete muset upravit své odkazy na data o položkách či produktech.

Pomocí tohoto skriptu můžete migrovat stávající datové sady BigQuery ze starého exportního schématu do nového.

Přihlaste se na stránce Cloud Platform Console > Zdroje správce.
Otevřete projekt, jehož data chcete migrovat, a v horní části stránky klikněte na Aktivovat Google Cloud Shell.

Po otevření shellu zkopírujte níže uvedený skript do souboru s názvem migration_script.sql:

Zadejte příkaz cat > migration_script.sql
Zkopírujte a vložte níže uvedený skript do shellu.
Stisknutím kombinace kláves Ctrl+D uložte data a ukončete shell.

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

Otevřete nový shell a zkopírujte níže uvedený bash skript do souboru s názvem migration.sh:

Zadejte příkaz cat > migration.sh
Zkopírujte a vložte níže uvedený skript do shellu.
Stisknutím kombinace kláves Ctrl+D uložte data a ukončete shell.

Upravte následující skript tak, aby zahrnoval ID vaší služby Analytics, ID projektu BigQuery, ID aplikace Firebase, název datové sady BigQuery a počáteční a koncové datum požadovaných údajů.

Skript (migration.sh):

# ID služby Analytics pro projekt. Údaj najdete ve službě Firebase v části Nastavení Analytics.
PROPERTY_ID=ID služby Analytics

# Projekt exportu BigQuery.
BQ_PROJECT_ID="vaše ID projektu BigQuery" (např. "veřejný projekt firebase")

# ID aplikace ve službě Firebase.
FIREBASE_APP_ID="ID aplikace ve službě Firebase" (např. "1:300830567303:ios:09b1ab1d3ca29bda")

# Zdrojová datová sada pro import.
BQ_DATASET="název datové sady BigQuery, ze které chcete importovat" (např. "com_firebase_demo_IOS")

# Platforma
PLATFORM="platforma aplikace. ANDROID nebo IOS"

# Období, která chcete migrovat, včetně hraničních dat [START_DATE,END_DATE].
START_DATE=20180324
END_DATE=20180327

# Následující skript neupravujte, pokud si akcí nejste jisti :)
startdate=$(date -d"$START_DATE"  +%Y%m%d) || exit -1
enddate=$(date -d"$END_DATE"  +%Y%m%d) || exit -1

# Iterace po datech.
DATE="$startdate"
while [ "$DATE" -le "$enddate" ]; do

        # Sestavení tabulky BQ podle předchozích parametrů.
        BQ_TABLE="$BQ_PROJECT_ID.$BQ_DATASET.app_events_$DATE"

        echo "Migrace tabulky $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

# END OF SCRIPT

Otevřete nový shell a zadejte příkaz bash migration.sh

Staré exportní schéma

user_dim

Název pole	Typ dat	Popis
user_dim	RECORD	Záznam uživatelských dimenzí.
user_dim.user_id	STRING	ID uživatele nastavené prostřednictvím rozhraní setUserId API.
user_dim.first_open_timestamp_micros	INTEGER	Čas (v mikrosekundách), kdy uživatel aplikaci poprvé otevřel.
user_dim.user_properties	RECORD	Opakovaný záznam uživatelských vlastností nastavených v rozhraní setUserProperty API.
user_dim.user_properties.key	STRING	Název uživatelské vlastnosti.
user_dim.user_properties.value	RECORD	Záznam pro údaje o uživatelské vlastnosti.
user_dim.user_properties.value.value	RECORD	Hodnota record charakteristiky uživatele.
user_dim.user_properties.value.value.string_value	STRING	Hodnota string charakteristiky uživatele.
user_dim.user_properties.value.value.int_value	INTEGER	Hodnota integer charakteristiky uživatele
user_dim.user_properties.value.value.double_value	FLOAT	Hodnota double charakteristiky uživatele.
user_dim.user_properties.value.set_timestamp_usec	INTEGER	Čas (v mikrosekundách), kdy byla tato charakteristika uživatele naposled nastavena.
user_dim.user_properties.value.index	INTEGER	Index (0–24) uživatelské vlastnosti.
user_dim.device_info	RECORD	Záznam informací o zařízení.
user_dim.device_info.device_category	STRING	Kategorie zařízení (mobil, tablet, počítač).
user_dim.device_info.mobile_brand_name	STRING	Značka zařízení.
user_dim.device_info.mobile_model_name	STRING	Název modelu zařízení.
user_dim.device_info.mobile_marketing_name	STRING	Obchodní název zařízení.
user_dim.device_info.device_model	STRING	Model zařízení.
user_dim.device_info.platform_version	STRING	Verze operačního systému.
user_dim.device_info.device_id	STRING	Identifikátor IDFV (uvádí se pouze v případě, pokud není k dispozici identifikátor IDFA).
user_dim.device_info.resettable_device_id	STRING	Inzertní ID/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 proti GMT v sekundách.
user_dim.device_info.limited_ad_tracking	BOOLEAN	Nastavení funkce Omezení sledování reklam u zařízení.
user_dim.geo_info	RECORD	Záznam geografické polohy uživatele.
user_dim.geo_info.continent	STRING	Kontinent, ze kterého byly události hlášeny, podle IP adresy.
user_dim.geo_info.country	STRING	Země, ze které byly události hlášeny, podle IP adresy.
user_dim.geo_info.region	STRING	Region, ze kterého byly události hlášeny, podle IP adresy.
user_dim.geo_info.city	STRING	Město, ze kterého byly události hlášeny (podle IP adresy).
user_dim.app_info	RECORD	Záznam informací o aplikaci.
user_dim.app_info.app_version	STRING	Název verze aplikace (Android) nebo zkrácená verze balíčku.
user_dim.app_info.app_instance_id	STRING	Jedinečný identifikátor dané instance aplikace.
user_dim.app_info.app_store	STRING	Obchod, který aplikaci nainstaloval.
user_dim.app_info.app_platform	STRING	Platforma, na které aplikace funguje.
user_dim.traffic_source	RECORD	Název zdroje návštěvnosti, který uživatele přivedl. Toto pole není uváděno v průběžných denních tabulkách.
user_dim.traffic_source.user_acquired_campaign	STRING	Název marketingové kampaně, která uživatele přivedla. Toto pole není uváděno v průběžných denních tabulkách.
user_dim.traffic_source.user_acquired_medium	STRING	Název média (placené vyhledávání, organické vyhledávání, e-mail a podobně), které uživatele přivedlo. V průběžných denních tabulkách se toto pole nevyplňuje.
user_dim.traffic_source.user_acquired_source	STRING	Název sítě, která uživatele přivedla. Toto pole není uváděno v průběžných denních tabulkách.
user_dim.bundle_info	RECORD	Zápis informací o balíčku, v jehož rámci byly tyto události nahrány.
user_dim.bundle_info.bundle_sequence_id	INTEGER	Pořadové číslo balíčku, v jehož rámci byly tyto události nahrány.
user_dim.ltv_info	RECORD	Záznam údajů o celkové hodnotě tohoto uživatele. Toto pole není uváděno v průběžných denních tabulkách.
user_dim.ltv_info.revenue	FLOAT	Celková hodnota (výnos) tohoto uživatele. Toto pole není uváděno v průběžných denních tabulkách.
user_dim.ltv_info.currency	STRING	Celková hodnota (měna) tohoto uživatele. Toto pole není uváděno v průběžných denních tabulkách.

event_dim

Název pole	Typ dat	Popis
event_dim	RECORD	Opakovaný záznam údajů týkajících se událostí v tomto balíčku.
event_dim.date	STRING	Datum, kdy byla událost zaznamenána (formát RRRRMMDD v registrovaném časovém pásmu vaší aplikace).
event_dim.name	STRING	Název události.
event_dim.params	RECORD	Opakovaný záznam parametrů spojených s touto událostí.
event_dim.params.key	STRING	Klíč parametru události.
event_dim.params.value	RECORD	Záznam hodnoty parametru události.
event_dim.params.value.string_value	STRING	Řetězec hodnoty parametru události.
event_dim.params.value.int_value	INTEGER	Celočíselná hodnota parametru události.
event_dim.params.value.double_value	FLOAT	Dvojitá hodnota parametru události.
event_dim.timestamp_micros	INTEGER	Čas (v mikrosekundách, UTC), kdy byla událost u klienta zaznamenána.
event_dim.previous_timestamp_micros	INTEGER	Čas (v mikrosekundách, UTC), kdy byla taková událost u klienta zaznamenána naposled.

Pomohly vám tyto informace?

Jak bychom článek mohli vylepšit?