Import z Google Analytics 4

1. Co se importuje a co ne

Obě cesty čtou data z vašeho účtu Google a zapínají se samostatně. Odpovídají na různé otázky a nepotřebujete obě.

Cesta	Co načítá	K čemu slouží
Data API	Denní součty: relace, uživatelé, zobrazení stránek a relace se zapojením	Otázka pokrytí. GA4 počítá 3 000 relací, MousePlayer zaznamenal 40. Bez referenčního údaje by rozdíl ani nebyl patrný.
Import z BigQuery	Jednotlivé relace GA4 s jejich událostmi	Co se stalo při návštěvě, kterou MousePlayer nemohl zaznamenat.

Importovanou relaci nelze přehrát. GA4 neuchovává snímek stránky ani pohyby myši, takže není z čeho sestavit záznam pro přehrávání. Získáte údaje a události vedle svých záznamů, nic víc, a ani to za nic víc nevydáváme.

Import má vlastní tabulky a nikdy se nemísí s vašimi záznamy. Jinak by se tiše změnil význam všech odvozených údajů: profilů chování, hodnocení návštěvníků i analýzy tření. Nikdo by pak nedokázal říct, který řádek byl naměřen a který načten.

2. Cesta 1: Data API

Potřebujete dvě věci: ID služby a klíč servisního účtu.

ID služby není ID měření

Jde o nejčastější příčinu neúspěchu a vlastní chybová zpráva Googlu ji neuvádí. ID měření vypadá jako G-ABC123XYZ, je ve sledovacím snippetu a je vidět všude. ID služby je čistě číselné a zobrazuje se jen ve správě, v části Admin, Property settings. Potřebujete druhý údaj; první odmítneme s vysvětlením, místo abychom vás nechali narazit na chybu 400.

Vytvoření servisního účtu a udělení oprávnění

V Google Cloud Console vytvořte servisní účet a vygenerujte klíč JSON.
Ve stejném projektu zapněte Google Analytics Data API.
V GA4 v části Admin, Property access management přidejte e-mailovou adresu servisního účtu s rolí Viewer. Servisní účet je samostatný uživatel; bez tohoto kroku Google odpoví 403, aniž uvede důvod.

Vložte obsah souboru JSON do pole. Uloží se zašifrovaný a poté se zobrazuje pouze ve zkrácené podobě.

3. Cesta 2: import z BigQuery

Tato cesta čte surový export GA4. Ten musíte v GA4 jednou nastavit: Admin, BigQuery links. Tabulky se objeví až následující den - do té doby import nic nenajde a nejde o chybu.

Co zadáte

Údaj ID projektu GCP označující projekt, ve kterém je export. Nemusí jít o stejný projekt, do kterého exportujete data MousePlayer.
Údaj ID datové sady. GA4 ji pojmenuje analytics_<propertyId>.
Klíč servisního účtu s rolí BigQuery Data Viewer u datové sady a BigQuery Job User v projektu. Stačí přístup pro čtení, neudělujte širší oprávnění.

Kolik to stojí a kdo platí

BigQuery účtuje podle přečtených bajtůa účet platíte vy. Proto import při každém spuštění čte jen několik dní a vždy provede jediný dotaz; druhý by znovu četl stejné tabulky. Navíc pevný limit přeruší dotaz dříve, než se prodraží. V takovém případě protokol doručení oznámí, že časové okno je příliš velké.

Interval

Ve výchozím nastavení každých šest hodin, přičemž se vždy znovu načtou poslední tři dny. Není to náhodné: GA4 doplňuje data až 48 hodin zpětně a denní export se objeví až další den. Častější dotazy nepřinesou čerstvější čísla, jen ta samá.

4. Klíč, který propojuje obě strany

Pokud zároveň nastavíte analytický most na GA4, MousePlayer u každé relace uloží ID klienta z cookie _ga . Přesně tuto hodnotu obsahuje export BigQuery jako user_pseudo_id.

Díky ní lze relaci GA4 přiřadit k některému z vašich záznamů a naopak zjistit, co GA4 napočítal během stejné návštěvy. Bez mostu jsou obě strany pouze vedle sebe, bez propojení.

Stejné pole obsahuje i váš vlastní identifikátor zákazníka, pokud používáte setUserId(). Obojí současně mít nelze: je v něm buď ID klienta Google, nebo vaše vlastní číslo.

5. Souhlas, doba uchování a mazání

Importovaná data měla cookie

Importují se pouze řádky obsahující user_pseudo_id . Když návštěvník odmítne souhlas, GA4 v režimu Consent Mode posílá požadavky bez cookies a ty identifikátor nemají, takže automaticky vypadnou, aniž by to někdo musel zvlášť slibovat. Ze stejného důvodu se neimportují modelované, tedy odhadované řádky: uložit odhad jako relaci by znamenalo uchovávat návštěvy, které se nikdy nestaly.

Jak dlouho data zůstanou

Standardně 180 dní od dne, který řádek popisuje, nikoli od okamžiku importu. Jinak by lhůta nikdy nevypršela, protože každé spuštění znovu načítá stejné dny.

Mazání

Pokud návštěvník požádá o vymazání údajů, odstraní se i jeho importované relace GA4, pokud je lze přiřadit pomocí výše uvedeného identifikátoru. Při smazání projektu zmizí vždy, včetně řádků, které nikdy nepatřily k žádnému z vašich záznamů. Denní mazání podle doby uchování je záměrně ponechává: data GA4 mají vlastní lhůtu a vaše záznamy vyprší dříve.

6. Když nic nepřichází

Každé spuštění zapíše výsledek do protokolu doručení na stránce integrací, včetně selhání a srozumitelným jazykem. Obvykle už tam zjistíte, co chybí.

Zpráva	Co dělat
ID služby musí být čistě číselné	V poli je ID měření. Správné číslo je v GA4 v části Property settings.
HTTP 403 z Data API	Servisní účet nemá u služby GA4 roli Viewer nebo v projektu GCP není zapnuto Data API.
Datová sada nebo exportní tabulky nenalezeny	Chybí propojení s BigQuery, datová sada má jiný název nebo ještě neuplynul den.
Přístup odepřen (BigQuery)	Servisnímu účtu chybí role BigQuery Data Viewer u datové sady nebo BigQuery Job User v projektu.
Dotaz by přečetl příliš mnoho dat	Nákladový limit dotaz přerušil dříve, než se cokoli účtovalo. Zvolte menší časové okno.
v časovém okně nejsou žádné relace	Nejde o chybu. V načtených dnech nebyla žádná relace se souhlasem.

Jak vám můžeme pomoci?