Geburtstagsgutschein: Dokumentation des PrestaShop-Moduls

Überblick

Das Modul sendet Ihren Kunden automatisch einen persönlichen Rabattcode zu drei Anlässen: zum Geburtstag, zum Jahrestag der ersten gültigen Bestellung und zum Jahrestag der Kontoerstellung. Jeder Code ist eine native PrestaShop-Warenkorbregel, dem Kunden vorbehalten und einmal verwendbar. Anschließend misst das Modul den Umsatz der Bestellungen, bei denen diese Codes eingelöst wurden.

Kompatibilität: PrestaShop 8.0 bis 9.x, Multishop, 8 Sprachen (Englisch, Französisch, Spanisch, Deutsch, Italienisch, Niederländisch, Polnisch, Portugiesisch).

Installation

1. Klicken Sie unter Module > Modulmanager auf Modul hochladen und senden Sie die ZIP-Datei.
2. Das Modul legt zwei Tabellen an, registriert seine Hooks, erzeugt den Token für den geplanten Task und kopiert die E-Mail-Vorlagen für jede installierte Sprache.
3. Im Menü Kunden erscheint der neue Reiter Geburtstage und besondere Anlässe. Der Button Konfigurieren des Moduls führt ebenfalls dorthin.

Für das Update von 1.0.0 auf 1.1.0 laden Sie einfach die neue ZIP-Datei hoch: Das Upgrade-Skript registriert die neuen Hooks.

Kampagnen einrichten

Der Reiter Kampagnen enthält eine Karte pro Anlass. Aktivieren Sie sie mit dem Schalter oben rechts: Einstellungen und E-Mail-Vorschau werden eingeblendet.

Das Angebot

• Rabattart: Prozentsatz, fester Betrag (in der Standardwährung) oder kostenloser Versand.
• Wert und Zusätzlich kostenlosen Versand anbieten zu einem Prozentsatz oder Betrag.
• Mindestbestellwert (inkl. MwSt.): 0 für keinen Mindestwert.
• Gültigkeit nach dem Datum: Gültigkeitsdauer des Codes in Tagen ab dem Datum des Anlasses.
• Im Voraus senden: Anzahl Tage vor dem Datum. 0 sendet am Tag selbst.
• Erhöhung pro zusätzlichem Jahr und Höchstwert (Bestell- und Kontojubiläum): zum Beispiel 10 % im ersten Jahr, +2 pro Jahr, begrenzt auf 20 %.
• Bereits reduzierte Produkte ausschließen und Mit anderen Gutscheinen kombinierbar.

Wer ihn erhält

• Mindestanzahl gültiger Bestellungen: 0 beim Geburtstag schließt Kunden ein, die noch nie bestellt haben.
• Code-Präfix: zum Beispiel ergibt BDAY Codes wie BDAY-7KQ2M9.
• Kundengruppen: keine ausgewählt bedeutet alle Gruppen.

Die E-Mail

Bearbeiten Sie Betreff, Überschrift und Nachricht für jede Sprache über die Sprachreiter. Die Vorschau rechts aktualisiert sich live mit dem tatsächlichen Rabatt. Verfügbare Platzhalter: {firstname}, {lastname}, {discount}, {code}, {expiry_date}, {min_amount}, {years} (außer Geburtstag) und {shop_name}. Ein leeres Feld übernimmt den Standardtext der Sprache.

Der Button Speichern und Test senden schickt die E-Mail an die Adresse des angemeldeten Mitarbeiters, in dessen Sprache.

Den täglichen Versand planen

Kopieren Sie unter Automatisierung und Einstellungen die URL des geplanten Tasks und rufen Sie sie einmal täglich auf, am besten früh morgens. Beispiel für eine Cron-Zeile:

0 7 * * * curl -s "https://ihr-shop.de/module/dfkeydates/cron?token=IHR_TOKEN" >/dev/null

Jeder Durchlauf erstellt die Codes des Tages, versendet E-Mails und Erinnerungen, ordnet eingelöste Codes ihrer Bestellung zu und löscht abgelaufene, ungenutzte Codes.

• Nachholen verpasster Tage (standardmäßig 2): Ist der Task nicht gelaufen, werden die Termine der Vortage verarbeitet.
• Maximale Codes pro Durchlauf (standardmäßig 200): Der Rest wird beim nächsten Durchlauf versendet.
• Auch bei Shop-Besuchen ausführen: Ohne Cronjob läuft das Modul bei Shop-Besuchen, höchstens einmal pro Stunde und nach Auslieferung der Seite. Es stoppt, sobald in den letzten 26 Stunden ein echter Cronjob aufgerufen wurde.

Die Buttons Heute simulieren (Liste der Codes, die versendet würden, ohne Versand), Jetzt ausführen, Verwendete Codes neu synchronisieren und Neuer Token befinden sich auf derselben Seite.

Missbrauchsschutz und Erfassung der Geburtsdaten

Die Wartezeit nach Registrierung oder Änderung des Geburtstags (standardmäßig 30 Tage) sperrt den Geburtstagscode für ein zu neues Konto oder ein Konto, dessen Datum gerade im Shop eingetragen oder geändert wurde. Änderungen durch einen Mitarbeiter im Backoffice lösen diese Wartezeit nicht aus.

