Scroll export button | ||||||||||
---|---|---|---|---|---|---|---|---|---|---|
|
Scroll ignore | ||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| ||||||||||||||||
Copyright (c) WEBSALE AG 2017-2019
- Vertraulich -
Weitergabe an Dritte nur mit Genehmigung der WEBSALE AG.
- Confidential -
Transfer to third parties only allowed with written permission of WEBSALE AG.
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.
...
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.
...
Der allgemeine Aufbau sieht folgendermaßen aus:<html>
<head>
...
</head>
<body>
...
...
<script
Code Block |
---|
<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)
|
|
|
|
ws_basket[i][14] (ExtraInput-Felder)
|
|
|
|
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:
...
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.
...
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
Code Block |
---|
var ws_shopid="test"; |
...
var ws_subshopid="deutsch"; |
...
var ws_sid="01b0e4e61dd4910fe09d79f07427e4"; |
...
var ws_extid="0815"; |
...
var ws_data_type="advanced"; |
...
var ws_order="no"; |
...
var ws_referer="xyz"; |
...
var ws_subreferer="123"; |
...
var ws_http_referer="http://www.domain.de/seite.htm"; |
...
var ws_login_type="na"; |
...
var ws_tp1="12345"; |
...
var ws_tp2=""; |
...
var ws_tp3=""; |
...
var ws_gclid=""; |
...
var ws_userindex_md5="" |
...
; ... |
Aufruf der Startseite
Code Block |
---|
<script language="JavaScript"> |
...
<!-- |
...
<Standard-Parameter (siehe oben)> |
...
var ws_state="Start"; |
...
var ws_page_name="Startseite"; |
...
//--> |
...
</script> |
Anzeige einer Kategorie
Code Block |
---|
<script language="JavaScript"> |
...
<!-- |
...
<Standard-Parameter (siehe oben)> |
...
var ws_state="Category"; |
...
var ws_page_name="Kategorie"; |
...
var ws_cat_name="Kleidung/Hosen/Jeans"; |
...
//--> |
...
</script> |
Als Kategorie-Name wird stets der vollständige Pfad mit "/" getrennt angezeigt.
Anzeige eines Artikels
Code Block |
---|
<script language="JavaScript"> |
...
<!-- |
...
<Standard-Parameter (siehe oben)> |
...
var ws_state="Product"; |
...
var ws_cat_name="Technik/Handys"; |
...
var ws_prod_name="Nokia 6100"; |
...
var ws_prod_number="123456"; |
...
//--> |
...
</script> |
Einen Artikel mit der Menge 3 dem Warenkorb hinzufügen ws_data_type=advanced
Code Block |
---|
<script language="JavaScript"> |
...
<!-- |
...
<Standard-Parameter (siehe oben)> |
...
var ws_state="AddBasket"; |
...
var ws_page_name="Warenkorb: Artikel hinzufügen"; |
...
var ws_add_basket_positions="1"; |
...
var ws_add_basket_quantities="3"; |
...
var ws_add_basket_subtotal="30.00" |
...
; var ws_add_basket = new Array(); |
...
ws_add_basket[1] = new Array(); |
...
ws_add_basket[1][1] = "12345"; |
...
ws_add_basket[1][2] = "Hose 123"; |
...
ws_add_basket[1][3] = "10.00"; |
...
ws_add_basket[1][4] = "3"; |
...
ws_add_basket[1][5] = "Kleidung/Hosen"; |
...
... |
...
//--> |
...
</script> |
Einen Artikel mit der Menge 1 aus dem Warenkorb löschen ws_data_type=advanced
Code Block |
---|
<script language="JavaScript"> |
...
<!-- |
...
<Standard-Parameter (siehe oben)> |
...
var ws_state="DelBasket"; |
...
var ws_page_name="Warenkorb: Artikel löschen"; |
...
var ws_del_basket_positions="1"; |
...
var ws_del_basket_quantities="1"; |
...
var ws_del_basket_subtotal="128.40"; |
...
var ws_del_basket = new Array(); |
...
ws_del_basket[1] = new Array(); |
...
ws_del_basket[1][1] = "112233"; |
...
ws_del_basket[1][2] = "Schuhe"; |
...
ws_del_basket[1][3] = "128.40"; |
...
ws_del_basket[1][4] = "1"; |
...
ws_del_basket[1][5] = "Kleidung/Schuhe"; |
...
... |
...
//--> |
...
</script> |
Aufruf der Anmelde-Seite
Code Block |
---|
<script language="JavaScript"> |
...
<!-- |
...
<Standard-Parameter (siehe oben)> |
...
var ws_state="Login"; |
...
var ws_login_type="input"; |
...
var ws_login_error="na"; |
...
//--> |
...
</script> |
Fehlerhafte Anmeldung eines Altkunden, UserID bzw. Passwort falsch
Code Block |
---|
<script language="JavaScript"> |
...
<!-- |
...
<Standard-Parameter (siehe oben)> |
...
var ws_state="Login"; |
...
var ws_login_type="input"; |
...
var ws_login_error="uid_err"; |
...
//--> |
...
</script> |
Fehlerhafte Registrierung eines Neukunden, UserID existiert bereits
Code Block |
---|
<script language="JavaScript"> |
...
<!-- |
...
<Standard-Parameter (siehe oben)> |
...
var ws_state="Login"; |
...
var ws_login_type="register"; |
...
var ws_login_error="new_uid"; |
...
//--> |
...
</script> |
Bestellbestätigung mit 1 Artikel ohne abweichende Lieferadresse und ohne Kundennummer ws_data_type=advanced
Code Block |
---|
<script language="JavaScript"> |
...
<!-- |
...
<Standard-Parameter (siehe oben)> |
...
var ws_state="Confirm"; |
...
var ws_page_name="Bestellbestätigung"; |
...
var ws_order_number="1234567890"; |
...
var ws_payment_name="Rechnung"; |
...
var ws_payment_cost="0.00"; |
...
var ws_delivery_name="DHL"; |
...
var ws_delivery_cost="5.50"; |
...
var ws_basket_positions="1"; |
...
var ws_basket_quantities="1"; |
...
var ws_basket_subtotal="123.00"; |
...
var ws_basket_total="128.00"; |
...
var ws_a_zip="90453" |
...
var ws_a_city="Nürnberg" |
...
var ws_a_Country="Deutschland" |
...
var ws_a_number="" |
...
var ws_basket = new Array(); |
...
ws_basket[1] = new Array(); |
...
ws_basket[1][1] = "12345"; |
...
ws_basket[1][2] = "Hose 123"; |
...
ws_basket[1][3] = "123.00"; |
...
ws_basket[1][4] = "1"; |
...
ws_basket[1][5] = "Kleidung/Hosen"; |
...
... |
...
//--> |
...
</script> |
Bestellbestätigung mit 2 Artikeln mit abweichender Lieferadresse und mit Kundennummer ws_data_type=advanced
Code Block |
---|
<script language="JavaScript"> |
...
<!-- |
...
<Standard-Parameter (siehe oben)> |
...
var ws_state="Confirm"; |
...
var ws_page_name="Bestellbestätigung"; |
...
var ws_payment_name="Nachnahme"; |
...
var ws_payment_cost="4.50"; |
...
var ws_delivery_name="UPS Standardpaket"; |
...
var ws_delivery_cost="7.50"; |
...
var ws_order_number="1234567890"; |
...
var ws_currency="EUR"; |
...
var ws_basket_positions="2"; |
...
var ws_basket_quantities="3"; |
...
var ws_basket_subtotal="200.00"; |
...
var ws_basket_total="205.00"; |
...
var ws_a_zip="90453" |
...
var ws_a_city="Nürnberg" |
...
var ws_a_Country="Deutschland" |
...
var ws_a_number="0033211ddddff34553432344448033221" |
...
var ws_d_zip="12345" |
...
var ws_d_city="Beispielstadt" |
...
var ws_d_Country="Deutschland" |
...
var ws_basket = new Array(); |
...
ws_basket[1] = new Array(); |
...
ws_basket[1][1] = "12345"; |
...
ws_basket[1][2] = "Hose 123"; |
...
ws_basket[1][3] = "100.00"; |
...
ws_basket[1][4] = "2"; |
...
ws_basket[1][5] = "Kleidung/Hosen" |
...
; ... |
...
ws_basket[2] = new Array(); |
...
ws_basket[2][1] = "11111"; |
...
ws_basket[2][2] = "Hose xyz"; |
...
ws_basket[2][3] = "100.00"; |
...
ws_basket[2[4] = "1"; |
...
ws_basket[1][5] = "Kleidung/Hosen"; |
...
... |
...
//--> |
...
</script> |
Die Kundennummer ist 32 Zeichen lang und wird aus einem 16Byte MD5-Hash gebildet.
Bestellbestätigung mit ws_data_type=basic
Code Block |
---|
<script language="JavaScript"> |
...
<!-- |
...
<Standard-Parameter (siehe oben)> |
...
var ws_state="Confirm" |
...
; var ws_page_name="Bestellbestätigung"; |
...
//--> |
...
</script> |
Anzeige der Suchergebnisse
Code Block |
---|
<script language="JavaScript"> |
...
<!-- |
...
<Standard-Parameter (siehe oben)> |
...
var ws_state="Search"; |
...
var ws_page_name="Suchergebnisse"; |
...
var ws_search_phrase="schuhe leder schwarz"; |
...
var ws_search_results="85"; |
...
//--> |
...
</script> |
Auf der folgenden Seite finden Sie Beispiel-Dateien: Beispieldateien für WS-Tracking
Include Page | ||||
---|---|---|---|---|
|