Voer uit Google Analytics 4 in
Twee maniere om u GA4-syfers hierheen te bring: daaglikse totale om te bepaal hoeveel MousePlayer enigsins sien, en individuele GA4-sessies uit die BigQuery-uitvoer vir besoeke wat ons nie kon opneem nie.
1. Wat inkom en wat nie
Albei roetes lees uit u Google-rekening en word afsonderlik aangeskakel. Hulle beantwoord verskillende vrae; u het nie albei nodig nie.
| Roete | Wat dit ophaal | Waarvoor |
|---|---|---|
| Data API | Daaglikse totale: sessies, gebruikers, bladsybesigtigings, betrokke sessies | Die dekkingsvraag. GA4 tel 3,000 sessies, MousePlayer het 40 opgeneem — sonder die verwysingsyfer kan die verskil nie eens opgemerk word nie. |
| BigQuery-invoer | Individuele GA4-sessies met hul gebeure | Wat gebeur het tydens 'n besoek wat MousePlayer nie kon opneem nie. |
'n Ingevoerde sessie kan nie herspeel word nie. GA4 hou geen bladsykiekie of muisbeweging nie, dus is daar niks om 'n herspeling van te bou nie. U kry syfers en gebeure langs u opnames — niks meer nie en ons stel dit nie as meer voor nie.
Die invoer bly in eie tabelle en word nooit met u opnames gemeng nie. Anders sou die betekenis van elke afgeleide syfer stilweg verander — gedragsprofiele, besoekerwaardering, struikelblokontleding — en daarna sou niemand weet watter ry gemeet en watter opgehaal is nie.
2. Roete 1: Data API
U het twee dinge nodig: die webwerf-ID en 'n diensrekeningsleutel.
Die webwerf-ID is nie die meet-ID nie
Dit is die algemeenste mislukte poging en Google se eie foutboodskap noem dit nie. Die meet-ID lyk soos G-ABC123XYZ, staan in u nasporingskodebrokkie en is oral sigbaar. Die webwerf-ID is net syfers en verskyn slegs in die administrasiegebied onder Admin, Property settings. Die tweede is nodig; ons weier die eerste met 'n nota eerder as om u in 'n 400 te laat vasloop.
Skep en magtig die diensrekening
- Skep 'n diensrekening in Google Cloud Console en genereer 'n JSON-sleutel.
- Aktiveer in dieselfde projek die Google Analytics Data API.
- Voeg in GA4 onder Admin, Property access management die diensrekening se e-posadres by as 'n Viewer. 'n Diensrekening is 'n gebruiker op sy eie; sonder dié stap antwoord Google 403 sonder om te sê waarom.
Plak die JSON-lêer se inhoud in die veld. Dit word geënkripteer gestoor en daarna slegs verkort gewys.
3. Roete 2: BigQuery-invoer
Hierdie roete lees die rou GA4-uitvoer. U moet dit een keer in GA4 opstel: Admin, BigQuery links. Tabelle verskyn eers vanaf die volgende dag — voordien vind die invoer niks en dit is nie 'n fout nie.
Wat u invoer
- Die GCP-projek-ID waarin die uitvoer is. Dit is nie noodwendig dieselfde projek waarheen u MousePlayer-data uitvoer nie.
- Die datastel-ID. GA4 noem dit
analytics_<propertyId>. - 'n Diensrekeningsleutel met BigQuery Data Viewer op die datastel en BigQuery Job User in die projek. Leestoegang is genoeg; moenie asseblief meer verleen nie.
Wat dit kos en wie betaal
BigQuery hef koste volgens grepe geleesen dié rekening is u eie. Daarom lees die invoer net 'n paar dae per lopie en voer altyd net een navraag uit — 'n tweede sou dieselfde tabelle weer lees. Daarby stop 'n vaste limiet die navraag voordat dit duur raak; wanneer dit gebeur, sê die afleweringslogboek dat die tydvenster te groot is.
Die frekwensie
By verstek elke ses uur; elke lopie haal die laaste drie dae weer op. Dit is nie willekeurig nie: GA4 vul tot 48 uur terug aan en die daaglikse uitvoer verskyn eers die volgende dag. Meer gereelde navrae kry nie varser syfers nie, net dieselfde.
4. Die sleutel wat albei kante verbind
As u ook die ontledingsbrug op GA4 stel, teken MousePlayer die kliënt-ID uit die _ga koekie by elke sessie aan. Dit is presies die waarde wat die BigQuery-uitvoer dra as user_pseudo_id.
Daarmee kan 'n GA4-sessie aan een van u opnames gekoppel word — en omgekeerd kan u sien wat GA4 tydens dieselfde besoek getel het. Sonder die brug bly albei kante bloot langs mekaar, ongekoppel.
Dieselfde veld dra ook u eie klantidentifiseerder as u setUserId()gebruik. U kan nie albei hê nie: óf die Google-kliënt-ID is daar óf u eie nommer.
5. Toestemming, bewaring, uitwissing
Wat inkom, het 'n koekie gehad
Slegs rye met 'n user_pseudo_id word ingevoer. Waar 'n besoeker weier, stuur GA4 koekielose treffers onder Consent Mode sonder dié waarde — hulle val dus vanself uit. Gemodelleerde, dit wil sê geraamde, rye bly om dieselfde rede uit: 'n raming as sessie stoor sou besoeke stoor wat nooit gebeur het nie.
Hoe lank dit bly
By verstek 180 dae, getel vanaf die dag wat die ry beskryf — nie die invoertyd nie. Anders sou die tydperk nooit verstryk nie, want elke lopie haal dieselfde dae weer op.
Uitwissing
As 'n besoeker vra dat data uitgevee word, gaan die ingevoerde GA4-sessies saam — sover hulle deur die identifiseerder hierbo toegereken kan word. As u die projek uitvee, gaan hulle in elk geval, ook rye wat nooit aan een van u opnames behoort het nie. Die daaglikse bewaringslopie laat hulle doelbewus alleen: GA4-data het sy eie tydlyn en u opnames verval vroeër.
6. Wanneer niks aankom nie
Elke lopie skryf die resultaat in die afleweringslogboek op die integrasiebladsy — mislukkings ingesluit, in gewone taal. Dit sê gewoonlik reeds wat ontbreek.
| Boodskap | Wat om te doen |
|---|---|
| Webwerf-ID moet net syfers wees | U het die meet-ID ingevoer. Die regte nommer is in GA4 onder Property settings. |
| HTTP 403 uit die Data API | Die diensrekening is nie 'n Viewer op die GA4-webwerf nie of die Data API is nie in die GCP-projek geaktiveer nie. |
| Datastel of uitvoertabelle nie gevind nie | Die BigQuery-koppeling ontbreek, die datastel het 'n ander naam of 'n dag het nog nie verstryk nie. |
| Toegang geweier (BigQuery) | Die diensrekening kort BigQuery Data Viewer op die datastel of BigQuery Job User in die projek. |
| Die navraag sou te veel gelees het | Die kostelimiet het dit gestop voordat enigiets gefaktureer is. Kies 'n kleiner tydvenster. |
| geen sessies in die tydvenster nie | Nie 'n fout nie. Daar was geen sessie met toestemming in die opgehaalde dae nie. |