Trusted Shops - WEBSALE Dokumentation

Trusted Shops zertifiziert Online-Shops und vergibt ein Gütesiegel. Für Ihren Shop bedeutet das drei Bausteine, die Sie einzeln oder gemeinsam nutzen können: das Gütesiegel selbst, den Käuferschutz als Geld-zurück-Garantie und die Kundenbewertungen. Alle drei laufen über das Trustbadge, einen JavaScript-Baustein von Trusted Shops. Der sichtbare Teil ist das Siegel mit der Bewertungsanzeige, üblicherweise unten rechts im Shop. Der unsichtbare Teil liest nach einer Bestellung die Bestelldaten aus der Seite und bietet dem Käufer den Käuferschutz an. WEBSALE steuert dazu genau eines bei: die Bestelldaten in einer Form, die das Trustbadge lesen kann. Alles andere ist Trusted Shops.

Trusted Shops hat seine Plattform auf eTrusted umgestellt und dabei Integrationswege und Dokumentationsseiten geändert. Die Skripte auf dieser Seite sind Beispiele, die zeigen, an welchen Stellen WEBSALE-Tags einzusetzen sind. Holen Sie den tatsächlich einzubindenden Code immer aktuell bei Trusted Shops und übertragen Sie dann die Tags.

Die drei Bausteine im Überblick

Baustein	Was er leistet	Freischaltung durch WEBSALE
Gütesiegel als Trustbadge	zeigt Siegel und Bewertungen im Shop	nicht nötig
Käuferschutz, Standard-Modell	für den Käufer kostenlos, nach der Bestellung abschließbar	erforderlich
Käuferschutz Excellence	kostenpflichtig, wird auf der Zahlungsartenseite gewählt	erforderlich
Kundenbewertungen	Shop- und Produktbewertungen anzeigen und an Google übergeben	nicht nötig

Der Käuferschutz setzt das Gütesiegel voraus, die Bewertungen bauen auf dem Trustbadge auf. Arbeiten Sie die Abschnitte deshalb in dieser Reihenfolge ab. Ausführliche Informationen finden Sie bei Trusted Shops unter business.trustedshops.com/knowledge/integration und im Hilfebereich unter help.etrusted.com.

Das Trustbadge einbinden

Schritt 1: Den Trustbadge-Code beschaffen

Nach der Zertifizierung erhalten Sie von Trusted Shops Ihre Trusted Shops ID. Daraus erzeugt Trusted Shops den Skriptblock mit Ihrem individuellen Trustbadge-Code.

Der folgende Code ist ein Beispiel. Kopieren Sie ihn nicht, sondern lassen Sie sich Ihren eigenen Code von Trusted Shops erzeugen. Die Beispiel-ID funktioniert in keinem Shop.

Schritt 2: Den Trustbadge-Code einbinden

Fügen Sie den Skriptblock auf den gewünschten Shop-Templates unmittelbar vor dem schließenden body-Tag ein.

<script type="text/javascript">
  (function () {
    var _tsid = 'INDIVIDUELLER TRUSTBADGE-CODE';
    _tsConfig = {
      'yOffset': '0',                 /* Abstand vom unteren Seitenrand */
      'variant': 'reviews',           /* text, default, small, reviews, custom, custom_reviews */
      'customElementId': '',          /* nur für die Varianten custom und custom_reviews */
      'trustcardDirection': '',       /* für custom: topRight, topLeft, bottomRight, bottomLeft */
      'customBadgeWidth': '',         /* für custom: 40 bis 90 Pixel */
      'customBadgeHeight': '',        /* für custom: 40 bis 90 Pixel */
      'disableResponsive': 'false',
      'disableTrustbadge': 'false',
      'trustCardTrigger': 'mouseenter' /* 'click', wenn die Trustcard erst beim Klick aufgehen soll */
    };
    var _ts = document.createElement('script');
    _ts.type = 'text/javascript';
    _ts.charset = 'utf-8';
    _ts.async = true;
    _ts.src = '//widgets.trustedshops.com/js/' + _tsid + '.js';
    var __ts = document.getElementsByTagName('script')[0];
    __ts.parentNode.insertBefore(_ts, __ts);
  })();
