Single-Page Applications messen

Bei einer Single-Page Application (SPA) wird nur eine einzige HTML-Seite geladen und der Inhalt dann mithilfe von JavaScript-APIs aktualisiert, um angezeigte Inhalte zu ändern. Diese Änderungen werden standardmäßig nicht als neue Seitenaufrufe gemessen. Daher ist es erforderlich, hierfür virtuelle Seitenaufrufe zu generieren.

Für die Messung virtueller Seitenaufrufe gibt es zwei Methoden:

1. Automatische Wrapper-Funktion.
2. Manueller Einbau des Wrappers.

Automatische Wrapper-Funktion

Bestimmte Änderungen lassen sich automatisch erkennen und für das Auslösen der Messung eines neuen Seitenaufrufs nutzen. Hierzu muss folgende Ergänzung innerhalb des in der Website integrierten etracker Codes vorgenommen werden:

data-page-changed-detection=<Modus>

Für den Modus stehen diese Optionen zur Verfügung:

1. off: Aus.
2. url: Löst einen neuen Seitenaufruf aus, wenn sich die URL ohne Hashwert ändert.
3. url_debug: Wie url, jedoch nur auszulesen im console.log der Browser-DevTools.
4. hash: Löst einen neuen Seitenaufruf aus, wenn sich die URL inklusive Hashwert ändert.
5. hash_debug: Wie hash, jedoch nur auszulesen im console.log der Browser-DevTools.
6. title: Löst einen neuen Seitenaufruf aus, wenn sich document.title ändert.
7. title_debug: Wie title, jedoch nur auszulesen im console.log der Browser-DevTools.

Manueller Einbau des Wrappers

Der Wrapper wird mit dem Standard JavaScript Code von etracker ausgeliefert und kann z. B. so eingebaut werden:

<script>
    function testCall(){
        if(typeof(_etracker) === 'object') {
            et_eC_Wrapper({et_et: 'ACCOUNTSCHLÜSSEL', et_pagename: 'pagename', et_areas: 'Bereich1/Bereich2/Bereich3', et_seg1: 'Eigenes Segment 1'});
        }
    }
</script>

Damit der Aufruf der Wrapper-Funktion durch eventuell geblockten etracker Code, bspw. durch den Ausschluss von der Zählung, nicht zu einem JavaScript-Fehler führt, wird mit typeof zunächst das Vorhandensein des etracker Objektes überprüft.

Parameter des Wrappers

Der Parameter et_et für den Account-Schlüssel ist ein Pflichtparameter. Alle weiteren Parameter sind optional:

Wenn die optionalen Parameter nicht ausdrücklich gesetzt sind, werden die Werte übernommen, die beim letzten Seitenaufruf an etracker übermittelt wurden. Die Werte können über den Standard Tracking Code bei Seitenaufruf der Seite im Browser oder über den Wrapper beim dynamischen Laden der Seite übermittelt werden.

Folgender Aufruf erzeugt die gleichen Daten wie der ursprüngliche Aufruf über den Standard Tracking Code:

<script>
    if(typeof(_etracker) === 'object') {
        et_eC_Wrapper({et_et: 'ACCOUNTSCHLÜSSEL'});
    }
</script>

<script>
    if(typeof(_etracker) === 'object') {
        et_eC_Wrapper(
            {
                et_et: 'ACCOUNTSCHLÜSSEL',
                et_pagename:'Suchergebnisse',
                et_areas: 'DE/Suche',
                cc_attributes:{etcc_cu:'onsite',etcc_med_onsite:'Interne Suche',etcc_cmp_onsite:'Mit Ergebnis',etcc_st_onsite:'Stiefel'},
                et_seg1: 'eingeloggt',
                et_seg2: 'B2B'
            }
            );
        }
</script>

Allgemeine Hinweise zur Wrapper-Funktion

Erfassung von Events im Zusammenspiel mit dem Wrapper

Werden Events im Rahmen des etracker Event Trackings an etracker übermittelt, so werden diese dem Seitennamen zugewiesen, der zuletzt vor dem Auslösen des Events an etracker übermittelt wurde. Wurde bspw. ein Seitenaufruf zunächst mittels Wrapper ausgelöst und danach ein Event getrackt, so wird das Event in der Auswertung dem Seitennamen zugeordnet, der mit dem Wrapper an etracker übermittelt wurde.

Erfassung von URLs im Zusammenspiel mit dem Wrapper

Da über den Wrapper keine URL an etracker übermittelt werden kann, weist etracker die Seitenaufrufe, die mittels Wrapper an etracker übertragen werden, immer der URL zu, die in der Eigenschaft document.location.href gespeichert ist.