Impostazioni Avanzate dell'Evento Purchase
L'evento Purchase è il segnale più prezioso che puoi inviare a Meta — dice a Facebook quali visitatori hanno effettivamente acquistato qualcosa e per quale valore. Pixel Plus ti dà un controllo preciso su quando questo evento si attiva: solo per gli ordini pagati, dopo la conferma di un bonifico bancario, o anche dal back office giorni dopo che il cliente ha effettuato l'ordine. Questa guida spiega ogni impostazione e come funzionano insieme.
⚙️ Configurazione consigliata per il tracciamento solo degli ordini pagati
Se il tuo obiettivo è inviare eventi Purchase solo per gli ordini pagati o confermati, usa questa configurazione:
- Abilita Traccia solo ordini validati (
FCTP_PURCHASE_VALID_ONLY) - Aggiungi gli stati chiaramente non validi agli Stati ordine da escludere (
FCTP_ORDER_STATUS_EXCLUDE) — ad esempio, Errore di pagamento e Annullato - Imposta un Limite di validazione per ordini non validati di 7 giorni (
FCTP_ORDER_DELAY_LIMIT_DAYS) — il valore predefinito va bene - Abilita Usa cookie per prevenire duplicati di conversione (
FCTP_COOKIE_CONTROL) - Lascia Forza modalità base evento Purchase deselezionato per tutti i moduli di pagamento, a meno che un metodo specifico non venga tracciato correttamente
Con questa configurazione, Pixel Plus traccia solo gli ordini che raggiungono uno stato pagato o validato, e ignora gli ordini in attesa, falliti o incompleti.
🔄 Come funziona il tracciamento degli ordini
Pixel Plus prepara l'evento Purchase durante il hook actionValidateOrder di PrestaShop — il momento in cui viene creato un ordine. Quello che succede dopo dipende dalle tue impostazioni:
| Impostazione | Chiave | Predefinito |
|---|---|---|
| Traccia solo ordini validati | FCTP_PURCHASE_VALID_ONLY | Disabilitato |
| Stati ordine da escludere | FCTP_ORDER_STATUS_EXCLUDE | Nessuno |
| Limite di validazione per ordini non validati | FCTP_ORDER_DELAY_LIMIT_DAYS | 7 giorni |
| Forza modalità base (per modulo di pagamento) | FCTP_FORCE_BASIC_MODE_LIST | Nessuno |
| Usa cookie per prevenire duplicati | FCTP_COOKIE_CONTROL | Disabilitato |
Non tutti i metodi di pagamento funzionano allo stesso modo. I pagamenti con carta validano l'ordine immediatamente; i bonifici bancari creano prima l'ordine e confermano il pagamento dopo. Queste impostazioni ti permettono di gestire entrambi correttamente.
✅ Traccia solo ordini validati
Chiave di configurazione: FCTP_PURCHASE_VALID_ONLY
Questa impostazione controlla se Pixel Plus attende che un ordine sia confermato prima di inviare l'evento Purchase.
"Validato" significa che il flag interno logable di PrestaShop sullo stato dell'ordine è true. Stati come "Pagamento accettato" sono logable; stati come "In attesa di bonifico bancario" non lo sono.
Quando abilitato: Solo gli ordini il cui stato iniziale è logable vengono tracciati immediatamente. Gli ordini non logable vengono salvati in una lista di attesa con il contesto browser del cliente (IP, user agent, _fbp, _fbc, URL). Quando il commerciante cambia l'ordine in uno stato logable, Pixel Plus invia l'evento Purchase tramite CAPI usando il contesto salvato.
Quando disabilitato: Tutti gli ordini vengono tracciati immediatamente, eccetto quelli nella lista degli stati esclusi.
⏳ Metodi di pagamento differito
Bonifico bancario, assegno, pagamento alla consegna e alcuni moduli di pagamento personalizzati creano un ordine prima che il pagamento sia confermato.
Quando Traccia solo ordini validati è abilitato e viene usato uno di questi metodi, l'ordine non viene tracciato immediatamente. Pixel Plus lo salva in una lista di attesa (FCTP_ORDER_DELAYED_LIST). Quando il commerciante segna l'ordine come pagato, si attiva il hook actionOrderStatusPostUpdate e Pixel Plus invia l'evento Purchase tramite CAPI usando il contesto browser salvato.
Quando un ordine viene validato dal back office, può essere inviato solo l'evento dell'API Conversioni — il Pixel browser richiede che il browser del cliente sia sulla pagina. Pixel Plus inietta il contesto browser salvato nella richiesta CAPI in modo che l'evento venga attribuito correttamente.
📅 Limite di validazione per ordini non validati
Chiave di configurazione: FCTP_ORDER_DELAY_LIMIT_DAYS · Predefinito: 7 giorni
Pixel Plus mantiene gli eventi Purchase in sospeso per un tempo limitato. Se un ordine viene validato dopo questo limite, l'entry in sospeso viene eliminata e viene registrato un avviso: "L'ordine X non verrà inviato tramite il pixel perché è stato superato il numero massimo di giorni (7)."
Esempio: Un cliente effettua un ordine con bonifico lunedì. Giovedì il commerciante conferma il pagamento. Pixel Plus trova l'ordine nella lista di attesa, verifica che sia entro il limite di 7 giorni, e invia l'evento Purchase tramite CAPI.
🚫 Stati ordine da escludere
Chiave di configurazione: FCTP_ORDER_STATUS_EXCLUDE
Blocca stati ordine specifici impedendo che generino un evento Purchase, indipendentemente dall'impostazione di validazione.
Stati consigliati da aggiungere:
- Errore di pagamento
- Annullato
- Pagamento fallito
- Rimborsato (se non vuoi che i rimborsi contino come acquisti)
🔧 Forza modalità base evento Purchase
Chiave di configurazione: FCTP_FORCE_BASIC_MODE_LIST (per modulo di pagamento)
Per impostazione predefinita, Pixel Plus attiva l'evento Purchase durante actionValidateOrder — la creazione server-side dell'ordine. Questo è l'approccio più affidabile.
La modalità base è un'alternativa per i moduli di pagamento che usano un flusso checkout non standard. Quando è abilitata per un modulo di pagamento specifico:
- Durante
actionValidateOrder: se l'URL corrente non è la pagina di conferma ordine, il hook non fa nulla - Durante
displayOrderConfirmation: Pixel Plus attiva l'evento Purchase del Pixel browser quando il cliente arriva sulla pagina di conferma
Usa la modalità base solo quando un metodo di pagamento non viene tracciato correttamente con la logica standard di Pixel Plus. Quando la abiliti per un modulo, abilita anche Usa cookie per prevenire duplicati di conversione — altrimenti un ricaricamento della pagina può attivare un evento Purchase duplicato.
🍪 Usa cookie per prevenire duplicati di conversione
Chiave di configurazione: FCTP_COOKIE_CONTROL
Aggiunge una verifica lato browser prima di attivare l'evento Purchase. Pixel Plus imposta un cookie chiamato pp_purchaseSent con l'ID ordine come valore. Se quel cookie esiste già per l'ordine corrente, l'evento non viene inviato di nuovo.
Questo protegge dagli eventi Purchase duplicati del Pixel browser quando:
- La pagina di conferma ordine viene ricaricata
- La modalità base è abilitata per un modulo di pagamento
- Un layer di cache serve incorrettamente la pagina di conferma dalla cache
Cloudflare generalmente non memorizza nella cache le pagine PHP dinamiche. La protezione anti-duplicati tramite cookie può comunque essere abilitata come precauzione aggiuntiva.
💡 Esempi
Pagamento con carta (flusso standard)
Il cliente paga con carta. L'ordine viene creato e raggiunge immediatamente uno stato logable (pagato). Pixel Plus attiva l'evento Purchase CAPI immediatamente e mette in coda l'evento Pixel browser per la pagina di conferma.
Bonifico bancario con "Traccia solo ordini validati" abilitato
Il cliente sceglie il bonifico. L'ordine viene creato come "In attesa di bonifico bancario" (non logable). Pixel Plus salva l'ordine in FCTP_ORDER_DELAYED_LIST con il contesto browser del cliente. Tre giorni dopo il commerciante conferma il pagamento e Pixel Plus invia l'evento Purchase via CAPI.
Errore di pagamento
Il cliente tenta di pagare ma il pagamento fallisce. L'ordine riceve lo stato "Errore di pagamento". Se questo stato è nella lista di esclusione (o se il tracciamento solo validati è abilitato), non viene inviato alcun evento Purchase.
'Traccia solo ordini validati' significa che vengono inviati solo gli ordini pagati?
Sì. Pixel Plus usa il flag logable di PrestaShop sugli stati ordine per determinare se un ordine è confermato. Assicurati che i tuoi stati ordine siano configurati correttamente — gli stati che consideri pagati devono avere logable = true in PrestaShop.
Gli ordini non pagati possono ancora essere tracciati?
Sì, in due casi: se 'Traccia solo ordini validati' è disabilitato e lo stato dell'ordine non è nella lista di esclusione, oppure se un ordine differito (bonifico, ecc.) viene successivamente validato dal commerciante entro il limite di tempo consentito.
Devo escludere manualmente gli stati non pagati?
Se 'Traccia solo ordini validati' è abilitato, gli stati non logable sono già bloccati. Escludere stati chiaramente non validi come Errore di pagamento o Annullato è comunque utile come livello di sicurezza aggiuntivo. Se il tracciamento solo validati è disabilitato, devi escludere manualmente ogni stato che non vuoi tracciare.
Devo abilitare la protezione anti-duplicati tramite cookie?
Sì, nella maggior parte dei casi. È particolarmente consigliata quando la modalità base è abilitata per qualsiasi modulo di pagamento. Aggiunge un livello secondario contro gli eventi Pixel browser duplicati senza alcuno svantaggio.
Quando devo abilitare la modalità base per un modulo di pagamento?
Solo quando quel modulo di pagamento non viene tracciato correttamente con la logica standard di Pixel Plus. Se la abiliti, abilita anche Usa cookie per prevenire duplicati di conversione.
Cosa succede se un ordine differito non viene validato entro il limite di tempo?
Pixel Plus elimina l'entry in sospeso e registra un avviso nel sistema di log di PrestaShop. Non viene inviato alcun evento Purchase per quell'ordine.
✅ Lista di Controllo Finale
- Decidi se tracciare solo gli ordini validati o tutti gli ordini — abilita
FCTP_PURCHASE_VALID_ONLYdi conseguenza - Aggiungi gli stati non validi (Errore di pagamento, Annullato, Rimborsato) agli Stati ordine da escludere
- Imposta il limite di validazione in base alla tua finestra abituale di conferma pagamento (7 giorni predefinito)
- Abilita Usa cookie per prevenire duplicati di conversione (
FCTP_COOKIE_CONTROL) - Lascia Forza modalità base deselezionato a meno che un modulo di pagamento specifico non venga tracciato correttamente
- Se abiliti la modalità base per qualsiasi modulo di pagamento, abilita anche la protezione anti-duplicati tramite cookie