Die Geburtsdaten stammen aus dem nativen Feld des Kundenkontos (Kunden > Einstellungen > Geburtsdatum). Ist dieses Feld deaktiviert, erfasst das Modul sie selbst:

• auf der Bestellbestätigungsseite, wenn das Datum unbekannt ist (Option Auf der Bestellbestätigungsseite nach dem Geburtsdatum fragen, wenn es unbekannt ist);
• auf der Seite Meine Geschenke und besonderen Anlässe im Kundenkonto.

Das Dashboard zeigt den Anteil der Konten mit bekanntem Datum.

Erinnerung vor Ablauf

Aktivieren Sie die Erinnerung und wählen Sie, wie viele Tage vor Ablauf sie versendet wird. Sie geht nur raus, wenn der Code noch nicht verwendet wurde. Die Texte der Erinnerung und der Button-Text aller E-Mails werden pro Sprache eingestellt. Der Button Test-Erinnerung senden speichert die Einstellungen und schickt Ihnen ein Beispiel.

Code mit einem Klick

Der Button jeder E-Mail verweist auf einen signierten Link, der zum Code gehört. Das Modul merkt sich den Code und legt ihn in den Warenkorb, sobald der Kunde angemeldet ist und Produkte im Warenkorb hat. Ist der Kunde nicht angemeldet, wird er zur Anmeldeseite geführt. Ist der Mindestbestellwert nicht erreicht, wartet der Code und wird eingelöst, sobald er erreicht ist. Ein abgelaufener, bereits verwendeter oder für einen anderen Kunden bestimmter Code wird mit einer Meldung abgelehnt.

Die Kundenseite „Meine Geschenke und besonderen Anlässe“

Über Mein Konto erreichbar, zeigt sie die aktiven Codes mit einem Kopier-Button und einem Button Im Warenkorb verwenden, die nächsten Anlässe des Kunden, das Geburtsdatumsformular, frühere Geschenke und ein Kästchen, um diese E-Mails nicht mehr zu erhalten. Sie können diese Seite in den Einstellungen ausblenden.

Statistiken und Umsatz-Tracking

Der Reiter Dashboard zeigt für den gewählten Zeitraum:

• den erzielten Umsatz netto und brutto, berechnet auf gültige Bestellungen mit Code und in die Standardwährung umgerechnet;
• die versendeten und eingelösten Codes, die Konversionsrate und den durchschnittlichen Warenkorb;
• den gewährten Rabatt und die Rendite (Umsatz geteilt durch Rabatt);
• die Bestellungen ohne den Code, die während der Gültigkeit eines Codes aufgegeben wurden;
• eine 12-Monats-Grafik, die Leistung nach Anlass, die Versände der nächsten 30 Tage und die letzten Bestellungen mit Code.

Der Umsatz wird dem Versandzeitraum des Codes zugeordnet. Der Reiter Versendete Codes listet alle Codes mit Suche, Filtern nach Anlass, Status und Datum, erneutem E-Mail-Versand für aktive Codes und CSV-Export. Auch die Kundenseite im Backoffice zeigt die an diesen Kunden versendeten Codes.

Bereinigung abgelaufener Codes

Die Einstellung Abgelaufene, ungenutzte Codes löschen nach (standardmäßig 30 Tage) löscht die entsprechenden Warenkorbregeln, damit Katalog > Rabatte übersichtlich bleibt. Verlauf und Statistiken des Moduls bleiben erhalten. Mit 0 wird nie gelöscht.

DSGVO

Das Modul meldet sich beim offiziellen DSGVO-Modul von PrestaShop an. Der Datenexport eines Kunden enthält seine Codes und Einstellungen, die Löschung entfernt den Modulverlauf dieses Kunden. Jeder Kunde kann sich in seinem Konto von diesen E-Mails abmelden.

Multishop

Kampagnen und Einstellungen gelten pro Shop. Wählen Sie im Multishop-Menü einen Shop aus, um sie zu bearbeiten. Die erstellten Codes sind auf den jeweiligen Shop beschränkt.

Häufige Fragen und Fehlerbehebung

Es wird kein Code versendet

Prüfen Sie, ob mindestens eine Kampagne aktiv ist, und nutzen Sie Heute simulieren. Ist die Liste leer, erfüllt heute kein Kunde die Kriterien: unbekanntes Datum, laufende Wartezeit, nicht ausgewählte Gruppe, zu wenige Bestellungen oder abgemeldeter Kunde.

Die E-Mails kommen nicht an

Senden Sie aus einer Kampagne eine Test-E-Mail. Kommt sie nicht an, prüfen Sie die E-Mail-Konfiguration von PrestaShop unter Erweiterte Einstellungen > E-Mail. Ein Code, dessen E-Mail fehlgeschlagen ist, wird in der Codeliste markiert und kann erneut gesendet werden.

Eine Bestellung fehlt in den Statistiken

Es werden nur gültige Bestellungen gezählt. Hat ein Mitarbeiter ohne Berechtigung für das Modul eine Bestellung im Backoffice angelegt, klicken Sie auf Verwendete Codes neu synchronisieren; der tägliche Task erledigt das ebenfalls automatisch.