Skip to end of metadata
Go to start of metadata

You are viewing an old version of this page. View the current version.

Compare with Current View Page History

« Previous Version 6 Next »

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.

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:
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

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:
{
"style" :"value1",
"material" :"value2"
...
}

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

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

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

<script language="JavaScript">
<!--
<Standard-Parameter (siehe oben)>
var ws_state="Start";
var ws_page_name="Startseite";
//-->
</script>

Anzeige einer Kategorie

<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

<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

<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

<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

<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

<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

<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

<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

<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

<script language="JavaScript">
<!--
<Standard-Parameter (siehe oben)>
var ws_state="Confirm";
var ws_page_name="Bestellbestätigung";
//-->
</script>

Anzeige der Suchergebnisse

<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>

  • No labels