Code promo anniversaire client : documentation du module PrestaShop

Présentation

Le module envoie automatiquement un code de réduction personnel à vos clients pour trois occasions : leur anniversaire, la date anniversaire de leur première commande valide et la date anniversaire de création de leur compte. Chaque code est une règle panier native PrestaShop, réservée au client et utilisable une fois. Le module mesure ensuite le chiffre d’affaires des commandes passées avec ces codes.

Compatibilité : PrestaShop 8.0 à 9.x, multiboutique, 8 langues (anglais, français, espagnol, allemand, italien, néerlandais, polonais, portugais).

Installation

1. Dans Modules > Gestionnaire de modules, cliquez sur Installer un module et envoyez le fichier ZIP.
2. Le module crée deux tables, enregistre ses hooks, génère le jeton de la tâche planifiée et copie les modèles d’e-mails pour chaque langue installée.
3. Un nouvel onglet Anniversaires et dates clés apparaît dans le menu Clients. Le bouton Configurer du module y mène aussi.

Pour passer de la 1.0.0 à la 1.1.0, envoyez simplement le nouveau ZIP : le script de mise à jour enregistre les nouveaux hooks.

Configurer les campagnes

L’onglet Campagnes contient une carte par occasion. Activez-la avec l’interrupteur en haut à droite : les réglages et l’aperçu de l’e-mail s’affichent.

L’offre

• Type de réduction : pourcentage, montant fixe (dans la devise par défaut) ou livraison gratuite.
• Valeur et Offrir aussi la livraison gratuite en complément d’un pourcentage ou d’un montant.
• Commande minimum (TTC) : 0 pour aucun minimum.
• Validité après la date : durée de validité du code en jours, à partir de la date de l’occasion.
• Envoyer à l’avance : nombre de jours avant la date. 0 envoie le jour même.
• Hausse par année supplémentaire et Valeur maximum (anniversaire de commande et de compte) : par exemple 10 % la première année, +2 par année, plafonné à 20 %.
• Exclure les produits déjà en promotion et Cumulable avec d’autres bons de réduction.

Qui le reçoit

• Nombre minimum de commandes valides : 0 pour l’anniversaire permet d’inclure les clients qui n’ont jamais commandé.
• Préfixe du code : par exemple BDAY donne des codes du type BDAY-7KQ2M9.
• Groupes de clients : aucun coché signifie tous les groupes.

L’e-mail

Modifiez l’objet, le titre et le message pour chaque langue grâce aux onglets de langue. L’aperçu à droite se met à jour en direct avec la remise réelle. Balises disponibles : {firstname}, {lastname}, {discount}, {code}, {expiry_date}, {min_amount}, {years} (hors anniversaire) et {shop_name}. Un champ laissé vide reprend le texte par défaut de la langue.

Le bouton Enregistrer et envoyer un test envoie l’e-mail à l’adresse de l’employé connecté, dans sa langue.

Planifier l’envoi quotidien

Dans Automatisation et réglages, copiez l’URL de la tâche planifiée et appelez-la une fois par jour, idéalement tôt le matin. Exemple de ligne cron :

0 7 * * * curl -s "https://votre-boutique.com/module/dfkeydates/cron?token=VOTRE_JETON" >/dev/null

Chaque exécution crée les codes du jour, envoie les e-mails et les relances, rattache les codes utilisés à leur commande et supprime les codes expirés non utilisés.

• Rattrapage des jours manqués (2 par défaut) : si la tâche n’a pas tourné, les dates des jours précédents sont traitées.
• Codes maximum par exécution (200 par défaut) : le reste est envoyé à l’exécution suivante.
• Exécuter aussi lors des visites : sans cron, le module s’exécute sur les visites de la boutique, au plus une fois par heure, après l’envoi de la page. Il s’arrête dès qu’un vrai cron a été appelé dans les 26 dernières heures.

Les boutons Simuler aujourd’hui (liste des codes qui partiraient, sans rien envoyer), Exécuter maintenant, Resynchroniser les codes utilisés et Nouveau jeton sont disponibles sur la même page.

Anti-abus et collecte des dates de naissance

