Integration von econda Tracking und econda ARP

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.

Es gibt zwei Möglichkeiten, econda Tracking (Analytics) zu integrieren:

▪mit WEBSALE Tracking-Schnittstelle

▪ohne WEBSALE Tracking-Schnittstelle

Bitte wählen Sie im Folgenden die zutreffende Integrationsbeschreibung.

Außerdem wird in diesem Kapitel die Integration von econda ARP beschrieben.
Inhalt

1 Integration von econda Tracking

1.1 ohne WEBSALE Tracking-Schnittstelle (empfohlen)

1.2 mit WEBSALE Tracking-Schnittstelle

2 Deaktivieren des econda Trackings (bei Integration mit Tracking-Schnittstelle)

3 Migration von econda Tracking "mit Tracking-Schnittstelle" zu "ohne Tracking-Schnittstelle"

 

4 Integration von econda ARP

 

1. Integration von econda Tracking

1.1 Integration von econda Tracking ohne WEBSALE Tracking-Schnittstelle (empfohlen)

Voraussetzung

Voraussetzung ist, einen entsprechenden Vertrag mit econda abzuschließen.

Sie erhalten dann den Zugang zur Dokumentation von econda, in der die entsprechende Integrationsanleitung zu finden ist.

Soll WEBSALE die Integration in den Shop vornehmen, teilen Sie bitte Ihrem WEBSALE-Ansprechpartner die Zugangsdaten von econda mit.

Schritt 1: Freischaltung/Aktivierung bei WEBSALE

Es ist keine Freischaltung/Aktivierung seitens WEBSALE erforderlich.

Schritt 2: Integration in die Shop-Templates

Die Integration erfolgt anhand der Dokumentation von econda, die Sie direkt von econda erhalten.

Je nach gewünschtem Tracking entnehmen Sie bitte der Dokumentation von econda die entsprechenden Codes und integrieren Sie diese in die Templates Ihres WEBSALE-Shops.

Beispiel:

<!-- ######################################################## -->
<!-- ######################################################## -->
<!-- Einbinden der Econda Dienste (global für alle Templates) -->
<!-- ######################################################## -->
<script>
    window.econda = {
        onReady: [],
        ready: function(f) { this.onReady.push(f);}
    };

    window.emos3 = {
        defaults : {
            siteid : 'Name Ihres Shops'
        },
        stored : [],
        plugins : [],
        send : function(p){this.stored.push(p);}
    };
</script>
<script type="text/javascript" defer="defer" src="https://l.ecn-ldr.de/loader/loader.js" client-key="XXXXXXXX-XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX" container-id="XXX"></script>


<!-- ######################################### --> 
<!-- Tracking Startseitenaufruf (ws_start.htm) -->
<!-- ######################################### --> 
<script type="text/javascript">
    window.emos3.send({
        content : 'Startseite',
		pageId: 'Startseite'
    });
</script>

  
<!-- ########################################### -->  
<!--  Tracking Kategorieaufruf (ws_category.htm) -->
<!-- ########################################### --> 
<script type="text/javascript">
    window.emos3.send({
        content : '{Cat-PathData}~DC-Int1_set(0)~{@CAT-PathRegular}~DC-Int1_inc~{!DC-Int1(1)}/{/!DC-Int1(1)}~CAT-Name_StripHtml~{/@CAT-PathRegular}{/Cat-PathData}',
		pageId: '~CAT-Index~'
    });
 </script>
 
 
<!-- ####################################### -->  
<!-- Tracking Produktaufruf (ws_product.htm) -->
<!-- ####################################### -->  
<script type="text/javascript">
    window.emos3.send({
	    content : '{Cat-PathData}~DC-Int1_set(0)~{@CAT-PathRegular}~DC-Int1_inc~{!DC-Int1(1)}/{/!DC-Int1(1)}~CAT-Name_StripHtml~{/@CAT-PathRegular}{/Cat-PathData}{PR-Data}/~PR-Name_StripHtml~{/PR-Data}',
		pageId: '~CAT-Index~~PR-Number~',
	    ec_Event:  [{
	    {PR-Data}
            type: 'view',
            pid: '~PR-ProdIndex~',
            sku: '~PR-Number~',
            name: '~PR-Name_StripHtml~',
            price: ~WS-DisablePriceAndNumberFormat~~PR-Price~~WS-EnablePriceAndNumberFormat~,
            group: '{Cat-PathData}~DC-Int1_set(0)~{@CAT-PathRegular}~DC-Int1_inc~{!DC-Int1(1)}/{/!DC-Int1(1)}~CAT-Name_StripHtml~{/@CAT-PathRegular}{/Cat-PathData}',
            var1: {PR-DepVariationValue1}'~PR-DepVariationValue1~'{/PR-DepVariationValue1}{!PR-DepVariationValue1}'null'{/!PR-DepVariationValue1},
            var2: {PR-DepVariationValue2}'~PR-DepVariationValue2~'{/PR-DepVariationValue2}{!PR-DepVariationValue2}'null'{/!PR-DepVariationValue2},
            var3: {PR-DepVariationValue3}'~PR-DepVariationValue3~'{/PR-DepVariationValue3}{!PR-DepVariationValue3}'null'{/!PR-DepVariationValue3},
            count: 1
	    {/PR-Data}
	}]
  });
