DfCartRecovery: herstel van verlaten winkelwagens voor Shopware 6
Het herstel van verlaten winkelwagens op Shopware 6 installeren en configureren: geplande herinneringen, unieke kortingscodes, herstellink en tracking.
Overzicht
DfCartRecovery voegt aan Shopware 6 (Community Edition) het herstel van verlaten winkelwagens toe, normaal voorbehouden aan het Commercial-plan: detectie van winkelwagens, tot 3 geplande herinneringsmails, een unieke kortingscode per klant, een link om de winkelwagen met één klik te herstellen en tracking van teruggewonnen bestellingen. Geen externe dienst en geen administratiebuild: alles wordt in de instellingen van de plugin geconfigureerd.
Vereisten
- Shopware 6.5, 6.6 of 6.7 (zelfgehoste Community Edition, Shopware Cloud SaaS wordt niet ondersteund)
- PHP 8.1 of hoger (8.2+ aanbevolen)
- De message consumer en de uitvoering van geplande taken actief (de standaardaanbeveling van Shopware in productie)
- Werkende e-mailverzending op de shop (de herinneringen lopen via de native maildienst van Shopware)
Installatie
- Pak het archief uit en plaats de map
DfCartRecoveryincustom/plugins/. - Voer vanuit de Shopware-hoofdmap uit:
bin/console plugin:refresh
bin/console plugin:install --activate DfCartRecovery
bin/console cache:clear
De geplande taak df_cart_recovery.process wordt automatisch geregistreerd en draait elke 15 minuten. Controleer of uw workers draaien:
bin/console scheduled-task:run
bin/console messenger:consume async low_priority
De installatie maakt de opvolgtabel df_cart_recovery aan en het e-mailsjabloon “Herinnering verlaten winkelwagen (DataFirefly)”, vooraf vertaald in FR, EN, DE, ES en IT.
Configuratie
Ga naar Extensies → Mijn extensies → DfCartRecovery → Configuratie. Er zijn drie instellingenkaarten:
Algemeen
- Winkelwagenherstel activeren: hoofdschakelaar van de plugin.
- Minimale winkelwagenwaarde: winkelwagens onder dit bedrag worden genegeerd (0 = geen minimum).
- Bewaartermijn van de gegevens (dagen): oudere opvolgrecords worden automatisch verwijderd (standaard 30 dagen, zie het hoofdstuk AVG).
Herinneringsmails
- Aantal herinneringen: 1, 2 of 3 (standaard 2).
- Herinnering 1: minuten na het verlaten van de winkelwagen (standaard 60, dus 1 uur).
- Herinnering 2: minuten na herinnering 1 (standaard 1440, dus 24 uur).
- Herinnering 3: minuten na herinnering 2 (standaard 4320, dus 72 uur).
De reeks 1 u / +24 u / +72 u is de beproefde standaard van e-mailretargeting: houd hem aan als vertrekpunt en pas hem daarna aan op basis van uw herstelcijfers.
Kortingscode
- Een unieke kortingscode toevoegen: activeert het genereren van individuele codes.
- Promotie voor de gegenereerde codes: selecteer de Shopware-promotie die de codes zal dragen (zie hieronder).
- De code meesturen bij herinnering nr.: standaard 2, zodat klanten die al bij de eerste e-mail terugkomen zonder korting bestellen.
- Voorvoegsel van de code: standaard CART; de gegenereerde codes zien eruit als
CART-7F3A91B2.
De promotie voor de unieke codes aanmaken
- Open in de Shopware-admin Marketing → Promoties en maak een promotie aan (of hergebruik er een).
- Activeer op het tabblad Algemeen de individuele promotiecodes.
- Stel de korting (percentage of bedrag), de voorwaarden en de geldigheidsperiode in zoals gebruikelijk.
- Activeer de promotie en selecteer haar daarna in de configuratie van de plugin.
Bij de promotie moeten de individuele codes beslist geactiveerd zijn: de plugin voegt zijn gegenereerde codes aan die lijst toe. Zonder deze optie worden de verzonden codes in de checkout niet geaccepteerd.
De herinneringsmail aanpassen
De inhoud bewerkt u in Instellingen → E-mailsjablonen, type “Herinnering verlaten winkelwagen (DataFirefly)”, voor elke taal van de shop. Beschikbare Twig-variabelen:
firstName/lastName: voornaam en achternaam van de klantitems: artikelen in de winkelwagen, elk metlabelenquantitytotalencurrency: bedrag van de winkelwagen en valutacoderecoveryUrl: link om de winkelwagen te herstellen (te plaatsen op de actieknop)voucherCode: unieke kortingscode (leeg als de optie uitstaat of bij een herinnering zonder code, omring het blok dus met een Twig-voorwaarde)shopName: naam van de shop van het verkoopkanaalreminderNumber: nummer van de lopende herinnering (1, 2 of 3)
De herstellink
Elke e-mail bevat een unieke link in de vorm /df-cart-recovery/token, gegenereerd op het domein van het verkoopkanaal van de klant en in zijn taal. Bij een klik bouwt de plugin de winkelwagen artikel voor artikel opnieuw op, meldt hij via een storefrontbericht welke producten intussen niet meer beschikbaar zijn, registreert hij het tijdstip van de klik en stuurt hij door naar de winkelwagenpagina. Ongeldige of verlopen links leiden naar de homepage met een duidelijke melding.
Tracking van het herstel
Zodra er een bestelling wordt geplaatst, koppelt de plugin het e-mailadres van de klant aan de lopende verlaten winkelwagens: het record krijgt de status “hersteld” met de bestel-identificatie, de datum en het aantal verzonden herinneringen. De herinneringen stoppen voor die winkelwagen onmiddellijk. De gegevens zijn raadpleegbaar in de tabel df_cart_recovery (tokens, statussen, kliks, gekoppelde bestellingen) voor uw SQL- of BI-rapportage.
AVG en gegevens
- Er verlaat geen enkel gegeven uw server; er wordt geen enkele dienst van derden aangeroepen.
- De opvolgrecords worden automatisch opgeschoond na de ingestelde bewaartermijn.
- Kies bij het verwijderen “Alle gegevens van de applicatie wissen” om de tabel, het e-mailsjabloon en de configuratie te verwijderen, of behoud ze om de geschiedenis te bewaren.
Probleemoplossing
Er wordt geen enkele e-mail verzonden
- Controleer of de geplande taak draait:
bin/console scheduled-task:listmoetdf_cart_recovery.processmet de status scheduled tonen, en uw messenger-workers moeten actief zijn. - Test de algemene e-mailverzending van de shop (Instellingen → Mailagent): de plugin gebruikt de standaard maildienst.
- Controleer de minimale winkelwagenwaarde en de vertraging van herinnering 1: een winkelwagen die 20 minuten geleden is verlaten, komt met een vertraging van 60 minuten nog niet in aanmerking.
Gasten ontvangen niets
Dat is het verwachte gedrag: zonder e-mailadres is er geen herinnering mogelijk. Gasten worden gevolgd zodra ze zich identificeren (inloggen of een account aanmaken tijdens de checkout), want het samenvoegen van de winkelwagen werkt het record met hun adres bij.
De kortingscode verschijnt niet in de e-mail
- Controleer of de optie “Een unieke kortingscode toevoegen” actief is en of er een promotie is geselecteerd.
- De promotie moet bestaan, actief zijn en individuele codes geactiveerd hebben.
- De code wordt pas vanaf de ingestelde herinnering meegestuurd (standaard de tweede): herinnering 1 bevat er in de standaardconfiguratie geen.
De herstellink leidt naar de homepage
Het token is ongeldig of het record is opgeschoond (bewaartermijn overschreden), waarna de klant een bericht krijgt met de uitnodiging zijn winkelwagen opnieuw samen te stellen. Verhoog de bewaartermijn als uw herinneringsintervallen lang zijn.