GA4- ja Tag Manager -konversioseuranta

Kiilan upotus lähettää tapahtumat kolmeen paikkaan samanaikaisesti:

• Kiilan oma analytiikka — näkyy hallintapaneelin analytiikkanäkymissä ilman mitään asennusta.
• Sivustosi dataLayer — Google Tag Managerin Custom Event -triggereitä varten.
• Suora gtag()-lähetys — jos sivustolla on GA4 (gtag.js) ilman Tag Manageria, tapahtumat menevät GA4:ään automaattisesti. Jos Tag Manager on asennettu, Kiila havaitsee sen ja jättää suoran lähetyksen pois, jotta konversio ei kirjaudu kahteen kertaan.

Liiditapahtumat käyttävät GA4:n virallista suositusnimeä generate_lead, jolloin ne toimivat suoraan konversiotavoitteina ja Google Ads -tuonnissa. Alkuperäinen Kiilan tapahtumanimi kulkee mukana parametrissa kiila_event.

Tuleeko generate_lead GA4:ään ilman asennusta? Jos sivustolla on GA4:n gtag.js suoraan (ei pelkkä GTM), kyllä — Kiila lähettää tapahtuman automaattisesti. Jos GA4 on asennettu vain Tag Managerin kautta, ei: GTM ei tarjoa globaalia gtag-funktiota, joten Kiila voi vain pushata tapahtuman dataLayeriin. Silloin tarvitaan kertaluontoinen määritys (Vaihtoehto B): Custom Event -trigger kiila_generate_lead → GA4 Event -tagi.

Tuplakonversioiden esto on automaattinen. Kiila tunnistaa Tag Managerin (GTM) sivuston skripteistä ja jättää suoran gtag()-lähetyksen automaattisesti pois, kun GTM on asennettu — sinun ei tarvitse lisätä mitään koodia käsin. Poikkeus: jos GTM on asennettu mutta sieltä ei ole GA4-tagiä konversiolle ja haluat käyttää suoraa gtag.js:ää, pakota suora lähetys asettamalla ennen upotuskoodia window.KiilaForceGtag = true. Vastaavesti window.KiilaDisableGtag = true pakottaa suoran lähetyksen pois myös ilman GTM:ää (esim. muu tag manager).

1. 1Varmista, että sivustolla on GA4:n gtag.js -koodi (Google-tunniste G-XXXXXXX) ennen Kiilan upotuskoodia.
2. 2Ei muuta asennusta — Kiila havaitsee window.gtag:n ja lähettää tapahtumat automaattisesti.
3. 3Avaa GA4 → Ylläpito → Tapahtumat. Kun sivustolla on käyty ja chatista on jätetty yhteystieto, listalle ilmestyy generate_lead sekä muut Kiilan tapahtumat (24–48 h viive raporteissa, reaaliaika näkyy heti).
4. 4Merkitse generate_lead avaintapahtumaksi (Mark as key event) → se lasketaan konversioksi.

Jos sivustolla on sekä GTM-tagi että gtag.js, Kiila estää tuplakonversion automaattisesti: se havaitsee GTM:n eikä lähetä tapahtumaa suoraan gtag():lla. Mitään koodia ei tarvitse lisätä. Tarvittaessa voit silti pakottaa suoran lähetyksen pois asettamalla <script>window.KiilaDisableGtag = true;</script> tai takaisin päälle asettamalla window.KiilaForceGtag = true.

Jos GA4 on sivustollasi Tag Managerin kautta, tee nämä seitsemän askelta kerran. Sen jälkeen jokainen Kiilan kautta tullut liidi näkyy GA4:ssä tapahtumana generate_lead.

1. 1Mene osoitteeseen tagmanager.google.com, kirjaudu sisään ja avaa sivustosi säiliö (container).
2. 2Klikkaa vasemmalta Muuttujat → Käyttäjän määrittämät muuttujat → Uusi → valitse tyypiksi Tietokerroksen muuttuja (Data Layer Variable). Kirjoita Tietokerroksen muuttujan nimi -kenttään kiila_ga4_event ja nimeä muuttuja ylhäältä DLV - kiila_ga4_event. Paina Tallenna.
3. 3Klikkaa vasemmalta Aktivointisäännöt (Triggers) → Uusi → tyypiksi Mukautettu tapahtuma (Custom Event). Kirjoita tapahtuman nimeksi kiila_generate_lead. Nimeä sääntö ylhäältä esimerkiksi “Kiila – liidi” ja paina Tallenna.
4. 4Klikkaa vasemmalta Tagit → Uusi → tyypiksi Google Analytics: GA4-tapahtuma. Laita Measurement ID -kenttään oma GA4-tunnisteesi G-XXXXXXX. Klikkaa Tapahtuman nimi -kentän vieressä olevaa palikkakuvaketta ja valitse muuttuja DLV - kiila_ga4_event. Valitse aktivointisäännöksi “Kiila – liidi” ja paina Tallenna.
5. 5Paina oikeasta yläkulmasta Esikatselu, syötä oman sivustosi osoite, käy sivustolla chat-keskustelu ja jätä sähköposti tai puhelinnumero. Tag Assistant -ikkunassa pitää näkyä tapahtuma kiila_generate_lead ja tagisi kohdassa “Tags Fired”.
6. 6Palaa GTM:ään ja paina Lähetä → Julkaise. Ilman julkaisua muutokset eivät ole voimassa oikeilla kävijöillä.
7. 7Avaa GA4 → Ylläpito → Tapahtumat. Kun generate_lead ilmestyy listalle (voi kestää muutaman tunnin), laita sen kohdalta Merkitse avaintapahtumaksi päälle. Nyt liidit lasketaan konversioiksi.

