Importálás a Google Analytics 4-ből

1. Mi kerül be, és mi nem

Mindkét mód az Ön Google-fiókjából olvas, és külön kapcsolható be. Más kérdésre válaszolnak; nincs szüksége mindkettőre.

Mód	Mit kér le	Mire való
Data API	Napi összesítések: munkamenetek, felhasználók, oldalmegtekintések, aktív munkamenetek	A lefedettség kérdésére. A GA4 3 000 munkamenetet számol, a MousePlayer 40-et rögzített — viszonyítási adat nélkül a különbség észre sem vehető.
BigQuery-importálás	Egyedi GA4-munkamenetek az eseményeikkel	Mi történt olyan látogatáskor, amelyet a MousePlayer nem tudott rögzíteni.

Az importált adatok saját táblákban vannak, és soha nem keverednek a felvételeivel. Máskülönben minden származtatott szám jelentése észrevétlenül megváltozna — a viselkedési profiloké, a látogatóértékelésé, a súrlódáselemzésé —, és utólag senki nem tudná megmondani, melyik sort mértük és melyiket kértük le.

2. Első mód: Data API

Két dolog szükséges: a tulajdon azonosítója és egy szolgáltatásfiók kulcsa.

A tulajdon azonosítója nem a mérési azonosító

Ez a leggyakoribb sikertelen próbálkozás, és a Google saját hibaüzenete nem nevezi meg az okot. A mérési azonosító ilyen alakú: G-ABC123XYZ, a követőkódrészletben van, és mindenhol látható. A tulajdon azonosítója csak számjegyekből áll, és kizárólag az adminisztrációs részben jelenik meg, az Adminisztrálás, Tulajdon beállításai alatt. Ez utóbbi kell; az előbbit magyarázattal elutasítjuk, hogy ne egy 400-as hibába ütközzön.

Szolgáltatásfiók létrehozása és feljogosítása

• A Google Cloud Console-ban hozzon létre szolgáltatásfiókot, és generáljon JSON-kulcsot.
• Ugyanebben a projektben engedélyezze ezt: Google Analytics Data API.
• A GA4-ben az Adminisztrálás, Tulajdon hozzáférés-kezelése alatt adja hozzá a szolgáltatásfiók e-mail-címét ezzel a szerepkörrel: Megtekintő. A szolgáltatásfiók önálló felhasználó; e lépés nélkül a Google 403-mal válaszol, és nem indokolja meg.

Illessze a JSON-fájl tartalmát a mezőbe. Titkosítva tároljuk, és később csak rövidített formában mutatjuk.

3. Második mód: BigQuery-importálás

Ez a mód a GA4 nyers exportját olvassa. Ezt egyszer be kell állítania a GA4-ben: Adminisztrálás, BigQuery-összekapcsolások. A táblák csak a következő naptól jelennek meg — előtte az importálás semmit nem talál; ez nem hiba.

Mit kell megadnia

• Annak a projektnek a GCP-projektazonosítóját, ahol az export van. Ez nem feltétlenül az a projekt, ahová a MousePlayer adatait exportálja.
• Az adatkészlet-azonosítót. A GA4 ezt a nevet adja neki: analytics_<propertyId>.
• Szolgáltatásfiók-kulcsot, amelyhez az adatkészleten BigQuery Data Viewer, a projektben pedig BigQuery Job User jogosultság tartozik. Az olvasási hozzáférés elég; kérjük, ne adjon többet.

Mennyibe kerül, és ki fizeti

A BigQuery az olvasott bájtok alapján számláz; ezt Ön fizeti. Ezért az importálás futásonként csak néhány napot olvas, és mindig csak egyetlen lekérdezést futtat — egy második újra ugyanazokat a táblákat olvasná. Emellett egy szigorú korlát megszakítja a lekérdezést, mielőtt drágává válna; ilyenkor a kézbesítési napló üzenete szerint túl nagy az időablak.

Ütemezés

Alapértelmezetten hatóránként fut, és minden futás újra lekéri az utolsó három napot. Ennek oka van: a GA4 akár 48 óráig utólag pótol adatokat, a napi export pedig csak másnap jelenik meg. A gyakoribb lekérés nem frissebb, csak ugyanazokat a számokat adná.

4. A két oldalt összekapcsoló kulcs

Ha az analitikai hidat is GA4-re állítja, a MousePlayer minden munkamenethez rögzíti a _ga sütiből az ügyfélazonosítót. Pontosan ezt az értéket tartalmazza a BigQuery-export ebben a mezőben: user_pseudo_id.

Ezzel egy GA4-munkamenet a felvételei egyikéhez rendelhető — és fordítva is látszik, mit számolt a GA4 ugyanazon látogatás során. A híd nélkül a két oldal egymás mellett marad, összeköttetés nélkül.

5. Hozzájárulás, megőrzés, törlés

A bekerülő adatokhoz süti tartozott

Csak azokat a sorokat importáljuk, amelyekben van user_pseudo_id. Ha a látogató elutasítja a hozzájárulást, a GA4 a Consent Mode keretében süti nélküli találatokat küld, amelyekben nincs ilyen — így külön ígéret nélkül is kimaradnak. A modellezett, vagyis becsült sorok ugyanezért maradnak ki: egy becslés munkamenetként tárolása meg nem történt látogatások tárolását jelentené.

Mennyi ideig marad meg

Alapértelmezetten 180 napig, a sor által leírt naptól számítva — nem az importálás pillanatától. Különben az időszak soha nem járna le, hiszen minden futás újra ugyanazokat a napokat kéri le.

Törlés

Ha a látogató adatai törlését kéri, importált GA4-munkameneteit is töröljük — amennyiben a fenti azonosítóval hozzá rendelhetők. A projekt törlésekor mindenképp törlődnek, azok a sorok is, amelyek soha nem tartoztak felvételéhez. A napi megőrzési feladat szándékosan nem érinti őket: a GA4-adatoknak saját időzítésük van, felvételei korábban lejárnak.

6. Ha semmi nem érkezik

Minden futás az integrációs oldal kézbesítési naplójába írja az eredményét — a hibákat is, közérthetően. Ez általában már megmutatja, mi hiányzik.

Üzenet	Teendő
A tulajdon azonosítója csak számjegyekből állhat	A mérési azonosítót adta meg. A megfelelő szám a GA4 Tulajdon beállításai részében található.
HTTP 403 a Data API-tól	A szolgáltatásfiók nem Megtekintő a GA4-tulajdonon, vagy a Data API nincs engedélyezve a GCP-projektben.
Az adatkészlet vagy az exporttáblák nem találhatók	Hiányzik a BigQuery-összekapcsolás, más az adatkészlet neve, vagy még nem telt el egy nap.
Hozzáférés megtagadva (BigQuery)	A szolgáltatásfióknak nincs BigQuery Data Viewer jogosultsága az adatkészleten vagy BigQuery Job User jogosultsága a projektben.
A lekérdezés túl sok adatot olvasott volna	A költségkorlát még a számlázás előtt megszakította. Válasszon kisebb időablakot.
nincs munkamenet az időablakban	Ez nem hiba. A lekért napokon nem volt hozzájárulással rendelkező munkamenet.