<< Click here to display Table of Contents >> Navigation: Wegweiser > Externe Dienste > Tracking-Schnittstelle:

Integration der Tracking-Schnittstelle

Datenschutz-Hinweis:

Gemäß aktueller Rechtsprechung reicht ein einfacher Hinweis auf jegliche Instrumente der Werbewirksamkeitsforschung, des Marketings oder der Verkaufsförderung nicht mehr aus. Zu diesen Instrumenten gehören beispielsweise Cookies oder Tracking (Datenverarbeitung durch Dritte). Auch als Voreinstellung aktivierte Optionen sind unzulässig.
Vielmehr muss der Shopbesucher aktiv bestätigen, dass er mit der Verwendung o. g. Instrumente auf seinem Endgerät einverstanden ist. Bei zustimmungspflichtigen Instrumenten und Funktionen muss also stets ein Opt-In-Verfahren gewählt werden (Kunde klickt aktiv Kästchen an, um seine Zustimmung zu signalisieren). Dieses Verfahren gewährleistet, dass erst nach ausdrücklicher Zustimmung erstmals Daten übertragen werden. Bitte wenden Sie sich zur Klärung von Einzelheiten und zum Abgleich mit der aktuellen Rechtsprechung stets an Ihren Datenschutzbeauftragten.

Die Tracking-Schnittstelle ist dafür konzipiert, alle tracking-spezifischen JavaScripts verschiedener Tracking-Dienstleister aufzunehmen.

Inhalt

1 Integration mit PageSpeed-Tool (empfohlen)

2 Integration ohne PageSpeed-Tool

3 Integration im <head>-Bereich

4 Integration in Verbindung mit AJAX-basierten Funktionen

5 Nutzung des Datenbereichs der Tracking-Schnittstelle

1 Integration mit PageSpeed-Tool (empfohlen)

In Verbindung mit dem PageSpeed-Tool gibt es die klassische Tracking-Datei (ws_analyse.js) nicht mehr. Alle Tracking-Scripts, die normalerweise zentral in der Tracking-Datei (ws_analyse.js) gespeichert werden, werden jetzt als einzelne JavaScript-Dateien im Ordner js_upload bereitgestellt. Im PageSpeed-Tool wird dann eine Gruppierung erstellt, der diese Tracking-Scripts zugewiesen werden. Diese Gruppierung wird automatisch auf allen Seiten an der gewünschten Stelle eingebunden.

Schritt 1: Freischalten der Tracking-Schnittstelle

Die Schnittstelle muss zunächst von der WEBSALE AG global freigeschaltet werden. Die Tracking-Schnittstelle verfolgt in der Basic-Version lediglich, welche Seiten angeklickt werden. Wenn die Schnittstelle in vollem Umfang genutzt werden soll (Conversion Tracking, Umsätze), wird die Advanced-Version der Schnittstelle benötigt. WEBSALE schaltet seit April 2019 als Standard die Advanced-Version der Tracking-Schnittstelle frei. Auf die Vorgehensweise bei der Integration hat die Wahl zwischen Basic und Advanced keinen Einfluss.

Schritt 2: Bereitstellen der Tracking-Scripts im PageSpeed-Tool

Speichern Sie Ihre gewünschten Tracking-Scripts im Ordner js_upload.

Nach dem Bereitstellen sehen Sie diese Dateien in der rechten Spalte des PageSpeed-Tools unter der Überschrift "Ihre JavaScript-Bibliotheken".

Legen Sie dann eine neue Gruppierung, z. B. tracking, im PageSpeed-Tool an. Fügen Sie jetzt die gewünschten JavaScript-Dateien per Drag-and-Drop (innerhalb des OSB-Bereichs) der Gruppierung hinzu. Haben Sie die Zuweisung abgeschlossen, klicken Sie auf das Weltkugel-Icon, um die optimierte JavaScript-Datei Ihrer Gruppierung tracking zu erstellen.

Schritt 3: Zuweisen der Gruppierung über die Shopkonfiguration shop.config

Der Tracking-Code und der Aufruf Ihrer Tracking-Gruppierungsdatei muss unmittelbar vor dem schließenden <body>-Tag aller Shopseiten platziert werden. Um dies automatisch mit der Aktivierung der Tracking-Schnittstelle in Ihrer Shopkonfiguration shop.config zu erreichen, müssen Sie die Gruppierung in der Shopkonfiguration shop.config zuweisen. Eine Anpassung der Templates ist weiterhin nicht notwendig.

