Importeren uit Google Analytics 4

1. Wat wordt geïmporteerd en wat niet

Beide routes lezen uit uw Google-account en worden afzonderlijk ingeschakeld. Ze beantwoorden verschillende vragen; u hoeft ze niet allebei te gebruiken.

Route	Wat wordt opgehaald	Waarvoor
Data API	Dagtotalen: sessies, gebruikers, paginaweergaven en betrokken sessies	De vraag naar dekking. GA4 telt 3.000 sessies, MousePlayer nam er 40 op. Zonder referentiecijfer valt dat verschil niet eens op.
BigQuery-import	Afzonderlijke GA4-sessies met hun gebeurtenissen	Wat er gebeurde tijdens een bezoek dat MousePlayer niet kon opnemen.

De import staat in eigen tabellen en wordt nooit vermengd met uw opnamen. Anders zou de betekenis van elk afgeleid cijfer ongemerkt veranderen: gedragsprofielen, bezoekerswaardering en frictieanalyse. Achteraf zou niemand meer weten welke rij was gemeten en welke was opgehaald.

2. Route 1: Data API

U hebt twee dingen nodig: de property-ID en een sleutel voor een serviceaccount.

De property-ID is niet de metings-ID

Dit is de meest voorkomende mislukte poging, en de foutmelding van Google noemt de oorzaak niet. De metings-ID ziet eruit als G-ABC123XYZ, staat in uw trackingsnippet en is overal zichtbaar. De property-ID bestaat uitsluitend uit cijfers en staat alleen in het beheergedeelte, onder Beheer, Property-instellingen. U hebt de tweede nodig; de eerste wijzen we af met een toelichting, zodat u niet tegen een 400 aanloopt.

Het serviceaccount maken en toegang geven

• Maak in de Google Cloud Console een serviceaccount en genereer een JSON-sleutel.
• Schakel in hetzelfde project de Google Analytics Data APIin.
• Voeg in GA4 onder Beheer, Toegangsbeheer voor property, het e-mailadres van het serviceaccount toe als Kijker. Een serviceaccount is een zelfstandige gebruiker; zonder deze stap antwoordt Google met 403, zonder te zeggen waarom.

Plak de inhoud van het JSON-bestand in het veld. De sleutel wordt versleuteld opgeslagen en daarna alleen verkort weergegeven.

3. Route 2: BigQuery-import

Deze route leest de ruwe GA4-export. Stel die eenmalig in bij GA4: Beheer, BigQuery-koppelingen. Tabellen verschijnen pas de volgende dag ; tot die tijd vindt de import niets, en dat is geen fout.

Wat u invult

• De GCP-project-ID van het project waarin de export staat. Dat is niet noodzakelijk hetzelfde project als waarnaar u MousePlayer-gegevens exporteert.
• De dataset-ID. GA4 geeft deze de naam analytics_<propertyId>.
• Een sleutel voor een serviceaccount met BigQuery Data Viewer op de dataset en BigQuery Job User in het project. Leestoegang is voldoende; verleen niet meer rechten.

Wat het kost en wie betaalt

BigQuery factureert op basis van gelezen bytes, en die rekening is voor u. Daarom leest de import per uitvoering maar enkele dagen en wordt er steeds maar één query uitgevoerd: een tweede zou dezelfde tabellen opnieuw lezen. Bovendien breekt een harde limiet de query af voordat deze duur wordt. In dat geval meldt het afleverlogboek dat het tijdvenster te groot is.

Het interval

Standaard elke zes uur; bij elke uitvoering worden de laatste drie dagen opnieuw opgehaald. Dat is bewust: GA4 vult gegevens tot 48 uur later aan, en de dagelijkse export verschijnt pas de volgende dag. Vaker opvragen levert geen recentere cijfers op, alleen dezelfde.

4. De sleutel die beide kanten verbindt

Als u ook de analysekoppeling op GA4 instelt, slaat MousePlayer bij elke sessie de client-ID uit de _ga cookie op. Dat is precies de waarde die de BigQuery-export bevat als user_pseudo_id.

Daarmee kan een GA4-sessie aan een van uw opnamen worden gekoppeld. Andersom ziet u wat GA4 tijdens hetzelfde bezoek heeft geteld. Zonder de koppeling staan beide gegevensbronnen simpelweg los naast elkaar.

5. Toestemming, bewaartermijn en verwijderen

Geïmporteerde gegevens hadden een cookie

Alleen rijen met een user_pseudo_id worden geïmporteerd. Als een bezoeker weigert, verstuurt GA4 via Consent Mode hits zonder cookies, die geen identificatie bevatten. Ze vallen dus vanzelf af, zonder dat iemand iets hoeft toe te zeggen. Gemodelleerde, dus geschatte, rijen blijven om dezelfde reden buiten de import: een schatting als sessie opslaan zou betekenen dat we bezoeken bewaren die nooit hebben plaatsgevonden.

Hoe lang de gegevens blijven

Standaard 180 dagen, gerekend vanaf de dag die de rij beschrijft, niet vanaf het importmoment. Anders zou de termijn nooit aflopen, omdat elke uitvoering dezelfde dagen opnieuw ophaalt.

Verwijderen

Als een bezoeker om verwijdering van zijn gegevens vraagt, worden de geïmporteerde GA4-sessies ook verwijderd, voor zover deze via de bovenstaande identificatie aan die bezoeker kunnen worden gekoppeld. Als u het project verwijdert, verdwijnen ze altijd, inclusief rijen die nooit bij een van uw opnamen hoorden. De dagelijkse opruiming volgens de bewaartermijn laat deze gegevens bewust ongemoeid: voor GA4-gegevens geldt een eigen termijn, en uw opnamen verlopen eerder.

6. Wanneer er niets binnenkomt

Elke uitvoering schrijft het resultaat naar het afleverlogboek op de integratiepagina, inclusief fouten, in begrijpelijke taal. Meestal staat daar al wat er ontbreekt.

Melding	Wat u kunt doen
Property-ID mag alleen cijfers bevatten	U hebt de metings-ID ingevuld. Het juiste nummer staat in GA4 onder Property-instellingen.
HTTP 403 van de Data API	Het serviceaccount is geen Kijker op de GA4-property, of de Data API is niet ingeschakeld in het GCP-project.
Dataset of exporttabellen niet gevonden	De BigQuery-koppeling ontbreekt, de dataset heeft een andere naam of er is nog geen dag verstreken.
Toegang geweigerd (BigQuery)	Het serviceaccount mist BigQuery Data Viewer op de dataset of BigQuery Job User in het project.
De query zou te veel gegevens lezen	De kostenlimiet heeft de query afgebroken voordat er kosten werden berekend. Kies een kleiner tijdvenster.
geen sessies in het tijdvenster	Geen fout. In de opgehaalde dagen was er geen sessie met toestemming.