Syväanalyysi · 11 min lukuaika

Tilauksen katteen tuonti Google Adsiin, kun kauppa ei tallenna klikkaustunnistetta

Verkkokauppasi ei tallenna Googlen klikkaustunnusta tilauksiin. Hae tunniste GA4:n BigQuery-viennistä ja lähetä kate Google Adsiin API:n kautta.

Keittiömestari asettelee pientä annosta lautaselle, jossa lukee Margin. Hänen takanaan kokki pitelee ylitäyttä lautasta, jossa lukee Revenue, ja joku torjuu sen. Pieni tarjoilijarobotti, jonka kyltissä lukee Google Ads, odottaa tiskillä.
Vakavat faktat ovat aitoja — artikkelien kannet eivät.

Lyhyesti: Tavallinen tilausten API-tuonti Google Adsiin vaatii tilaukseen tallennetun Googlen klikkaustunnuksen. Valmis verkkokauppa-alusta ei usein tallenna sitä. Sinun ei tarvitse tallentaa sitä kaupassa. GA4:n BigQuery-vienti sisältää jo klikkaustunnisteen jokaisen mainoksesta tulleen vierailun yhteydessä. Yhdistät tilaukset klikkauksiin BigQueryssä. Sitten lähetät Data Manager API:n kautta katteen jokaisesta tilauksesta, jonka tietojen käyttöön on saatu suostumus. Lähetät mukana klikkaustunnisteen tai sähköpostiosoitteen ja puhelinnumeron tiivisteet. Lähetät peruutukset Google Ads API:n kautta. Mikään ei muutu verkkosivustolla.

Ilmainen lataus

Haluatko ohjeistuksen Claude Codelle heti?

Claude Code tai kehittäjä kirjoittaa koko tuonnin tästä ohjepaketista. Jätä sähköpostisi ja tiedosto on sinun. Voit myös jatkaa lukemista.

Yksi tiedosto, yksi lista. Kirjoitan vain kun on jotain lukemisen arvoista.

Google Ads optimoi kampanjat verkkosivuston tagin ilmoittaman myyntitulon perusteella. Myyntitulo ei ole voittoa. Useimmat kaupat myyvät oman tuotemerkkinsä tuotteita tavarantoimittajien tuotteiden ohella. Kokemukseni mukaan näiden tuotteiden kate vaihtelee karkeasti 20 %:sta 60 %:iin. Kun hintatarjouksissa käytetään myyntituloa, kaksi saman myyntitulon tilausta saa saman arvon, vaikka toisella olisi matala ja toisella korkea kate. Lisäksi peruutusten osuus tilauksista on tavallisesti 3:n ja 10 prosentin välillä. Verkkosivuston tagi ei tallenna peruutuksia. Konversio säilyttää siten täyden arvonsa.

Et halua lähettää katetta verkkosivuston tagin kautta. Kuka tahansa voi lukea tagin tiedot selaimessa. Tämä koskee myös kilpailijoitasi. Siksi kate menee Google Adsiin API:n kautta.

Tavallinen API-tuonti tarvitsee jokaisen tilauksen Googlen klikkaustunnuksen. Valmiilla alustalla, kuten Shopifyssa tai Shoptetissa, et voi vaikuttaa siihen, miten kassa tallentaa tilauksen. Tilauksella ei ole klikkaustunnistekenttää. Esimerkiksi Shopify tallentaa vain asiakkaan ensimmäisen ja viimeisen vierailun aloitussivun. Aloitussivun osoite saattaa sisältää klikkaustunnisteen, mutta vain jos kävijä on sallinut seurannan. Ilman erikseen kirjoitettua koodia tai tunnisteen tallentavaa sovellusta ei voi luottaa siihen, että tilauksella on klikkaustunniste. Sinun ei tarvitse tallentaa sitä kaupassa. GA4:n BigQuery-vienti tallentaa jo klikkaustunnisteen jokaisen mainoksesta tulleen vierailun yhteydessä.

Tärkeimmät kohdat tl;dr
  • Mitä tarkalleen lähetät. Lähetät jokaisesta tilauksesta tilausnumeron, katteen arvona, ajan, klikkaustunnisteen, sähköpostiosoitteen ja puhelinnumeron tiivisteet, suostumuksen sekä tiedon uudesta tai palaavasta asiakkaasta.
  • Peruutukset menevät vanhemman Google Ads API:n kautta. Uudempi Data Manager API ei voi perua konversiota. Uudet tilaukset ja katteen muutokset menevät Data Manager API:n kautta.
  • Lähetä jokainen tilaus, jonka tietojen käyttöön on saatu suostumus, vaikka klikkaustunniste puuttuisi. Jos tilauksella ei ole Googlen klikkaustunnusta, lähetä sen mukana sähköpostiosoitteen ja puhelinnumeron tiivisteet. Google yhdistää osan niistä laajennettujen konversioiden kautta.
  • Klikkaustunniste saadaan GA4:n BigQuery-viennistä. Kauppaan ei siis tallenneta mitään uutta. Vienti on ilmainen. BigQuery maksaa tyypilliselle kaupalle muutaman dollarin kuukaudessa.