</script>
  
  
<!-- ######################################################################## -->  
<!-- Tracking zum Warenkorb hinzufügen AddToCart (ws_basket_ajax_success.htm) -->
<!-- ######################################################################## --> 
<script type="text/javascript">
	window.emos3.send({
	    content : 'Checkout/Cart',
		pageId: '~BASKET-PR-CatIndex~~BASKET-PR-Number~',
	    ec_Event:  [{
		    type: 'c_add',
            pid: '~BASKET-PR-ProdIndex~',
            sku: '~BASKET-PR-Number~',
            name: '~BASKET-PR-Name~',
            price: ~WS-DisablePriceAndNumberFormat~~BASKET-PR-Price~~WS-EnablePriceAndNumberFormat~,
            group: '{Cat-PathData($BASKET-PR-CatIndex$)}~DC-Int1_set(0)~{@CAT-PathRegular}~DC-Int1_inc~{!DC-Int1(1)}/{/!DC-Int1(1)}~CAT-Name_StripHtml~{/@CAT-PathRegular}{/Cat-PathData($BASKET-PR-CatIndex$)}',
		    {PR-LoadData($BASKET-PR-Number$,1)}
                {PR-DepVariationValue1}~DC-FPDepVarValue1_set($PR-DepVariationValue1$)~{/PR-DepVariationValue1}
                {PR-DepVariationValue2}~DC-FPDepVarValue2_set($PR-DepVariationValue2$)~{/PR-DepVariationValue2}
                {PR-DepVariationValue3}~DC-FPDepVarValue3_set($PR-DepVariationValue3$)~{/PR-DepVariationValue3}
            {/PR-LoadData($BASKET-PR-Number$,1)}
            var1: {DC-FPDepVarValue1}'~DC-FPDepVarValue1~'{/DC-FPDepVarValue1}{!DC-FPDepVarValue1}'null'{/!DC-FPDepVarValue1},
            var2: {DC-FPDepVarValue2}'~DC-FPDepVarValue2~'{/DC-FPDepVarValue2}{!DC-FPDepVarValue2}'null'{/!DC-FPDepVarValue2},
            var3: {DC-FPDepVarValue3}'~DC-FPDepVarValue3~'{/DC-FPDepVarValue3}{!DC-FPDepVarValue3}'null'{/!DC-FPDepVarValue3},
		    count: ~BASKET-PR-AffectedQuantity~
	    }]
	});
</script>


<!-- ####################### -->
<!-- Tracking Checkout Steps -->
<!-- ####################### -->

~DC-FPTemplateName_set($WS-TemplateName$)~

{DC-FPTemplateName(ws_basket.htm)}
    <script type="text/javascript">
        window.emos3.send({
            content : 'Checkout/Basket',
			pageId: 'CheckoutBasket',
            orderProcess: '1_Cart',
        });
    </script>
{/DC-FPTemplateName(ws_basket.htm)}

{DC-FPTemplateName(ws_login.htm)}
    {ST-Addr_Order}
        <script type="text/javascript">
            window.emos3.send({
                content : 'Checkout/Login',
				pageId: 'CheckoutLogin',
                orderProcess: '2_Login',
            });
        </script>
    {/ST-Addr_Order}
{/DC-FPTemplateName(ws_login.htm)}

{DC-FPTemplateName(ws_address_combined.htm)}
    <script type="text/javascript">
    window.emos3.send({
        content : 'Checkout/Adress',
		pageId: 'CheckoutAdress',
        orderProcess: '3_AdressDetails',
    });
    </script>
{/DC-FPTemplateName(ws_address_combined.htm)}

{DC-FPTemplateName(ws_pay_deliv.htm)}
    <script type="text/javascript">
    window.emos3.send({
        content : 'Checkout/PaymentDelivery',
		pageId: 'CheckoutPaymentDelivery',
        orderProcess: '4_PayDeliv',
    });
    </script>
{/DC-FPTemplateName(ws_pay_deliv.htm)}

