Le suivi des conversions envoie des événements natifs Meta Pixel, TikTok Pixel et Google Tag Manager dataLayer depuis vos pages de campagne, formulaires de don et pages de reçu. Chaque événement transporte le contexte complet du don, y compris le montant, la devise, le nom de la campagne, le type de don et le mode de paiement, afin que vos plateformes publicitaires puissent optimiser les dépenses en fonction des résultats réels de la collecte de fonds.
Disponible avec Charitable Pro 1.8.13.5+ ou ultérieur sur les plans de licence Pro, Agency et Elite.
Fonctionnalités clés
- Déclencher les événements Meta Pixel
PurchaseetDonatepour chaque don confirmé - Déclencher les événements TikTok Pixel
CompletePaymentavec la valeur et la devise complètes du don - Pousser des données de don riches vers
window.dataLayerpour Google Tag Manager et GA4 - Suivre les vues de page de campagne et les ouvertures de formulaire de don comme événements de haut de tunnel
- Inclure le montant du don, la devise, le nom de la campagne, le type de don et le mode de paiement dans chaque conversion
- Respecter le consentement du visiteur via l'API WP Consent, avec un hook de filtre pour les gestionnaires de consentement personnalisés
- Empêcher les conversions en double lors des actualisations de la page de reçu en utilisant le suivi de session limité à l'onglet
- Examiner l'état du suivi pour chaque don dans l'administration WordPress
Pourquoi utiliser le suivi des conversions ?
Les organisations à but non lucratif qui diffusent des publicités payantes sur Meta, TikTok ou via Google Tag Manager ont besoin d'une attribution de conversion précise pour optimiser leurs dépenses publicitaires et prouver leur retour sur investissement. Les plugins de pixel génériques déclenchent des événements vides qui indiquent seulement à la plateforme publicitaire qu'une « conversion » a eu lieu. Le suivi des conversions de Charitable envoie le montant du don, la devise et le contexte de la campagne que les algorithmes Meta et TikTok utilisent réellement pour trouver plus de donateurs. Votre coût d'acquisition par donateur diminue. Vos campagnes apprennent plus vite.
Exigences
- Charitable Pro 1.8.13 ou ultérieur
- Un plan de licence Charitable Pro, Agency ou Elite
- WordPress 5.0 ou ultérieur
- PHP 7.2 ou ultérieur
- Facultatif : API WP Consent et un plugin de gestion du consentement compatible, si vous souhaitez que les pixels soient soumis au consentement du visiteur
Démarrage
Activation
- Téléchargez le module complémentaire Suivi des conversions depuis votre tableau de bord de compte Charitable.
- Dans WordPress, allez dans Plugins > Ajouter un nouveau > Téléverser un plugin et téléversez le fichier ZIP.
- Activez Charitable – Suivi des conversions.
- Allez dans Charitable > Réglages > Avancé > Suivi des conversions pour saisir vos identifiants de pixel.
Saisissez vos identifiants de pixel
Chaque plateforme a un seul champ d'identifiant. Laisser un champ vide désactive cette plateforme. Aucun interrupteur marche/arrêt séparé n'est nécessaire.
Utilisation
Le suivi des conversions s'exécute automatiquement une fois les identifiants de pixel saisis. Il n'y a pas de bloc ou de shortcode à placer. Le module complémentaire écoute trois moments sur votre site :
- Vue de page de campagne. Se déclenche lorsqu'un visiteur charge une page de campagne unique.
- Formulaire de don rendu. Se déclenche lorsqu'un formulaire de don est affiché sur n'importe quelle page.
- Don confirmé. Se déclenche sur la page de reçu après un don réussi, pour toutes les passerelles, y compris Stripe, PayPal, Square, Braintree, Mollie et Offline.
Options de configuration
Identifiants de plateforme
| Paramètre | Type | Défaut | Description |
|---|---|---|---|
meta_pixel_id | chaîne de caractères | vide | Votre ID Meta Pixel à 15 chiffres. Exemple : 123456789012345 |
tiktok_pixel_id | chaîne de caractères | vide | Votre ID TikTok Pixel. Exemple : CXXXXXXXXXXXXXXX |
gtm_container_id | chaîne de caractères | vide | Votre ID de conteneur GTM. Charitable pousse les événements dataLayer mais ne charge pas GTM lui-même. Installez GTM via votre thème ou un plugin séparé. Exemple : GTM-XXXXXXX |
Suivi du comportement
| Paramètre | Type | Défaut | Description |
|---|---|---|---|
pixel_track_campaign_views | case à cocher | activé | Déclencher les événements ViewContent et charitable_campaign_view lorsqu'un visiteur charge une page de campagne |
pixel_track_form_opens | case à cocher | activé | Déclencher les événements InitiateCheckout et charitable_initiate_checkout lorsqu'un formulaire de don est rendu |
pixel_consent_integration | case à cocher | activé | Vérifier wp_has_consent( 'marketing' ) avant de déclencher tout pixel |
Référence des événements
| Moment | Meta Pixel | TikTok Pixel | Événement dataLayer GTM |
|---|---|---|---|
| Vue de la page de campagne | ViewContent | ViewContent | charitable_campaign_view |
| Formulaire de don rendu | InitiateCheckout | InitiateCheckout | charitable_initiate_checkout |
| Don confirmé | Purchase et Donate | CompletePayment | charitable_donation_complete |
Charge utile dataLayer lors de la confirmation du don
window.dataLayer.push({
event: 'charitable_donation_complete',
donationId: 8937,
value: 28.87,
currency: 'USD',
campaignId: 7952,
campaignName: 'Clean Water for Rural Communities',
donationType: 'one-time',
paymentMethod: 'stripe'
});Personnalisation
Campagnes multiples dans un seul don
Lorsqu'un don couvre plusieurs campagnes, le suivi des conversions utilise la campagne avec le montant de don le plus élevé comme cible d'attribution. La valeur value totale est la somme sur toutes les campagnes. Utilisez le filtre charitable_pixel_primary_campaign pour remplacer cette sélection.
Statuts de don qui déclenchent des conversions
Par défaut, le suivi des conversions déclenche des pixels pour les dons avec les statuts charitable-completed, charitable-preapproved et charitable-pending. Utilisez le filtre charitable_pixel_fire_statuses pour ajouter ou supprimer des statuts.
Dépannage
Aucun événement pixel n'apparaît dans Meta Events Manager ou TikTok Events Manager
Vérifiez que le champ ID du pixel est renseigné pour cette plateforme et que votre visiteur a accordé son consentement marketing (ou que pixel_consent_integration est désactivé). Ouvrez l'onglet Réseau de vos outils de développement de navigateur sur la page de reçu et filtrez pour fbevents.js ou analytics.tiktok.com pour confirmer que la bibliothèque de pixels se charge.
Les événements dataLayer GTM se déclenchent mais les balises GTM ne se déclenchent pas
Charitable pousse les événements vers window.dataLayer mais n'installe pas le conteneur GTM lui-même. Installez GTM via l'en-tête de votre thème ou un plugin GTM dédié. Confirmez que l'ID du conteneur dans GTM correspond à l'ID saisi dans les paramètres du suivi des conversions.
Les événements de la page de reçu ne se déclenchent pas
Vérifiez le statut du don. Les dons hors ligne qui restent en charitable-pending sans être approuvés manuellement ne déclencheront pas de pixels. Confirmez également que le don est passé par la page de reçu plutôt que par une redirection de remerciement personnalisée, car le suivi des conversions repose sur le hook charitable_donation_receipt_page.
Conversion suivie deux fois lorsqu'un visiteur actualise la page de reçu
Le suivi des conversions utilise sessionStorage avec l'ID du don comme clé pour éviter les redéclenchements dans le même onglet de navigateur. L'ouverture de l'URL de reçu dans un nouvel onglet est considérée comme une nouvelle session et se déclenchera une fois, ce qui est le comportement attendu.
La bannière de licence inactive apparaît dans l'administration
Confirmez que Charitable Pro est installé et activé, que votre licence est sur le plan Pro, Agency ou Elite, et que la licence a été saisie et activée dans Charitable > Settings > Licenses. Les licences expirées ont une période de grâce de 30 jours avant que la livraison ne soit bloquée.
Ressources pour les développeurs
Accroches et filtres
charitable_pixel_fire_statuses— tableau des statuts de don qui permettent aux pixels de se déclenchercharitable_pixel_primary_campaign— remplace la campagne choisie pour les dons multi-campagnescharitable_pixel_consent_granted— vérification de consentement de secours lorsque l'API WP Consent est indisponiblecharitable_ajax_donation_response— ajouté au cœur de Charitable Pro ; permet aux extensions d'enrichir la réponse AJAX du don pour les futurs travaux de l'API Conversions
Clés méta de don
_charitable_pixel_tracking_status—tracked,consent_blocked,status_blocked,license_blocked, ounot_configured_charitable_pixel_tracked_at— Horodatage Unix de l'événement de suivi_charitable_pixel_platforms— tableau des plateformes qui ont déclenché, par ex.['meta', 'tiktok', 'gtm']_charitable_pixel_event_id— ID d'événement unique réservé pour la déduplication future de la Meta Conversions API
Intégration du consentement
Le suivi des conversions lit le consentement via l'API WP Consent lorsqu'elle est disponible :
if ( function_exists( 'wp_has_consent' ) ) {
return (bool) wp_has_consent( 'marketing' );
}
return (bool) apply_filters( 'charitable_pixel_consent_granted', true, 'marketing' );Les sites sans gestionnaire de consentement déclenchent les pixels par défaut. Les sites avec un plugin de consentement compatible (CookieYes, Complianz et autres qui implémentent l'API WP Consent) respectent automatiquement le consentement.
