Zum Hauptinhalt springen
Ein angemeldeter Bestandskunde bekommt im Shop einen persönlichen Empfehlungslink. Gibt er diesen Link weiter und bestellt der Empfänger daraufhin, dann stehen in den Bestelldaten der Werbende und der Geworbene nebeneinander. Was daraus wird, also Treuepunkte, Prämien oder Geschenke, entscheidet die Warenwirtschaft. Das Shopsystem übernimmt dabei genau drei Aufgaben: es erzeugt den Empfehlungslink, es merkt sich den Werbenden in der Sitzung und auf Wunsch im Cookie, und es schreibt die Empfehlungsinformation in die Bestelldaten. Es vergibt selbst keine Prämien, führt keine Statistik und verschickt keine Einladungsmails.

​
So läuft eine Empfehlung ab

  1. Der Bestandskunde meldet sich an und ruft eine Seite auf, auf der Sie den Empfehlungslink eingebaut haben. Das Shopsystem verschlüsselt seine Kennung und hängt sie als URL-Parameter an den Link.
  2. Er gibt den Link weiter, über welchen Kanal auch immer.
  3. Der Empfänger ruft den Link auf. Das Shopsystem entschlüsselt den Parameter, prüft ihn und merkt sich den Werbenden in der Sitzung.
  4. Der Empfänger bestellt. In die Bestelldaten kommen die Kennung und die Kundennummer des Werbenden.
  5. Die Warenwirtschaft liest die Bestellung und startet ihren eigenen Freundschaftswerbung-Prozess.
Die Funktion steht ab Release-Version 82 zur Verfügung und muss nicht freigeschaltet werden. Die Übergabe an eine Warenwirtschaft oder ein ERP-System lässt sich jedoch nicht über den WSP Manager abbilden, dafür ist ein Connector-Modul nötig. Ohne dieses Modul erzeugt der Shop zwar Links und erkennt Werbende, die Information bleibt aber in den Bestelldaten liegen. Wenden Sie sich für das Connector-Modul an Ihren WEBSALE Ansprechpartner.

​
Shopkonfiguration

Tragen Sie den Abschnitt TellAFriend in die Shopkonfiguration shop.config ein. Die folgenden Werte entsprechen den Standardwerten.
Allow wirkt ausschließlich auf das Schreiben der Bestelldaten. Bei Allow = no erzeugt das Shopsystem weiterhin Empfehlungslinks, erkennt Werbende und beantwortet alle TAF-Tags wie gewohnt. Nur die beiden Zeilen in der Bestellung fehlen. Wenn Sie die Funktion im Shop vollständig abschalten wollen, entfernen Sie zusätzlich den Empfehlungslink aus den Templates.
Setzen Sie CookieDays auf einen Wert größer 0, dann registrieren Sie den Cookie im Abschnitt AgreementCookies der Shopkonfiguration shop.config als WEBSALE-Service.
Ohne vorliegende Einwilligung schreibt das Shopsystem den Cookie nicht und liest ihn auch nicht aus. Die Zuordnung des Werbenden funktioniert dann weiterhin, aber nur innerhalb der laufenden Sitzung. Erteilt der Besucher die Einwilligung später im selben Besuch, wird der Cookie nachträglich geschrieben. Referenz: Abschnitt TellAFriend, Abschnitt AgreementCookies Der Empfehlungslink ist ein gewöhnlicher Shop-Link mit einem zusätzlichen Parameter. Den Parameternamen liefert TAF-Name, den verschlüsselten Wert TAF-Value. Zusammengebaut wird beides mit den DC-CustomLink-Tags. Weil nur angemeldete Kunden empfehlen können, gehört der Link in eine Klammerung mit ST-LoggedIn. Das folgende Beispiel hängt den Link an die Produktdetailansicht ws_product.htm.
Der fertige Link sieht dann so aus:
Die Klammerung {TAF-Value} greift genau dann, wenn ein Kunde angemeldet ist, und ist damit an dieser Stelle gleichbedeutend mit {ST-LoggedIn}. Sie können den Block statt mit ST-LoggedIn auch mit TAF-Value klammern, wenn das im Template besser liest. Beides zugleich ist nicht nötig.
Der Empfehlungslink funktioniert nur in dem Shop, in dem er erzeugt wurde. Die Shopkennung steckt verschlüsselt im Parameter und wird beim Aufruf gegen den aufgerufenen Shop geprüft. Ein Link aus dem deutschen Shop greift in einem anderen Shop der Mall nicht.
Referenz: PR-Data, ST-LoggedIn, DC-CustomLink_SetLink(), DC-CustomLink_AppendParameter(), DC-CustomLink Das Shopsystem nimmt den Parameter taf aus der URL entgegen und prüft ihn in mehreren Schritten, bevor es den Werbenden in die Sitzung schreibt.
Alle diese Fälle werden stillschweigend verworfen. Es gibt keine Fehlermeldung und keinen Hinweis im Template, der Besucher landet einfach auf einer Seite ohne Werbenden. Im Log erscheint ein Eintrag der Stufe Info. Zur Kontrolle beim Testen eines Links verwenden Sie TAF-UserIndex.
Der Fall Eigenwerbung wird zweimal geprüft: beim Aufruf des Links und noch einmal unmittelbar vor dem Schreiben der Bestellung. Damit ist auch der Weg abgedeckt, dass jemand seinen eigenen Link abmeldet aufruft und sich erst danach anmeldet.

