Import fra Google Analytics 4
To måter å hente GA4-tall hit på: dagssummer for å se hvor mye MousePlayer overhodet får med seg — og enkeltøkter fra GA4s BigQuery-eksport for besøkene vi ikke kunne ta opp.
1. Hva som hentes, og hva som ikke hentes
Begge alternativene leser fra din Google-konto og slås på hver for seg. De besvarer ulike spørsmål, og du trenger ikke begge.
| Alternativ | Hva det henter | Formål |
|---|---|---|
| Data API | Dagssummer: økter, brukere, sidevisninger, engasjerte økter | Dekningsspørsmålet. GA4 teller 3 000 økter, MousePlayer tok opp 40 — uten referansetallet kan forskjellen ikke engang oppdages. |
| BigQuery-import | Enkeltøkter fra GA4 med tilhørende hendelser | Hva som skjedde under et besøk MousePlayer ikke kunne ta opp. |
En importert økt kan ikke spilles av. GA4 lagrer verken øyeblikkskopi av siden eller musebevegelser, så det finnes ikke noe å bygge en avspilling fra. Du får tall og hendelser ved siden av opptakene — ikke mer, og vi fremstiller det ikke som mer.
Importen ligger i egne tabeller og blandes aldri inn i opptakene dine. Ellers ville betydningen av alle avledede tall endret seg uten varsel — atferdsprofilene, verdivurderingen av besøkende, friksjonsanalysen — og etterpå kunne ingen sagt hvilke rader som var målt og hvilke som var hentet.
2. Alternativ 1: Data API
Du trenger to ting: område-ID og en tjenestekontonøkkel.
Område-ID-en er ikke målings-ID-en
Dette er den vanligste feilen, og Googles egen feilmelding sier ikke hva som er galt. En målings-ID ser ut som G-ABC123XYZ, ligger i sporingskodestykket og er synlig overalt. En område-ID består bare av tall og vises kun i administrasjonen under Administrator, Områdeinnstillinger. Det er den siste du trenger; vi avviser den første med en merknad i stedet for å la deg møte en 400-feil.
Opprett tjenestekontoen og gi tilgang
- Opprett en tjenestekonto i Google Cloud Console og generer en JSON-nøkkel.
- Aktiver Google Analytics Data API i samme prosjekt.
- I GA4 under Administrator, Tilgangsstyring for området, legger du til tjenestekontoens e-postadresse som Leser. En tjenestekonto er en egen bruker; uten dette trinnet svarer Google 403 uten å si hvorfor.
Lim inn innholdet i JSON-filen i feltet. Det lagres kryptert og vises bare i forkortet form etterpå.
3. Alternativ 2: BigQuery-import
Dette alternativet leser råeksporten fra GA4. Den må du sette opp én gang i GA4: Administrator, BigQuery-koblinger. Tabellene dukker først opp dagen etter — før det finner importen ingenting, og det er ingen feil.
Hva du fyller inn
- Oppgi GCP-prosjekt-ID-en som eksporten ligger i. Det er ikke nødvendigvis samme prosjekt som du eksporterer MousePlayer-data til.
- Oppgi datasett-ID-en. GA4 gir det navnet
analytics_<propertyId>. - En tjenestekontonøkkel med BigQuery Data Viewer på datasettet og BigQuery Job User i prosjektet. Lesetilgang er nok; ikke gi mer.
Hva det koster, og hvem som betaler
BigQuery fakturerer etter leste byte, og regningen er din. Derfor leser importen bare noen få dager per kjøring og kjører alltid bare én spørring — en ekstra ville lest de samme tabellene igjen. I tillegg avbryter en fast grense spørringen før det blir dyrt; når det skjer, sier meldingen i leveringsloggen at tidsvinduet er for stort.
Kjørefrekvens
Som standard hver sjette time, og hver kjøring henter de siste tre dagene på nytt. Det er ikke tilfeldig: GA4 etterfyller i opptil 48 timer, og dagseksporten vises først dagen etter. Hyppigere forespørsler gir ikke ferskere tall, bare de samme.
4. Nøkkelen som kobler begge sider
Hvis du også setter analysebroen til GA4, lagrer MousePlayer klient-ID-en fra informasjonskapselen _ga med hver økt. Det er nøyaktig verdien som BigQuery-eksporten har som user_pseudo_id.
Med den kan en GA4-økt kobles til et av opptakene dine — og omvendt kan du se hva GA4 telte under samme besøk. Uten broen ligger sidene bare ved siden av hverandre uten kobling.
Det samme feltet inneholder også din egen kundeidentifikator hvis du bruker setUserId(). Du kan ikke ha begge: enten ligger Googles klient-ID der eller ditt eget nummer.
5. Samtykke, oppbevaring, sletting
Det som hentes, hadde en informasjonskapsel
Bare rader med en user_pseudo_id importeres. Når en besøkende avslår, sender GA4 treff uten informasjonskapsler i Consent Mode, og de har ingen slik verdi — så de utelates uten at noen må gi en forsikring. Modellerte, altså estimerte, rader utelates av samme grunn: å lagre et estimat som en økt ville betydd å lagre besøk som aldri fant sted.
Hvor lenge dataene beholdes
Som standard 180 dager, regnet fra dagen raden beskriver — ikke importtidspunktet. Ellers ville perioden aldri utløpt, siden hver kjøring henter de samme dagene på nytt.
Sletting
Hvis en besøkende ber om sletting av dataene sine, slettes også de importerte GA4-øktene deres — så langt de kan tilordnes via identifikatoren ovenfor. Sletter du prosjektet, slettes de uansett, også rader som aldri hørte til et av opptakene dine. Den daglige oppbevaringsjobben lar dem bevisst være: GA4-data følger sin egen tidsplan, og opptakene dine utløper tidligere.
6. Når ingenting kommer frem
Hver kjøring skriver resultatet i leveringsloggen på integrasjonssiden — også feil, i klare ord. Vanligvis står det allerede der hva som mangler.
| Melding | Hva du bør gjøre |
|---|---|
| Område-ID må bare inneholde tall | Du har oppgitt målings-ID-en. Riktig nummer finnes i GA4 under Områdeinnstillinger. |
| HTTP 403 fra Data API | Tjenestekontoen er ikke Leser på GA4-området, eller Data API er ikke aktivert i GCP-prosjektet. |
| Datasett eller eksporttabeller ikke funnet | BigQuery-koblingen mangler, datasettet har et annet navn, eller det har ikke gått en dag ennå. |
| Tilgang avvist (BigQuery) | Tjenestekontoen mangler BigQuery Data Viewer på datasettet eller BigQuery Job User i prosjektet. |
| Spørringen ville lest for mye | Kostnadsgrensen avbrøt før noe ble fakturert. Velg et mindre tidsvindu. |
| ingen økter i tidsvinduet | Ingen feil. Det fantes ingen økt med samtykke i dagene som ble hentet. |