Tracking für die Nutzung von Eye-Able Software

Die Eye-Able Software trackt keine Nutzerinteraktionen direkt, bietet aber die Möglichkeit, eine bestehende Tracking-Software wie Google Analytics zu nutzen. Sobald bestimmte Funktionen in Eye-Able aktiviert werden, wird ein benutzerdefiniertes JavaScript-Event („eyeable:event") ausgelöst, das an die Tracking-Software weitergeleitet werden kann. In diesem Artikel erfährst du, wie du Tracking für die Nutzung der Eye-Able Software auf deiner Webseite einrichtest.

Wichtige Hinweise zum Datenschutz

Bitte respektiere die Datenschutzbestimmungen deiner Nutzenden. Die Informationen darüber, welche Eye-Able-Funktionen genutzt werden, sind insbesondere in Kombination mit der Nutzeridentifikation sehr sensibel. Achte darauf, die geltenden Datenschutzrechte zu befolgen. Eye-Able übernimmt keine Haftung für etwaige Datenschutzverletzungen.

Versionen und Updates

Eye-Able Assist: Stelle sicher, dass deine Eye-Able Assist Version höher als 1.13.0 ist, um alle neuen Funktionen, wie z. B. „Disable Events" und „Toolbar_Opened_CustomIcon" bei Verwendung eines benutzerdefinierten Buttons, zu nutzen.
Eye-Able Translate: Die Version sollte mindestens 3.1 sein, um alle neuen Events zu unterstützen.

Tracking mit Google Analytics

Um die Eye-Able-Ereignisse an Google Analytics zu senden, füge folgenden Code in den Kopfbereich deiner Webseite ein und passe die Google Analytics Tracking-ID an:

// Google Analytics laden
(function(i,s,o,g,r,a,m){i['GoogleAnalyticsObject']=r;i[r]=i[r]||function(){(i[r].q=i[r].q||[]).push(arguments)},i[r].l=1*new Date(); a =
s.createElement(o),m=s.getElementsByTagName(o)[0];a.async=1;a.src=g;m.parentNode.insertBefore(a,m)})(window,document,'script','https://www.google-analytics.com/analytics.js','ga');

// Eigene Google Analytics Tracking-ID einfügen
const gaID = "UA-XXXXX-X";
// Verbindung einrichten
ga('create', gaID, 'auto');

// Eye-Able Ereignisse registrieren
document.addEventListener("eyeable:event", function (e) {
if(e.detail){
ga('send', {
hitType: 'event',
eventCategory: 'Eye Able Event',
eventAction: 'Funktion',
eventLabel: e.detail // Hier wird die verwendete Funktion angezeigt
});
}
});

Dieser Code sendet Eye-Able-Ereignisse an dein Google Analytics-Konto. Diese Ereignisse können im Google Analytics Dashboard verarbeitet und analysiert werden. Das eventLabel enthält Informationen darüber, welche Funktion aufgerufen wurde.

Tracking mit anderen Tracking-Tools

Der oben angezeigte Google Analytics-Code kann auch für andere Tracking-Software angepasst werden. Falls du ein anderes Framework verwendest, kannst du den Funktionsaufruf ga('send', ...) durch die entsprechende Funktion deiner Tracking-Software ersetzen. Für Matomo findest du eine detaillierte Anleitung im Artikel „Nutzung von Event-Tracking mit Matomo“.

Verfügbare Ereignisse für das Tracking

Die folgenden Ereignisse können in Eye-Able für das Tracking genutzt werden:

Eye-Able Assist - Verfügbare Ereignisse

Ereignisname	Beschreibung
Toolbar_Opened	Die Toolbar wurde geöffnet.
Active_Settings_At_PageLoad	Wird ausgelöst, wenn bei Seitenaufruf eine Assist-Einstellung aktiv ist. Kann genutzt werden, um aktive Besucher zu zählen.
One_Click_Mode	Der Sofortansicht-Button wurde gedrückt.
Adaptive_Zoom_Change	Eine Änderung oder Initialisierung des adaptiven Zooms fand statt.
Adaptive_Zoom_Disabled	Der Zoom wurde deaktiviert.
Darkmode_Enabled	Der Dunkelmodus wurde aktiviert.
Darkmode_Disabled	Der Dunkelmodus wurde deaktiviert.
Contrast_Enabled	Der Kontrastmodus wurde aktiviert oder geändert.
Contrast_Disabled	Der Kontrastmodus wurde deaktiviert.
Bluefilter_Enabled	Der Blaulichtfilter wurde aktiviert.
Bluefilter_Disabled	Der Blaulichtfilter wurde deaktiviert.
Bluefilter_Adjusted	Der Blaulichtfilter wurde angepasst.
Screenreader_Enabled	Der Bildschirmleser wurde aktiviert.
Screenreader_Disabled	Der Bildschirmleser wurde deaktiviert.
Key_Navigation_Enabled	Nur die Tastaturnavigation ohne den Bildschirmleser wurde aktiviert.
Key_Navigation_Disabled	Nur die Tastaturnavigation ohne den Bildschirmleser wurde deaktiviert.
CVD_Filter_Enabled	Der Farbkorrekturfilter wurde aktiviert.
CVD_Filter_Disabled	Der Farbkorrekturfilter wurde deaktiviert.
CVD_Filter_Adjusted	Der Farbkorrekturfilter wurde angepasst.
Hide_Images_Enabled	Das Ausblenden von Bildern wurde aktiviert.
Hide_Images_Disabled	Das Ausblenden von Bildern wurde deaktiviert.
Big_Cursor_Enabled	Der große Cursor wurde aktiviert.
Big_Cursor_Disabled	Der große Cursor wurde deaktiviert.
Font_Enabled	Die barrierefreie Schriftart wurde aktiviert.
Font_Disabled	Die barrierefreie Schriftart wurde deaktiviert.
Animations_Disabled	Animationen wurden deaktiviert.
Animations_Enabled	Animationen wurden aktiviert.
Mute_Audio_Enabled	Der Ton wurde deaktiviert.
Mute_Audio_Disabled	Der Ton wurde aktiviert.

Eye-Able Translate - Verfügbare Ereignisse

Ereignisname	Beschreibung
eyeable:translation_failure	Ein Fehler bei der Übersetzung ist aufgetreten.
eyeable:translate	Ein Text wurde erfolgreich übersetzt.
eyeable:plainLanguage	Der einfache Sprachmodus wurde aktiviert.

Parameter für Eye-Able Translate Events

Parametername	Beschreibung
tarLang	Die Zielsprache, in die der Text übersetzt wurde.
originalLang	Die Quellsprache der Webseite, von der die Übersetzung durchgeführt wurde.
timestamp	Der aktuelle Zeitstempel des Ereignisses.
website	Die URL der aktuellen Seite.
message	Bei einem Fehler: Die Fehlermeldung.
status	Der Fehlerstatus (nur bei einem Übersetzungsfehler).
lang	Die aktuelle Sprache der Webseite (nur bei „eyeable:plainLanguage“).

Häufig gestellte Fragen (FAQ)

- Frage: Wie sende ich Eye-Able Ereignisse an ein anderes Tracking-Tool?
  Antwort: Der Google Analytics-Code kann für jedes Event-basierte Tracking-Tool angepasst werden. Ersetze die Funktion ga('send', ...) durch die entsprechende Funktion deiner Tracking-Software.
- Frage: Was mache ich, wenn ich Probleme mit dem Tracking habe?
  Antwort: Bitte wenden Sie sich an den Support. Du findest Kontaktmöglichkeiten in diesem Artikel: Kontaktmöglichkeiten für Kundinnen, Kunden und Interessierte