Mitä tarvitset

  • GA4 kaupan verkkosivustolla. Sen täytyy tallentaa ostot tilausnumeroineen.
  • kaupan tilaukset ja niiden tuotteiden ostohinnat tilausviennistä, alustan API:sta tai tietokannasta.
  • Google Cloud -projekti.
  • järjestelmänvalvojan pääsy Google Ads -tilille.
  • paikka yhden päivittäisen ajon suorittamiseen.

Kenenkään ei tarvitse muuttaa verkkosivustoa tai kassaa. Klikkaustunniste saadaan sivustolla jo toimivasta GA4:stä. Kate tulee kaupan jo säilyttämistä tilaustiedoista. Valmiiden alustojen tilausvienti sisältää yleensä tuotteiden ostohinnat. Tarkista tämä kuitenkin oman alustasi kohdalla.

Vaihe 1: Luo Google Cloud -projekti

Esitän Google Cloud -konsolin sivujen ja painikkeiden nimet englanniksi. Yksi Cloud-projekti sisältää GA4-viennin ja antaa pääsyn molempiin API-rajapintoihin. Jos GA4 vie jo tietoja projektiin, käytä sitä.

  1. Jos sinulla ei ole vielä laskutustiliä, avaa Billing Google Cloud -konsolissa ja luo sellainen. Uusi laskutustili on aluksi ilmaisessa kokeilussa.
  2. Avaa laskutustilin Overview-sivu. Jos siellä lukee Free trial account, klikkaa Activate siellä tai konsolin Welcome-sivulla ja vahvista valinta.
  3. Avaa Manage resources, klikkaa Create project, syötä nimi ja valitse kyseinen laskutustili. Henkilökohtaisella tilillä organisaation valintana on No organization. Klikkaa Create.
  4. Avaa APIs & Services -kohdassa Library, etsi BigQuery API ja klikkaa Enable. Tee sama rajapinnoille Data Manager API ja Google Ads API.

Projekti tarvitsee maksullisen laskutustilin. Googlen nykyisten ohjeiden mukaan Google Ads API:n käyttöoikeushakemus hylätään, jos projektin laskutustili on ilmaisessa kokeilussa, jäädytetty tai poistettu käytöstä. Ilman laskutustiliä BigQuery toimii hiekkalaatikkona. Hiekkalaatikon taulukot vanhenevat 60 päivän kuluttua.

GA4-vienti itsessään on ilmainen. BigQuery veloittaa tallennuksesta ja kyselyistä. Kokemukseni mukaan tämä maksaa tyypilliselle kaupalle muutaman dollarin kuukaudessa. Näet todellisen summan avaamalla Billing-sivun. Valitse laskutustili, avaa Reports ja rajaa raportti tähän projektiin.

Tarkistus. Enabled APIs & services -sivulla näkyvät kaikki kolme API:a.

Vaihe 2: Laita GA4:n BigQuery-vienti päälle

Tässä vaiheessa saat Googlen klikkaustunnuksen muuttamatta mitään kaupassa. Tee se ajoissa. Vienti sisältää vain linkityksen jälkeiset päivät. Googlen ohje ei kuvaa tapaa viedä aiempia päiviä.

Tarvitset GA4-mittauskokonaisuuden Muokkaaja-roolin ja Cloud-projektin Omistaja-roolin. Tarkista Google Adsissa automaattisen taggauksen tila. Se löytyy kohdasta Järjestelmänvalvoja, Tilin asetukset, Automaattinen taggaus. Ilman sitä mainosklikkaukset eivät sisällä Googlen klikkaustunnusta. Jos se on pois päältä, rasti Taggaa URL-osoite, jota ihmiset klikkaavat mainoksestani ja klikkaa Tallenna.

  1. Avaa GA4:ssä Järjestelmänvalvoja. Klikkaa Tuotelinkit-kohdasta BigQuery-linkit ja sitten Linkitä.
  2. Klikkaa Valitse BigQuery-projekti, valitse vaiheen 1 projekti ja klikkaa Vahvista.
  3. Valitse datan sijainti. Valitse EU-kaupalle joko EU:n kattava usean alueen sijainti tai jokin EU:ssa sijaitseva yksittäinen alue. Laita se muistiin. Tuonnin kyselyt ja tilatietoja tallentavat taulukot käyttävät samaa sijaintia. Jos projektilla on jo datajoukko tälle mittauskokonaisuudelle, sijainti on kiinteä. Sitä ei voi muuttaa. Klikkaa Seuraava.
  4. Klikkaa Määritä datastriimejä ja tapahtumia, valitse kaupan verkkostriimi ja klikkaa Valmis.
  5. Jätä Sisällytä mobiilisovellusstriimien mainostunnukset pois päältä. Verkkokauppa ei tarvitse sitä.
  6. Valitse Päivittäin ja jätä Striimaus pois päältä.
  7. Klikkaa Seuraava ja sitten Lähetä.

