Tracking integrieren

LoyJoy emittiert Ereignisse für jede bedeutende Chat-Interaktion (Öffnen, Anmeldung, Link geklickt und viele mehr). Diese Seite zeigt, wie Sie diese Ereignisse an Google Analytics, Google Tag Manager oder Ihr eigenes JavaScript weiterleiten.

Tracking ist optional und läuft nur, sobald der Kunde die relevanten Cookie-Kategorien akzeptiert hat. Prüfen Sie vor der Aktivierung den Cookie-Banner-Integrations-Guide, damit das LoyJoy-Snippet und Ihr Consent Manager korrekt zusammenwirken.

Im Publish-Tab Ihres KI-Agenten wählen Sie, ob Ereignisse an Google Analytics, Google Tag Manager oder ein benutzerdefiniertes Skript weitergeleitet werden sollen. Die Auswahl läuft, wann immer ein Ereignis emittiert wird.

So verbinden Sie LoyJoy mit Google Global Site Tag / Google Analytics (gtag.js)

Wenn Sie Google Analytics auswählen, wird bei jedem LoyJoy-Ereignis automatisch das folgende Skript ausgeführt:

gtag && gtag('event', type, {
  'event_category': 'LoyJoy Chat',
  'event_action': detail && detail.process_name,
  'event_label': type + (detail.label ? '/' + detail.label : '')
})

So verbinden Sie LoyJoy mit Google Tag Manager (gtm.js)

Wenn Sie Google Tag Manager auswählen, wird bei jedem LoyJoy-Ereignis automatisch das folgende Skript ausgeführt:

dataLayer && dataLayer.push && dataLayer.push({
  'event': type,
  'event_category': 'LoyJoy Chat',
  'event_action': detail && detail.process_name,
  'event_label': type + (detail.label ? '/' + detail.label : '')
})

hinweis

Bei der standardmäßigen Google-Tag-Manager-Integration haben die gespeicherten Ereignisse die folgenden Felder:

Feld	Inhalt
event	Ereignisname / -typ. Z. B. session_started. Siehe hier
event_category	Fest, immer LoyJoy Chat
event_action	Name des KI-Agenten
event_label	Ereignisname + optionales Label, z. B. Quick-Reply-Titel

Benutzerdefinierter JavaScript-Code

Wenn Sie Benutzerdefiniert auswählen, können Sie benutzerdefinierten JavaScript-Code eingeben, der bei jedem LoyJoy-Ereignis ausgeführt werden soll, z. B.:

if ([
  'data_collection_question_answered', 'interaction', 'link_clicked', 'load', 'open', 'session_interacted', 'session_started', 'start'
].includes(event.type)) {
  dataLayer && dataLayer.push && dataLayer.push({
    'event': 'LoyJoy ChatBot ' + event.type,
    'event_category': 'LoyJoy ChatBot',
    'event_action': ['load', 'session_interacted', 'session_started'].includes(event.type) ? event.type : event.detail && (event.detail.process_name || event.detail.process_id),
    'event_label': ['load', 'session_interacted', 'session_started'].includes(event.type) ? event.type : event.type + (event.detail && event.detail.label ? ' / '  + event.detail.label : '') + (event.detail && (event.detail.sub_process_name || event.detail.sub_process_id) ? ' / ' + (event.detail.sub_process_name || event.detail.sub_process_id) : '')
  })
}

Facebook-Pixel / Meta-Pixel

Eine Facebook-/Meta-Pixel-Integration könnte so aussehen:

if (event.type === 'link_clicked') {
  fbq('track', 'Lead', { process: event.detail.process_name });
}

Typischerweise möchten Sie den geprüften Ereignistyp (hier link_clicked) sowie das an Facebook gesendete getrackte Ereignis (hier Lead) anpassen.

Geklickte Links tracken

link_clicked-Ereignisse enthalten das Feld url in ihrer detail-Eigenschaft, mit dem Sie geklickte Links tracken können. Wenn Sie z. B. tracken möchten, wann ein Nutzer einen Link im Chat klickt, könnten Sie den folgenden Code verwenden:

if (event.type === 'link_clicked') {
  dataLayer && dataLayer.push && dataLayer.push({
    'event': 'LoyJoy ChatBot Link Clicked',
    'event_category': 'LoyJoy ChatBot',
    'event_action': 'Link Clicked',
    'event_label': event.detail.url
  })
}