</script>

Binden Sie den Block auch auf der Bestelleingangsbestätigung ws_confirm.htm ein. Ohne ihn dort gibt es keinen Käuferschutz, weil genau dort die Trustcard aufgeht.

Den Käuferschutz einbinden

Nach Abschluss der Bestellung öffnet das Trustbadge ein kleines Fenster, die Trustcard. Darin wird dem Käufer der Käuferschutz angeboten. Damit das funktioniert, muss das Trustbadge die Bestelldaten aus der Seite lesen können.

Voraussetzung

Der Käuferschutz muss von der WEBSALE AG für Ihren Shop freigeschaltet werden. Wenden Sie sich an Ihren WEBSALE Ansprechpartner.

Die Bestelldaten übergeben

Setzen Sie auf der Bestelleingangsbestätigung ws_confirm.htm das Tag WS-TrustBadge.

~WS-TrustBadge~

Das Tag erzeugt einen versteckten Container mit den Bestelldaten. Daran erkennt das Trustbadge, dass der Kunde die Bestellung abgeschlossen hat, und öffnet die Trustcard. Der Kunde muss nichts erneut eingeben.

<div id="trustedShopsCheckout" style="display: none;">
   <span id="tsCheckoutOrderNr">Auftragsnummer</span>
   <span id="tsCheckoutBuyerEmail">E-Mail-Adresse des Kunden</span>
   <span id="tsCheckoutOrderAmount">Gesamtsumme</span>
   <span id="tsCheckoutOrderCurrency">Währung</span>
   <span id="tsCheckoutOrderPaymentType">Name der Zahlungsart</span>

   <!-- je Warenkorbposition -->
   <span class="tsCheckoutProductItem">
      <span class="tsCheckoutProductUrl">Link zum Produkt</span>
      <span class="tsCheckoutProductName">Produktname</span>
      <span class="tsCheckoutProductSKU">Produktnummer</span>
   </span>
</div>

WS-TrustBadge arbeitet ausschließlich auf der Bestelleingangsbestätigung. Auf jedem anderen Template bleibt es wirkungslos, auch ohne Fehlermeldung. Ebenso bleibt es stumm, wenn für den Shop keine Trusted Shops ID hinterlegt ist.

Der Container listet jede Warenkorbposition, auch Set-Unterprodukte. Für ein Set-Unterprodukt setzt der Shop den Link des Set-Oberprodukts ein, damit der Kunde in der Bewertungsanfrage nicht auf einer Seite landet, die es einzeln nicht gibt. Trusted Shops kennt weitere optionale Felder, beispielsweise für Lieferdatum, Produktbild, GTIN, MPN und Marke. Diese übergibt der Shop nicht. Wenn Sie sie brauchen, etwa für Google-Produktbewertungen, müssen Sie den Container im Template selbst ergänzen. Referenz: WS-TrustBadge

Käuferschutz Excellence einbinden

Neben dem für den Käufer kostenlosen Standard-Modell gibt es den kostenpflichtigen Käuferschutz Excellence. Der Kunde wählt ihn auf der Zahlungs- und Versandartenseite aus einer Liste von Produkten, die nach Versicherungssumme gestaffelt sind. Die Kosten erscheinen wie Versandkosten im Warenkorb und gehen in die Bestelldaten ein.

Voraussetzung

Käuferschutz Excellence muss von der WEBSALE AG freigeschaltet werden. Dabei werden auch die Zugangsdaten zu Trusted Shops hinterlegt, die der Shop für die Statusabfrage braucht.

Schritt 1: Die Käuferschutzprodukte konfigurieren

Legen Sie in der shop.config den Abschnitt TrustedShopsAdvList an. Die Produkt-IDs für TSID-Txt erhalten Sie von Trusted Shops.

