Allgemeine yalst-Shop-Einbindung

Da es eine Vielzahl an Shop-Systemen auf dem Markt gibt und wir nur für die wichtigsten Lösungen individuelle Einbindungsanleitungen erstellen können, beschreiben wir auf dieser Seite die allgemeine Vorgehensweise, um yalst optimal in einen beliebigen Shop einzubinden. Wenn Sie nur die Chat-Funktionen von yalst nutzen möchten, reicht selbstverständlich die normale einzeilige Standardeinbindung aus. Voraussetzung ist natürlich, daß Sie an Ihre Shop-Dateien irgenwie herankommen. Die allermeisten Shop-Systeme sind Template-basiert, d.h., Funktionalität und Design des Shops sind voneinander getrennt. Für die hier beschriebenen Einbindungen ist es in der Regel ausreichend, die Templates - also die Dateien, die das Design festlegen - anzupassen. Die hier zusammengestellten Einbindungen bewirken (zusätzlich zu den ohnehin schon standardmäßig vorhandenen Funktionalitäten) im Einzelnen: Besucher-Monitoring mit Anzeige der Artikelzahl und des Warenwertes im Warenkorb direkt in der Operator-Konsole Anzeige des Kundennamens direkt im Besucher-Monitor Anzeige des Warenkorb-Inhalts mit Hilfe der yalst-Funktion "Tracking-Daten" Erfassung der Verkäufe und Umsätze (Conversion-Tracking) In den folgenden Beispielen gehen wir davon aus, daß Ihr yalst auf der Domain www.example.com installiert ist (muß nicht identisch sein mit der Domain Ihres Online-Shops). Sie müssen also "www.example.com" immer durch die tatsächliche Domain ersetzen. Bei unseren Mietlösungen ist diese z.B. "rd.livesupportserver.de". Ferner gehört zu jedem yalst-Paket eine sogenannte Site-Nummer, da innerhalb einer yalst-Installation grundsätzlich mehrere Instanzen der Software laufen können. Bei Kauflösungen ist die Site-Nummer in der Regel "1-1", ansonsten können Sie diese aus Ihrem yalst-Kundenbereich entnehmen. Für diese Anleitung nehmen wir als Beispiel 1-1.

letzte Aktualisierung dieser Anleitung: 28.07.2009

Einbindung des Chat-Buttons

Der Chat-Button wird von den meisten Nutzern in der Regel im rechten oder linken Rand der Shop-Fenster plaziert, z.B. in der Nähe der Warenkorbanzeige. Er sollte gut sichtbar im oberen Bereich untergebracht werden. Der notwendige HTML-Code, um den Button erscheinen zu lassen, sieht so aus:

<script language="JavaScript" src="http://www.example.com/yalst/yalst.js.php?site=1-1&amp;count=no" type="text/javascript"></script>

Wenn yalst als Seitentitel bei Chat-Anfragen nicht den Dateinamen der jeweiligen Seite, sondern den HTML-Titel anzeigen soll, lautet die Zeile:

<script language="JavaScript" src="http://www.example.com/yalst/yalst.js.php?site=1-1&amp;count=no&amp;pagetitle=auto" type="text/javascript"></script>

Soll sich das Chat-Fenster in der Zweitsprache (falls konfiguriert) öffnen, lautet der Code:

<script language="JavaScript" src="http://www.example.com/yalst/yalst.js.php?site=1-1&amp;count=no&amp;lang=2" type="text/javascript"></script>

Besucher- und Warenkorb-Monitoring

Die folgenden Einbindungen sollten alle so weit unten auf der Seite plaziert werden wie irgendwie möglich - idealerweise unmittelbar vor dem </body>-Tag. Sie sorgen für das Warenkorb- und Besucher-Monitoring und sollten auf jeder Seite vorhanden sein.

Beginnen wir mit der Anzahl der Artikel im Korb und dem Warenkorbwert. Diese Einbindung steht Ihnen ab der Business-Edition zur Verfügung. Der Code sieht so aus:

<script language="JavaScript" src="http://www.example.com/yalst/cart.js.php?items=Artikelzahl&amp;value=Warenkorbwert" type="text/javascript"></script>

Für Artikelzahl und Warenkorbwert müssen Sie die entsprechenden Shop-Variablen an dieser Stelle ausgeben. Welche das sind und wie man die ausgibt, entnehmen Sie bitte der Dokumentation Ihres Shops. Auch der jeweilige Produktsupport sollte Ihnen diesbezüglich weiterhelfen können. Verweisen Sie diesen ggf. auf diese Anleitung.

Komplizierter ist das Auslesen des Warenkorbinhalts, da der Umfang variabel ist. Die Übergabe an yalst muß daher in einer Art Schleife erfolgen. Diese kann über eine Server-seitige Programmiersprache wie PHP, eine Template-Sprache wie Smarty oder auch über JavaScript realisiert werden. Diese Einbindung steht Ihnen ab der Professional-Edition zur Verfügung. Wir realisieren diese Funktionalität hier einmal per JavaScript:

<script language="JavaScript">
<!--
if (typeof y_track=='undefined')
  {y_track=new Array();}
y_track[0]=new Array();
y_track[0][0]="basket*";
y_track[0][1]="-";
for (var i=1; i<=Artikelzahl; i++)
  {
  y_track[i]=new Array();
  y_track[i][0]="basket_Artikelnummer";
  y_track[i][1]="Artikelbeschreibung/-anzahl";
  }
-->
</script>

Die farbig dargestellten Werte müssen Sie wieder aus Ihren Shop-Variablen gewinnen. Im Falle von Artikelnummer und Artikelbeschreibung/-anzahl ist bei jedem Schleifendurchlauf ein anderer Wert zu übergeben.

Der Kundenname läßt sich relativ einfach als Bemerkung an yalst übergeben. Er wird erneut aus einer Shop-Variablen bezogen. Das Ausrufezeichen sorgt dafür, daß eine evtl. bereits vorhandene Bemerkung nicht überschrieben wird (z.B. durch eine leere Zeichenkette, wenn der Kunden sich noch nicht angemeldet hat) Wir machen das Ganze wieder in JavaScript:

<script language="JavaScript">
<!--
y_remark="!Kundenname";
-->
</script>

Abschließend noch die yalst-Einbindung für das Besucher-Monitoring. Diese verarbeitet auch die ganzen anderen zuvor gewonnenen Daten und muß daher auf jeden Fall unterhalb des o.g. Codes stehen:

<script language="JavaScript" src="http://www.example.com/yalst/yalst.js.php?site=1-1&amp;button=no" type="text/javascript"></script>

Wenn im Besucher-Monitor (und den Statistiken) statt der Datei-Namen (wie z.B. index.php oder shop.php) die HTML-Seitentitel angezeigt werden sollen, muß dieser Code so aussehen:

<script language="JavaScript" src="http://www.example.com/yalst/yalst.js.php?site=1-1&amp;button=no&amp;pagetitle=auto" type="text/javascript"></script>

Da die in diesem Abschnitt genannten Einbindungen alle zusammengehören (wie gesagt am besten unmittelbar vor </body> plazieren), fassen wir sie an dieser Stelle nochmal zusammen:

<script language="JavaScript" src="http://www.example.com/yalst/cart.js.php?items=Artikelzahl&amp;value=Warenkorbwert" type="text/javascript"></script>
<script language="JavaScript">
<!--
if (typeof y_track=='undefined')
  {y_track=new Array();}
y_track[0]=new Array();
y_track[0][0]="basket*";
y_track[0][1]="-";
for (var i=1; i<=Artikelzahl; i++)
  {
  y_track[i]=new Array();
  y_track[i][0]="basket_Artikelnummer";
  y_track[i][1]="Artikelbeschreibung/-anzahl";
  }
y_remark="!Kundenname";
-->
</script>
<script language="JavaScript" src="http://www.example.com/yalst/yalst.js.php?site=1-1&amp;button=no" type="text/javascript"></script>

Conversion-Tracking

Die folgenden beiden Einbindungen kommen ausschließlich auf die Bestellabschlußseite, also wenn ein Einkaufsvorgang beendet ist. Sie müssen oberhalb der Besucher-Monitoring-Einbindung plaziert werden. Der erste Codeschnipsel schließt das Warenkorb-Monitoring ab (ab Business-Edition):

<script language="JavaScript">
<!--
y_cartcomplete=true;
-->
</script>

Nun folgt das eigentliche Conversion-Tracking (ab Professional-Edition):

<script language="JavaScript" src="http://www.example.com/yalst/conversion.js.php?event=Verkauf%20im%20Shop&amp;ref=3&amp;volume=Warenkorbwert&amp;comment=Kundenname" type="text/javascript"></script>

Warenkorbwert und Kundenname sind wie immer aus dem Shop-System zu entnehmen.

Hinweis für https-Seiten

Wenn es in Ihrem Shop Seiten gibt, die über SSL-Verschlüsselung abgerufen werden (https-Seiten), sollten Sie yalst mit SSL-Unterstützung verwenden, damit es keine Sicherheitswarnungen in den Webbrowsern der Besucher gibt. Diese ist ab der Basic-Edition verfügbar, bei der Kauflösung kann die SSL-Unterstützung bei der Installation (oder auch nachträglich, s. Installationsanleitung) konfiguriert werden (Domain, die per https erreichbar ist, oder SSL-Proxy erforderlich). Zur Einbindung können Sie in obenstehenden HTML-Codes alle "http://" durch "https://" ersetzen (bei Verwendung eines sogenannten SSL-Proxys muß die entsprechende Proxy-URL angegeben werden).