Récupération des dons

La récupération des dons capture automatiquement l'intention des donateurs sur vos formulaires de collecte de fonds et envoie un e-mail de rappel personnalisé lorsqu'un don est laissé incomplet. Lorsqu'un donateur revient via le lien de récupération, son formulaire est pré-rempli afin qu'il puisse finaliser son don en quelques secondes.

Disponible dans Charitable Pro 1.8.13.5+.

Fonctionnalités clés

Suit silencieusement l'activité du donateur (e-mail, nom, montant) pendant que les donateurs remplissent les formulaires de don
Détecte automatiquement les sessions abandonnées à l'aide d'une tâche cron en arrière-plan
Envoie un e-mail de récupération HTML personnalisé avec un lien « Compléter mon don » en un clic
Pré-remplit le formulaire de don avec les détails précédemment saisis par le donateur lorsqu'il revient
Mécanisme de désinscription intégré à chaque e-mail de récupération
Contrôle de portée par campagne : choisissez exactement quelles campagnes participent
Onglet Rapports dédié avec statistiques filtrées par date, tableau des sessions et exportation CSV
Les statistiques de récupération apparaissent directement dans le bloc Aperçu des rapports

Pourquoi utiliser la récupération des dons ?

Même les donateurs motivés abandonnent les formulaires de don – une distraction, un temps de chargement lent de la page ou une interruption peuvent mettre fin à une session avant qu'elle ne se convertisse. La récupération des dons intercepte ces moments automatiquement et offre aux donateurs un moyen simple de finaliser leur don, sans aucune action manuelle de votre équipe.

Voyez-le en action

Exigences

Charitable Pro 1.8.13.1 ou version ultérieure
WordPress 6.2 ou ultérieure
PHP 7.2 ou ultérieur
WP-Cron activé (ou un déclencheur cron externe)

Démarrage

Activation

Dans votre administration WordPress, allez dans Charitable > Paramètres > Général.
Cliquez sur l'onglet Récupération des dons.
Cochez Activer la récupération des dons.
Sous Portée de la récupération des campagnes, sélectionnez les campagnes que vous souhaitez suivre. Aucune campagne n'est incluse par défaut.
Cliquez sur Enregistrer les paramètres.

La récupération est maintenant active pour les campagnes sélectionnées. Les sessions seront détectées et les e-mails planifiés automatiquement.

Options de configuration

Tous les paramètres se trouvent dans Charitable > Paramètres > Général > Récupération des dons.

Paramètres principaux

Paramètre	Type	Défaut	Description
Activer la récupération des dons	Case à cocher	Activé	Interrupteur principal marche/arrêt pour toute la fonctionnalité.
Délai d'abandon	Nombre (minutes)	60	Minutes d'inactivité avant qu'une session ne soit marquée comme abandonnée. Min : 15. Max : 1440 (24 heures).
Rétention des sessions	Nombre (jours)	90	Combien de jours les enregistrements de session sont conservés avant le nettoyage automatique. Min : 30. Max : 365.

Portée de la récupération des campagnes

Sélectionnez les campagnes qui participent à la récupération. La liste affiche toutes les campagnes publiées et non expirées, ainsi que le nombre total de sessions, le nombre de récupérations et le taux de récupération de chaque campagne. Une boîte de recherche et des boutons Tout sélectionner / Tout désélectionner aident à gérer les longues listes de campagnes.

Option	Description
Cases à cocher de campagne	Sélectionnez des campagnes individuelles pour activer le suivi de la récupération.
Inclure automatiquement les nouvelles campagnes	Lorsqu'elle est cochée, toute nouvelle campagne publiée est automatiquement ajoutée à la portée de récupération.

Remarque : les campagnes de pair-à-pair des ambassadeurs Charitable ne sont pas prises en charge et sont exclues de cette liste.

Expéditeur de l'e-mail de récupération

Paramètre	Type	Défaut	Description
Email de récupération : Nom d’expéditeur	Texte	Le nom de votre site	Le nom affiché dans le champ « De » des e-mails de récupération.
Email de récupération : Adresse d’expéditeur	E-mail	Adresse e-mail d’administration de WordPress	L’adresse e-mail utilisée comme expéditeur pour les e-mails de récupération.

