Google Analytics 4 (tuonti)

1. Mitä tuodaan ja mitä ei

Molemmat tavat lukevat omaa Google-tiliä ja otetaan käyttöön erikseen. Ne vastaavat eri kysymyksiin, eikä molempia tarvita.

Tapa	Mitä haetaan	Tarkoitus
Data API	Päiväsummat: istunnot, käyttäjät, sivun katselut, sitoutuneet istunnot	Kattavuuskysymys. GA4 laskee 3 000 istuntoa, MousePlayer tallensi 40 — ilman vertailulukua eroa ei edes huomaa.
BigQuery-tuonti	Yksittäiset GA4-istunnot tapahtumineen	Mitä tapahtui käynnillä, jota MousePlayer ei voinut tallentaa.

Tuotua istuntoa ei voi toistaa. GA4 ei säilytä sivun tilannekuvaa tai hiiren liikettä, joten toistoa ei voi rakentaa. Tuloksena ovat luvut ja tapahtumat tallenteiden vieressä — ei enempää, emmekä esitä muuta.

Tuonti on omissa tauluissaan, eikä sitä koskaan sekoiteta tallenteisiin. Muuten jokaisen johdetun luvun merkitys muuttuisi huomaamatta — käyttäytymisprofiilit, kävijöiden arvotus, kitka-analyysi — eikä kukaan enää erottaisi mitattuja rivejä haetuista.

2. Tapa 1: Data API

Tarvitaan kaksi asiaa: omaisuuden tunnus ja palvelutilin avain.

Omaisuuden tunnus ei ole mittaustunnus

Tämä on yleisin virhe, eikä Googlen oma virheviesti nimeä sitä. Mittaustunnus näyttää tältä: G-ABC123XYZ, sisältyy seurantakoodikatkelmaan ja näkyy kaikkialla. Omaisuuden tunnus on vain numeroita ja näkyy ainoastaan hallinnassa kohdassa Järjestelmänvalvoja, Omaisuuden asetukset. Jälkimmäinen tarvitaan; ensimmäisen hylkäämme huomautuksella 400-virheen sijaan.

Palvelutilin luonti ja valtuutus

Luo Google Cloud Consolessa palvelutili ja JSON-avain.
Ota samassa projektissa käyttöön Google Analytics Data API.
Lisää GA4:n kohdassa Järjestelmänvalvoja, Omaisuuden käyttöoikeuksien hallinta palvelutilin sähköpostiosoite rooliin Katselija. Palvelutili on oma käyttäjänsä; ilman tätä vaihetta Google vastaa 403 kertomatta syytä.

Liitä JSON-tiedoston sisältö kenttään. Se säilytetään salattuna ja näytetään jatkossa vain lyhennettynä.

3. Tapa 2: BigQuery-tuonti

Tämä tapa lukee GA4:n raakaviennin. Määritä se kerran GA4:n kohdassa Järjestelmänvalvoja, BigQuery-linkitykset. Taulut näkyvät vasta seuraavasta päivästä — sitä ennen tuonti ei löydä mitään, eikä kyse ole virheestä.

Täytettävät tiedot

Anna GCP-projektitunnus projektille, jossa vienti sijaitsee. Se ei välttämättä ole sama projekti kuin MousePlayer-tietojen vientikohde.
Anna tietojoukon tunnus. GA4 antaa sille nimen analytics_<propertyId>.
Palvelutilin avain, jolla on rooli BigQuery Data Viewer tietojoukossa ja BigQuery Job User projektissa. Lukuoikeus riittää; älä myönnä enempää.

Kustannukset ja maksaja

BigQuery laskuttaa luetut tavut, ja lasku on oma. Siksi tuonti lukee vain muutaman päivän ajoa kohti ja suorittaa vain yhden kyselyn — toinen lukisi samat taulut uudelleen. Lisäksi kova raja keskeyttää kyselyn ennen sen kallistumista; toimituslokin viesti kertoo silloin liian suuresta aikaikkunasta.

Ajotiheys

Oletuksena kuuden tunnin välein, ja joka ajo hakee viimeiset kolme päivää uudelleen. Tämä ei ole satunnaista: GA4 täydentää tietoja jopa 48 tuntia ja päivävienti näkyy vasta seuraavana päivänä. Tiheämpi kysely ei tuo tuoreempia lukuja, vain samat.

4. Molemmat puolet yhdistävä avain

Jos myös analytiikkasilta asetetaan GA4-tilaan, MousePlayer tallentaa jokaisen istunnon mukana tunnuksen evästeestä _ga. Sama arvo kulkee BigQuery-viennissä nimellä user_pseudo_id.

Sillä GA4-istunto voidaan yhdistää tallenteeseen — ja toisinpäin nähdä, mitä GA4 laski samalla käynnillä. Ilman siltaa tiedot ovat vain rinnakkain ilman yhteyttä.

Samassa kentässä on myös oma asiakastunnus, jos käytössä on setUserId(). Molempia ei voi olla: kentässä on joko Googlen asiakastunnus tai oma numero.

5. Suostumus, säilytys ja poistaminen

Tuodulla tiedolla oli eväste

Vain rivit, joilla on user_pseudo_id, tuodaan. Kävijän kieltäytyessä GA4 lähettää Consent Modessa evästeettömiä osumia ilman sitä — joten ne jäävät pois ilman erillisiä vakuutteluja. Mallinnetut eli arvioidut rivit jätetään pois samasta syystä: arvion tallentaminen istunnoksi tarkoittaisi toteutumattomien käyntien tallennusta.

Säilytysaika

Oletuksena 180 päivää rivin kuvaamasta päivästä, ei tuontihetkestä. Muuten aika ei koskaan päättyisi, koska jokainen ajo hakee samat päivät uudelleen.

Poistaminen

Jos kävijä pyytää tietojensa poistoa, myös tuodut GA4-istunnot poistetaan siltä osin kuin ne voidaan kohdistaa yllä olevalla tunnuksella. Projektin poisto poistaa ne joka tapauksessa, myös rivit, jotka eivät koskaan kuuluneet tallenteisiin. Päivittäinen säilytysajo jättää ne tarkoituksella rauhaan: GA4-tiedoilla on oma aikansa ja tallenteet vanhenevat aiemmin.

6. Kun mitään ei saavu

Jokainen ajo kirjoittaa tuloksensa integraatiosivun toimituslokiin — myös virheet selvin sanoin. Se yleensä kertoo jo puuttuvan asian.

Viesti	Toimenpide
Omaisuuden tunnuksessa saa olla vain numeroita	Annoit mittaustunnuksen. Oikea numero löytyy GA4:n Omaisuuden asetuksista.
HTTP 403 Data API -rajapinnasta	Palvelutili ei ole GA4-omaisuuden Katselija tai Data API ei ole käytössä GCP-projektissa.
Tietojoukkoa tai vientitauluja ei löytynyt	BigQuery-linkitys puuttuu, tietojoukon nimi on eri tai päivää ei ole vielä kulunut.
Pääsy estetty (BigQuery)	Palvelutililtä puuttuu BigQuery Data Viewer tietojoukossa tai BigQuery Job User projektissa.
Kysely olisi lukenut liikaa	Kustannusraja keskeytti ennen veloitusta. Valitse pienempi aikaikkuna.
ei istuntoja aikaikkunassa	Ei virhe. Haetuilla päivillä ei ollut suostumuksen sisältäviä istuntoja.

Miten voimme auttaa?