WS-Tracking (DE)

Was sind Tracking- bzw. Analyse-Daten?

WEBSALE übermittelt an externe Systeme bestimmte Shopdaten in Echtzeit zur weiteren Verarbeitung. Diese Daten sind somit die Grundlage für alle shopspezifischen Statistik-Auswertungen.

Es werden keine personenbezogenen Daten übermittelt, sondern nur allgemeine Daten wie z. B.

  • angezeigte Seite (Name der Seite)

  • angezeigte Kategorie (Kategorie-Name)

  • angezeigter Artikel (Artikelname und Artikelnummer)

  • Bestellte Artikel (Artikelname, Artikelnummer, Menge und Preis)

  • PLZ, Ort und Land der Rechnungs- und Lieferadresse

  • Zahlungsart und Zustellung

  • etc.

Datenschnittstelle

WEBSALE übergibt die Daten in JavaScript-Variablen, die wiederum per JavaScript ausgelesen und verarbeitet werden können. Das JavaScript, das die übergebenen Variablen verarbeitet, wird in der Regel vom externen Dienstleister erstellt.

Auf jeder von WEBSALE generierten Seite werden vom Shopsystem die entsprechende JavaScript-Variablen gesetzt.

Der allgemeine Aufbau sieht folgendermaßen aus:

<html> <head> ... </head> <body> ... ... <script language="JavaScript"> <!-- var ws_state="Start"; var ws_page_name="Startseite"; var ... ... //--> </script> <script src="<JavaScript-Datei>" type="text/javascript"></script> </body> </html>

Am Ende der HTML-Seite werden die entsprechenden Code-Teile von WEBSALE eingesetzt. Zuerst werden dort von WEBSALE die JavaScript-Variablen gesetzt. Anschließend wird eine JavaScript-Datei aufgerufen, das die von WEBSALE gesetzten Werte ausliest, weiterverarbeitet und an das externe System übermittelt.

Das JavaScript wird in der Regel vom externen Dienstleister erstellt.

Beschreibung der Variablen

Auf jeder Seite wird die Variable "ws_state" gesetzt, die den Status bzw. Zustand angibt. Abhängig von dieser Variablen, folgen weitere Variablen.

Netto-/Brutto-Preise

In einem Netto-Shop werden alle Preise bzw. Kosten (außer ws_basket_total) in Netto (exklusive MwSt.) ausgegeben. In einem Brutto-Shop werden alle Preise bzw. Kosten in Brutto (inklusive MwSt.) ausgegeben.

Einige Kosten (Warenwert, Gesamtsumme etc.) werden in Netto und Brutto ausgegeben.

Standard-Variablen

Standard-Variablen werden auf jeder Seite ausgegeben und können auch leer sein.

Variable

Bedeutung

Variable

Bedeutung

ws_state

Status bzw. Zustand in dem sich der Shop befindet, wenn die Seite angezeigt wird.

ws_shopid

Die ShopID wird von WEBSALE vergeben und existiert zu jedem WEBSALE-Shop.

ws_subshopid

Die SubshopID wird von WEBSALE vergeben und existiert zu jedem WEBSALE-Shop. Subshops werden z. B. für weitere Shop-Sprachen verwendet, können aber auch einen Endkundenshop (B2C) oder Händlershop (B2B) repräsentieren.

ws_sid

Session-ID des Shops

Diese 32-stellige ID wird für jeden Shop-Besuch eindeutig generiert. Mit Ihr lässt sich damit eine exakte Anzahl der Besuche messen.

ws_extid

Diese optionale ID wird von einem externen Dienstleister vergeben.

ws_page_name

Name der angezeigten Shop-Seite, z. B. "Warenkorb"

ws_data_type

Mögliche Werte:
basic: Es werden nur Standardinformationen ausgegeben
advanced: Es werden zusätzliche Informationen ausgegeben, die in dieser Dokumentation blau markiert sind.

ws_order

Mögliche Werte:
yes: Seite ist Teil des Bestellprozesses.
no: Seite ist kein Bestandteil des Bestellprozesses

ws_referer

Wird beim Aufruf des Shop optional mit übergeben

z. B. “...&ref=google“

ws_subreferer

Weitere Infos zum Referer

Wird beim Aufruf des Shop optional mit übergeben

z. B. “...&subref=banner26“

ws_http_referer

HTTP-Referer. Komplette URL, von der der Shop aufgerufen wurde.

Bitte beachten Sie:
Ein HTTP-Referer wird nicht immer vom Browser übergeben!

ws_login_type

Aktueller Zustand der Anmeldung/Registrierung

Mögliche Werte:
na: Kunde ist (noch) nicht angemeldet
login: Altkunde hat sich angemeldet
register: Neukunde hat sich registriert

ws_tp1

