WS-Tracking (DE)
- René Meyer
- Rainer Biedermann
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 |
|---|---|
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: |
ws_order | Mögliche Werte: |
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: |
ws_login_type | Aktueller Zustand der Anmeldung/Registrierung Mögliche Werte: |
ws_tp1 | Ein optionaler Parameter (maximal 128 Zeichen), der zusätzlich beim Aufruf des Shops (mit “&ws_tp1=...“) übergeben werden kann. |
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. |
ws_test | Mögliche Werte: |
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: |
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: |
Tabelle der möglichen Zustände
Zustand "ws_state" | Beschreibung | zusätzliche Variablen |
|---|---|---|
Start | Startseite |
|
Category | Anzeige einer Kategorie | ws_cat_name (Name der Kategorie) |
Product | Anzeige eines Artikels | ws_cat_name |
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) {
"additionalinput1" : "value1",
"additionalinput2" : "value2"
...
}ws_basket[i][14] (ExtraInput-Felder) {
"extrainput1" : "value1",
"extrainput2" : "value2"
...
}ws_basket[i][15] (freie Felder im Warenkorb) ws_basket[i][16] (Anzahl an verwendeten Adressen der Position (bei MultiALA)/leer, wenn MultiALAs nicht verwendet) i=1 ... n Optionale Kosten bei einer klimaneutralen Produktion Optionale Kosten bei Web2Print |
ProductRecmd | Artikel weiterempfehlen | ws_cat_name |
ProductRecmdConfirm | Bestätigung Artikel weiterempfehlen | ws_cat_name |
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 |
|---|---|
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 |
|---|---|---|---|
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