Päivittäinen vienti riittää. Tuonti lukee päivittäisiä taulukoita events_YYYYMMDD. Striimaus lisää kuluvan päivän datan minuuteissa. Päivittäinen ajo ei käytä sitä. Striimaus maksaa myös ylimääräistä.

Miljoonan tapahtuman raja. Tavallinen GA4-mittauskokonaisuus voi viedä miljoona tapahtumaa päivässä Päivittäin-asetuksella. Jos mittauskokonaisuus ylittää rajan toistuvasti, Google keskeyttää viennin. Google ei vie puuttuvien päivien tietoja jälkikäteen. Jos olet lähellä rajaa, sulje pois tarpeettomat tapahtumat datastriimien ikkunassa. Näitä voivat olla scroll tai user_engagement. Säilytä purchase, page_view ja session_start. Ne sisältävät tilaustiedot, aloitussivun ja klikkaustunnisteen. Jos tämä ei riitä, Striimaus-vaihtoehdolla ei ole rajaa. Se vaatii kuitenkin tuonnin mukauttamista. Googlen ohje ehdottaa myös päivitystä Analytics 360 -versioon.

Ensimmäiset viikot. Linkityspäivää edeltävät klikkaukset eivät ole BigQueryssä. Ensimmäisen 30 päivän aikana tuonti lähettää siksi tavallista enemmän tilauksia, joiden mukana on vain sähköpostiosoitteen ja puhelinnumeron tiivisteet.

Tarkistus. Datan pitäisi alkaa saapua 24 tunnin kuluessa BigQuery-datajoukkoon analytics_<property ID>. Sinne lisätään joka päivä taulukko edellisen päivän datasta. Tämä tapahtuu yleensä varhain iltapäivällä mittauskokonaisuuden aikavyöhykkeellä. Joskus se tapahtuu myöhemmin samana tai seuraavana päivänä.

Vaihe 3: Määritä pääsy molempiin API-rajapintoihin

Uudet tilaukset ja katteen muutokset menevät Data Manager API:n kautta. Peruutukset menevät vanhemman Google Ads API:n kautta. Data Manager API ei voi perua konversiota. Molemmat käyttävät samaa projektia ja samaa sisäänkirjautumista.

Olen kirjoittanut koodia Google Ads API:a vasten kaksitoista vuotta. Vuonna 2026 sen käyttöoikeudet muuttuivat. Google lakkautti kehittäjätunnukset 9. syyskuuta 2026. Pääsy kuuluu nyt Cloud-projektiin. Uuden projektin käyttöoikeustaso on aluksi Test. Sillä voi käyttää vain testitilejä. Varsinaisen Google Ads -tilisi käyttö edellyttää Explorer-tasoa.

  1. Avaa Cloud-konsolissa Google Ads API Overview -sivu. Tarkista, että käyttöoikeustaso on Test.
  2. Laajenna Upgrade access level ja tarkista, että seuraava taso on Explorer.
  3. Klikkaa Apply for access, täytä lyhyt lomake ja odota Googlen vastausta sähköpostitse. Overview-sivu näyttää Explorer-tason vasta hyväksynnän jälkeen.

Explorer-tasolla voit tehdä 2 880 toimintoa päivässä varsinaisilla Google Ads -tileillä. Explorer-taso ei vaadi brändin vahvistusta. Google hyväksyy Explorer-hakemuksen useimmiten automaattisesti. Yksi dokumentoitu hylkäyksen syy on se, että laskutustili on ilmaisessa kokeilussa, jäädytetty tai poistettu käytöstä. Tarkista syy sähköpostista. Korjaa laskutustili, odota muutama minuutti ja hae Explorer-tasoa uudelleen.

Sisäänkirjautuminen. Määritä käyttäjätilille OAuth Cloud-konsolin kohdassa Google Auth Platform.

  1. Täytä Branding-sivulla sovelluksen nimi, käyttäjätuen sähköpostiosoite ja kehittäjän sähköpostiosoite yhteydenottoja varten. Klikkaa sitten Create.
  2. Klikkaa Data Access -sivulla Add or remove scopes. Lisää Data Manager API, Google Ads API ja BigQuery API. Tuonti käyttää samaa sisäänkirjautumista GA4-viennin lukemiseen. Klikkaa Update ja sitten Save.
  3. Valitse Audience-sivulla Internal vain, jos Cloud-projekti kuuluu Google Workspace -organisaatioosi ja jokainen käyttäjä kuuluu tähän organisaatioon. Valitse muuten External ja klikkaa Publish app. Näin tila on In production.