Comment fonctionne le suivi

Lorsqu’un donateur visite une page de formulaire de don pour une campagne de récupération active, un léger script de suivi JavaScript se charge en arrière-plan. Il écoute les modifications apportées aux champs e-mail, prénom, nom et montant.

Lorsque le donateur saisit une adresse e-mail valide (au moment de la perte de focus), le suivi envoie les données capturées à un point de terminaison d’API REST à l’adresse /charitable-recovery/v1/capture. Le point de terminaison est authentifié par nonce et limité à 20 requêtes par minute par adresse IP. Aucune donnée n’est stockée tant qu’une adresse e-mail valide n’est pas présente.

Le suivi capture :

Adresse e-mail
Prénom et nom (si saisis)
Montant du don
Période de don (ponctuel ou récurrent, le cas échéant)
URL source (la page sur laquelle le donateur se trouvait lorsqu’il a rempli le formulaire)

Le suivi fonctionne sur les anciens formulaires de don et sur les formulaires Visual Form Builder (VFB).

Remarque : Le suivi est un fichier JavaScript qui se charge sur les pages de formulaire de don. Si un autre plugin ou votre thème produit une erreur JavaScript sur la même page, cela peut empêcher le suivi de s’initialiser. Cela entraînerait la non-capture de sessions, même lorsque les donateurs remplissent le formulaire. Consultez la section Dépannage pour connaître les étapes de diagnostic des conflits JavaScript.

Détection d’abandon

Une tâche WP-Cron s’exécute toutes les 5 minutes (charitable_recovery_detect_abandoned). À chaque exécution, elle identifie les sessions qui sont restées en statut « suivi » pendant plus longtemps que la période de délai d’abandon configurée et les marque comme abandonnées.

Les sessions sont automatiquement nettoyées après la période de rétention des sessions configurée.

À propos de WP-Cron

WordPress utilise un système de cron virtuel appelé WP-Cron. Contrairement à une tâche cron de serveur traditionnelle, WP-Cron ne se déclenche que lorsque quelqu’un visite votre site – il s’accroche aux chargements de page réguliers. Dans des conditions de trafic normales, cela fonctionne bien, mais il existe des situations où il peut être peu fiable :

Sites à faible trafic : Si votre site reçoit très peu de visiteurs, les tâches planifiées peuvent se déclencher beaucoup plus tard que prévu. Un e-mail de récupération programmé pour 1 heure après l’abandon pourrait ne pas être envoyé avant que le prochain visiteur ne charge une page.
DISABLE_WP_CRON défini sur true : Certains hôtes et plugins de performance définissent define( 'DISABLE_WP_CRON', true ); dans wp-config.php pour réduire la surcharge de chargement des pages. Si cela est défini sans un véritable cron de serveur pour le remplacer, la détection d’abandon et l’envoi d’e-mails s’arrêteront complètement.
Conflits de plugins : Certains plugins effacent incorrectement tous les événements planifiés lors de l’activation ou de la désactivation, ou ils peuvent empêcher l’enregistrement de nouveaux événements. Si cela se produit, l’événement charitable_recovery_detect_abandoned peut disparaître de la planification sans avertissement. Les e-mails de récupération cesseront d’être envoyés jusqu’à ce que le plugin soit désactivé et que le site soit réenregistré.
Limites des ressources d'hébergement mutualisé : Sur un hébergement mutualisé fortement sollicité, l'exécution de PHP peut être interrompue avant que les tâches cron n'aient fini de traiter un grand lot de sessions.

Si les e-mails de récupération sont retardés ou n'arrivent pas du tout, WP-Cron est la première chose à examiner. Consultez la section Dépannage ci-dessous pour connaître les étapes et les outils recommandés.

E-mails de récupération

Après qu'une session est marquée comme abandonnée, un e-mail de récupération est programmé pour être envoyé environ 1 heure plus tard via WP-Cron.

Contenu de l'e-mail

L'e-mail de récupération comprend :

