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.
Pole události obsahují informace, které příslušnou událost jednoznačně identifikují. | ||
Název pole | Typ dat | Popis |
---|---|---|
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 pro každou následující stránku 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
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. |
||
Název pole | Typ dat | Popis |
---|---|---|
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 RECORD
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á. |
||
Název pole | Typ dat | Popis |
---|---|---|
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. |
Tato pole obsahují informace, které jednoznačně identifikují uživatele spojeného s událostí. | ||
Název pole | Typ dat | Popis |
---|---|---|
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 ( |
user_id | STRING | Jedinečný identifikátor přiřazený uživateli. |
user_pseudo_id | STRING | Pseudonymní ID (např. ID instance aplikace) daného uživatele. |
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
Pokud je zapnut režim souhlasu, obsahují pole privacy_info informace týkající se stavu souhlasu uživatele. | ||
Název pole | Typ dat | Popis |
---|---|---|
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
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. | ||
Název pole | Typ dat | Popis |
---|---|---|
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
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. | ||
Název pole | Typ dat | Popis |
---|---|---|
user_ltv.revenue | FLOAT | Celková hodnota (tržby) uživatele. V průběžných denních tabulkách se toto pole nevyplňuje. |
user_ltv.currency | STRING | Celková hodnota (měna) uživatele. V průběžných denních tabulkách se toto pole nevyplňuje. |
Pole device typu RECORD obsahuje informace o zařízení, na němž událost vznikla. | ||
Název pole | Typ dat | Popis |
---|---|---|
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
Pole geo typu RECORD obsahuje informace o zeměpisné poloze, kde k události došlo. | ||
Název pole | Typ dat | Popis |
---|---|---|
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). |
Pole app_info typu RECORD obsahuje informace o aplikaci, v níž k události došlo. | ||
Název pole | Typ dat | Popis |
---|---|---|
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. |
Pole collected_traffic_source typu RECORD obsahuje údaje o zdrojích návštěvnosti, které byly s událostí shromážděny. |
||
Název pole | Typ dat | Popis |
---|---|---|
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í. |
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). |
||
Název pole | Typ dat | Popis |
---|---|---|
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. |
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í. |
||
Název pole | Typ dat | Popis |
---|---|---|
traffic_source.name | STRING | Název marketingové kampaně, která jako první uživatele přivedla. V průběžných denních tabulkách se toto pole nevyplňuje. |
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. V průběžných denních tabulkách se toto pole nevyplňuje. |
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. |
Pole stream a platforma obsahují informace o streamu a platformě aplikace. | ||
Název pole | Typ dat | Popis |
---|---|---|
stream_id | STRING | Číselné ID datového streamu, ze kterého událost pochází. |
platform | STRING | Platforma datového streamu (web, iOS nebo Android), ze které událost pochází. |
Pole ecommerce typu RECORD obsahuje informace o všech událostech elektronického obchodu, které byly na webu nebo v aplikaci definovány. | ||
Název pole | Typ dat | Popis |
---|---|---|
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. |
Pole items typu RECORD obsahují informace o položkách obsažených v události. Opakuje se pro každou položku. | ||
Název pole | Typ dat | Popis |
---|---|---|
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í položky. Pokud není uvedeno, 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
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. |
||
Název pole | Typ dat | Popis |
---|---|---|
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. |
Řá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 | |||
medium | odkazující zdroj | |||
source | ||||
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.
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.
- 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.
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
- Zadejte příkaz
- 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
- Zadejte příkaz
- Otevřete nový shell a zadejte příkaz
bash migration.sh
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. |