Älä koskaan jätä sovellusta Testing-tilaan. Googlen Data Manager -oppaassa Testing-tilaa käytetään kehitystyössä. Testing-tilassa tehdyn kirjautumisen tunnistetiedot vanhenevat 7 päivän kuluttua. Päivittäinen ajo pysähtyy viikon kuluttua. Tästä ei tule ilmoitusta, ellei ajolle ole asetettu virheilmoituksia. Julkaistu sovellus, jota Google ei ole vahvistanut, näyttää varoituksen vahvistamattomasta sovelluksesta kerran ensimmäisellä kirjautumiskerralla. Jos käytät sovellusta itse, klikkaa Advanced ja jatka. Varoitus ei tarkoita minkään olevan vialla.

Luo tunnistetiedot.

  1. Jos tuonti ajetaan palvelimella tai omalla tietokoneellasi, luo Desktop app -tyyppinen OAuth-asiakas Clients-sivulla. Lataa sen JSON. Google Apps Script kirjautuu sisään itse skriptin kautta eikä tarvitse tätä tiedostoa.
  2. Anna JSON tuonnin rakentajalle (vaihe 5). Tuonnin rakentaja kirjautuu JSONin avulla sisään kerran. Tämä tuottaa tallennetut tunnistetiedot, jotka tuonti uusii automaattisesti.

Palvelimella voit käyttää sen sijaan palvelutiliä. Luo palvelutili ja anna sille projektissa roolit Service Usage Consumer ja BigQuery Job User. Anna sille GA4-datajoukossa rooli BigQuery Data Viewer ja tuonnin omassa datajoukossa rooli BigQuery Data Editor. Lisää sitten palvelutilin sähköpostiosoite Google Adsiin seuraavien ohjeiden mukaan.

Lisää sitten tili Google Adsissa kohdassa Järjestelmänvalvoja, Pääsyoikeudet ja suojaus. Käytä plus-painiketta ja valitse pääsyoikeustasoksi Normaali. Klikkaa henkilön kohdalla Lähetä kutsu. Henkilö hyväksyy sen. Syötä palvelutilin sähköpostiosoite ja klikkaa Lisää tili ilman kutsua. Käytä yrityksessä pysyvää tiliä. Tuonti pysähtyy, kun tili poistetaan.

Tarkistus. Overview-sivu näyttää Explorer. Vaiheessa 6 testaat molemmat rajapinnat. Teet validateOnly-kutsun Data Manageriin ja testiperuutuskutsun Google Ads API:in.

Vaihe 4: Luo konversiotapahtuma katteelle

Luo katteelle erillinen tuontityyppinen konversiotapahtuma. Tässä laitat päälle myös laajennetut konversiot. Niiden avulla Google voi yhdistää tilauksia, joilta puuttuu klikkaustunniste.

  1. Klikkaa Google Adsissa Tavoitteet, sitten Konversiot ja sitten Yhteenveto.
  2. Klikkaa + Luo konversiotapahtuma ja valitse Offline-konversiot.
  3. Kun sinulta kysytään datalähdettä, valitse Ohita tämä vaihe ja ota datalähde käyttöön myöhemmin. Tuonti lähettää datan API:n kautta.
  4. Määritä sitten itse tapahtuma ohjatussa toiminnossa. Valitse Osto-kategoria, nimeä tapahtuma, klikkaa Tallenna ja jatka ja päätä klikkaamalla Hyväksy ja viimeistele.

Googlen ohje sanoo, ettei uusi offline-tapahtuma ole aktiivinen ennen datalähteen yhdistämistä. Käytännössä API-lataus on tämä lähde. Vaiheen 6 kymmenen tilauksen testi on todiste tästä. Jos tapahtuma ei näytä arvoa seuraavana päivänä, avaa tapahtuma. Klikkaa Muokkaa datalähteitä ja tarkista ne.

Avaa tapahtuma, klikkaa Muokkaa asetuksia ja aseta nämä:

  • Valitse Arvo-kohdassa Käytä eri arvoja kullekin konversiolle. Muuten Google käyttää oletusarvoa katteesi sijaan. Kenttä vaatii silti oletusarvon. Syötä jokin pieni arvo. Google käyttää sitä vain, kun tapahtuma ei sisällä arvoa.
  • Valitse Määrä-kohdassa Jokainen. Jokainen tilaus on erillinen myynti.
  • Aseta Klikkauskonversioikkuna 90 päivään. Näin mukaan lasketaan myös tilaukset, joiden mainosklikkaus tapahtui viikkoja aiemmin.
  • Valitse Attribuutiomalli-kohdassa Dataan perustuva, jos se on tarjolla. Valitse se tai säilytä se, jos se on jo asetettu.