Ein optionaler Parameter (maximal 128 Zeichen), der zusätzlich beim Aufruf des Shops (mit “&ws_tp1=...“) übergeben werden kann.
Der Wert wird von WEBSALE auf jeder Seite ausgegeben.
Wenn dieser Parameter beim Aufruf fehlt, dann gibt WEBSALE einen Leerstring zurück (ws_tp1=““).

ws_tp2

Bedeutung und Handling wie bei “ws_tp1“

ws_tp3

Bedeutung und Handling wie bei “ws_tp1“

ws_gclid

Optionale GoogleClickID (maximal 64 Zeichen), die zusätzlich beim Aufruf des Shops (mit „&gclid=...“) übergeben werden kann.
Der Wert wird von WEBSALE auf jeder Seite ausgegeben.
Wenn dieser Parameter beim Aufruf fehlt, dann gibt WEBSALE einen Leerstring zurück (ws_gclid=““).

ws_test

Mögliche Werte:
yes: Der Shop befindet sich im Testmodus
no: Der Shop befindet sich nicht im Testmodus

ws_userindex_md5

MD5-Hash (16 Byte, 32 Zeichen) des Userindexes. Der UserIndex ist eine eindeutige ID, wenn sich ein User im Shop anmeldet oder neu registriert. Diese ID wird nur einmal vergeben und bleibt für einen User über den gesamten Zeitraum konstant. Für nicht angemeldete User ist dieser Parameter leer.

ws_email_md5

MD5-Hash (16 Byte, 32 Zeichen) der E-Mail-Adresse. Dieser Wert wird erst dann ausgegeben, wenn der Shop die E-Mail-Adresse des Bestellers kennt.

ws_price_type

Werte:
net: Alle Preise/Kosten außer „ws_basket_total“ sind Netto
gross: Alle Preise/Kosten sind Brutto

ws_currency

Währungscode nach ISO 4217, z. B. „EUR“ für Euro

ws_currency_display

Optionale Zielwährung nach ISO 4217, wenn mehrere Subshops mit unterschiedlichen Währungen arbeiten

ws_exchange_rate

Optionaler Umrechnungskurs, bezogen auf die Zielwährung.

Beispiel:
Basiswährung: USD
Zielwährung: EUR
ws_exchange_rate = 1.3072

Tabelle der möglichen Zustände

Zustand "ws_state"

Beschreibung

zusätzliche Variablen

Zustand "ws_state"

Beschreibung

zusätzliche Variablen

Start

Startseite

 

Category

Anzeige einer Kategorie

ws_cat_name (Name der Kategorie)
ws_cat_index (Index der Kategorie)

Product

Anzeige eines Artikels

ws_cat_name
ws_cat_index
ws_prod_name (Artikelname)
ws_prod_number (Artikelnummer)
ws_prod_index (Produktindex)

Basket

Anzeige des Warenkorbes

 

AddBasket

Ein oder mehrere Artikel wurden in den Warenkorb gelegt

ws_add_basket_positions (Anzahl hinzugefügter Positionen)

ws_add_basket_mainpositions (Anzahl hinzugefügter Haupt-Positionen im Warenkorb, berücksichtigt alle Positionen außer versteckte Positionen und Set-Unterprodukte)

ws_add_basket_quantities (Anzahl hinzugefügter Artikel)

ws_add_basket_mainquantities (Anzahl hinzugefügter Haupt-Artikel im Warenkorb, berücksichtigt alle Positionen außer versteckte Positionen und Set-Unterprodukte)

Die folgenden Informationen werden bei ws_data_type=advanced ausgegeben!

ws_add_basket_subtotal (Warenwert der hinzugefügten Artikel)

ws_add_basket[i][1] (Artikelnummer)

ws_add_basket[i][2] (Artikelname)

ws_add_basket[i][3] (Preis)

ws_add_basket[i][4] (Menge)

ws_add_basket[i][5] (Kategorie-Pfad)

ws_add_basket[i][6] (Produktindex)

ws_add_basket[i][7] (MwSt.-Satz, z. B. „19“)

ws_add_basket[i][8] (Gesamtsumme)

ws_add_basket[i][9] (Set-Oberprodukt ja/nein)

ws_add_basket[i][10] (Set-Unterprodukt ja/nein)

ws_add_basket[i][11] (versteckte Position ja/nein)

i=1 ... n

n= Anzahl Positionen im Warenkorb

DelBasket

Ein oder mehrere Artikel wurden aus dem Warenkorb gelöscht

ws_del_basket_positions (Anzahl gelöschter Positionen)

ws_del_basket_mainpositions (Anzahl gelöschter Haupt-Positionen im Warenkorb, berücksichtigt alle Positionen außer versteckte Positionen und Set-Unterprodukte)

