Event Tracking
The Event Tracker can be used to record and evaluate any interactions of website visitors with page elements after the page has been loaded, as well as the display of certain page elements when the page is called up. The recording is triggered by a specially implemented JavaScript function. As an alternative to the event tracker function, interactions can also be recorded via etracker consent & tag manager without integrating additional code in HTML.
Interactions – such as scrolling, external links, downloads or video views – are automatically recorded in etracker analytics unless this has been deactivated. To adjust the automatic recording, go to Account → Automatic recording → Events. Scrolling is configured under Data protection → Automatic scroll tracking customized.
Prerequisite: The etracker code must be correctly integrated on the page.
- Every measured event interaction is counted towards the hit quota. Event measurement should therefore only be used for targeted usability and conversion optimization.
- All values must be transferred in URL-encoded format (RFC 3986) in accordance with the ISO standard, this applies in particular to special characters.
- The page on which the event is triggered is automatically recorded with the page name (corresponds to the page title by default) and URL as well as URL path (area assignment) and does not have to be transferred additionally.
These event tracking functions are available:
User-defined events
To send an event, simply insert the following snippet into an HTML tag:
onmousedown="_etracker.sendEvent(new et_UserDefinedEvent('Objektname', 'Kategorie', 'Aktion', 'Typ'));"The parameters are all freely definable character strings and correspond to the respective report dimensions or segments. The “Action” and “Type” parameters are optional.
<a href="http://www.meineseite.de/test.pdf" onmousedown="_etracker.sendEvent(new et_UserDefinedEvent('myObject', 'myCategory', 'myAction', 'myType'));">PDF-Download</a>Download
<a href="http://www.meineseite.de/test.pdf" onmousedown="_etracker.sendEvent(new et_UserDefinedEvent('test.html', 'Download', 'Anleitungen', 'PDF'));">PDF-Download</a>Link-Click
<a href="http://www.meineseite.de/link.html" onmousedown="_etracker.sendEvent(new et_UserDefinedEvent('Links.html', 'Links', 'Click', 'Link'));">Link-Click</a>The automatically recorded events are assigned to the dimensions as follows:
| Kategorie | Objekt | Aktion | Typ |
|---|---|---|---|
| Links | Aufgerufener Link | link | External Link Social Media Mailto Link Phone |
| Download | Datei (Name und Endung) | download | Download |
| Video | Datei (Name und Endung) | start stop playtime | - |
Rich Media Events
Special event functions are available for recording the use of multimedia content (audio and video) in order to be able to evaluate the playing time in addition to the interactions. Please note that playable media are measured by default via automatic event recording.
<input type="button" value="Film starten" onmousedown="_etracker.sendEvent(new et_VideoStartEvent('Film1','Produktvorstellung'))">The transfer using the event tracker functions is as follows:
| JavaScript Funktion | Beschreibung |
|---|---|
| et_AudioStartEvent(eventObject,eventType) | Messung der Startfunktion eines Musikplayers. |
| et_AudioStopEvent(eventObject,eventType) | Messung der Stopfunktion eines Musikplayers. |
| et_AudioPauseEvent(eventObject,eventType) | Messung der Pausefunktion eines Musikplayers. |
| et_AudioMuteEvent(eventObject,eventType) | Messung der Stummschaltefunkt. eines Musikplayers. |
| et_AudioSeekEvent(eventObject,eventType) | Messung der Abspielposition eines Musikplayers. |
| et_AudioNextEvent(eventObject,eventType) | Messung der Weiterfunktion eines Musikplayers. |
| et_AudioPreviousEvent(eventObject,eventType) | Messung der Zurückfunktion eines Musikplayers. |
| et_VideoStartEvent(eventObject,eventType) | Messung der Startfunktion eines Videoplayers. |
| et_VideoStopEvent(eventObject,eventType) | Messung der Stopfunktion eines Videoplayers. |
| et_VideoPauseEvent(eventObject,eventType) | Messung der Pausefunktion eines Videoplayers. |
| et_VideoMuteEvent(eventObject,eventType) | Messung der Stummschaltefunkt. eines Videoplayers. |
| et_VideoSeekEvent(eventObject,eventType) | Messung der Abspielposition eines Videoplayers. |
| et_VideoNextEvent(eventObject,eventType) | Messung der Weiterfunktion eines Videoplayers. |
| et_VideoPreviousEvent(eventObject,eventType) | Messung der Zurückfunktion eines Videoplayers. |
| et_VideoFullsizeEvent(eventObject,eventType) | Messung der Vollbildfunktion eines Videoplayers. |
| et_VideoRestoreEvent(eventObject,eventType) | Messung der Normalbildfunktion eines Videoplayers. |
View Events
The ViewEvent function should be used to send a view event:
etracker.sendEvent(new et_ViewEvent(myObject, myType));To ensure that the etracker code has been loaded before the ViewEvent is sent, the ViewEvent function should be called with the following _etrackerOnReady so that the ViewEvent finally looks like this:
var _etrackerOnReady = typeof _etrackerOnReady === 'undefined' ? [] : _etrackerOnReady;
_etrackerOnReady.push(function()
{ _etracker.sendEvent(new et_ViewEvent(myObject, myType));
});The Category and Action parameters are automatically filled with “View” and “view” respectively.