Klikkaa Tallenna. Avaa sitten Yhteenveto-näkymässä katetapahtuman rivi ja klikkaa Muokkaa tavoitetta. Valitse Konversiotapahtuman optimointi -kohdasta Toissijainen (vain havainnointi) ja klikkaa Tallenna. Näin kate ei vaikuta hintatarjousten tekemiseen ennen kuin tarkistat sen. Jos kampanja käyttää omaa tavoitetta, sen hintatarjoukset perustuvat kaikkiin tavoitteen konversiotapahtumiin. Tämä koskee myös toissijaisia tapahtumia. Älä siis lisää katetta mittaavaa konversiotapahtumaa omiin tavoitteisiin.

Laajennettuja konversioita varten klikkaa Tavoitteet ja sitten Asetukset. Laajenna Asiakasdatan käyttö, valitse Laita laajennetut konversiot päälle ja klikkaa Hyväksy ja tallenna. Tarkista sitten asiakasdatan ehdot ja klikkaa Hyväksy ja jatka. Ilman näiden ehtojen hyväksymistä Google ei käytä sähköpostiosoitteen ja puhelinnumeron tiivisteitä.

Kopioi tapahtuman tunnus sen Tiedot-välilehdeltä, kohdasta Konversiotyypin tunnus. Laita muistiin myös tapahtuman omistavan Google Ads -tilin 10-numeroinen tunnus. Google suosittelee odottamaan ennen ensimmäistä latausta 4:stä 6:een tuntia. Seuraava päivä on siksi kätevä aika ensimmäiselle lähetykselle.

Tarkistus. Tapahtuman konversiolähde on Verkkosivusto (importoi klikkauksista). Laajennetut konversiot on rastittu Asiakasdatan käyttö -kohdassa.

Ilmainen lataus

Kirjoituta koodi ohjepaketista

Tilauksen ja klikkauksen yhdistävä kysely, katteen laskenta ja päivittäiset korjaukset ovat yhdessä tiedostossa Claude Codelle tai kehittäjälle. Jätä sähköpostisi ja tiedosto on sinun.

Yksi tiedosto, yksi lista. Kirjoitan vain kun on jotain lukemisen arvoista.

Vaihe 5: Etsi mainosklikkaus jokaiselle tilaukselle BigQueryssä

Tästä eteenpäin Claude Code tai kehittäjä rakentaa tuonnin ohjepaketin pohjalta. Alla olevat vaiheet kertovat, mitä tuonti tekee ja mitä sinä tarkistat.

Tämä vaihe korvaa klikkaustunnisteen tallentamisen kaupassa. Yhdistät jokaisen tilauksen sen vierailuun GA4-viennissä.

Etsi GA4-osto, jonka ecommerce.transaction_id vastaa kaupan tilausnumeroa. Vertaa niitä tekstinä ja poista vain alussa ja lopussa olevat välilyönnit. Vierailu tunnistetaan kenttien user_pseudo_id ja ga_session_id muodostaman parin avulla. Ota oston sisältävältä vierailulta viimeisin ennen ostoa tallennettu Googlen klikkaustunnus tai wbraid. Jos vierailulla ei ole kumpaakaan, etsi saman kävijän aiemmat vierailut user_pseudo_id-tunnisteen avulla. Hae vierailut enintään 30 päivän ajalta ennen ostoa ja ota niistä viimeisin klikkaustunniste. Jos yksi tapahtuma sisältää molemmat, käytä Googlen klikkaustunnusta.

Googlen klikkaustunnus on kentässä collected_traffic_source.gclid. wbraid on iPhonen klikkaustunniste. Jos viennin page_location-kentässä oleva sivun URL-osoite sisältää wbraid-parametrin, kysely lukee sen sieltä. Tarkista tämä datastasi.

Ohjepaketissa on koko kysely, joka huomioi myös myöhemmin saapuvat tapahtumat.

Tarkistus. Ota kaupasta viisi tilausta, joiden GA4-osto on viennin kattamalta ajalta. Kyselyn täytyy löytää kyseinen osto jokaiselle. Tilausnumeroiden täytyy täsmätä merkki merkiltä. Sama kysely näyttää, kuinka monelle ostolle se löytää klikkaustunnisteen.

Vaihe 6: Lähetä tilaukset katteineen Data Manager API:in

Tässä vaiheessa lähetät jokaisen tilauksen täydet tiedot Data Manager API:n kautta menetelmällä events:ingest. Yksi pyyntö voi sisältää enintään 2 000 tilausta.

Kate on tilauksen bruttokate ilman arvonlisäveroa. Ota tuotteiden hinnat tuotealennusten jälkeen. Kerro kunkin tuotteen hinta asiakkaan pitämien kappaleiden määrällä. Vähennä mahdollinen tilausalennus ja asiakkaan pitämien tuotekappaleiden ostohinnat. Jätä toimitus- ja maksukulut pois. Älä käsittele puuttuvaa ostohintaa nollana. Älä lähetä tällaista tilausta ennen kuin sen tuotteiden ostohinnat ovat tiedossa.