Une salutation personnalisée utilisant le prénom du donateur (ou « Bonjour », si aucun nom n'a été capturé)
Le nom de la campagne à laquelle le donateur faisait un don
Un bouton d'appel à l'action vert « Compléter mon don »
Une URL de secours en texte brut
Un lien de désinscription dans le pied de page

Sécurité des e-mails

Les liens de récupération utilisent des jetons HMAC signés (SHA-256) qui expirent après 7 jours. Les jetons sont liés à la clé de session, à l'ID de l'e-mail et à l'horodatage d'expiration – ils ne peuvent pas être réutilisés pour différentes sessions. Si un jeton est expiré ou invalide, le donateur est redirigé vers la page d'accueil du site.

E-mails ignorés

Un e-mail n'est pas envoyé si :

L'adresse e-mail du donateur figure sur la liste de désinscription
La campagne s'est terminée avant l'envoi de l'e-mail
Un e-mail de récupération a déjà été envoyé pour cette session
La session a déjà été marquée comme récupérée, désinscrite ou expirée

Retour du donateur et pré-remplissage du formulaire

Lorsqu'un donateur clique sur le lien de récupération, il est redirigé vers la page où il a initialement commencé son don (en utilisant la source_url capturée). Son formulaire est automatiquement pré-rempli avec :

Adresse e-mail
Prénom et nom
Montant du don (correspondant à un bouton radio prédéfini, ou saisi dans le champ de montant personnalisé)

Le pré-remplissage s'exécute au chargement du DOM et à nouveau après 400 ms pour prendre en charge les formulaires rendus dynamiquement. Le pré-remplissage ne remplace jamais un champ dans lequel le donateur a déjà tapé.

Désinscription

Chaque e-mail de récupération comprend un lien de désinscription. Lorsqu'un donateur clique dessus, son adresse e-mail est ajoutée à une liste de suppression et aucun autre e-mail de récupération n'est envoyé à cette adresse depuis votre site.

Rapports et analyses

La récupération des dons dispose d'un onglet dédié dans Charitable > Rapports > Récupération des dons.

Tuiles de statistiques

Tuile	Description
Total suivi	Sessions où une adresse e-mail a été capturée.
Abandonné	Sessions qui ont dépassé le seuil d'abandon.
Récupéré	Sessions où le donateur a complété son don après avoir reçu un e-mail de récupération.
Taux de récupération	Dons récupérés en pourcentage des sessions abandonnées.
Revenus récupérés	Valeur totale des dons provenant des sessions récupérées.

Toutes les tuiles répondent au filtre de plage de dates en haut de la page.

Filtre de plage de dates

Utilisez les sélecteurs de dates pour filtrer toutes les statistiques et le tableau des sessions sur une plage personnalisée. Des préréglages de sélection rapide sont disponibles pour les 7 derniers jours, les 30 derniers jours et les 90 derniers jours.

Tableau des sessions

Affiche jusqu'à 50 sessions pour la plage de dates sélectionnée, triées par date de modification la plus récente. Chaque ligne affiche le nom du donateur, l'e-mail, la campagne, le montant, le badge de statut, le nombre d'e-mails et les horodatages.

Statuts des sessions :

– Suivi – session active, le donateur est toujours sur le formulaire

– Abandonné – la session a dépassé le seuil sans être complétée

– Récupéré – le donateur a complété son don

– Désinscrit – le donateur a cliqué sur le lien de désinscription

– Expiré – la session a été nettoyée par la politique de rétention

Export CSV

Cliquez sur Télécharger le CSV dans le tableau des sessions pour exporter toutes les sessions (sans limite de lignes) pour la plage de dates active. Le CSV inclut le prénom, le nom, l'e-mail, la campagne, le montant, la devise, le statut, les e-mails envoyés, l'ID du don, la date de création et la date de modification.

Indice de l'aperçu de récupération

L'onglet Aperçu des rapports affiche un indice de récupération juste en dessous de la tuile Dons totaux. L'indice indique le nombre de dons récupérés et les revenus récupérés pour la plage de dates actuelle de l'aperçu. Il se met à jour automatiquement lorsque vous modifiez le filtre de dates de l'aperçu.

Récupération par campagne

Sous le tableau des sessions, une ventilation par campagne montre le total des sessions, abandonnées, récupérées et les revenus pour chaque campagne dans la plage de dates.

Personnalisation du modèle

Le modèle d'e-mail HTML de récupération peut être remplacé dans votre thème :

your-theme/charitable/emails/recovery-immediate.php

Copiez l'original depuis wp-content/plugins/charitable-recovery/templates/emails/recovery-immediate.php vers le dossier de votre thème et modifiez-le selon vos besoins. Les variables suivantes sont disponibles dans le modèle :

Variable	Description
`$session`	L'objet de session (email, prénom, nom, montant, campaign_id, etc.)
`$recovery_url`	L'URL de récupération signée pour le bouton CTA
`$unsub_url`	L'URL de désinscription en un clic

Ressources pour les développeurs

Accroches et filtres

charitable_recovery_detect_abandoned — Crochet d'action WP-Cron ; s'exécute toutes les 5 minutes pour détecter les sessions abandonnées. Vous pouvez vous y accrocher pour exécuter une logique supplémentaire après la détection d'abandon.
charitable_recovery_send_email — Crochet d'action WP-Cron ; s'exécute une fois par e-mail de récupération planifié. Reçoit le $email_row_id comme premier argument.

Point d'accès REST

Le traqueur soumet les données à :

POST /wp-json/charitable-recovery/v1/capture

Nécessite un en-tête X-WP-Nonce valide. Limité à 20 requêtes par minute par adresse IP. Accepte application/json.

API des paramètres

Les paramètres de récupération sont stockés sous l'option charitable_settings dans le groupe general__recovery. Accédez-y via :

charitable_get_option( array( 'general__recovery', 'recovery_enabled' ), 1 );
charitable_get_option( array( 'general__recovery', 'abandonment_cutoff' ), 60 );
charitable_get_option( array( 'general__recovery', 'session_retention_days' ), 90 );
charitable_get_option( array( 'general__recovery', 'recovery_sender_name' ), get_bloginfo('name') );
charitable_get_option( array( 'general__recovery', 'recovery_sender_email' ), get_option('admin_email') );
charitable_get_option( array( 'general__recovery', 'recovery_campaign_ids' ), array() );
charitable_get_option( array( 'general__recovery', 'recovery_include_new_campaigns' ), 0 );

Dépannage

Les e-mails de récupération ne sont pas envoyés

La cause la plus fréquente est un problème WP-Cron. Suivez ces vérifications dans l'ordre :

Confirmez que WP-Cron n'est pas désactivé. Ouvrez wp-config.php et vérifiez si DISABLE_WP_CRON est défini. S'il est défini sur true, WP-Cron ne s'exécutera pas du tout, à moins que vous n'ayez configuré un véritable cronjob serveur pour le déclencher manuellement. Contactez votre hébergeur si vous n'êtes pas sûr de la manière de configurer un cron serveur pour WordPress.
Vérifiez un plugin conflictuel. Certains plugins de mise en cache, de performance et de sécurité interagissent avec WP-Cron de manière à effacer ou bloquer les événements planifiés. Si vous avez récemment activé ou désactivé un autre plugin et que les e-mails ont cessé d'être envoyés, ce plugin est un suspect probable. Essayez de le désactiver temporairement et vérifiez si les événements de récupération réapparaissent.
Inspectez directement les événements planifiés. Installez un plugin gratuit tel que WP Crontrol (disponible sur WordPress.org) pour afficher tous les événements planifiés. Une fois installé, allez dans Outils > Événements Cron et recherchez charitable_recovery_detect_abandoned. S'il est manquant, enregistrez la page des paramètres de récupération des dons une fois pour le réenregistrer. S'il disparaît après le réenregistrement, un plugin conflictuel est probablement en train de le supprimer.
Confirmez la portée de la campagne et le statut de désinscription. Vérifiez que la campagne concernée est sélectionnée sous Portée de la récupération de campagne et que l'adresse e-mail du donateur ne figure pas sur la liste de suppression.
Contactez votre hébergeur. Si WP-Cron semble fonctionner mais que les e-mails n'arrivent toujours pas, votre hébergeur peut bloquer les e-mails sortants de la fonction mail() de PHP. Demandez-leur s'ils nécessitent un plugin SMTP pour une livraison fiable des e-mails.

Si vous avez suivi toutes les étapes ci-dessus et que les e-mails ne sont toujours pas envoyés, contactez le support Charitable avec une description de ce que vous avez trouvé dans WP Crontrol.

Le formulaire de don n'est pas pré-rempli au retour

La source_url enregistrée lorsque le donateur a initialement rempli le formulaire est utilisée pour la redirection. Si le formulaire a été intégré sur une page dont l'URL a depuis changé, la cible de la redirection peut ne plus correspondre. Vérifiez que la campagne utilise le bon permalien et que le traqueur JavaScript du plugin de récupération s'est chargé sur la page du formulaire d'origine.

Un donateur continue de recevoir des e-mails après s'être désinscrit

La liste de suppression est stockée dans la table des options WordPress sous le nom charitable_recovery_unsubscribed_emails. Confirmez que l'entrée est présente avec la bonne casse. La comparaison est insensible à la casse, mais l'e-mail doit être stocké sans espaces avant ou après.

Aucune session n'est suivie (l'onglet Rapports affiche zéro activité)