Jos mikään ei näy:

• Onko Kiilan upotuskoodi varmasti sivulla, jolla testaat?
• Hyväksyitkö evästebannerista analytiikkaevästeet? Consent Mode estää lähetyksen ilman suostumusta.
• Painoitko GTM:ssä Julkaise — pelkkä Tallenna ei riitä.

1. 1Luo muuttujat. GTM → Variables → User-Defined → Data Layer Variable. Luo tarvitsemasi parametrit samalla nimellä kuin dataLayerissa, esim. conversation_id, source, form_slug, agent_id, kiila_event.
2. 2Luo trigger. Triggers → New → Custom Event. Event name: generate_lead. Halutessasi rajaa vain Kiilan liideihin ehdolla kiila_event matches RegEx goal_reached|form_lead_submitted.
3. 3Luo GA4-tagi. Tags → New → Google Analytics: GA4 Event. Measurement ID = GA4-tunnisteesi, Event Name = generate_lead. Lisää Event Parameters -kohtaan vaiheessa 1 luodut muuttujat.
4. 4Liitä trigger tagiin ja tallenna.
5. 5Testaa Preview-tilassa (GTM → Preview): avaa sivusto, käy chat-keskustelu ja jätä sähköposti tai puhelinnumero. Tapahtumat näkyvät Tag Assistantin dataLayer-listassa.
6. 6Julkaise säiliö ja merkitse generate_lead GA4:ssä avaintapahtumaksi.

Kiila pushaa jokaisen tapahtuman kahdessa muodossa: GTM-muodossa nimellä kiila_<tapahtuma> ja parametrit kiila_-etuliitteellä, sekä GA4-muodossa ilman etuliitettä. Käytä sitä kumpi sopii säiliöösi paremmin — molemmat toimivat. Liidit pushataan lisäksi nimellä kiila_generate_lead, ja jokainen push sisältää muuttujan kiila_ga4_event (= generate_lead). Jos käytät yhtä GA4-tagia kaikille Kiila-tapahtumille, aseta sen Event Name -kentäksi dataLayer-muuttuja kiila_ga4_event — silloin liidit kirjautuvat GA4:ään aina nimellä generate_lead.

Nimimuutos: aiemmin GTM-tapahtumat ja -parametrit käyttivät etuliitettä loveo_. Jos säiliössäsi on vanhoja triggereitä tai muuttujia, päivitä ne muotoon kiila_. GA4-muotoiset tapahtumanimet (esim. generate_lead) eivät muuttuneet.

Huom: chatin tavoite laukeaa heti, kun kävijältä saadaan sähköposti tai puhelinnumero — myös silloin kun tieto annetaan keskustelussa eikä lomakkeella. Jos kävijä jättää tämän jälkeen vielä yhteystietolomakkeen samassa keskustelussa, Kiila lähettää tapahtuman lead_submitted (kiila_lead_submitted) — sitä ei pidä merkitä konversioksi, jotta sama liidi ei laskeudu kahdesti.

Jokaisessa tapahtumassa on lisäksi yhteiset parametrit: agent_id, visitor_id, origin, path, referrer sekä kampanjatiedot utm_source, utm_medium, utm_campaign, utm_content, utm_term, gclid ja fbclid.

Konversioelementtien tapahtumissa on lisäksi trigger_source (popup, slidein, banner tai inline), host sekä A/B-testin tiedot variant_id ja experiment_id. Jos sisältö on tuotettu sivukohtaisella AI-variaatiolla, mukana on ai_variant.

1. 1Varmista, että GA4-omaisuus on linkitetty Google Ads -tiliin (Ylläpito → Tuotelinkitykset → Google Ads).
2. 2Google Ads → Tavoitteet → Konversiot → Uusi konversiotoiminto → Tuo → Google Analytics 4.
3. 3Valitse generate_lead ja tuo se. Kiilan chatista ja konversioelementeistä tulevat liidit lasketaan tämän jälkeen kampanjoiden konversioiksi.

• DebugView: GA4 → Ylläpito → DebugView näyttää tapahtumat reaaliajassa, kun selaimessa on GTM Preview tai Google Analytics Debugger -laajennus.
• Konsolitarkistus: aja sivustolla window.dataLayer.filter(e => e.event?.includes("lead")) — Kiilan pushit näkyvät listassa.
• Ei tapahtumia? Tarkista että evästesuostumus sallii analytiikan (Consent Mode estää lähetyksen ilman suostumusta) ja että GA4-koodi latautuu ennen Kiilan upotusta.
• Tuplakonversiot? Kiila estää tämän automaattisesti, kun se havaitsee Tag Managerin. Jos silti näkyy tuplaa, pakota suora lähetys pois: window.KiilaDisableGtag = true. (Jos taas GTM on mutta GA4-tagi puuttuu ja haluat gtag.js:n hoitavan konversion: window.KiilaForceGtag = true.)
• Vertailu: Kiilan oma analytiikka näyttää liidit hallintapaneelissa — luvut voivat poiketa GA4:stä hieman evästesuostumusten ja mainosestojen takia.