<TrustedShopsAdvList>
   VATRate-Value        = 1
   <+Entry>
      TSID-Txt      = TS123456_500_30_EUR
      ERPID-Txt     = 82TS500
      ListName-Txt  = Käuferschutz bis 500 € (0,97 € inkl. 19% deutscher MwSt. / 0,82 € netto)
      OrderName-Txt = Käuferschutz bis 500 €
      Cost-Value    = 0.82
   </+Entry>
   <+Entry>
      TSID-Txt      = TS123456_1500_30_EUR
      ERPID-Txt     = 82TS1500
      ListName-Txt  = Käuferschutz bis 1.500 € (2,94 € inkl. 19% deutscher MwSt. / 2,47 € netto)
      OrderName-Txt = Käuferschutz bis 1.500 €
      Cost-Value    = 2.47
   </+Entry>
</TrustedShopsAdvList>

Parameter	Bedeutung
`VATRate-Value`	Nummer des Mehrwertsteuersatzes aus der Steuersatztabelle des Shops, nicht der Prozentwert
`VATType`	optional, mit `dynamic` wird die Mehrwertsteuer dynamisch statt statisch berechnet
`TSID-Txt`	Produkt-ID von Trusted Shops
`ERPID-Txt`	Ihre eigene Artikelnummer für die Übergabe an das Warenwirtschaftssystem
`ListName-Txt`	Text in der Auswahlliste, die der Kunde sieht
`OrderName-Txt`	Text in den Bestelldaten
`Cost-Value`	Nettopreis

VATRate-Value ist ein Index, kein Steuersatz. Der Wert 1 bedeutet “der erste in der Shopkonfiguration hinterlegte Steuersatz”, nicht “1 Prozent”. Fehlt der Parameter oder liegt er außerhalb der gültigen Indizes, verwendet der Shop stillschweigend Index 1.Die Trusted Shops Produkt-ID trägt die Versicherungssumme im Namen, nach dem Muster <Ihre ID>_<Versicherungssumme>_<Laufzeit>_<Währung>. Der Shop liest diese Summe aus, um den passenden Eintrag vorauszuwählen: Er nimmt den ersten Eintrag der Liste, dessen Versicherungssumme mindestens dem Bestellwert entspricht. Sortieren Sie die Einträge deshalb aufsteigend nach Versicherungssumme. Bei falscher Reihenfolge schlägt der Shop dem Kunden ein unnötig teures Produkt vor.

Referenz: Abschnitt TrustedShopsAdvList

Schritt 2: Die Auswahl auf der Zahlungs- und Versandartenseite anbieten

Ergänzen Sie ws_pay_deliv.htm um Checkbox, Auswahlliste und Erläuterung.

{ST-TrustedShopsAdv}

   ~WS-TrustedShopsAdvCheck~ Trusted Shops Käuferschutz

   ~WS-TrustedShopsAdvList~

   Der Trusted Shops Käuferschutz sichert Ihren Online-Kauf ab.
   Mit der Übermittlung und Speicherung meiner E-Mail-Adresse zur Abwicklung
   des Käuferschutzes durch Trusted Shops bin ich einverstanden.

{/ST-TrustedShopsAdv}

Tag	Was es erzeugt
`ST-TrustedShopsAdv`	Klammerung, greift nur bei freigeschaltetem Käuferschutz Excellence
`WS-TrustedShopsAdvCheck`	die Checkbox, dazu ein verstecktes Feld, das die Auswertung des Formulars steuert
`WS-TrustedShopsAdvList`	die Auswahlliste als fertiges `select`-Element
`WS-TrustedShopsAdvID`	die konfigurierte Trusted Shops ID, falls Sie sie im Template brauchen

Die Checkbox ist nur dann vorausgewählt, wenn der Kunde den Käuferschutz in dieser Bestellung bereits gewählt hatte. Beim ersten Aufruf der Seite ist sie leer. Ein Wort wie “empfohlen” neben der Checkbox ändert daran nichts, es ist nur Text. Die Auswahlliste bleibt vollständig leer, wenn der Käuferschutz nicht freigeschaltet ist oder kein einziger Eintrag konfiguriert wurde. Es erscheint dann kein leeres Auswahlfeld, sondern gar nichts. Referenz: ST-TrustedShopsAdv · WS-TrustedShopsAdvCheck · WS-TrustedShopsAdvList · WS-TrustedShopsAdvID

