GA4- ja Tag Manager -konversioseuranta
Kiila lähettää jokaisen chat- ja konversioelementtitapahtuman suoraan sivustosi analytiikkaan. Tästä ohjeesta näet vaihe vaiheelta, miten saat liidit näkymään Google Analytics 4:ssä konversioina — sekä Tag Managerin kanssa että ilman.
Päivitetty 4.8.2026.
Miten seuranta toimii
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.
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.
Vaihtoehto A: GA4 ilman Tag Manageria
- 1Varmista, että sivustolla on GA4:n
gtag.js-koodi (Google-tunnisteG-XXXXXXX) ennen Kiilan upotuskoodia. - 2Ei muuta asennusta — Kiila havaitsee
window.gtag:n ja lähettää tapahtumat automaattisesti. - 3Avaa GA4 → Ylläpito → Tapahtumat. Kun sivustolla on käyty ja chatista on jätetty yhteystieto, listalle ilmestyy
generate_leadsekä muut Kiilan tapahtumat (24–48 h viive raporteissa, reaaliaika näkyy heti). - 4Merkitse
generate_leadavaintapahtumaksi (Mark as key event) → se lasketaan konversioksi.
Jos sivustolla on sekä GTM-tagi että gtag.js ja tapahtumat kirjautuvat kahteen kertaan, estä suora lähetys lisäämällä ennen Kiilan upotuskoodia: <script>window.KiilaDisableGtag = true;</script>
Vaihtoehto B: Google Tag Manager
- 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. - 2Luo trigger. Triggers → New → Custom Event. Event name:
generate_lead. Halutessasi rajaa vain Kiilan liideihin ehdollakiila_eventmatches RegExgoal_reached|form_lead_submitted. - 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. - 4Liitä trigger tagiin ja tallenna.
- 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.
- 6Julkaise säiliö ja merkitse
generate_leadGA4: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.
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.
Liiditapahtumat (konversiot)
| Tapahtuma | GTM Custom Event | GA4-nimi | Parametrit |
|---|---|---|---|
| Tavoite saavutettu chatissa (yhteystieto saatu) | kiila_goal_reached | generate_lead | conversation_id, source (chat_message / lead_submit), kiila_event = goal_reached |
| Konversioelementin lomake lähetetty | kiila_form_lead_submitted | generate_lead | form_id, form_slug, kind, kiila_event = form_lead_submitted |
Huom: chatin tavoite laukeaa heti, kun kävijältä saadaan sähköposti tai puhelinnumero — myös silloin kun tieto annetaan keskustelussa eikä lomakkeella.
Muut tapahtumat
| Tapahtuma | GTM Custom Event | GA4-nimi | Parametrit |
|---|---|---|---|
| Widget ladattu | kiila_widget_loaded | widget_loaded | host |
| Chat avattu | kiila_widget_open | widget_open | source |
| Chat suljettu | kiila_widget_close | widget_close | messages_sent |
| Heräte näytetty | kiila_trigger_shown | trigger_shown | trigger_id, trigger_label, kind |
| Herätettä klikattu | kiila_trigger_click | trigger_click | trigger_id, trigger_label, kind |
| Pikavastaus klikattu | kiila_quick_reply_click | quick_reply_click | label |
| Keskustelu aloitettu | kiila_conversation_started | conversation_started | conversation_id |
| Viesti lähetetty | kiila_message_sent | message_sent | conversation_id, length, index |
| Konversioelementti näytetty | kiila_form_shown | form_shown | form_id, form_slug, kind |
| Konversioelementin CTA klikattu | kiila_form_cta_clicked | form_cta_clicked | form_id, form_slug, kind |
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.
Google Ads -konversion tuonti
- 1Varmista, että GA4-omaisuus on linkitetty Google Ads -tiliin (Ylläpito → Tuotelinkitykset → Google Ads).
- 2Google Ads → Tavoitteet → Konversiot → Uusi konversiotoiminto → Tuo → Google Analytics 4.
- 3Valitse
generate_leadja tuo se. Kiilan chatista ja konversioelementeistä tulevat liidit lasketaan tämän jälkeen kampanjoiden konversioiksi.
Testaus ja vianetsintä
- 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? Sivustolla on todennäköisesti sekä GTM-tagi että gtag.js. Käytä
window.KiilaDisableGtag = true. - Vertailu: Kiilan oma analytiikka näyttää liidit hallintapaneelissa — luvut voivat poiketa GA4:stä hieman evästesuostumusten ja mainosestojen takia.
Tarvitsetko apua käyttöönotossa?
Teemme seurannan määrittelyn puolestasi osana käyttöönottoa. Ota yhteyttä: kiila-app@joinas.fi