> ## Documentation Index
> Fetch the complete documentation index at: https://dokumentation.websale.de/llms.txt
> Use this file to discover all available pages before exploring further.

# Bewertungserinnerungen per E-Mail versenden

> Käufer eine konfigurierbare Zeit nach dem Kauf automatisch an eine Produktbewertung erinnern, mit Deep-Links auf die gekauften Produkte.

Die meisten Käufer bewerten nicht, weil sie nicht wollen, sondern weil sie im Moment des Kaufs noch nichts zu sagen haben und später nicht mehr daran denken. Eine Erinnerung ein paar Wochen nach der Lieferung trifft genau den Zeitpunkt, an dem beides zusammenkommt: Erfahrung und Anlass.

Der Shop verschickt diese Erinnerung automatisch, als HTML-Mail, mit Deep-Links auf genau die Produkte, die der Empfänger gekauft hat.

Produkte, die Sie vom Produktbewertungs-Modul ausgenommen haben, beispielsweise Gutscheine, tauchen in der Erinnerung nicht auf. Es wird auch keine Erinnerung verschickt, wenn eine Bestellung ausschließlich aus solchen Produkten bestand.

## Bevor Sie anfangen

> [!WARNING]
>
> Lesen Sie diesen Abschnitt vollständig, bevor Sie `Allow` auf `yes` setzen. Der Schalter wirkt sofort und rückwirkend: Steht er auf `yes`, verschickt der Shop die Erinnerungen für **alle** Bestellungen, die im eingestellten Zeitraum liegen, auch für längst zurückliegende. Bei einem Shop, der schon läuft, sind das im Zweifel tausende Mails auf einmal.

### Was WEBSALE einrichtet

Drei Dinge liegen nicht in Ihrer Hand und müssen von der WEBSALE AG eingerichtet werden:

* die Freischaltung der WEBSALE-Produktbewertung insgesamt
* die Freischaltung der Funktion "Bewertungserinnerungs-E-Mail senden"
* der Zeitraum zwischen Kauf und Erinnerung, beispielsweise 20 Tage

Lassen Sie den Zeitraum für die Einrichtungsphase bewusst hoch setzen, beispielsweise auf 90 Tage. Dann haben Sie Zeit für Aufbau und Test, ohne dass zwischendurch echte Mails hinausgehen. Nach dem Livegang lassen Sie ihn auf einen sinnvollen Wert zurücksetzen.

> [!WARNING]
>
> Der lange Zeitraum schützt nur zusammen mit `Allow = no`. Ein Shop, der seit drei Jahren läuft, hat auch vor 90 Tagen Bestellungen gehabt. Steht `Allow` dabei auf `yes`, gehen die Mails für diese Bestellungen sofort hinaus.