Si l'onglet Rapports n'affiche aucune session suivie malgré la visite des pages de formulaire de don par les donateurs, le traqueur JavaScript peut ne pas fonctionner correctement.

Les causes les plus courantes sont :

Une erreur JavaScript provenant d'un autre plugin ou de votre thème. Si un script qui se charge avant le traqueur de récupération de dons lance une erreur non interceptée, cela peut bloquer tout le JavaScript suivant sur la page, y compris le traqueur. Ouvrez la console développeur de votre navigateur (F12 dans la plupart des navigateurs, puis cliquez sur l'onglet Console) sur une page de formulaire de don et recherchez les messages d'erreur rouges. Si vous voyez des erreurs faisant référence à un autre plugin ou à votre thème, désactivez-les un par un pour identifier la source.
Un plugin de minification ou de concaténation JavaScript. Certains plugins de mise en cache et d'optimisation (tels que Autoptimize, W3 Total Cache ou WP Rocket) combinent et minifient les fichiers JavaScript. Cela peut parfois introduire des erreurs de syntaxe ou des problèmes d'ordre de chargement qui cassent le traqueur. Essayez de désactiver temporairement l'optimisation JavaScript et testez à nouveau.
Un en-tête de politique de sécurité de contenu (CSP) bloquant l'appel à l'API REST. Certains plugins de sécurité ajoutent des en-têtes CSP stricts qui empêchent le JavaScript d'effectuer des appels fetch ou XMLHttpRequest vers votre propre site. Vérifiez la console du navigateur pour les erreurs liées au CSP.