{DC-FPTemplateName(ws_place_order.htm)}
    <script type="text/javascript">
    window.emos3.send({
        content : 'Checkout/Orderoverview',
		pageId: 'CheckoutOrderoverview',
        orderProcess: '5_Orderoverview',
    });
    </script>
{/DC-FPTemplateName(ws_place_order.htm)}

{DC-FPTemplateName(ws_confirm.htm)}
    <script type="text/javascript">
        window.emos3.send({
            content: 'Checkout/Confirmation',
			pageId: 'CheckoutConfirmation',
            orderProcess: '6_OrderConfirmation',
            billing:  ['~WS-OrderID~', '~A-Number~', '~A-CountryISO~/~A-City~/~A-ZIP~', ~BASKET-TechnicalOrderTotal~, '~WS-Currency~', '~WS-Delivery~', ~BASKET-TechnicalDeliveryCost~, '~WS-Payment~', ~BASKET-TechnicalPaymentCost~],
            ec_Event:  [
                {BASKET-PR-Data}~DC-Int1_set(0)~{@BASKET-PR-Data}~DC-Int1_Inc~
                {!DC-Int1(1)},{/!DC-Int1(1)}{
                    type: 'buy',
                    pid: '~BASKET-PR-ProdIndex~',
                    sku: '~BASKET-PR-Number~',
                    name: '~BASKET-PR-Name~',
                    price: ~WS-DisablePriceAndNumberFormat~~BASKET-PR-Price~~WS-EnablePriceAndNumberFormat~,
                    group: '{Cat-PathData($BASKET-PR-CatIndex$)}~DC-Int1_set(0)~{@CAT-PathRegular}~DC-Int1_inc~{!DC-Int1(1)}/{/!DC-Int1(1)}~CAT-Name_StripHtml~{/@CAT-PathRegular}{/Cat-PathData($BASKET-PR-CatIndex$)}',
                    {PR-LoadData($BASKET-PR-Number$,1)}
                        {PR-DepVariationValue1}~DC-FPDepVarValue1_set($PR-DepVariationValue1$)~{/PR-DepVariationValue1}
                        {PR-DepVariationValue2}~DC-FPDepVarValue2_set($PR-DepVariationValue2$)~{/PR-DepVariationValue2}
                        {PR-DepVariationValue3}~DC-FPDepVarValue3_set($PR-DepVariationValue3$)~{/PR-DepVariationValue3}
                    {/PR-LoadData($BASKET-PR-Number$,1)}
                    var1: {DC-FPDepVarValue1}'~DC-FPDepVarValue1~'{/DC-FPDepVarValue1}{!DC-FPDepVarValue1}'null'{/!DC-FPDepVarValue1},
                    var2: {DC-FPDepVarValue2}'~DC-FPDepVarValue2~'{/DC-FPDepVarValue2}{!DC-FPDepVarValue2}'null'{/!DC-FPDepVarValue2},
                    var3: {DC-FPDepVarValue3}'~DC-FPDepVarValue3~'{/DC-FPDepVarValue3}{!DC-FPDepVarValue3}'null'{/!DC-FPDepVarValue3},
                    count: ~BASKET-PR-Quantity~
                }{/@BASKET-PR-Data}{/BASKET-PR-Data}
            ]
        });
    </script>
{/DC-FPTemplateName(ws_confirm.htm)}

 

1.2 Integration von econda Tracking mit der WEBSALE Tracking-Schnittstelle

Der WEBSALE-Partner econda kann die Tracking-Schnittstelle von WEBSALE direkt nutzen.

Schritt 1: Freischalten der Tracking-Schnittstelle

Die Schnittstelle muss zunächst von der WEBSALE AG global freigeschaltet werden.

Wegweiser: Integration der Tracking-Schnittstelle

Wegweiser: Tracking-Schnittstelle

Schritt 2: Aktivieren der Tracking-Schnittstelle

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

Wegweiser: Integration der Tracking-Schnittstelle

Schritt 3: Integration des Scriptes in die Tracking-Datei (ws_analyse.js)

econda sendet Ihnen einen Code-Abschnitt zu, ähnlich dem im folgendem Beispiel gezeigten. Kopieren Sie den erhaltenen Code in die Tracking-Datei (ws_analyse.js). Verwenden Sie Kommentarzeilen, um den econda-Code nach folgendem Schema einzufügen und damit vom Tracking-Code anderer Anbieter abzugrenzen.

 

