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

  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 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

  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.

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)

TapahtumaGTM Custom EventGA4-nimiParametrit
Tavoite saavutettu chatissa (yhteystieto saatu)kiila_goal_reachedgenerate_leadconversation_id, source (chat_message / lead_submit), kiila_event = goal_reached
Konversioelementin lomake lähetettykiila_form_lead_submittedgenerate_leadform_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

TapahtumaGTM Custom EventGA4-nimiParametrit
Widget ladattukiila_widget_loadedwidget_loadedhost
Chat avattukiila_widget_openwidget_opensource
Chat suljettukiila_widget_closewidget_closemessages_sent
Heräte näytettykiila_trigger_showntrigger_showntrigger_id, trigger_label, kind
Herätettä klikattukiila_trigger_clicktrigger_clicktrigger_id, trigger_label, kind
Pikavastaus klikattukiila_quick_reply_clickquick_reply_clicklabel
Keskustelu aloitettukiila_conversation_startedconversation_startedconversation_id
Viesti lähetettykiila_message_sentmessage_sentconversation_id, length, index
Konversioelementti näytettykiila_form_shownform_shownform_id, form_slug, kind
Konversioelementin CTA klikattukiila_form_cta_clickedform_cta_clickedform_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

  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.

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