Pour isoler le problème, basculez temporairement vers un thème WordPress par défaut (tel que Twenty Twenty-Four) et désactivez tous les plugins sauf Charitable et Donation Recovery. Si des sessions commencent à apparaître, réactivez vos autres plugins un par un pour identifier le conflit.

Si vous ne parvenez pas à résoudre le conflit vous-même, contactez le support Charitable en indiquant le nom du plugin conflictuel et tous les messages d'erreur de la console que vous avez trouvés.

Les statistiques montrent zéro revenu récupéré

Les revenus récupérés sont la somme de la colonne amount des sessions où le montant saisi par le donateur a été capturé avant qu'il n'abandonne. Si un donateur a sélectionné un montant après avoir cliqué sur le lien de récupération (sans que le montant ne soit dans l'URL pré-remplie), le amount dans l'enregistrement de la session peut être vide ou nul. Cela reflète l'intention capturée avant l'abandon, et non le montant final du don.

Questions fréquemment posées

Cela ralentira-t-il mes formulaires de don ?

Non. Le script de suivi est léger et s'exécute de manière asynchrone. Il ne bloque jamais le rendu ou la soumission du formulaire. Si l'appel à l'API REST échoue pour une raison quelconque (erreur réseau, limite de débit), il échoue silencieusement afin que l'expérience du donateur ne soit pas affectée.

Que se passe-t-il si WP-Cron cesse de fonctionner sur mon site ?

Les nouvelles sessions continueront d'être capturées (cette partie n'utilise pas cron), mais la détection des abandons et l'envoi d'e-mails s'arrêteront jusqu'à ce que cron soit restauré. Les sessions en attente seront traitées lors de la prochaine exécution réussie de cron. Installez WP Crontrol depuis WordPress.org pour surveiller vos événements planifiés et confirmer que cron fonctionne. Si les problèmes persistent, contactez votre hébergeur — il pourra vous indiquer si WP-Cron est bloqué et vous aider à configurer un vrai cron job au niveau du serveur en remplacement.