Le délai après inscription ou modification de l’anniversaire (30 jours par défaut) bloque l’envoi d’un code d’anniversaire à un compte trop récent ou dont la date vient d’être saisie ou modifiée en boutique. Les modifications faites par un employé en back-office ne déclenchent pas ce délai.

Les dates de naissance viennent du champ natif du compte client (Clients > Paramètres > Date de naissance). Si ce champ est désactivé, le module les collecte lui-même :

• sur la page de confirmation de commande, quand la date est inconnue (option Demander la date de naissance sur la page de confirmation de commande) ;
• dans la page Mes cadeaux et dates clés du compte client.

Le tableau de bord affiche le pourcentage de comptes dont la date est connue.

Relance avant expiration

Activez la relance et choisissez combien de jours avant l’expiration elle part. Elle n’est envoyée que si le code n’a pas été utilisé. Les textes de la relance et le texte du bouton de tous les e-mails se règlent par langue. Le bouton Envoyer une relance de test enregistre les réglages et vous envoie un exemple.

Le code appliqué en un clic

Le bouton de chaque e-mail pointe vers un lien signé propre au code. Le module mémorise le code et l’ajoute au panier dès que le client est connecté et que son panier contient des produits. Si le client n’est pas connecté, il est dirigé vers la page de connexion. Si le minimum de commande n’est pas atteint, le code reste en attente et s’applique dès qu’il l’est. Un code expiré, déjà utilisé ou destiné à un autre client est refusé avec un message.

La page client « Mes cadeaux et dates clés »

Accessible depuis Mon compte, elle affiche les codes actifs avec un bouton de copie et un bouton L’utiliser dans mon panier, les prochaines dates clés du client, le formulaire de date de naissance, les cadeaux précédents et une case pour ne plus recevoir ces e-mails. Vous pouvez masquer cette page dans les réglages.

Statistiques et suivi du chiffre d’affaires

L’onglet Tableau de bord présente, sur la période choisie :

• le CA généré HT et TTC, calculé sur les commandes valides ayant utilisé un code, converti dans la devise par défaut ;
• les codes envoyés et utilisés, le taux de conversion et le panier moyen ;
• la remise accordée et le retour (CA divisé par la remise) ;
• les commandes sans le code passées pendant la validité d’un code ;
• une courbe sur 12 mois, la performance par occasion, les envois des 30 prochains jours et les dernières commandes avec un code.

Le CA est rattaché à la période d’envoi du code. L’onglet Codes envoyés liste tous les codes avec recherche, filtres par occasion, statut et date, renvoi de l’e-mail pour un code actif et export CSV. La fiche client du back-office affiche aussi les codes envoyés à ce client.

Nettoyage des codes expirés

Le réglage Supprimer les codes expirés non utilisés après (30 jours par défaut) supprime les règles panier correspondantes pour garder Catalogue > Réductions lisible. L’historique et les statistiques du module sont conservés. Mettez 0 pour ne jamais supprimer.

RGPD

Le module se déclare auprès du module RGPD officiel de PrestaShop. L’export des données d’un client inclut ses codes et ses préférences, la suppression efface l’historique du module pour ce client. Chaque client peut se désinscrire de ces e-mails depuis son compte.

Multiboutique

Les campagnes et les réglages sont propres à chaque boutique. Sélectionnez une boutique dans le menu multiboutique pour les modifier. Les codes créés sont limités à la boutique concernée.

Questions fréquentes et dépannage

Aucun code n’est envoyé

Vérifiez qu’au moins une campagne est activée, puis utilisez Simuler aujourd’hui. Si la liste est vide, aucun client ne correspond aux critères du jour : date inconnue, délai anti-abus en cours, groupe non ciblé, nombre de commandes insuffisant ou client désinscrit.

Les e-mails n’arrivent pas

Envoyez un e-mail de test depuis une campagne. S’il n’arrive pas, vérifiez la configuration e-mail de PrestaShop dans Paramètres avancés > E-mail. Un code dont l’e-mail a échoué est signalé dans la liste des codes et peut être renvoyé.

Une commande n’apparaît pas dans les statistiques

Seules les commandes valides sont comptées. Si une commande a été créée en back-office par un employé sans droit sur le module, cliquez sur Resynchroniser les codes utilisés ; la tâche quotidienne le fait aussi automatiquement.