Événement Remboursement
Lorsqu'une commande PrestaShop est remboursée, partiellement remboursée, retournée ou annulée, Pixel Plus peut envoyer un événement Meta personnalisé nommé Refund via l'API Conversions. Cela vous donne une visibilité sur les résultats post-achat dans Meta Events Manager et vous permet de créer des audiences d'exclusion et des conversions personnalisées basées sur les commandes remboursées.
Refundn'est PAS un événement standard Meta. Pixel Plus l'envoie comme événement personnalisé via CAPI.- La valeur est envoyée en nombre positif, pas négatif. L'API Conversions de Meta n'accepte pas les champs
valuenégatifs. - Meta ne réduit PAS automatiquement les événements Purchase précédents. L'envoi de Refund ne corrige pas rétroactivement le ROAS ni la « valeur des conversions d'achat » dans Ads Manager. Meta enregistre les événements ; il ne fonctionne pas comme un logiciel de comptabilité qui annule des transactions antérieures.
- À quoi ça sert vraiment : visibilité des remboursements dans Events Manager, audiences d'exclusion/suppression (ex. rembourseurs habituels), conversions personnalisées et reporting externe où vous combinez vos propres signaux Purchase et Refund.
Traitez le nom de l'événement comme le signal — c'est le cas d'utilisation supporté.
⚙️ Configuration
- Allez dans Modules > Gestionnaire de modules dans votre Back Office
- Trouvez Pixel Plus et cliquez sur Configurer
- Ouvrez le panneau Événements suivis et localisez la section Événement Remboursement / Annulation
- Activez Activer l'événement Remboursement (
FCTP_REFUND_ENABLED) - Choisissez Uniquement pour les commandes payées (
FCTP_REFUND_PAID_ONLY) — recommandé activé, pour que les annulations de commandes non payées ne déclenchent pas de faux remboursements - Sélectionnez les états de commande qui déclenchent l'événement Remboursement (
FCTP_REFUND_STATUS) — typiquement Remboursé, Annulé, Retourné - Cliquez sur Enregistrer
L'événement Remboursement est uniquement côté serveur (CAPI). Les remboursements se produisent dans le Back Office, après que le client a quitté le site, il n'y a donc pas de navigateur pour envoyer un événement pixel. Assurez-vous que CAPI est configuré avec un token d'accès valide — voir API Conversions (CAPI).
📦 Données envoyées
Pixel Plus envoie un événement personnalisé nommé Refund avec les données suivantes :
| Champ | Valeur |
|---|---|
| event_name | Refund (événement personnalisé) |
| value | Montant remboursé — nombre positif, dans la configuration de devise de la boutique |
| currency | Code ISO de la devise de la commande |
| content_type | product |
| content_ids | IDs des produits de la commande remboursée |
| contents | Tableau par article avec id, quantity, price |
| num_items | Nombre total d'articles dans la commande remboursée |
| order_id | ID de commande PrestaShop |
| order_reference | Référence de commande PrestaShop |
| event_id | ID aléatoire généré par le module |
Le nom de l'événement est le signal indiquant qu'il s'agit d'un remboursement. Le value positif est requis par l'API Meta — il n'indique pas une nouvelle vente.
🔄 Comment il se déclenche dans PrestaShop
L'événement Remboursement se déclenche via le hook actionOrderStatusPostUpdate de PrestaShop — c'est-à-dire quand le statut d'une commande change dans l'interface de gestion du Back Office. Pixel Plus vérifie :
- Le nouveau statut de commande est-il dans les statuts configurés pour déclencher l'événement Remboursement ?
- Si Uniquement pour les commandes payées est activé, la commande a-t-elle été préalablement validée/payée ?
Si les deux conditions sont remplies, le module construit le payload CAPI et l'envoie immédiatement. Cela fonctionne avec tous les flux de remboursement PrestaShop — remboursement standard, remboursement partiel, retour de produits, annulation de produits / annulation de commande — tant que le changement de statut résultant correspond à l'un de ceux que vous avez configurés.
📊 Ce que vous pouvez en faire
| Cas d'utilisation | Compatible ? | Notes |
|---|---|---|
| Voir le volume/valeur des remboursements dans Events Manager | ✅ | L'événement personnalisé fait apparaître des signaux de remboursement attribuables aux commandes du trafic Meta. |
| Créer des audiences d'exclusion (rembourseurs habituels, 30/60/180 derniers jours) | ✅ | Audiences basées sur l'événement Refund personnalisé, exclues des campagnes de remarketing. Selon votre posture légale/consentement. |
| Créer des conversions personnalisées basées sur Remboursement | ✅ | Meta supporte les conversions personnalisées sur tout événement personnalisé. Utile pour suivre le taux de remboursement du trafic attribué à Meta. |
| Reporting externe (revenus bruts vs remboursés) | ✅ | Si vous enregistrez Purchase + Refund localement, vous pouvez calculer le revenu net réel plus précisément qu'Ads Manager seul. |
| Corriger automatiquement le ROAS ou la valeur des achats dans Ads Manager | ❌ | Meta ne fait pas ça. L'événement Purchase original n'est pas réduit rétroactivement. |
| Annuler un événement Purchase précédemment envoyé | ❌ | Ce n'est pas ainsi que fonctionne l'attribution Meta. |
✅ Liste de vérification finale
- Confirmez que CAPI est activé et le Token d'accès configuré (guide API Conversions)
- Activez Activer l'événement Remboursement dans le panneau Événements suivis
- Sélectionnez les statuts de commande qui doivent le déclencher (Remboursé, Annulé, Retourné)
- Décidez si vous gardez Uniquement pour les commandes payées activé (recommandé)
- Test : remboursez/annulez une commande de test dans le Back Office et vérifiez dans Meta Events Manager → Test Events un événement
Refundentrant avec l'ID de commande original - (Optionnel) Créez une audience personnalisée ou une conversion personnalisée dans Meta Ads Manager basée sur l'événement
Refund
Est-ce que Refund est un événement standard Meta ?
Non. Pixel Plus l'envoie comme un événement personnalisé nommé Refund via l'API Conversions. Meta n'a pas d'événement standard pour les remboursements.
Pourquoi la valeur est-elle envoyée en nombre positif et pas négatif ?
L'API Conversions de Meta n'accepte pas les champs value négatifs, donc le module envoie le montant remboursé en nombre positif. Le nom de l'événement 'Refund' est le signal qui le distingue d'une vente, pas une valeur négative.
L'envoi d'événements Refund corrigera-t-il automatiquement mon ROAS dans Ads Manager ?
Non. Meta ne déduit pas rétroactivement les montants remboursés des événements Purchase précédents. Le ROAS et la valeur des conversions d'achat dans Ads Manager ne sont pas corrigés quand un événement Refund arrive. L'événement Refund est utile pour la visibilité des remboursements, les audiences d'exclusion et les conversions personnalisées — pas pour réconcilier automatiquement les revenus.
L'événement Remboursement nécessite-t-il CAPI activé ?
Oui. Les remboursements se produisent dans le Back Office PrestaShop après que le client a quitté le site, donc il n'y a pas de contexte navigateur pour envoyer un événement pixel. L'événement Remboursement est envoyé exclusivement côté serveur via l'API Conversions et nécessite un token d'accès valide.
Pixel Plus supporte-t-il les remboursements partiels et les retours ?
Oui. L'événement Remboursement se déclenche via actionOrderStatusPostUpdate quand une commande atteint un statut que vous avez configuré, quel que soit le flux de remboursement PrestaShop — remboursement standard, remboursement partiel, retour de produits, annulation de produits ou annulation de commande.
Quelle est la meilleure façon d'utiliser l'événement Remboursement dans Meta Ads Manager ?
Créez une audience personnalisée d'utilisateurs ayant déclenché l'événement Refund sur une période récente (par exemple les 30, 60 ou 180 derniers jours) et excluez-la de vos campagnes de remarketing et de réengagement. Vous pouvez aussi créer une conversion personnalisée basée sur l'événement Refund pour surveiller votre taux de remboursement depuis le trafic attribué à Meta.