...
...
// *************************************************************************
// Beginn econda Tracking
// *************************************************************************
(function()
{var EMOS_VERSION="cm46.8ws";
var URL_TRACKING_ALLOWED=false;
var SITE_ID=(typeof(window.ws_shopid)!="undefined")?window.ws_shopid:0;
var MANDANT=false;
var LOG_URL=(location.protocol=="https:")?"https://www.econda-monitor.de/els/logging":"http://www.econda-monitor.de/els/logging";
var STORAGE_MAX=10;
....
....
// *************************************************************************
// Ende Econda Tracking
// *************************************************************************
...
...

 

2 Deaktivieren des econda Trackings (bei Integration mit Tracking-Schnittstelle)

Solange das Script von econda in Ihrem Shop weiterhin "trackt", fallen weitere Kosten bei econda an. Um dies zu vermeiden, muss das Script aus der Tracking-Datei (ws_analyse.js) entfernt werden. Nur dann fallen keine weiteren Kosten an.

Schritt 1: Entfernen des econda Scriptes

Bitte entfernen Sie zum einen alle econda Scripte aus der Tracking-Datei (ws_analyse.js) und überprüfen Sie, ob auch eventuelle Scripte aus dem Template entfernt werden müssen, die ebenfalls econda betreffen.

Schritt 2: Deaktivieren der Tracking-Schnittstelle

Ist in der Tracking-Datei (ws_analyse.js) ausschließlich das econda Tracking enthalten, können Sie die Tracking-Schnittstelle deaktivieren. Sind in der Tracking-Datei (ws_analyse.js) noch andere Trackingscripte enthalten, z. B. Google Conversion Tracking, dann darf die Tracking-Schnittstelle nicht deaktiviert werden. In diesem Fall muss nur das econda Tracking sorgfältig aus der Tracking-Datei (ws_analyse.js) entfernt werden, da ansonsten - trotz Kündigung - Kosten auf den Shopbetreiber zukommen.

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 = no
   ...
</Basic>

Referenz: Abschnitt Basic

Wegweiser: Integration der Tracking-Schnittstelle

Hinweis:

Wenn Sie die Tracking-Schnittstelle deaktiviert haben, weisen Sie bitte Ihren Ansprechpartner bei WEBSALE darauf hin. Eventuell ist dann eine globale Deaktivierung der Tracking-Schnittstelle sinnvoll.

 

3 Migration von econda Tracking "mit Tracking-Schnittstelle" zu "ohne Tracking-Schnittstelle"

Wenn Sie bereits econda Tracking in Verbindung mit der Tracking-Schnittstelle nutzen und auf die Einbindung ohne Tracking-Schnittstelle umsteigen möchten, empfehlen wir folgende Vorgehensweise:

▪Für die "alte" Integration muss eine Kopie der Tracking-Datei frei im Template positioniert werden. Dies bedarf einer technischen Freischaltung seitens WEBSALE.

▪Die "neue" Integration wird im Testmodus mit ST-DesignTest-Klammerungen vorgenommen.

▪Nach erfolgreichem Test wird die "neue" Integration durch Entfernung der ST-DesignTest-Klammerungen livegeschaltet. Die "alte" Integration kann entfernt werden.

Schritt 1: Freischaltung der freien Positionierung der Tracking-Schnittstelle

Wenden Sie sich an Ihren WEBSALE-Ansprechpartner, um die hierfür notwendige freie Positionierung der Tracking-Schnittstelle für Ihren Shop freizuschalten.

Wegweiser: Freie Positionierung der Tracking-Schnittstelle

Schritt 2: Inhalt der Tracking-Datei ws_analyse.js in separate JS-Datei kopieren

Schreiben Sie den kompletten Code der ws_analyse.js in eine neue JavaScript-Datei und speichern Sie diese z. B. unter dem Namen econda.js im Verzeichnis benutzer/templates/js_upload.

Entfernen Sie anschließend den kopierten Code aus der ws_analyse.js, da er ansonsten zweimal ausgegeben wird und damit das Tracking nicht mehr korrekt erfolgt.

Schritt 3: Integration der Tracking-Datei in allen Templates

Fügen Sie folgenden Code auf allen Seiten des Shops ein:

{!ST-DesignTest}
   ~WS-ExternalStatistics~
   <script src="../js_upload/econda.js"></script>
{/!ST-DesignTest}

Referenz: WS-ExternalStatistics

Schritt 4: Integration ohne Tracking-Schnittstelle im Testmodus

Nehmen Sie die "neue" Integration (ohne Tracking-Schnittstelle) im Testmodus vor.

Folgen Sie hierfür der oben aufgeführten Integrationsbeschreibung und verwenden Sie ST-DesignTest-Klammerungen.

Referenz: ST-DesignTest

Schritt 5: Umstellung der bisher genutzten URL-Parameter

Die bisher genutzten URL-Parameter, wie z. B. Referer (ref, subref), müssen auf den neuen econda-Standard umgestellt werden.

Eine entsprechende Liste finden Sie unter folgenden Links:

Externer Link: https://docs.econda.de/de/INDE/econda-datenerfassung/eingehenden-traffic-erfassen/cheatsheet+url-parameter.html#inde-cheatsheet-url-parameter
Externer Link: https://docs.econda.de/de/INDE/econda-datenerfassung/eingehenden-traffic-erfassen/eingehenden+traffic+erfassen+url-parameter.html
(Zugangsdaten von econda erforderlich)

Stellen die die entsprechenden URL-Parameter auf das jeweils beschriebene Format um.

Schritt 6: Testen der Integration

Rufen Sie den Shop im Design-Testmodus auf, um die Integration zu testen.

http://www.xyz.de/?test=on&design-test=on

Deaktivieren des Design-Testmodus:

http://www.xyz.de/?test=on&design-test=off

Wegweiser: Testmodi des Shops ein-/aussschalten

Schritt 7: Liveschalten der neuen Integration

Schalten Sie nach erfolgreichem Test die Integration live, indem Sie die ST-DesignTest-Klammerungen aus dem Template entfernen.

Sollte nur econda in der Tracking-Schnittstelle vorhanden sein, kann diese anschließend auch von WEBSALE deaktiviert werden. Ihr WEBSALE-Ansprechpartner steht Ihnen gerne zur Verfügung.

 

4 Integration von econda ARP

econda bietet Shopbetreibern die Möglichkeit, Besuchern zielsicher passendes Zubehör, ähnliche Produkte oder die Top-Seller der Woche anzuzeigen. Die selbstlernenden Algorithmen orientieren sich dabei am Verhalten der Shopbesucher und geben nur passende Empfehlungen aus.

Der Mehrwert für den Händler ist dabei eine signifikante Umsatzsteigerung.

Mithilfe der econda Audience Relationship Platform (ARP) werden diese intelligente Produktempfehlungen auch geräteübergreifend angezeigt.

Voraussetzungen:

▪Die Funktion "econda ARP" kann nur genutzt werden, wenn econda Tracking in Ihrem Shop integriert ist.

▪econda ARP muss bei econda beauftragt und freigeschaltet werden. Bitte wenden Sie sich an Ihren econda-Ansprechpartner.

Schritt 1: Freischaltung/Aktivierung

Es ist keine Freischaltung/Aktivierung nötig.

Schritt 2: Script auf Loginseite (ws_login.htm) einfügen

Ergänzen Sie den folgenden Code auf der Loginseite (ws_login.htm) innerhalb der ST-LoggedIn-Klammerung:

{ST-LoggedIn}
   ...
   <script type="text/javascript">
   window.econda.ready(() => {
    econda.data.visitor.login({
      ids: {customerId: '~A-Number~', userId: '~A-UserIndex~', email: '~A-E-Mail~' }
    });
   });
 
   window.emos3.send({
      content: 'login/success',
      login: ['~A-Number~', 0]
   });
   </script>
   ...
{/ST-LoggedIn}

Referenz: ST-LoggedIn

Schritt 3: Script auf der Logoutseite (ws_logout.htm) einfügen

Ergänzen Sie den folgenden Code auf der Logoutseite (ws_logout.htm) innerhalb der negativen ST-LoggedIn-Klammerung:

{!ST-LoggedIn}
   ...
   <script type="text/javascript">
    window.econda.ready(() => {
      econda.data.visitor.logout();
    });
   </script>
   ...
{/!ST-LoggedIn}

Referenz: ST-LoggedIn

Schritt 4:  Weitere Eigenschaften einfügen (optional)

Neben den Profileigenschaften, die z. B. über econda Tracking automatisch in die ARP gespeichert sind, können Sie weitere, eigene Profileigenschaften in den ARP-Profilen speichern.

Hierfür müssen Sie die eigenen Profileigenschaften zunächst in econda Personalization anlegen, bevor diese befüllt werden können.

Codebeispiel einer solchen Eigenschaft:

<script type="text/javascript">
   window.emos3.send({
      arpprops: [['zip','~A-ZIP~'],['gender','~A-Salutation_code~'],['dateofbirth','~A-DateofBirth~']]
   });
</script>

Haben Sie alle Schritte durchgeführt, ist econda ARP erfolgreich in Ihrem Shop integriert und aktiv.