Verjaardagskorting: documentatie van de PrestaShop-module
De module installeren, de verjaardagscampagnes instellen, de dagelijkse verzending plannen en de gegenereerde omzet bekijken.
Overzicht
De module stuurt je klanten automatisch een persoonlijke kortingscode bij drie gelegenheden: hun verjaardag, het jubileum van hun eerste geldige bestelling en het jubileum van het aanmaken van hun account. Elke code is een native PrestaShop-winkelwagenregel, voorbehouden aan de klant en eenmaal bruikbaar. Daarna meet de module de omzet van de bestellingen die met deze codes zijn geplaatst.
Compatibiliteit: PrestaShop 8.0 tot 9.x, multistore, 8 talen (Engels, Frans, Spaans, Duits, Italiaans, Nederlands, Pools, Portugees).
Installatie
- Klik in Modules > Modulebeheer op Upload een module en verstuur het ZIP-bestand.
- De module maakt twee tabellen aan, registreert zijn hooks, genereert het token van de geplande taak en kopieert de e-mailsjablonen voor elke geïnstalleerde taal.
- In het menu Klanten verschijnt het nieuwe tabblad Verjaardagen en speciale dagen. De knop Configureren van de module leidt er ook naartoe.
Om van 1.0.0 naar 1.1.0 te gaan, upload je gewoon het nieuwe ZIP-bestand: het updatescript registreert de nieuwe hooks.
Het dashboard toont de checklist “Aan de slag” zolang de vier belangrijkste stappen niet zijn uitgevoerd: een campagne inschakelen, jezelf een test-e-mail sturen, de dagelijkse taak inplannen en geboortedata verzamelen.
De campagnes instellen
Het tabblad Campagnes bevat één kaart per gelegenheid. Schakel hem in met de schakelaar rechtsboven: de instellingen en het voorbeeld van de e-mail verschijnen.
Het aanbod
- Type korting: percentage, vast bedrag (in de standaardvaluta) of gratis verzending.
- Waarde en Ook gratis verzending aanbieden bovenop een percentage of bedrag.
- Minimaal bestelbedrag (incl. btw): 0 voor geen minimum.
- Geldigheid na de datum: aantal dagen dat de code geldig blijft vanaf de datum van de gelegenheid.
- Vooraf versturen: aantal dagen voor de datum. 0 verstuurt op de dag zelf.
- Verhoging per extra jaar en Maximale waarde (bestel- en accountjubileum): bijvoorbeeld 10 % het eerste jaar, +2 per jaar, maximaal 20 %.
- Producten die al in de aanbieding zijn uitsluiten en Combineerbaar met andere kortingsbonnen.
Wie ontvangt het
- Minimaal aantal geldige bestellingen: 0 bij de verjaardag neemt ook klanten mee die nog nooit hebben besteld.
- Codeprefix: BDAY geeft bijvoorbeeld codes als BDAY-7KQ2M9.
- Klantgroepen: niets aangevinkt betekent alle groepen.
De e-mail
Pas onderwerp, titel en bericht per taal aan via de taaltabbladen. Het voorbeeld rechts wordt live bijgewerkt met de werkelijke korting. Beschikbare tags: {firstname}, {lastname}, {discount}, {code}, {expiry_date}, {min_amount}, {years} (behalve verjaardag) en {shop_name}. Een leeg veld gebruikt de standaardtekst van de taal.
De knop Opslaan en test versturen stuurt de e-mail naar het adres van de ingelogde medewerker, in diens taal.
De dagelijkse verzending plannen
Kopieer in Automatisering en instellingen de URL van de geplande taak en roep hem eenmaal per dag aan, bij voorkeur vroeg in de ochtend. Voorbeeld van een cronregel:
0 7 * * * curl -s "https://jouw-winkel.nl/module/dfkeydates/cron?token=JOUW_TOKEN" >/dev/nullElke uitvoering maakt de codes van de dag aan, verstuurt de e-mails en herinneringen, koppelt gebruikte codes aan hun bestelling en verwijdert verlopen, ongebruikte codes.
- Inhalen van gemiste dagen (standaard 2): als de taak niet heeft gedraaid, worden de data van de voorgaande dagen verwerkt.
- Maximaal aantal codes per uitvoering (standaard 200): de rest wordt bij de volgende uitvoering verstuurd.
- Ook uitvoeren bij winkelbezoeken: zonder cronjob draait de module bij winkelbezoeken, maximaal eenmaal per uur en nadat de pagina is verstuurd. Hij stopt zodra er in de laatste 26 uur een echte cronjob is aangeroepen.
De knoppen Vandaag simuleren (lijst van de codes die zouden vertrekken, zonder iets te versturen), Nu uitvoeren, Gebruikte codes opnieuw synchroniseren en Nieuw token staan op dezelfde pagina.
Elke klant ontvangt maximaal één code per gelegenheid en per jaar. Je kunt de taak dus meerdere keren starten zonder risico op dubbele codes.
Bescherming tegen misbruik en verzamelen van geboortedata
De wachttijd na registratie of wijziging van de verjaardag (standaard 30 dagen) blokkeert de verjaardagscode voor een account dat te nieuw is of waarvan de datum net in de winkel is ingevuld of gewijzigd. Wijzigingen door een medewerker in de back-office activeren deze wachttijd niet.
De geboortedata komen uit het native veld van het klantaccount (Klanten > Instellingen > Geboortedatum). Is dat veld uitgeschakeld, dan verzamelt de module ze zelf:
- op de orderbevestigingspagina, als de datum onbekend is (optie Vraag naar de geboortedatum op de orderbevestigingspagina als die onbekend is);
- op de pagina Mijn cadeaus en speciale dagen in het klantaccount.
Het dashboard toont het percentage accounts met een bekende datum.
Herinnering voor het verlopen
Schakel de herinnering in en kies hoeveel dagen voor het verlopen hij wordt verstuurd. Hij gaat alleen uit als de code niet is gebruikt. De teksten van de herinnering en de knoptekst van alle e-mails stel je per taal in. De knop Testherinnering versturen slaat de instellingen op en stuurt je een voorbeeld.
Code met één klik
De knop in elke e-mail verwijst naar een ondertekende link die bij de code hoort. De module onthoudt de code en zet hem in de winkelwagen zodra de klant is ingelogd en producten in de winkelwagen heeft. Is de klant niet ingelogd, dan gaat hij naar de inlogpagina. Is het minimale bestelbedrag niet bereikt, dan wacht de code en wordt hij toegepast zodra dat wel zo is. Een verlopen code, een al gebruikte code of een code voor een andere klant wordt met een melding geweigerd.
De klantpagina “Mijn cadeaus en speciale dagen”
Bereikbaar via Mijn account, toont deze pagina de actieve codes met een kopieerknop en een knop Gebruiken in mijn winkelwagen, de komende speciale dagen van de klant, het formulier voor de geboortedatum, eerdere cadeaus en een vakje om deze e-mails niet meer te ontvangen. Je kunt deze pagina in de instellingen verbergen.
Statistieken en omzetrapport
Het tabblad Dashboard toont voor de gekozen periode:
- de gegenereerde omzet excl. en incl. btw, berekend op geldige bestellingen waarin een code is gebruikt en omgerekend naar de standaardvaluta;
- de verzonden en gebruikte codes, de conversieratio en de gemiddelde bestelwaarde;
- de toegekende korting en het rendement (omzet gedeeld door korting);
- de bestellingen zonder de code die zijn geplaatst terwijl een code geldig was;
- een grafiek over 12 maanden, de resultaten per gelegenheid, de verzendingen van de komende 30 dagen en de laatste bestellingen met een code.
De omzet wordt toegerekend aan de periode waarin de code is verzonden. Het tabblad Verzonden codes toont alle codes met zoekfunctie, filters op gelegenheid, status en datum, opnieuw verzenden van de e-mail voor een actieve code en CSV-export. Ook de klantpagina in de back-office toont de codes die naar die klant zijn verzonden.
Opschonen van verlopen codes
De instelling Verlopen, ongebruikte codes verwijderen na (standaard 30 dagen) verwijdert de bijbehorende winkelwagenregels zodat Catalogus > Kortingen overzichtelijk blijft. De geschiedenis en statistieken van de module blijven bewaard. Zet 0 om nooit te verwijderen.
AVG
De module meldt zich aan bij de officiële AVG-module van PrestaShop. De gegevensexport van een klant bevat zijn codes en voorkeuren, het verwijderen wist de modulegeschiedenis van die klant. Elke klant kan zich in zijn account afmelden voor deze e-mails.
Multistore
Campagnes en instellingen gelden per winkel. Selecteer een winkel in het multistore-menu om ze te wijzigen. De aangemaakte codes zijn beperkt tot de betreffende winkel.
Veelgestelde vragen en probleemoplossing
Er wordt geen code verstuurd
Controleer of minstens één campagne is ingeschakeld en gebruik Vandaag simuleren. Is de lijst leeg, dan voldoet vandaag geen enkele klant aan de criteria: onbekende datum, lopende wachttijd, groep niet geselecteerd, te weinig bestellingen of afgemelde klant.
De e-mails komen niet aan
Stuur een test-e-mail vanuit een campagne. Komt die niet aan, controleer dan de e-mailconfiguratie van PrestaShop in Geavanceerde instellingen > E-mail. Een code waarvan de e-mail is mislukt, wordt in de codelijst gemarkeerd en kan opnieuw worden verzonden.
Een bestelling ontbreekt in de statistieken
Alleen geldige bestellingen worden geteld. Heeft een medewerker zonder rechten op de module een bestelling in de back-office aangemaakt, klik dan op Gebruikte codes opnieuw synchroniseren; de dagelijkse taak doet dit ook automatisch.