ws_del_basket_quantities (Anzahl der gelöschten Menge)

ws_del_basket_mainquantities (Anzahl der gelöschten Haupt-Artikel im Warenkorb, berücksichtigt alle Positionen außer versteckte Positionen und Set-Unterprodukte)

Die folgenden Informationen werden bei ws_data_type=advanced ausgegeben!

ws_del_basket_subtotal (Warenwert der gelöschten Artikel)

ws_del_basket[i][1] (Artikelnummer)

ws_del_basket[i][2] (Artikelname)

ws_del_basket[i][3] (Preis)

ws_del_basket[i][4] (Menge)

ws_del_basket[i][5] (Kategorie-Pfad)

ws_del_basket[i][6] (Produktindex)

ws_del_basket[i][7] (MwSt.-Satz, z. B. „19“)

ws_del_basket[i][8] (Gesamtsumme)

ws_del_basket[i][9] (Set-Oberprodukt ja/nein)

ws_del_basket[i][10] (Set-Unterprodukt ja/nein)

ws_del_basket[i][11] (versteckte Position ja/nein)

i=1 ... n

n= Anzahl Positionen im Warenkorb

Address

Eingabe der Rechnungsadresse

 

DelivAddress

Eingabe einer abweichenden Lieferadresse

 

PayDeliv

Angabe der Zahlungsart und Zustellung

 

Conditions

Anzeige der AGB-Seite

 

PlaceOrder

Bestellübersicht, Bestellung absenden

 

Confirm

Bestätigungsseite

Die folgenden Informationen werden bei ws_data_type=advanced ausgegeben!

ws_order_number (Eindeutige Auftragsnummer)

ws_basket_positions (Anzahl Positionen im Warenkorb)

ws_basket_mainpositions (Anzahl Haupt-Positionen im Warenkorb, berücksichtigt alle Positionen außer versteckte Positionen und Set-Unterprodukte)

ws_basket_quantities (Anzahl Artikel im Warenkorb)

ws_basket_mainquantities (Anzahl Haupt-Artikel im Warenkorb, berücksichtigt alle Positionen außer versteckte Positionen und Set-Unterprodukte)

ws_basket_subtotal (Warenwert, Brutto oder Netto)

ws_basket_subtotal_net (Warenwert Netto)

ws_basket_subtotal_gross (Warenwert Brutto)

ws_basket_total (Gesamtsumme, immer Brutto)

ws_basket_total_net (Gesamtsumme Netto)

ws_affiliate_provider (Name des Affiliate Betreibers)

ws_affiliate_partner_id (Affiliate PartnerID)

ws_delivery_name (Name der Zustellung)

ws_delivery_cost (Lieferkosten)

ws_payment_name (Name der Zahlungsart)

ws_payment_cost (Kosten der Zahlungsart)

ws_total_discount (gewährter Gesamtrabatt)

ws_a_zip (PLZ der Rechnungsadresse)

ws_a_city (Ort der Rechnungsadresse)

ws_a_country (Land der Rechnungsadresse)

ws_a_number (MD5-Hash der Kundennummer)

ws_d_zip (PLZ der abw. Lieferadresse)

ws_d_city (Ort der abw. Lieferadresse)

ws_d_country (Land der abw. Lieferadresse)

ws_basket[i][1] (Artikelnummer)

ws_basket[i][2] (Artikelname)

ws_basket[i][3] (Preis)

ws_basket[i][4] (Menge)

ws_basket[i][5] (Kategorie-Pfad)

ws_basket[i][6] (Produktindex)

ws_basket[i][7] (MwSt.-Satz, z. B. „19“)

ws_basket[i][8] (Gesamtsumme)

ws_basket[i][9] (Set-Oberprodukt ja/nein)

ws_basket[i][10] (Set-Unterprodukt ja/nein)

ws_basket[i][11] (versteckte Position ja/nein)

ws_basket[i][12] (Commission Info)

ws_basket[i][13] (AdditionalInput-Felder)
Format:

{ "additionalinput1" : "value1", "additionalinput2" : "value2" ... }

ws_basket[i][14] (ExtraInput-Felder)
Format:

{ "extrainput1" : "value1", "extrainput2" : "value2" ... }

ws_basket[i][15] (freie Felder im Warenkorb)
Format:

ws_basket[i][16] (Anzahl an verwendeten Adressen der Position (bei MultiALA)/leer, wenn MultiALAs nicht verwendet)

i=1 ... n
n= Anzahl Positionen im Warenkorb

Optionale Kosten bei einer klimaneutralen Produktion
ws_climateneutral_cost (Netto oder Brutto)
ws_climateneutral_cost_net (Netto)
ws_climateneutral_cost_gross (Brutto)

