Wie kann ich Tracking für die Nutzung der Eye-Able Services auf unserer Webseite einstellen?

Einleitung

Die Eye-Able Software verfolgt keine Nutzerinteraktionen direkt, bietet jedoch die Möglichkeit, ein bestehendes 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 erfahren Sie, wie Sie das Tracking für die Nutzung der Eye-Able Services auf Ihrer Webseite einrichten.

Wichtige Hinweise zum Datenschutz

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

Versionen und Updates

Eye-Able Assist: Stellen Sie sicher, dass Ihre 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ügen Sie folgenden Code in den Kopfbereich Ihrer Webseite ein und passen Sie 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
    });
 }
});

Der Code sendet Eye-Able-Ereignisse an Ihr 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 Sie ein anderes Framework verwenden, können Sie den Funktionsaufruf ga('send', ...) durch die entsprechende Funktion Ihrer Tracking-Software ersetzen.

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. Ersetzen Sie die Funktion ga('send', ...) durch die entsprechende Funktion Ihrer Tracking-Software.
Frage: Was mache ich, wenn ich Probleme mit dem Tracking habe?
Antwort: Bitte wenden Sie sich an den Support.