Verbind Novaco met Google Analytics

    Stuur de events van je virtuele assistent door naar Google Tag Manager of Google Analytics 4 en rapporteer over gesprekken, leads en afspraken.

    Twee methoden

    Er zijn twee manieren om Novaco-gegevens te verbinden met Google Analytics. Kies er één — voer nooit beide tegelijk uit.

    Welke events zijn beschikbaar? Bekijk de Google Analytics events referentie.

    Verbinden met Google Tag Manager

    GTM verdeelt events naar derde partijen via tags. Hiervoor lever je de gegevens aan in de zogenaamde "datalaag". Voeg een listener toe voor elk event dat je wilt gebruiken.

    Voorbeeld: één event

    <script>
    window.addEventListener('autochat_lead_created', function (e) {
      try {
        dataLayer.push({
          "event": e.type,
          "autochat_event_details": e.detail.eventData
        });
      } catch(e) {
        // Your error handling if relevant
      }
    });
    </script>

    Voorbeeld: meerdere events

    <script>
    window.addEventListener('autochat_lead_created', function (e) {
      try {
        dataLayer.push({
          "event": e.type,
          "autochat_event_details": e.detail.eventData
        });
      } catch(e) {
        // Your error handling if relevant
      }
    });
    window.addEventListener('autochat_chat_first_user_interaction', function (e) {
      try {
        dataLayer.push({
          "event": e.type,
          "autochat_event_details": e.detail.eventData
        });
      } catch(e) {
        // Your error handling if relevant
      }
    });
    </script>

    De try-catch is optionele foutafhandeling — je kunt deze laten staan zoals hij is.

    Maak de datalaagvariabelen aan

    Naast de events biedt Novaco extra eventgegevens zoals session_id, chat_type en appointment_type. Maak voor elk een variabele aan.

    1. Ga naar je GTM-container.
    2. Ga naar Variabelen en klik op "Nieuw" onder "Door gebruiker gedefinieerde variabelen".
    3. Kies "Datalaagvariabele" als variabeltype.
    4. Geef het een duidelijke naam, bijvoorbeeld "Novaco – session_id".
    5. Vul bij de naam van de datalaagvariabele de Novaco-variabelnaam in.
    6. Klik op Opslaan.

    Koppel de events aan triggers en tags

    Maak een trigger aan voor elk event waarop je wilt reageren, en combineer vervolgens triggers en variabelen in een GA4-tag.

    Een trigger aanmaken

    1. Ga naar je GTM-container.
    2. Ga naar Triggers en klik op "Nieuw".
    3. Kies triggertype "Aangepast event".
    4. Geef het een duidelijke naam, bijvoorbeeld "Novaco – Lead aangemaakt".
    5. Gebruik de Novaco-eventnaam als eventnaam.
    6. Klik op Opslaan.

    De GA4-tag aanmaken

    1. Ga naar Tags en klik op "Nieuw".
    2. Kies tagtype "Google Analytics: GA4-event".
    3. Geef het een duidelijke naam, bijvoorbeeld "GA4 – Novaco events".
    4. Vul je meet-ID in of koppel het aan je Google tag-configuratie.
    5. Vul {{Event}} in als eventnaam.
    6. Voeg onder "Eventparameters" de Novaco-variabelen toe als parameters.
    7. Klik op Opslaan.

    Elke Novaco-eventtrigger die je nu toevoegt, stuurt automatisch zijn gegevens naar GA4. Dezelfde bouwstenen kunnen worden gebruikt voor andere tags, zoals een Google Ads-leadconversie.

    Rechtstreeks verbinden met Google Analytics 4

    Geen tagbeheerder? Gebruik de Google tag (gtag.js)-implementatie. Voer deze configuratie nooit parallel uit met Google Tag Manager — als je GTM gebruikt, volg dan in plaats daarvan de handleiding hierboven.

    1. Stel je Google tag in

    <script async src="https://www.googletagmanager.com/gtag/js?id=G-12345678"></script>
    <script>
      window.dataLayer = window.dataLayer || [];
      function gtag(){dataLayer.push(arguments);}
      gtag('js', new Date());
    
      gtag('config', 'G-12345678');
    </script>

    Vervang G-12345678 door je eigen meet-ID.

    2. Voeg de Novaco-eventtracking toe

    Voeg dit fragment toe na je gtag('config', ...)-aanroep.

    <script>
    window.addEventListener('autochat_lead_created', function (e) {
      try {
        gtag('event', e.type, {
          'session_id': e.detail.eventData.session_id,
          'appointment_type': e.detail.eventData.appointment_type
        });
      } catch(e) {
        // Your error handling if relevant
      }
    });
    window.addEventListener('autochat_chat_first_user_interaction', function (e) {
      try {
        gtag('event', e.type, {
          'session_id': e.detail.eventData.session_id,
          'chat_type': e.detail.eventData.chat_type
        });
      } catch(e) {
        // Your error handling if relevant
      }
    });
    </script>

    e.type wordt automatisch omgezet naar de eventnaam, bijvoorbeeld autochat_lead_created. Dat is ook de eventnaam die je in GA4 zult zien. Alles daarna zijn de eventparameters.

    GA4-aangepaste dimensies

    Om te rapporteren over de eventparameters, registreer je ze als aangepaste dimensies in GA4.

    1. Ga naar je GA4-property-beheer.
    2. Ga naar "Aangepaste definities".
    3. Ga naar "Aangepaste dimensies" en klik op "Aangepaste dimensie maken".
    4. Gebruik een beschrijvende dimensienaam, bijvoorbeeld "Novaco chat open type".
    5. Stel de bereik in op "Event".
    6. Gebruik als eventparameter de variabelnaam die je in de GA4-tag hebt gebruikt, bijvoorbeeld chat_open_type.

    analyticsSetup.dimensions.note

    Op zoek naar de eventlijst?

    Elk event, wanneer het wordt geactiveerd en welke gegevens het bevat.

    Bekijk de events referentie