Import z Google Analytics 4

Dva spôsoby, ako sem preniesť údaje GA4: denné súčty na zistenie, koľko toho MousePlayer vôbec vidí, a jednotlivé relácie GA4 z exportu BigQuery pre návštevy, ktoré sme nemohli zaznamenať.

1. Čo sa importuje a čo nie

Oba postupy čítajú z vášho účtu Google a zapínajú sa samostatne. Odpovedajú na rôzne otázky a nepotrebujete oba.

PostupČo získavaNa čo slúži
Data APIDenné súčty: relácie, používatelia, zobrazenia stránok, relácie so zapojenímOtázka pokrytia. GA4 počíta 3 000 relácií, MousePlayer zaznamenal 40 – bez referenčného údaja si rozdiel ani nemožno všimnúť.
Import BigQueryJednotlivé relácie GA4 s udalosťamiČo sa stalo počas návštevy, ktorú MousePlayer nemohol zaznamenať.

Importovanú reláciu nemožno prehrať. GA4 neuchováva snímku stránky ani pohyb myši, takže nie je z čoho zostaviť prehrávanie. Dostanete čísla a udalosti vedľa svojich záznamov – nič viac a ani to ako viac neprezentujeme.

Import sa ukladá vo vlastných tabuľkách a nikdy sa nemieša s vašimi záznamami. Inak by sa potichu zmenil význam každého odvodeného údaja – profilov správania, hodnotenia návštevníkov, analýzy trenia – a potom by nikto nevedel povedať, ktorý riadok bol zmeraný a ktorý získaný importom.

2. Postup 1: Data API

Potrebujete dve veci: ID vlastníctva a kľúč servisného účtu.

ID vlastníctva nie je ID merania

Ide o najčastejší neúspešný pokus a ani vlastné chybové hlásenie Google ho nepomenuje. Identifikátor ID merania vyzerá ako G-ABC123XYZ, nachádza sa vo vašom sledovacom úryvku kódu a je viditeľný všade. Identifikátor ID vlastníctva je čisto číselný a zobrazuje sa iba v správe v časti Správca, Nastavenia vlastníctva. Potrebný je druhý údaj; prvý odmietneme s vysvetlením, namiesto toho, aby sme vás nechali naraziť na chybu 400.

Vytvorenie a autorizácia servisného účtu

  • V konzole Google Cloud vytvorte servisný účet a vygenerujte kľúč JSON.
  • V tom istom projekte povoľte Google Analytics Data API.
  • V GA4 v časti Správca, Správa prístupu k vlastníctvu pridajte e-mailovú adresu servisného účtu s rolou Pozorovateľ. Servisný účet je samostatný používateľ; bez tohto kroku Google odpovie chybou 403 bez uvedenia dôvodu.

Vložte obsah súboru JSON do poľa. Uloží sa šifrovane a následne sa zobrazuje iba v skrátenej forme.

3. Postup 2: Import BigQuery

Tento postup číta surový export GA4. Treba ho jednorazovo nastaviť v GA4: Správca, Prepojenia BigQuery. Tabuľky sa objavia až nasledujúci deň – dovtedy import nič nenájde a nejde o chybu.

Čo zadávate

  • Identifikátor ID projektu GCP, v ktorom sa export nachádza. Nemusí ísť o rovnaký projekt, do ktorého exportujete údaje MousePlayer.
  • Identifikátor ID množiny údajov. GA4 ju nazýva analytics_<propertyId>.
  • Kľúč servisného účtu s rolou Pozorovateľ údajov BigQuery pre množinu údajov a rolou Používateľ úloh BigQuery v projekte. Prístup na čítanie stačí; neudeľujte viac oprávnení.

Koľko to stojí a kto platí

BigQuery účtuje podľa prečítaných bajtov a tento účet platíte vy. Preto import pri každom spustení číta iba niekoľko dní a vykonáva vždy iba jednu požiadavku – druhá by znovu čítala tie isté tabuľky. Okrem toho pevný limit preruší požiadavku skôr, než sa predraží; vtedy hlásenie v denníku doručení uvedie, že časové okno je príliš veľké.

Interval

Predvolene každých šesť hodín a každé spustenie znovu načíta posledné tri dni. Nie je to náhodné: GA4 spätne dopĺňa údaje až 48 hodín a denný export sa objaví až nasledujúci deň. Častejšie požiadavky neprinesú čerstvejšie čísla, len tie isté.

4. Kľúč prepájajúci obe strany

Ak aj analytický most nastavíte na GA4, MousePlayer pri každej relácii zaznamená ID klienta zo súboru cookie _ga. Presne túto hodnotu obsahuje export BigQuery ako user_pseudo_id.

Vďaka nej možno reláciu GA4 priradiť k jednému z vašich záznamov – a opačne vidieť, čo GA4 spočítal počas tej istej návštevy. Bez mosta sú obe strany jednoducho vedľa seba, neprepojené.

To isté pole obsahuje aj váš vlastný identifikátor zákazníka, ak používate setUserId(). Oboje naraz mať nemôžete: je tam buď ID klienta Google, alebo vaše vlastné číslo.

5. Súhlas, uchovávanie, vymazanie

Importované údaje mali súbor cookie

Importujú sa iba riadky obsahujúce user_pseudo_id. Keď návštevník odmietne súhlas, GA4 v režime súhlasu odosiela zásahy bez súborov cookie a tie túto hodnotu nemajú – preto sa vyradia bez toho, aby musel niekto poskytovať uistenie. Modelované, teda odhadované riadky zostávajú mimo z rovnakého dôvodu: uložiť odhad ako reláciu by znamenalo uložiť návštevy, ktoré sa nikdy nestali.

Ako dlho zostávajú

Predvolene 180 dní, počítaných odo dňa, ktorý riadok opisuje – nie od okamihu importu. Inak by lehota nikdy neuplynula, pretože každé spustenie znovu získava tie isté dni.

Vymazanie

Ak návštevník požiada o vymazanie údajov, vymažú sa aj jeho importované relácie GA4 – pokiaľ ich možno priradiť pomocou uvedeného identifikátora. Ak vymažete projekt, vymažú sa v každom prípade vrátane riadkov, ktoré nikdy nepatrili k žiadnemu z vašich záznamov. Denné čistenie podľa doby uchovávania ich zámerne ponecháva: údaje GA4 majú vlastnú lehotu a vaše záznamy vypršia skôr.

6. Keď nič neprichádza

Každé spustenie zapíše výsledok do denníka doručení na stránke integrácií – vrátane zlyhaní, zrozumiteľnými slovami. Zvyčajne už tam zistíte, čo chýba.

HlásenieČo urobiť
ID vlastníctva musí byť čisto číselnéZadali ste ID merania. Správne číslo je v GA4 v časti Nastavenia vlastníctva.
HTTP 403 z Data APIServisný účet nemá vo vlastníctve GA4 rolu Pozorovateľ alebo v projekte GCP nie je povolené Data API.
Množina údajov alebo exportné tabuľky sa nenašliChýba prepojenie BigQuery, množina údajov má iný názov alebo ešte neuplynul deň.
Prístup zamietnutý (BigQuery)Servisnému účtu chýba rola Pozorovateľ údajov BigQuery pre množinu údajov alebo Používateľ úloh BigQuery v projekte.
Požiadavka by prečítala priveľa údajovNákladový limit ju prerušil skôr, než sa niečo vyúčtovalo. Vyberte menšie časové okno.
žiadne relácie v časovom okneNejde o chybu. V získaných dňoch nebola žiadna relácia so súhlasom.