Evento Rimborso
Quando un ordine PrestaShop viene rimborsato, parzialmente rimborsato, restituito o annullato, Pixel Plus può inviare un evento Meta personalizzato chiamato Refund tramite la Conversions API. Questo ti dà visibilità sui risultati post-acquisto in Meta Events Manager e ti permette di creare audience di esclusione e conversioni personalizzate basate sugli ordini rimborsati.
RefundNON è un evento standard Meta. Pixel Plus lo invia come evento personalizzato via CAPI.- Il valore viene inviato come numero positivo, non negativo. La Conversion API di Meta non accetta campi
valuenegativi. - Meta NON riduce automaticamente gli eventi Purchase precedenti. L'invio di Refund non corregge retroattivamente il ROAS né il "valore delle conversioni acquisto" in Ads Manager. Meta registra gli eventi; non funziona come un software di contabilità che annulla transazioni precedenti.
- A cosa serve davvero: visibilità dei rimborsi in Events Manager, audience di esclusione/soppressione (es. rimborsatori abituali), conversioni personalizzate e reporting esterno dove combini i tuoi segnali Purchase e Refund.
Tratta il nome dell'evento come il segnale — questo è il caso d'uso supportato.
⚙️ Configurazione
- Vai su Moduli > Gestione moduli nel tuo Back Office
- Trova Pixel Plus e clicca su Configura
- Apri il pannello Eventi tracciabili e individua la sezione Evento Rimborso / Annullamento
- Abilita Abilita evento Rimborso (
FCTP_REFUND_ENABLED) - Scegli Solo per ordini pagati (
FCTP_REFUND_PAID_ONLY) — consigliato attivo, per evitare che le cancellazioni di ordini non pagati generino rimborsi falsi - Seleziona gli stati ordine che attivano l'evento Rimborso (
FCTP_REFUND_STATUS) — tipicamente Rimborsato, Annullato, Restituito - Clicca su Salva
L'evento Rimborso è solo lato server (CAPI). I rimborsi avvengono nel Back Office, dopo che il cliente ha lasciato il sito, quindi non c'è un browser dal quale inviare un evento pixel. Assicurati che CAPI sia configurato con un token di accesso valido — vedi Conversions API (CAPI).
📦 Dati inviati
Pixel Plus invia un evento personalizzato chiamato Refund con i seguenti dati:
| Campo | Valore |
|---|---|
| event_name | Refund (evento personalizzato) |
| value | Importo rimborsato — numero positivo, nella configurazione di valuta del negozio |
| currency | Codice ISO della valuta dell'ordine |
| content_type | product |
| content_ids | ID prodotti dell'ordine rimborsato |
| contents | Array per articolo con id, quantity, price |
| num_items | Totale articoli nell'ordine rimborsato |
| order_id | ID ordine PrestaShop |
| order_reference | Riferimento ordine PrestaShop |
| event_id | ID casuale generato dal modulo |
Il nome dell'evento è il segnale che indica un rimborso. Il value positivo è richiesto dall'API Meta — non indica una nuova vendita.
🔄 Come si attiva in PrestaShop
L'evento Rimborso si attiva tramite l'hook actionOrderStatusPostUpdate di PrestaShop — cioè quando lo stato di un ordine cambia nell'interfaccia di gestione del Back Office. Pixel Plus verifica:
- Il nuovo stato dell'ordine è tra gli stati configurati per attivare l'evento Rimborso?
- Se Solo per ordini pagati è attivo, l'ordine è stato precedentemente validato/pagato?
Se entrambe le condizioni sono soddisfatte, il modulo costruisce il payload CAPI e lo invia immediatamente. Funziona con tutti i flussi di rimborso PrestaShop — rimborso standard, rimborso parziale, restituzione prodotti, annullamento prodotti / annullamento ordine — purché il cambio di stato risultante corrisponda a uno di quelli configurati.
📊 Come puoi utilizzarlo
| Caso d'uso | Supportato? | Note |
|---|---|---|
| Vedere volume/valore rimborsi in Events Manager | ✅ | L'evento personalizzato mostra segnali di rimborso attribuibili agli ordini da traffico Meta. |
| Creare audience di esclusione (rimborsatori abituali, ultimi 30/60/180 giorni) | ✅ | Audience basate sull'evento Refund personalizzato, escluse dalle campagne di remarketing. Soggetto alla tua posizione legale/consenso. |
| Creare conversioni personalizzate basate su Rimborso | ✅ | Meta supporta conversioni personalizzate su qualsiasi evento personalizzato. Utile per monitorare il tasso di rimborso dal traffico attribuito a Meta. |
| Reporting esterno (ricavi lordi vs rimborsati) | ✅ | Se registri Purchase + Refund localmente, puoi calcolare il ricavo netto reale più accuratamente di Ads Manager da solo. |
| Correggere automaticamente il ROAS o il valore acquisti in Ads Manager | ❌ | Meta non fa questo. L'evento Purchase originale non viene ridotto retroattivamente. |
| Annullare un evento Purchase precedentemente inviato | ❌ | Non è così che funziona l'attribuzione Meta. |
✅ Lista di controllo finale
- Conferma che CAPI è attivo e il Token di Accesso configurato (guida Conversions API)
- Abilita Abilita evento Rimborso nel pannello Eventi tracciabili
- Seleziona gli stati ordine che devono attivarlo (Rimborsato, Annullato, Restituito)
- Decidi se mantenere Solo per ordini pagati attivo (consigliato)
- Test: rimborsa/annulla un ordine di test nel Back Office e controlla Meta Events Manager → Test Events per un evento
Refundin arrivo con l'ID ordine originale - (Opzionale) Crea un'audience personalizzata o una conversione personalizzata in Meta Ads Manager basata sull'evento
Refund
Refund è un evento standard Meta?
No. Pixel Plus lo invia come evento personalizzato chiamato Refund tramite la Conversions API. Meta non ha un evento standard per i rimborsi.
Perché il valore viene inviato come numero positivo e non negativo?
La Conversion API di Meta non accetta campi value negativi, quindi il modulo invia l'importo rimborsato come numero positivo. Il nome dell'evento 'Refund' è il segnale che lo distingue da una vendita, non un valore negativo.
Inviare eventi Refund correggerà automaticamente il mio ROAS in Ads Manager?
No. Meta non deduce retroattivamente gli importi rimborsati dagli eventi Purchase precedenti. Il ROAS e il valore delle conversioni acquisto in Ads Manager non vengono corretti quando arriva un evento Refund. L'evento Refund è utile per la visibilità dei rimborsi, le audience di esclusione e le conversioni personalizzate — non per riconciliare automaticamente i ricavi.
L'evento Rimborso richiede CAPI attivo?
Sì. I rimborsi avvengono nel Back Office PrestaShop dopo che il cliente ha lasciato il sito, quindi non c'è contesto browser per inviare un evento pixel. L'evento Rimborso viene inviato esclusivamente lato server tramite la Conversion API e richiede un token di accesso valido.
Pixel Plus supporta rimborsi parziali e resi?
Sì. L'evento Rimborso si attiva tramite actionOrderStatusPostUpdate quando un ordine raggiunge uno stato che hai configurato, indipendentemente dal flusso di rimborso PrestaShop — rimborso standard, rimborso parziale, restituzione prodotti, annullamento prodotti o annullamento ordine.
Qual è il modo migliore per usare l'evento Rimborso in Meta Ads Manager?
Crea un'audience personalizzata di utenti che hanno attivato l'evento Refund in un periodo recente (ad esempio gli ultimi 30, 60 o 180 giorni) ed escludila dalle tue campagne di remarketing e riattivazione. Puoi anche creare una conversione personalizzata basata sull'evento Refund per monitorare il tasso di rimborso dal traffico attribuito a Meta.