Un conflit de plugin peut-il casser la récupération de dons ?

Oui, de deux manières. Premièrement, un plugin qui interfère avec WP-Cron peut empêcher la détection des abandons et l'envoi d'e-mails (voir la section de dépannage de WP-Cron ci-dessus). Deuxièmement, un plugin ou un thème qui produit une erreur JavaScript sur la page de votre formulaire de don peut empêcher l'initialisation du suivi, ce qui signifie qu'aucune session n'est capturée. Si vous suspectez un conflit, utilisez la console développeur de votre navigateur pour rechercher les erreurs JavaScript, et essayez de désactiver les autres plugins un par un pour isoler la cause.

La récupération de dons fonctionne-t-elle avec Charitable Ambassadors (peer-to-peer) ?

Pas pour le moment. Les campagnes peer-to-peer gérées via Charitable Ambassadors sont exclues de la liste de portée de la récupération de campagne et ne sont pas prises en charge.

Les donateurs doivent-ils être connectés pour que la récupération fonctionne ?

Non. La récupération est entièrement basée sur l'e-mail. Tant que le donateur saisit une adresse e-mail valide dans le formulaire de don avant d'abandonner, une session est capturée et un e-mail de récupération peut être envoyé.

Puis-je personnaliser l'e-mail de récupération ?

Oui. Copiez le modèle depuis wp-content/plugins/charitable-recovery/templates/emails/recovery-immediate.php dans votre thème à l'emplacement charitable/emails/recovery-immediate.php et modifiez-le. Vous pouvez changer la mise en page, les couleurs, le texte et n'importe quel élément de l'e-mail tout en conservant les variables PHP requises ($recovery_url, $unsub_url, $session) intactes.

Combien de temps les liens de récupération sont-ils valides ?

Les liens de récupération expirent après 7 jours. Après expiration, cliquer sur le lien redirige le donateur vers la page d'accueil de votre site. Les jetons expirés sont enregistrés à des fins d'audit.

Ressources supplémentaires

[PLACEHOLDER: Lien vers la documentation de Charitable Reports]
[PLACEHOLDER: Lien vers la documentation des paramètres d'e-mail de Charitable]
WP Crontrol – plugin gratuit d'inspection de cron sur WordPress.org
[PLACEHOLDER: Lien vers la page de mise à niveau de Charitable Pro]
[PLACEHOLDER: Lien vers le support de Charitable]

Ambassadors 3.3.0 propose désormais des profils de créateurs, offrant à vos supporters un espace public permanent et partageable qui transforme les collecteurs de fonds ponctuels en relations durables.

👤 Pages publiques des créateurs : Donnez à chaque collecteur de fonds une page de destination instantanée et soignée sur /creator/leur-nom/ pour présenter leur avatar personnalisé, leur biographie et une grille consultable de leurs campagnes.

📊 Preuve d'impact : Renforcez la confiance des donateurs en affichant les jalons de l'ensemble du site sur le profil, tels que le montant total collecté et le nombre total de donateurs.

💳 Cartes interactives au survol : Lorsque les donateurs survolent le nom d'un créateur sur une page de campagne, une carte compacte s'affiche avec sa biographie et ses identifiants sociaux au moment de la décision.

📍 Partage responsable de la localisation : Permettez aux créateurs d'indiquer en toute sécurité où se trouvent leurs supporters locaux en utilisant uniquement les détails de la ville, de l'État et du pays.

🛠️ Personnalisation en libre-service : Les collecteurs de fonds peuvent mettre à jour leurs propres profils et lier jusqu'à six réseaux sociaux directement depuis le hub Mes campagnes, ce qui vous fait gagner du temps d'administration.

Prêt à responsabiliser vos défenseurs ? Mettez à jour vers Ambassadors 3.3.0 et activez "Activer la page publique du créateur" dès aujourd'hui !

Documentation Charitable

Ressources populaires