Schritt 3: Die Fehlermeldung hinterlegen

Ist Trusted Shops nicht erreichbar, deaktiviert der Shop den Käuferschutz und zeigt diese Meldung.

<NotifyMessages>
   ...
   TrustedShopsAdv = Der Trusted Shops Käuferschutz steht momentan leider nicht
                     zur Verfügung und wurde deaktiviert.
   ...
</NotifyMessages>

Referenz: Abschnitt NotifyMessages

Bewertungen anzeigen

Für die Bewertungen ist keine Freischaltung durch die WEBSALE AG nötig. Sie brauchen dafür aber den Käuferschutz mit Trustbadge, weil die Bewertungsanfrage an den Kauf gekoppelt ist.

Shopbewertungen

Die Shopbewertungen zeigt das Trustbadge von sich aus an, sobald Sie in der Konfiguration die Variante reviews oder custom_reviews gewählt haben. Dafür ist im Shop nichts weiter zu tun.

Trusted Shops stellt die Funktion “Rate Later Link” nicht mehr bereit. Damit konnte ein Käufer sich an die Abgabe einer Bewertung erinnern lassen. Die Bewertungs-E-Mail nach einer Bestellung kommt von Trusted Shops und nicht von WEBSALE. Prüfen Sie Ihre dort hinterlegten E-Mail-Vorlagen und entfernen Sie einen etwaigen Button oder Link zu dieser Funktion, weil er technisch ins Leere führt.

Produktbewertungen

Damit Produkte einzeln bewertet werden können, müssen die Produktnummern aller bestellten Produkte an Trusted Shops gehen. Das erledigt WS-TrustBadge auf der Bestelleingangsbestätigung. Trusted Shops schickt dem Kunden danach eine E-Mail mit der Bitte um Bewertung, die Bewertung selbst findet auf der Website von Trusted Shops statt. Zum Anzeigen der Bewertungen im Shop binden Sie ein Widget von Trusted Shops ein. Der folgende Block zeigt, an welchen Stellen die WEBSALE-Tags einzusetzen sind.

20180514 Ts Bewertungssterne Unterhalb Produkt 02

<script type="text/javascript">
   _tsProductReviewsConfig = {
      tsid: 'IHRE TRUSTED SHOPS ID',

      {PR-DepVariations}
         {CAT-AdvData($DepVariations,99)}sku: ['~PR-ProdIndex~'{@PR-Data},{PR-DepVariationName1}'~PR-Number~'{/PR-DepVariationName1}{/@PR-Data}],{/CAT-AdvData($DepVariations,99)}
      {/PR-DepVariations}

      {!PR-DepVariations}
         sku: '~PR-ProdIndex~',
      {/!PR-DepVariations}

      variant: 'productreviews',
      borderColor: '#8bab55',
      introtext: 'Was unsere Kunden über uns sagen:'
   };

   var scripts = document.getElementsByTagName('SCRIPT'),
       me = scripts[scripts.length - 1];
   var _ts = document.createElement('SCRIPT');
   _ts.type = 'text/javascript';
   _ts.async = true;
   _ts.charset = 'utf-8';
   _ts.src = '//widgets.trustedshops.com/reviews/tsSticker/tsProductSticker.js';
   me.parentNode.insertBefore(_ts, me);
   _tsProductReviewsConfig.script = _ts;
</script>

Ein Produkt ohne Varianten übergibt seinen Produktindex als einzelnen Wert. Ein Variantenprodukt übergibt ein Array aus dem Index des Basisprodukts und den Nummern aller Varianten, damit Trusted Shops die Bewertungen der Varianten dem Basisprodukt zuordnet.

Der obige Variantenzweig setzt voraus, dass das Basisprodukt eine eigene Produktnummer hat. Fehlt sie, entsteht am Anfang des Arrays ein leerer Eintrag und ein überzähliges Komma. Setzen Sie in diesem Fall die Kommata selbst, beispielsweise mit einem Zähler:

{CAT-AdvData($DepVariations,99)}~DC-Int1_set(0)~ sku: [{@PR-Data}~DC-Int1_inc~{!DC-Int1(1)},{/!DC-Int1(1)}{PR-DepVariationName1}'~PR-Number~'{/PR-DepVariationName1}{/@PR-Data}],{/CAT-AdvData($DepVariations,99)}

Der Zähler sorgt dafür, dass vor dem ersten Eintrag kein Komma steht.

Bewertungssterne separat anzeigen

Wollen Sie nur die Sterne an einer bestimmten Stelle zeigen, beispielsweise neben dem Produktnamen, verwenden Sie das Summary-Widget.

<div id="star-rating" style="cursor:pointer"></div>

<script type="text/javascript" src="//widgets.trustedshops.com/reviews/tsSticker/tsProductStickerSummary.js"></script>

<script type="text/javascript">
   var summaryBadge = new productStickerSummary();
   summaryBadge.showSummary({
      'tsId': 'IHRE TRUSTED SHOPS ID',

      {PR-DepVariations}
         {CAT-AdvData($DepVariations,99)}sku: ['~PR-ProdIndex~'{@PR-Data},{PR-DepVariationName1}'~PR-Number~'{/PR-DepVariationName1}{/@PR-Data}],{/CAT-AdvData($DepVariations,99)}
      {/PR-DepVariations}

      {!PR-DepVariations}
         'sku': '~PR-ProdIndex~',
      {/!PR-DepVariations}

      'element': '#star-rating',
      'starColor': '#FFDC0F',
      'starSize': '14px',
      'fontSize': '12px',
      'showRating': true,
      'scrollToReviews': false
   });
</script>

Ein script-Tag mit src muss geschlossen werden, bevor das nächste beginnt. Zwei Skriptblöcke ineinander zu schachteln führt dazu, dass der innere Block nie ausgeführt wird und die Sterne kommentarlos fehlen.

Produktbewertungen bei Google

Trusted Shops überträgt die Produktbewertungen automatisch per JavaScript an Google. Von Ihrer Seite ist dafür nichts weiter zu tun, sobald die Produktbewertungen eingebunden sind.

Shopbewertungen als Mikrodaten

Die Bewertungen Ihres Shops lassen sich zusätzlich als Mikrodaten an Suchmaschinen übergeben und erscheinen dort als Rich Snippets. Wegweiser: Mikrodaten für Suchmaschinen und Rich Snippets

​Die drei Bausteine im Überblick

​Das Trustbadge einbinden

​Schritt 1: Den Trustbadge-Code beschaffen

​Schritt 2: Den Trustbadge-Code einbinden

​Den Käuferschutz einbinden

​Voraussetzung

​Die Bestelldaten übergeben

​Käuferschutz Excellence einbinden

​Voraussetzung

​Schritt 1: Die Käuferschutzprodukte konfigurieren

​Schritt 2: Die Auswahl auf der Zahlungs- und Versandartenseite anbieten

​Schritt 3: Die Fehlermeldung hinterlegen

​Bewertungen anzeigen

​Shopbewertungen

​Produktbewertungen

​Bewertungssterne separat anzeigen

​Produktbewertungen bei Google

​Shopbewertungen als Mikrodaten

​Verwandte Themen

Die drei Bausteine im Überblick

Das Trustbadge einbinden

Schritt 1: Den Trustbadge-Code beschaffen

Schritt 2: Den Trustbadge-Code einbinden

Den Käuferschutz einbinden

Voraussetzung

Die Bestelldaten übergeben

Käuferschutz Excellence einbinden

Voraussetzung

Schritt 1: Die Käuferschutzprodukte konfigurieren

Schritt 2: Die Auswahl auf der Zahlungs- und Versandartenseite anbieten

Schritt 3: Die Fehlermeldung hinterlegen

Bewertungen anzeigen

Shopbewertungen

Produktbewertungen

Bewertungssterne separat anzeigen

Produktbewertungen bei Google

Shopbewertungen als Mikrodaten

Verwandte Themen