Optionale Kosten bei Web2Print
ws_web2print_cost (Netto oder Brutto)
ws_web2print_cost_net (Netto)
ws_web2print_cost_gross (Brutto)

ProductRecmd

Artikel weiterempfehlen

ws_cat_name
ws_prod_name
ws_prod_number
ws_prod_index

ProductRecmdConfirm

Bestätigung Artikel weiterempfehlen

ws_cat_name
ws_prod_name
ws_prod_number
ws_prod_index

Voucher

Seite Gutscheinnummer eingeben

 

Notify

Allgemeine Meldungsseite

ws_notify_msg (Text der Meldung)

OrderHistory

Seite Warenkorbhistorie (Bestellhistorie)

 

Search

Suchergebnisse

ws_search_phrase (Sucheingabe)

ws_search_results (Anzahl Treffer der Suche)

MemoList

Merkliste anzeigen

 

PrintConfirm

Druckansicht der Bestätigungsseite

 

Login

Anmeldung bzw. Registrierung im Shop

ws_login_error (Fehler bei Anmeldung/Registrierung)

na: Anmeldeseite wurde aufgerufen

error: Allgemeiner Fehler

uid_pw: Ungültige Benutzerkennung oder ungültiges Passwort bei Bestandskundenanmeldung

new_uid: UserID existiert bereits beim Registrieren oder ist falsch bei einer Neukundenregistrierung

new_pw: Falsches Passwort bei einer Neukundenregistrierung

change_uid: UserID existiert bereits oder ist falsch bei "UserID ändern"

change_pw: Passwort ist falsch bei "Passwort ändern"

UserAccount

Kundenkonto

 

Template

Ein beliebiges Template

ws_template_name

DirectOrder

Direktbestellung

 

Logout

Abmeldung

 

Hinweise zu den Parametern:

ws_affiliate_provider

Name des Affiliate Betreibers. Derzeit werden von WEBSALE folgende Betreiber unterstützt:

  • Adbutler

  • Affilinet

  • Awin (ehem. Zanox)

  • TradeDoubler

Bitte beachten Sie:
Der Parameter wird nur dann gesetzt, wenn der entsprechende Affiliate-Betreiber für Ihren Shop freigeschaltet wurde. Bitte kontaktieren Sie hierzu die WEBSALE AG.

ws_affiliate_partner_id

Die PartnerID, über die der Shop aufgerufen wurde. An diese PartnerID wird die Provision gezahlt.

WEBSALE hält sich die PartnerID für eventuelle Folgebestellungen noch 4 Wochen in einem Cookie.

Der Parameter "ws_affiliate_partner_id" entspricht dem folgenden Übergabeparameter des Betreibers:

Betreiber

Übergabeparameter des Betreibers

Betreiber

Übergabeparameter des Betreibers

Adbutler

fp

Affilinet

ref

Awin (ehem. Zanox)

PartnerID

TradeDoubler

tduid

Bitte beachten Sie:
Der Parameter wird nur dann gesetzt, wenn der entsprechende Affiliate-Betreiber für Ihren Shop freigeschaltet wurde. Bitte kontaktieren Sie hierzu die WEBSALE AG.

Produktindex

Der Produktindex ist ein variantenunabhängiger, eindeutiger Index je Artikel. Eine Artikelnummer hingegen kann sich je Variante ändern.

Beispiel: Hose mit Varianten

Farbe

Größe

Artikelnummer

Produktindex

Farbe

Größe

Artikelnummer

Produktindex

rot

42

12345-1

24-2333

rot

43

12345-2

24-2333

blau

42

12345-3

24-2333

Beispiele

Standard-Parameter auf allen Seiten

Aufruf der Startseite

Anzeige einer Kategorie

Als Kategorie-Name wird stets der vollständige Pfad mit "/" getrennt angezeigt.

Anzeige eines Artikels

Einen Artikel mit der Menge 3 dem Warenkorb hinzufügen ws_data_type=advanced

Einen Artikel mit der Menge 1 aus dem Warenkorb löschen ws_data_type=advanced

Aufruf der Anmelde-Seite

Fehlerhafte Anmeldung eines Altkunden, UserID bzw. Passwort falsch

Fehlerhafte Registrierung eines Neukunden, UserID existiert bereits

Bestellbestätigung mit 1 Artikel ohne abweichende Lieferadresse und ohne Kundennummer ws_data_type=advanced

Bestellbestätigung mit 2 Artikeln mit abweichender Lieferadresse und mit Kundennummer ws_data_type=advanced

Die Kundennummer ist 32 Zeichen lang und wird aus einem 16Byte MD5-Hash gebildet.

Bestellbestätigung mit ws_data_type=basic

Anzeige der Suchergebnisse

 

Auf der folgenden Seite finden Sie Beispiel-Dateien: Beispieldateien für WS-Tracking