Novaco mit Google Analytics verbinden

    Leite die Events deines virtuellen Assistenten an Google Tag Manager oder Google Analytics 4 weiter und erstelle Berichte zu Gesprächen, Leads und Terminen.

    Zwei Methoden

    Es gibt zwei Möglichkeiten, Novaco-Daten mit Google Analytics zu verbinden. Wähle eine — führe niemals beide parallel aus.

    1. Google Tag Manager

    Empfohlen, wenn du bereits GTM verwendest. Sende Events an die Datenebene und verteile sie an beliebige Tags.

    2. Google Analytics 4

    Verwende das Google-Tag (gtag.js) direkt auf deiner Website, um Events direkt an GA4 zu senden.

    Welche Events sind verfügbar? Siehe die Google Analytics-Events-Referenz.

    Mit Google Tag Manager verbinden

    GTM verteilt Events über Tags an Drittanbieter. Dazu stellst du die Daten in der sogenannten "Datenebene" (data layer) bereit. Füge für jedes Event, das du verwenden möchtest, einen Listener hinzu.

    Beispiel: ein 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>

    Beispiel: mehrere 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>

    Der try-catch-Block ist optionale Fehlerbehandlung — du kannst ihn so belassen.

    Die Datenebenen-Variablen erstellen

    Neben den Events stellt Novaco zusätzliche Event-Daten wie session_id, chat_type und appointment_type bereit. Erstelle für jede davon eine Variable.

    1. Gehe zu deinem GTM-Container.
    2. Gehe zu Variablen und klicke unter "Benutzerdefinierte Variablen" auf "Neu".
    3. Wähle "Datenebenen-Variable" als Variablentyp.
    4. Gib ihr einen klaren Namen, zum Beispiel "Novaco – session_id".
    5. Trage als Namen der Datenebenen-Variable den Novaco-Variablennamen ein.
    6. Klicke auf Speichern.

    Die Events mit Triggern und Tags verknüpfen

    Erstelle für jedes Event, auf das du reagieren möchtest, einen Trigger und kombiniere dann Trigger und Variablen in einem GA4-Tag.

    Einen Trigger erstellen

    1. Gehe zu deinem GTM-Container.
    2. Gehe zu Trigger und klicke auf "Neu".
    3. Wähle den Triggertyp "Benutzerdefiniertes Event".
    4. Gib ihm einen klaren Namen, zum Beispiel "Novaco – Lead erstellt".
    5. Verwende den Novaco-Eventnamen als Eventnamen.
    6. Klicke auf Speichern.

    Das GA4-Tag erstellen

    1. Gehe zu Tags und klicke auf "Neu".
    2. Wähle den Tag-Typ "Google Analytics: GA4-Event".
    3. Gib ihm einen klaren Namen, zum Beispiel "GA4 – Novaco-Events".
    4. Trage deine Messungs-ID ein oder verknüpfe sie mit deiner Google-Tag-Konfiguration.
    5. Trage {{Event}} als Eventnamen ein.
    6. Füge unter "Ereignisparameter" die Novaco-Variablen als Parameter hinzu.
    7. Klicke auf Speichern.

    Jeder Novaco-Event-Trigger, den du jetzt hinzufügst, sendet seine Daten automatisch an GA4. Dieselben Bausteine können für andere Tags verwendet werden, etwa für eine Google Ads-Lead-Conversion.

    Direkt mit Google Analytics 4 verbinden

    Kein Tag-Manager? Verwende die Google-Tag-Implementierung (gtag.js). Führe dieses Setup niemals parallel zu Google Tag Manager aus — wenn du GTM verwendest, folge stattdessen der obigen Anleitung.

    1. Dein Google-Tag einrichten

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

    Ersetze G-12345678 durch deine eigene Messungs-ID.

    2. Das Novaco-Event-Tracking hinzufügen

    Füge dieses Snippet nach deinem gtag('config', ...)-Aufruf hinzu.

    <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 wird automatisch zum Eventnamen aufgelöst, zum Beispiel autochat_lead_created. Das ist auch der Eventname, den du in GA4 siehst. Alles danach sind die Event-Parameter.

    GA4-benutzerdefinierte Dimensionen

    Um über die Event-Parameter zu berichten, registriere sie als benutzerdefinierte Dimensionen in GA4.

    1. Gehe zur Admin-Ansicht deiner GA4-Property.
    2. Gehe zu "Benutzerdefinierte Definitionen".
    3. Gehe zu "Benutzerdefinierte Dimensionen" und klicke auf "Benutzerdefinierte Dimension erstellen".
    4. Verwende einen aussagekräftigen Dimensionsnamen, zum Beispiel "Novaco Chat-Öffnungstyp".
    5. Setze den Bereich auf "Ereignis".
    6. Verwende als Ereignisparameter den Variablennamen, den du im GA4-Tag verwendet hast, zum Beispiel chat_open_type.

    analyticsSetup.dimensions.note

    Suchst du die Event-Liste?

    Jedes Event, wann es ausgelöst wird und welche Daten es enthält.

    Zur Events-Referenz