​
Woher der Werbende stammt

Das Shopsystem sucht den Werbenden zuerst im URL-Parameter. Steht dort nichts, liest es den Cookie aus, und zwar nur dann, wenn in der Sitzung noch kein Werbender steht und die Einwilligung vorliegt. Der Cookie wird nur erneuert, wenn der Wert aus der URL kam und CookieDays größer 0 ist. Die Kundennummer des Werbenden steht nicht im Link. Im verschlüsselten Parameter stecken die Shopkennung, die interne Kundenkennung und ein Zeitstempel. Die Kundennummer holt das Shopsystem aus dem Kundenkonto, sobald sie gebraucht wird.

​
Wie lange die Zuordnung gilt

Ein erkannter Werbender gilt für genau eine Bestellung. Nach einer erfolgreichen Bestellung setzt das Shopsystem die Zuordnung zurück und löscht den Cookie, auch wenn CookieDays eine längere Lebensdauer vorsieht. Ein zweiter Einkauf zählt also nicht noch einmal auf denselben Werbenden ein, solange nicht erneut ein Empfehlungslink aufgerufen wird.

​
Die Bestelldaten

Steht Allow = yes und ist ein Werbender erkannt, dann schreibt das Shopsystem zwei zusätzliche Zeilen in den Abschnitt Order der Bestelldaten.
Beide Zeilen erscheinen immer gemeinsam oder gar nicht. Ist kein Werbender erkannt, fehlen sie vollständig, es werden keine leeren Felder geschrieben. Ihre Warenwirtschaft prüft deshalb auf das Vorhandensein des Feldes und nicht auf einen leeren Wert.

​
TAF-Name

Liefert den Namen des URL-Parameters, über den die verschlüsselte Empfehlungsinformation übergeben wird. Der Wert ist fest und lautet taf.
Verwenden Sie TAF-Name, statt taf fest in das Template zu schreiben. Ändert sich der Parametername in einer künftigen Version des Shopsystems, dann ziehen Ihre Templates automatisch mit. Zulässig in allen Templates.

​
TAF-Value

Liefert den verschlüsselten Wert, der hinter dem Parameternamen im Empfehlungslink steht. Darin stecken die Shopkennung, die interne Kundenkennung des angemeldeten Kunden und ein Zeitstempel. Der Wert ist hexadezimal kodiert und damit ohne weitere Kodierung in einer URL verwendbar. Als Klammerung greift das Tag, wenn ein Kunde angemeldet ist.
Der verschlüsselte Wert wird einmal je Sitzung erzeugt und danach wiederverwendet. Alle Empfehlungslinks einer Sitzung tragen deshalb denselben Wert, unabhängig davon, auf welche Seite sie zeigen. Nach einer Abmeldung beginnt eine neue Sitzung und damit ein neuer Wert.
Schlägt die Verschlüsselung fehl, dann gibt das Einzel-Tag nichts aus und meldet keinen Fehler. Im Template entsteht dann ein Link mit leerem Parameter, der beim Aufruf verworfen wird. Prüfen Sie beim Einrichten einen erzeugten Link daraufhin, dass hinter taf= tatsächlich ein Wert steht.
Zulässig in allen Templates.

​
TAF-IsSet

Greift, wenn in der laufenden Sitzung ein Werbender erkannt wurde, der Besucher den Shop also über einen gültigen Empfehlungslink betreten hat. Damit blenden Sie Hinweise ein, die nur für Geworbene gelten.
TAF-IsSet ist ausschließlich eine Klammerung. Als Einzel-Tag ~TAF-IsSet~ meldet das Shopsystem ein ungültiges Tag.
Zulässig in allen Templates.

​
TAF-UserIndex

Gibt die interne Kundenkennung des Werbenden aus. Als Klammerung greift das Tag, wenn ein Werbender gesetzt ist, und verhält sich damit wie TAF-IsSet.
Das Tag ist für die Fehlersuche gedacht. Über die ausgegebene Kennung lässt sich beim Testen eines Empfehlungslinks feststellen, ob der richtige Werbende erkannt wurde, und der Kunde in der Warenwirtschaft nachschlagen. Für die Besucher des Shops hat die Zahl keine Bedeutung, geben Sie sie deshalb nur im Kommentar oder auf einer internen Testseite aus. Zulässig in allen Templates.

​
Die Tags im Überblick

​
Fehlersuche