Tragen Sie in der Shopkonfiguration shop.config im Abschnitt <Basic> den Namen Ihrer Gruppierung (Gruppierungs-ID) ein:

<Basic>
   ...
   DataAnalysis-JSID = tracking
   ...
</Basic>

Referenz: Abschnitt Basic

Schritt 4: Aktivieren der Tracking-Schnittstelle für Ihren Subshop

Sie können für jeden einzelnen Subshop bestimmen, ob die Tracking-Schnittstelle aktiviert oder deaktiviert werden soll. Diese Einstellung nehmen Sie in Ihrer Shopkonfiguration shop.config im Abschnitt <Basic> mit dem Parameter DataAnalysis-Allow = vor.

<Basic>
   ...
   DataAnalysis-Allow = yes
   ...
</Basic>

Referenz: Abschnitt Basic

Schritt 5: Integrieren der Tracking-Datei (ws_analyse.js) in die gewünschten Templates

Indem Sie Ihre Gruppierungs-ID in der Shopkonfiguration shop.config zugewiesen haben, wurden automatisch der Tracking-Code und der Aufruf der Gruppierungs-Datei (z. B. tracking) vor dem schließenden <body>-Tag auf allen Shopseiten eingefügt. Die Templates müssen nicht weiter angepasst werden.

Materialien: Beispiel des Trackings auf einer Shopseite

2 Integration ohne PageSpeed-Tool

Schritt 1: Freischalten der Tracking-Schnittstelle

Die Schnittstelle muss zunächst von der WEBSALE AG global freigeschaltet werden.
WEBSALE stellt als Standard die Advanced-Version der Tracking-Schnittstelle zur Verfügung, die z. B. Conversion Tracking und Nachverfolgung der Umsätze ermöglicht. Auch die Basic-Version wird weiterhin unterstützt. (Die Basic-Version verfolgt lediglich, welche Seiten angeklickt werden. Wenn die Schnittstelle in vollem Umfang genutzt werden soll, wird die Advanced-Version der Schnittstelle benötigt.)
Auf die Vorgehensweise bei der Integration hat die Wahl zwischen Basic und Advanced keinen Einfluss.

Schritt 2: Aktivieren der Tracking-Schnittstelle für Ihren Subshop

<Basic>
   ...
   DataAnalysis-Allow = yes
   ...
</Basic>

Referenz: Abschnitt Basic

Schritt 3: Bereitstellen der Tracking-Datei (ws_analyse.js)

Legen Sie eine JavaScript-Datei mit dem Namen ws_analyse.js an und speichern Sie diese direkt im Templateverzeichnis benutzer/templates/. Dadurch ist diese Datei Subshop-übergreifend und kann für alle Subshops verwendet werden.

Die Datei "ws_analyse.js" ist dafür konzipiert, alle tracking-spezifischen JavaScripts verschiedener Tracking-Dienstleister aufzunehmen. Wenn Sie von einem Anbieter eine Datei mit Namen "ws_analyse.js" erhalten, müssen Sie deshalb den Inhalt per Kopie in die gleichnamige Datei im Shopverzeichnis einfügen. Sie sollten den Beginn und das Ende jedes Tracking-Codes mit Kommentarzeilen versehen, damit Sie später die JavaScripts der verschiedenen Dienstleister leichter identifizieren können.

Schritt 4: Integration der Tracking-Datei (ws_analyse.js) in die gewünschten Templates

Mit der Aktivierung der Tracking-Schnittstelle in Ihrer Shopkonfiguration shop.config platziert WEBSALE V8s automatisch den Tracking-Code und den Aufruf der Tracking-Datei (ws_analyse.js) vor das schließende <body>-Tag aller Shopseiten. Es muss keine Anpassung der Templates vorgenommen werden.

Materialien: Beispiel des Trackings auf einer Shopseite

3 Integration im <head>-Bereich

Standardmäßig wird der Tracking-Code und der Aufruf der Tracking-Datei (ws_analyse.js) vor dem schließenden <body>-Tag aller Shopseiten platziert. Einige Tracking-Systeme wünschen jedoch eine Platzierung vor dem schließenden <head>-Tag.

Schritt 1: Freischalten der freien Positionierung