Jokainen tapahtuma sisältää nämä kentät:

  • transactionId, tilausnumero
  • conversionValue ja currency, kate ja sen valuutta
  • eventTimestamp, tilausaika ja aikavyöhykkeen UTC-poikkeama
  • eventSource, WEB
  • adIdentifiers, Googlen klikkaustunnus tai wbraid vaiheesta 5
  • userData, sähköpostiosoitteen ja puhelinnumeron tiivisteet
  • consent, adUserData myönnettynä
  • userProperties.customerType, NEW tai RETURNING, jos asiakastyyppi selviää kaupan aiemmista tilauksista
{
  "transactionId": "ORDER-EXAMPLE-000",
  "eventTimestamp": "2026-01-01T12:00:00+01:00",
  "eventSource": "WEB",
  "conversionValue": 123.45,
  "currency": "EUR",
  "adIdentifiers": { "gclid": "INVALID-EXAMPLE-CLICK-ID" },
  "userData": {
    "userIdentifiers": [
      { "emailAddress": "sha256-hex-of-the-normalised-email" },
      { "phoneNumber": "sha256-hex-of-the-e164-phone-number" }
    ]
  },
  "consent": { "adUserData": "CONSENT_GRANTED" },
  "userProperties": { "customerType": "NEW" }
}

Kaikki esimerkin arvot ovat keksittyjä. Esimerkki on yksi tapahtuma, ei kokonainen pyyntö. Tuonti sisällyttää tapahtuman pyyntöön yhdessä kohdetietojen ja koodauksen kanssa. Kohdetietoihin kuuluvat konversiotapahtuman omistavan tilin tunnus ja konversiotapahtuman tunnus. Normalisoi sähköpostiosoite ja puhelinnumero Googlen muotoilusääntöjen mukaisesti. Tiivistä ne SHA-256-algoritmilla ja aseta pyynnön encoding-kentän arvoksi HEX.

Lähetä jokainen tilaus, jonka tietojen käyttöön on saatu suostumus, vaikka klikkaustunniste puuttuisi. Tuonti lähettää jokaisen tuontiin soveltuvan tilauksen, jonka tietojen käyttöön on saatu suostumus ja jolla on vähintään yksi tunniste (klikkaustunniste, sähköpostiosoite tai puhelinnumero). Jos tilauksella ei ole klikkaustunnistetta, tuonti lähettää sen mukana sähköpostiosoitteen tiivisteen, puhelinnumeron tiivisteen tai molemmat. Google yhdistää osan näistä tilauksista laajennettujen konversioiden kautta, ei kaikkia. Et voi tietää etukäteen, mitkä niistä yhdistyvät. Tilausta, jolla ei ole klikkaustunnistetta, tiivistettyä sähköpostiosoitetta eikä tiivistettyä puhelinnumeroa, ei voi yhdistää. Jätä tällainen tilaus siis lähettämättä.

Suostumus. Lähetä tilaus vain, kun sille on tallennettu ad_user_data-suostumus. Älä koskaan merkitse puuttuvaa suostumusta evätyksi lähetettävissä tiedoissa. GA4-vienti sisältää vain kentän privacy_info.ads_storage. Käytä sitä vain, jos evästebannerissasi myönnetään aina ad_storage- ja ad_user_data-luvat yhdessä. Tarkistat tämän Tag Assistantissa. Ota muuten suostumus kaupan omista tiedoista. Kaupan on arvioitava, onko tämä juridisesti riittävää.

Ensimmäinen lähetys. Tuonti voi lähettää tilauksen, kun tilauspäivän GA4-päivätaulukko on olemassa. Tämä on vasta ensimmäinen ehto. Tuonti soveltaa myös paketin odotussääntöjä.

  1. Lähetä yksi erä Data Manageriin validateOnly-arvolla true. Lähetä myös yksi peruutuskutsu Google Ads API:in samalla validateOnly-arvolla. Google tarkistaa ne eikä tallenna mitään.
  2. Lähetä kymmenen oikeaa tilausta. Suosi tuoreita tilauksia, joilla on Googlen klikkaustunnus. Tarkista seuraavana päivänä, että pyyntö päättyi tilaan SUCCESS. Tarkista myös, että katetapahtuma näyttää niiden arvon sarakkeessa “Kaikkien konv. arvo”. Toissijaiset konversiotapahtumat eivät näy tavallisissa Konversiot-sarakkeissa. Arvot ovat tilin valuutassa. Jos voit perua yhden näistä kymmenestä tilauksesta, peru se myös (vaihe 7).
  3. Ajasta sitten tuonti päivittäiseksi ja ota virheilmoitukset käyttöön.

Vastaus events:ingest-kutsuun tarkoittaa vain, että Google hyväksyi pyynnön. Tuonti säilyttää jokaisen pyynnön tunnuksen ja lukee pyynnön tuloksen seuraavalla ajolla (Google tarvitsee 30 minuutista 24 tuntiin).

