Dynamische Inhalte: Wrapper

Mit dem Wrapper können virtuelle Seitenaufrufe ohne den ausdrücklichen Aufruf einer Webseite gemessen werden. So lassen sich auch Single Page Applications (SPAs) differenziert messen, d.h. Websites, die eine einzige HTML-Seite laden und diese dynamisch aktualisieren, ohne sie neu zu laden.

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:

Variable	Type	Bedeutung	Beschreibung
et_pagename	String	Seitenname	Eindeutiger Name der Seite.
et_areas	String	Bereichsname	Bezeichnung des Seitenbereichs.
et_tval	Float	Gesamtbestellwert	Netto Umsatz, der durch die Zielerreichung generiert wurde.
et_tonr	String	Bestellnummer	Eindeutige Bestellnummer (ohne Kommas und Semikolons)
et_tsale	Integer	Bestellstatus	Bestellstatus für Umsatzziele: 0 = Lead 1 = Sale 2 = Vollstorno
et_basket	String	Warenkorb	Vom Shopsystem vergebene Parameter zum Zuordnen der Warenkorbartikel (ArtNr,ArtName,ArtGruppe,Anzahl,Preis)
cc_attributes	String	Kampagnen-Attribute	Attributname und Attributwert für Kampagnen
et_seg1	String	Eigenes Segment	Inhalt des eigenen Segments

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>

Beispiel für einen vollständigen Aufruf:

<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 Wrappers 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 Wrappers an etracker übertragen werden, immer der URL zu, die in der Eigenschaft document.location.href gespeichert ist.

Hinweise für den Einsatz des Wrappers bei Single Page Applications (SPAs)

Eine eindeutige URL steht bei SPAs für die Auswertung nicht zur Verfügung. Um dennoch eine eindeutige Auswertung der einzelnen Inhalte zu gewährleisten, sollte besonders darauf geachtet werden, dass jede virtuelle Seite einen eindeutigen und in der Auswertung leicht nachzuvollziehenden Seitennamen erhält.

Falls dies wegen der Vielzahl an Inhalten oder aus anderen Gründen nicht möglich ist, empfehlen wir, keine sprechenden Seitennamen zu verwenden, sondern stattdessen virtuelle Seitenpfade über et_pagename an etracker zu übermitteln.

Integration & Setup

Einbau des Wrappers

Parameter des Wrappers

Allgemeine Hinweise zur Wrapper-Funktion