Die freie Positionierung muss von WEBSALE freigeschaltet werden. Nur so kann sichergestellt werden, dass der Tracking-Code und der Aufruf der Tracking-Datei (ws_analyse.js) nur an einer Stelle erfolgt.

Ohne vorherige Freischaltung durch die WEBSALE-Technik wird der Tracking-Code und Aufruf der Tracking-Datei (ws_analyse.js) mehrfach eingebunden und kann das Tracking verfälschen.

Schritt 2: Integration im Template

Mittels des Tags WS-ExternalStatistics kann man den Tracking-Code und den Aufruf der Tracking-Datei (ws_analyse.js) an einer beliebigen Stelle (also auch im <head>) ausgeben lassen. Wird das Tag auf einem Template platziert, entfällt die automatische Positionierung vor dem schließenden <body>-Tag.

<head>
   ...
    ~WS-ExternalStatistics~
   ...
</head>

Soll nur der Datenbereich der Tracking-Schnittstelle ausgegeben werden, um die Daten auf einem beliebigen Template zu verwenden, nutzen Sie das Tag WS-ExternalStatisticsData.

Referenz: WS-ExternalStatisticsData

	Hinweis:
	Auf allen Templates, in denen das Tag WS-ExternalStatistics nicht integriert wurde, kann der Tracking-Code und der Aufruf der Tracking-Datei (ws_analyse.js) automatisch vor dem schließenden <body>-Tag eingebunden werden. Dies muss jedoch von der WEBSALE Technik freigeschaltet/aktiviert werden. Ihr WEBSALE Ansprechpartner ist gerne für Sie da.

Referenz: WS-ExternalStatistics

Materialien: Beispiel des Trackings auf einer Shopseite

4 Integration in Verbindung mit AJAX-basierten Funktionen

Wenn Sie AJAX-basierte Funktionen verwenden, wie z. B. "Produkte per AJAX in den Warenkorb legen", wird normalerweise der automatisch generierte Bereich vor dem HTML-Tag </body> nicht mit ersetzt bzw. ausgeführt. In diesem Fall können Sie die entsprechenden Informationen in einem zu ersetzenden div-Container an einer beliebigen Stelle durch das Tag WS-ExternalStatistics ausgeben lassen.

Durch die Klammerung mit ST-Ajax werden die Informationen nur bei einer AJAX-Anfrage ausgegeben.

Beispiel:

Ein zu trackendes Produkt per AJAX in den Warenkorb legen (Template "BasketAjaxSuccess.htm"):

<WS-Ajax-WK-Info>
.....
{ST-Ajax}
~WS-ExternalStatistics~
{/ST-Ajax}
</WS-Ajax-WK-Info>

Wegweiser: Produkt per AJAX in den Warenkorb legen

5 Nutzung des Datenbereichs der Tracking-Schnittstelle

Die Tracking-Schnittstelle gibt Daten aus, auf die man über ein Tag nicht zugreifen kann, wohl aber über die Variablendefinitionen der Tracking-Schnittstelle. Das Tag WS-ExternalStatisticsData gibt lediglich den Datenbereich der Tracking-Schnittstelle auf dem Template aus, ohne Scripts zu starten. Dieses Tag kann z. B. verwendet werden, um die Daten an beliebiger Stelle im Template aus- und an eine andere Instanz zu übergeben. Die Tracking-Datei (ws_analyse.js) und andere Scripts werden dadurch nicht eingebunden.

Dies ist sinnvoll in Fällen, wo im <head> der Seiten auf Variablen der Tracking-Schnittstelle zugegriffen werden soll (gemäß Google-Vorgabe), aber die JavaScripts aus der Tracking-Datei (ws_analyse.js) erst unmittelbar vor dem schließenden </body>-Tag geladen werden sollen.

Der Datenbereich der Tracking-Schnittstelle und die JavaScripts können auf diese Weise getrennt voneinander eingebunden werden.

Beispiel (für Google Tag Manager):

...
<body>
~WS-ExternalStatisticsData~

<script>
//individueller Google Tag Manager-Code, welcher auf die Datenfelder der Tracking-Schnittstelle zugreifen möchte, z.B.:

window.dataLayer = window.dataLayer || [];
dataLayer.push(
{
    'pageType': ws_state,
    .....
}
               );
}

</script>
...
</body>
...

Referenz: WS-ExternalStatisticsData