Vaihe 7: Lähetä katteen muutokset ja peruutukset joka päivä

Tuonti vertaa joka päivä jokaisen lähetetyn tilauksen tietoja kaupan ajantasaisiin tilaustietoihin.

Katteen muutos. Lähetä tallennettu tapahtuma Data Manager API:in uudelleen. Käytä samaa tilausnumeroa, tunnisteita ja kohdetta. Lisää uusi arvo ja tämän päivän suostumus. Jos asiakas perui suostumuksensa, älä lähetä uudelleen. Dokumentaation mukaan Google korvaa arvon ja säilyttää konversiomäärän. Tarkista tämä ensimmäisen muutoksen jälkeen.

Peruutus. Lähetä se Google Ads API:n kautta. Menetelmä on UploadConversionAdjustments ja tyyppi RETRACTION. Älä lähetä arvoa. Googlen ilmoituksessa Google Ads API:n osien sulkemisesta mainitaan vain konversioiden lataaminen. Peruutukset menivät Google Ads API:n kautta kirjoitushetkellä. Tarkista ensimmäisellä peruutuksella, että se toimii myös projektissasi.

Älä koskaan lähetä nollaa tai negatiivista arvoa. Googlen ohje konversiomuutoksista sanoo, että arvo 0 peruu konversion lopullisesti. Peruutusta ei voi kumota. Data Manager API:n toimintaa ei ole dokumentoitu tilanteessa, jossa arvo on nolla. Älä siis koskaan lähetä nollaa tai negatiivista arvoa. Jos tilauksen kate putoaa nollaan tai sen alle, lähetä peruutus.

Ajoitus. Lähetä peruutus vähintään 24 tuntia konversion jälkeen ja 54 päivän sisällä. Googlen ohjeen mukaan yli 7 päivää konversion tallentamisen jälkeen saapuvaa korjausta ei käytetä hintatarjousten tekemiseen. Lähetä korjaukset siis päivittäin.

Rajoitukset. Muutokset Google Ads API:ssa eivät toimi wbraid-tunnisteella. Vain wbraid-tunnisteella lähetetyn tilauksen konversiota ei siis voi perua. Tuonti merkitsee tällaisen peruutuksen ratkaisemattomaksi ja tallentaa syyksi wbraid. Googlen Data Manager API:n dokumentaatiossa ei mainita tällaista katteen muutosten rajoitusta. Tarkista kuitenkin tililtä ensimmäisen katteen muutoksen tulos. Älä koskaan lähetä tilausta Data Manager API:in uudelleen, kun sen perumista on yritetty. Google voisi tallentaa sen uutena konversiona, jota et voisi perua toista kertaa.

Vaihe 8: Tarkista toimivuus ja päätä hintatarjouksista

Tarkista ensimmäisellä viikolla neljä asiaa joka päivä:

  1. Katetapahtuma näyttää arvon sarakkeessa “Kaikkien konv. arvo (konv.ajan mukaan)”, ei vain määrää. Suodata tai segmentoi raportti konversiotapahtuman mukaan.
  2. Jokainen pyyntö päättyy tilaan SUCCESS. Lue myös varoitukset.
  3. Katetapahtuman “Kaikki konv. (konv.ajan mukaan)” vastaa karkeasti samoille päiville lähettämiesi tilausten määrää. Selvä ero on syy tutkia asiaa. Se ei ole todiste siitä, että tuonti lähetti tilauksen kahdesti.
  4. Google hyväksyy ensimmäisen peruutusrivin. Pääsyvirheen puuttuminen ei riitä.

Vertaa sitten katetapahtumaa verkkosivuston tagin tapahtumaan konversiopäivän mukaan. Käytä vain dataa päiviltä, jotka ovat vähintään 3 päivää vanhoja. Näiden kahden konversiotapahtuman konversiomäärät voivat poiketa toisistaan. Mittaa ero tililläsi.

Päätä erikseen, alatko käyttää katetta hintatarjousten perusteena. Tee se, kun arvot, peruutukset ja pyynnöt ovat kunnossa. Tee silloin katetapahtumasta ensisijainen. Tee samalla myyntituloa mittaavasta konversiotapahtumasta toissijainen ja poista se omista tavoitteista. Muuten jokainen osto lasketaan kahdesti. Tarkista myös, että jokainen kampanja käyttää katetapahtuman sisältävää tavoitetta. Laske myös tROAS-tavoite uudelleen. Kate on pienempi kuin myyntitulo.

Kaksi muuta tietoa, jotka lähetät jokaisen tilauksen mukana