Wegweiser: [Produktbewertungs-Modul konfigurieren](https://dokumentation.websale.de/v8s/websale-produktbewertung/produktbewertungs-modul-konfigurieren.md)

### Was sich nicht testen lässt

Die Erinnerungsmail lässt sich nicht über eine alternative Shopkonfiguration ausprobieren. Sie kann nur über den Online-Servicebereich als Testmail ausgelöst werden, und der arbeitet mit der echten `shop.config`.

## Schritt 1: Die Shopkonfiguration ergänzen

```ini theme={"theme":{"light":"github-light","dark":"github-dark"},"languages":{"custom":["/languages/websale.json"]}}
<RateRemindMail>
   Allow         = no
   Subject-Txt   = Bewerten Sie die von Ihnen bestellten Produkte
   SenderAddress = bewertung@ihr-shop.de
   SenderName    = Ihr Shop
   Template      = mail_rate_remind.htm
</RateRemindMail>
```

| Parameter | Bedeutung | |
| - | - | - |
| `Allow` | `yes` schaltet den automatischen Versand ein | |
| `Subject-Txt` | der Betreff | Pflicht |
| `SenderAddress` | die Absenderadresse | Pflicht |
| `SenderName` | der angezeigte Absendername | |
| `Template` | das Template der Mail | Pflicht |

> [!WARNING]
>
> Fehlt `SenderAddress` oder `Subject-Txt`, oder ist die Template-Datei nicht vorhanden oder leer, dann schaltet sich die Funktion selbst ab, auch wenn `Allow` auf `yes` steht. Sie bekommen dafür keine Meldung im Shop, nur einen Eintrag im Protokoll. Wenn die Erinnerungen ausbleiben, prüfen Sie zuerst diese drei Angaben.
>
> Die Einstellungen werden **je Subshop** gelesen, aus der `shop.config` des jeweiligen Subshops, und auch das Mailtemplate wird im Templateverzeichnis dieses Subshops gesucht. In einem Shop mit mehreren Subshops muss jeder Subshop seinen eigenen Abschnitt und sein eigenes Template haben.

Referenz: [Abschnitt RateRemindMail](https://dokumentation.websale.de/v8s/referenz/konfigurationen/shopkonfiguration-shop-config/e-mails.md#rateremindmail)

## Schritt 2: Das Mail-Template anlegen

Legen Sie die Datei unter dem Namen an, den Sie bei `Template` eingetragen haben.

```html theme={"theme":{"light":"github-light","dark":"github-dark"},"languages":{"custom":["/languages/websale.json"]}}
<html>
   <head>
      <base href="~URL-Template~">
   </head>
   <body>

      <p>~A-CompleteSalutation~</p>

      <p>
         wir hoffen, dass Sie mit Ihrer Bestellung zufrieden sind. Nehmen Sie sich
         ein paar Minuten Zeit und berichten Sie uns und anderen Kunden von Ihren
         Erfahrungen mit diesen Produkten.
      </p>

      <p>Ihre Bestellung vom ~WS-OrderDate~:</p>

      {@PR-Data}
         <a href="~PR-DeepLink~">
            <img src="~PR-Image~" alt="">
            ~PR-Name~
         </a>
      {/@PR-Data}

      <p>
         Vielen Dank<br>
         Ihr Shop-Team
      </p>

   </body>
</html>
```

`<base href="~URL-Template~">` gehört in den Kopf. Ohne diese Zeile sind relative Bildpfade im Postfach des Empfängers ins Leere gerichtet, und die Produktbilder bleiben leer.

> [!WARNING]
>
> Versprechen Sie in dieser Mail keine Gegenleistung für eine Bewertung, also keinen Gutschein, keinen Rabatt und keine Teilnahme an einer Verlosung. Wer Bewertungen belohnt, muss das offenlegen, und ob eine so eingeworbene Bewertung überhaupt noch als Kundenbewertung dargestellt werden darf, ist eine rechtliche Frage. Lesen Sie dazu die Hinweise zur Omnibus-Richtlinie, bevor Sie einen solchen Satz in die Mail schreiben.

Über die im Beispiel verwendeten Tags hinaus stehen weitere zur Verfügung, unter anderem `PR-Number`, `PR-Thumbnail`, `WS-OrderID`, `WS-SubShopID` und die Adressfelder der Familie `A-`.

Referenz: [A-CompleteSalutation](https://dokumentation.websale.de/v8s/referenz/tags/a-rechnungsadresse.md#a-completesalutation) · A-"technischer Name" · [PR-DeepLink](https://dokumentation.websale.de/v8s/referenz/tags/pr/bilder-und-links.md#pr-deeplink-gehort-nicht-auf-ein-shoptemplate) · [PR-Image](https://dokumentation.websale.de/v8s/referenz/tags/pr/bilder-und-links.md#die-tags-im-uberblick) · [PR-Name](https://dokumentation.websale.de/v8s/referenz/tags/pr/grundlagen-und-produktdaten.md#die-tags-im-uberblick) · [PR-Number](https://dokumentation.websale.de/v8s/referenz/tags/pr/grundlagen-und-produktdaten.md#die-tags-im-uberblick) · [PR-Thumbnail](https://dokumentation.websale.de/v8s/referenz/tags/pr/bilder-und-links.md#die-tags-im-uberblick) · [URL-Template](https://dokumentation.websale.de/v8s/referenz/tags/url-internetadresse.md#die-tags-im-uberblick) · [WS-OrderDate](https://dokumentation.websale.de/v8s/referenz/tags/ws/bestellprozess-adressen-und-pruefungen.md#nach-der-bestellung) · [WS-OrderID](https://dokumentation.websale.de/v8s/referenz/tags/ws/bestellprozess-adressen-und-pruefungen.md#die-tags-im-uberblick) · [WS-SubShopID](https://dokumentation.websale.de/v8s/referenz/tags/ws/shop-seite-und-technik.md#die-tags-im-uberblick)

## Schritt 3: Den Käufer entscheiden lassen (optional)

![Bewertungserinnerungen](https://mintcdn.com/websaleag-44ee7ea6/3oj9a6fdwupCK3vQ/images/bewertungserinnerungen.png?fit=max\&auto=format\&n=3oj9a6fdwupCK3vQ\&q=85\&s=6e6f66e1c457adc568837b0ea1f15eb2)

Sie können dem Käufer auf der Bestellübersicht die Wahl lassen, ob er erinnert werden möchte. Der Shop merkt sich seine Entscheidung und bietet sie beim nächsten Mal wieder an.

Dafür gibt es sieben Tags.

| Tag | Liefert |
| - | - |
| `RATEREMINDMAIL-Hidden_name` | den Feldnamen des versteckten Feldes |
| `RATEREMINDMAIL-Hidden_value` | dessen Wert |
| `RATEREMINDMAIL-Name` | den Feldnamen der Checkbox |
| `RATEREMINDMAIL-UserLastorderExists` | Klammerung, wenn bei der **letzten Bestellung** eine Entscheidung festgehalten wurde |
| `RATEREMINDMAIL-UserLastOrderSelection` | setzt `checked` entsprechend dieser Entscheidung |
| `RATEREMINDMAIL-UserSelectedSession` | Klammerung, wenn in **dieser Sitzung** eine Entscheidung festgehalten wurde |
| `RATEREMINDMAIL-UserSelectionSession` | setzt `checked` entsprechend dieser Entscheidung |

Daraus ergibt sich eine Rangfolge: Die Entscheidung der letzten Bestellung schlägt die der Sitzung, und wenn es gar keine gibt, greift Ihre Voreinstellung im Template.

```html theme={"theme":{"light":"github-light","dark":"github-dark"},"languages":{"custom":["/languages/websale.json"]}}
<form action="~FORM-PlaceOrder~" method="post">

   <p>Möchten Sie eine Erinnerung zur Bewertung Ihrer Produkte erhalten?</p>

   <input type="hidden"
          name="~RATEREMINDMAIL-Hidden_name~"
          value="~RATEREMINDMAIL-Hidden_value~">

   {RATEREMINDMAIL-UserLastorderExists}
      <!-- Entscheidung aus der letzten Bestellung uebernehmen -->
      <input type="checkbox"
             id="rateremind"
             name="~RATEREMINDMAIL-Name~"
             ~RATEREMINDMAIL-UserLastOrderSelection~>
   {/RATEREMINDMAIL-UserLastorderExists}

   {!RATEREMINDMAIL-UserLastorderExists}

      {RATEREMINDMAIL-UserSelectedSession}
         <!-- Entscheidung aus dieser Sitzung uebernehmen -->
         <input type="checkbox"
                id="rateremind"
                name="~RATEREMINDMAIL-Name~"
                ~RATEREMINDMAIL-UserSelectionSession~>
      {/RATEREMINDMAIL-UserSelectedSession}

      {!RATEREMINDMAIL-UserSelectedSession}
         <!-- noch keine Entscheidung vorhanden, Voreinstellung -->
         <input type="checkbox"
                id="rateremind"
                name="~RATEREMINDMAIL-Name~" checked>
      {/!RATEREMINDMAIL-UserSelectedSession}

   {/!RATEREMINDMAIL-UserLastorderExists}

   <label for="rateremind">Ja, bitte erinnern Sie mich</label>

</form>
```

> [!WARNING]
>
> `UserLastorderExists` prüft **nicht**, ob es eine frühere Bestellung gibt. Es prüft, ob bei der letzten Bestellung eine Entscheidung zu dieser Frage festgehalten wurde. Ein Stammkunde, der die Checkbox bisher nie gesehen hat, fällt deshalb in den Zweig für Neukunden. Das ist richtig so, der Tagname legt aber etwas anderes nahe.

Das versteckte Feld muss mit im Formular stehen. Es sagt dem Shop, dass diese Seite die Frage überhaupt gestellt hat. Ohne das versteckte Feld kann der Shop eine nicht angehakte Checkbox nicht von einer fehlenden Checkbox unterscheiden.

Ob Sie die Checkbox vorbelegen, ist eine Abwägung. Das Beispiel oben belegt sie vor, das bringt mehr Bewertungen. Eine nicht vorbelegte Checkbox bringt weniger, dafür nur von Leuten, die tatsächlich erinnert werden wollen.

Referenz: [FORM-PlaceOrder](https://dokumentation.websale.de/v8s/referenz/tags/form-formulare.md#bestellablauf) · [RATEREMINDMAIL-Hidden\_name](https://dokumentation.websale.de/v8s/referenz/tags/rateremindmail-bewertungserinnerung.md#die-tags-im-uberblick) · [RATEREMINDMAIL-Hidden\_value](https://dokumentation.websale.de/v8s/referenz/tags/rateremindmail-bewertungserinnerung.md#die-tags-im-uberblick) · [RATEREMINDMAIL-Name](https://dokumentation.websale.de/v8s/referenz/tags/rateremindmail-bewertungserinnerung.md#die-beiden-formularfelder) · [RATEREMINDMAIL-UserSelectedSession](https://dokumentation.websale.de/v8s/referenz/tags/rateremindmail-bewertungserinnerung.md#die-fruhere-entscheidung-ubernehmen) · [RATEREMINDMAIL-UserSelectionSession](https://dokumentation.websale.de/v8s/referenz/tags/rateremindmail-bewertungserinnerung.md#die-fruhere-entscheidung-ubernehmen) · [RATEREMINDMAIL-UserLastorderExists](https://dokumentation.websale.de/v8s/referenz/tags/rateremindmail-bewertungserinnerung.md#die-fruhere-entscheidung-ubernehmen) · [RATEREMINDMAIL-UserLastOrderSelection](https://dokumentation.websale.de/v8s/referenz/tags/rateremindmail-bewertungserinnerung.md#die-fruhere-entscheidung-ubernehmen)

### Die Checkbox prüfen

Führen Sie eine Testbestellung durch und lassen Sie die Checkbox dabei **leer**. Sehen Sie sich die Bestelldaten anschließend im Online-Servicebereich an. Steht dort `DenyRateRemindEmail = yes`, hat der Shop die Entscheidung übernommen.

## Schritt 4: Eine Testmail verschicken

![Osb Rateremindmail Test](https://mintcdn.com/websaleag-44ee7ea6/1eGKRe68jdkjqhBR/images/osb_rateremindmail_test.jpg?fit=max\&auto=format\&n=1eGKRe68jdkjqhBR\&q=85\&s=eb906ec69a3e9ee8eb763d79ac8728b9)

> [!WARNING]
>
> Für diesen Schritt muss `Allow` auf `yes` stehen. Damit ist auch der automatische Versand scharf. Prüfen Sie vorher, dass der eingestellte Zeitraum weit genug in der Vergangenheit liegt, dass keine echte Bestellung ihn erreicht.

1. Setzen Sie `Allow` in `<RateRemindMail>` auf `yes`.
2. Führen Sie im Shop eine Bestellung eines beliebigen Produkts durch.
3. Öffnen Sie im Online-Servicebereich den Dienst **Bestellungen**.
4. Suchen Sie Ihre Bestellung und öffnen Sie die **Details**.
5. In der linken Spalte erscheint **Test-E-Mail zur Bewertungserinnerung**. Klicken Sie auf das Weltkugel-Symbol.
6. Tragen Sie die Adresse ein, an die die Testmail gehen soll.

## Schritt 5: Den Zeitraum zurücksetzen

Haben Sie den Zeitraum für die Einrichtung hoch setzen lassen, lassen Sie ihn nach dem Livegang von Ihrem Ansprechpartner bei der WEBSALE AG auf einen realistischen Wert zurücksetzen.

Wählen Sie den Abstand so, dass die Ware beim Empfänger angekommen und benutzt worden ist. Zu früh erinnert heißt: Der Käufer hat noch nichts zu sagen. Zu spät heißt: Er erinnert sich nicht mehr genau.

## Verwandte Themen

* Wegweiser: [Beschreibung des Produktbewertungs-Moduls](https://dokumentation.websale.de/v8s/websale-produktbewertung/beschreibung-des-produktbewertungs-moduls.md)
* Wegweiser: [Produktbewertungs-Modul konfigurieren](https://dokumentation.websale.de/v8s/websale-produktbewertung/produktbewertungs-modul-konfigurieren.md)
* Wegweiser: [Bewertungen beim Produkt anzeigen](https://dokumentation.websale.de/v8s/websale-produktbewertung/bewertungen-beim-produkt-anzeigen.md)
* Wegweiser: [Produkte aus dem Produktbewertungs-Modul ausschließen](https://dokumentation.websale.de/v8s/websale-produktbewertung/produkte-aus-dem-produktbewertungs-modul-ausschliessen.md)


## Related topics

- [Produkte aus dem Produktbewertungs-Modul ausschließen](https://dokumentation.websale.de/v8s/websale-produktbewertung/produkte-aus-dem-produktbewertungs-modul-ausschliessen.md)
- [Bewertungen beim Produkt anzeigen](https://dokumentation.websale.de/v8s/websale-produktbewertung/bewertungen-beim-produkt-anzeigen.md)
- [Materialien Produktbewertung](https://dokumentation.websale.de/v8s/materialien/materialien-produktbewertung.md)
- [Produktbewertungs-Modul konfigurieren](https://dokumentation.websale.de/v8s/websale-produktbewertung/produktbewertungs-modul-konfigurieren.md)
- [Beschreibung des Produktbewertungs-Moduls](https://dokumentation.websale.de/v8s/websale-produktbewertung/beschreibung-des-produktbewertungs-moduls.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.