Uusi tai palaava asiakas. Täytä userProperties.customerType (vaihe 6) kaupan tilaushistoriasta. Merkitse tilaus arvolla NEW, jos samalla sähköpostiosoitteella tai asiakastunnuksella ei ole viimeisen 540 päivän ajalta aiempaa tilausta, jota ei ole peruutettu. Google suosittelee tätä tarkastelujaksoa. Tilausviennin täytyy ulottua niin kauas taaksepäin. Jos et voi päätellä asiakastyyppiä, älä lähetä kenttää. Google käyttää tätä kenttää uusien asiakkaiden hankintatavoitteessa. Kun käytät katetapahtumaa kampanjoiden hintatarjousten määrittämiseen (vaihe 8), avaa Haku-, Performance Max-, Shopping- tai Demand Gen -kampanja ja klikkaa Kampanjan asetukset. Laajenna Asiakashankinta ja valitse Muokkaa hintatarjouksia saadaksesi uusia asiakkaita.

Tarkistus. Klikkaa Kampanjat-taulukossa Segmentti ja lisää Uudet vs. palaavat asiakkaat. Uusien ja palaavien asiakkaiden jakauman pitäisi vastata suunnilleen lähettämiäsi tietoja. Raportissa on tietoja siitä päivästä alkaen, kun otat tavoitteen käyttöön.

Omat muuttujasi. Oma muuttuja lisää jokaiseen konversioon tilaukseen liittyvän tiedon, esimerkiksi B2B tai B2C. Klikkaa ensin Google Adsissa Tavoitteet, sitten Konversiot, sitten Oma muuttuja ja plus-painiketta. Syötä pienillä kirjaimilla kirjoitettu nimi ja klikkaa Tallenna. Muuttujan tilan tulisi olla Käytössä. Tuonti lähettää sen nimen ja arvon tapahtuman kentässä customVariables. Google sivuuttaa muuttujan, jota ei ole tilillä, eikä näytä virhettä. Älä koskaan käytä sähköpostiosoitetta, puhelinnumeroa tai nimeä sen arvona. Google kuvaa dokumentaatiossaan omien muuttujien käyttöä raporteissa, ei hintatarjousten tekemisessä.

Tarkistus. Klikkaa Kampanjat-taulukossa Segmentti, valitse Konversiot, sitten Oma muuttuja ja valitse muuttujasi. Jokaisen arvon pitäisi näkyä omalla rivillään.

Ota mukaasi

Lataa ohjepaketti Claude Codelle

Ohjepaketissa on koko menettely Claude Codelle tai kehittäjälle. Se sisältää käyttöönoton tarkistukset, tilauksen ja klikkauksen yhdistävän kyselyn, tapahtuman rakenteen ja päivittäiset korjaukset. Se ei ole valmis ohjelma. Jätä sähköpostisi ja tiedosto on sinun.

Yksi tiedosto, yksi lista. Kirjoitan vain kun on jotain lukemisen arvoista.

Usein kysyttyä

Täytyykö kauppani tallentaa Googlen klikkaustunnus?

Ei. GA4:n BigQuery-vienti tallentaa klikkaustunnisteen jokaisen mainoksesta tulleen vierailun yhteydessä. Tuonti löytää sen sieltä tilausnumeron avulla. Kaupasta tarvitset vain tilaukset ja niiden tuotteiden ostohinnat.

Tarvitsenko kehittäjätunnuksen?

Ei. Google lakkautti kehittäjätunnukset 9. syyskuuta 2026. Data Manager API ei käytä sellaista. Pääsy Google Ads API:in kuuluu nyt Google Cloud -projektiin.

Tuoko tuonti näyttökonversioita?

Älä laske niiden varaan. Tuonnin konversiotapahtuma on klikkauspohjainen. Videoiden osalta Google dokumentoi vain jatkuneesta katselusta saadut konversiot. Ne täytyy ladata 14 päivän sisällä. Päivittäinen ajo täyttää tämän ehdon.

Mitä tehdä ensimmäiseksi

  1. Luo Cloud-projekti ja laita GA4:n BigQuery-vienti päälle tänään. Vienti ei sisällä aiempia tietoja. Laita se siis päälle mahdollisimman aikaisin.
  2. Tarkista Tag Assistantissa, että evästebannerissasi myönnetään ad_storage- ja ad_user_data-luvat yhdessä.
  3. Laske viiden tilauksen kate käsin. Näin näet, onko kaupassasi ostohinta jokaiselle tuotteelle.
Tämän kaiken pointti

Haluatko tämän tason näkyvyyden tilillesi?

Yksi sähköposti. Kerron rehellisesti, kannattaako se sinun setupissasi.

Ota yhteyttä →
Ilmainen lataus

Lataa ohjepaketti Claude Codelle

Ohjepaketissa on koko menettely Claude Codelle tai kehittäjälle. Se sisältää käyttöönoton tarkistukset, tilauksen ja klikkauksen yhdistävän kyselyn, tapahtuman rakenteen ja päivittäiset korjaukset. Se ei ole valmis ohjelma. Jätä sähköpostisi ja tiedosto on sinun.

Yksi tiedosto, yksi lista. Kirjoitan vain kun on jotain lukemisen arvoista.