Passa al contenuto principale

Opzioni Avanzate

Ottimizza come viene caricato il pixel, gestisci moduli di pagamento non standard, escludi clienti od ordini specifici dal tracciamento e configura selettori personalizzati per i temi che si discostano dal layout standard di PrestaShop.

note

Disponibile dalla v2.0

Panoramica​

Il pannello Opzioni Avanzate copre casi limite e requisiti di compatibilità che non riguardano la maggior parte dei negozi. Se il tuo pixel sta tracciando correttamente e i tuoi eventi Purchase sono accurati, puoi lasciare tutto qui ai valori predefiniti.

Avrai bisogno di questo pannello quando:

  • Il tuo tema non include l'hook footer standard di PrestaShop, quindi il pixel non si attiva mai
  • Gli ordini di un modulo di pagamento specifico non vengono tracciati perché usa un flusso non standard
  • Ordini dello staff, ordini di rivenditori o acquisti di test interni compaiono nelle statistiche delle tue campagne Meta
  • Il tuo CDN o la cache del server sta servendo una versione obsoleta dello script del pixel
  • Il tuo tema usa un pulsante personalizzato per Aggiungi al Carrello, o un modulo di checkout non standard

Il pannello è diviso in diverse sezioni: Ottimizzazione Caricamento Pixel, Opzioni di Conversione, Evento Rimborso/Cancellazione, Filtro Clienti, Opzioni di Visualizzazione, Opzioni di Registrazione, Opzioni PageView, Rilevamento Inizio Checkout, Prevenzione Cache e Selettori Personalizzati. Ogni sezione è descritta di seguito.

Configurazione​

Ottimizzazione Caricamento Pixel​

Queste impostazioni controllano dove e quando lo script del pixel viene inserito nelle pagine del tuo negozio.

CampoPredefinitoDescrizione
Forza Pixel nell'HeaderDisabilitatoCarica il pixel nell'<head> invece che nel footer. Abilita solo quando il tuo tema non include l'hook footer di PrestaShop. L'approccio footer è preferibile perché evita di bloccare il rendering della pagina.
Caricamento differitoDisabilitatoRitarda l'inizializzazione del pixel fino a dopo il completamento del caricamento della pagina. Può ridurre il tempo di caricamento percepito su connessioni lente, ma qualsiasi azione del cliente che avviene prima della fine del ritardo non verrà tracciata.
Secondi di differimento0Secondi da attendere dopo il caricamento completo della pagina prima che il pixel si inizializzi. Valore consigliato: 2–3 secondi quando il caricamento differito è attivo. Solo numeri interi.
Differisci solo la prima voltaAbilitatoApplica il caricamento differito solo alla prima pagina di una sessione. Nelle pagine successive, lo script del pixel è già nella cache del browser e si carica istantaneamente, quindi il differimento non è necessario. Lascia questo abilitato ogni volta che il caricamento differito è attivo.

Forza Pixel nell'Header e Caricamento differito affrontano problemi diversi. Se abiliti entrambi, il pixel si attiva immediatamente dall'header — il differimento non ha effetto. Scegli un approccio in base alla tua situazione.

Opzioni di Conversione​

Queste impostazioni controllano come vengono attivati e convalidati gli eventi Purchase.

CampoPredefinitoDescrizione
Escludi ordini da Back OfficeAbilitatoGli ordini creati dal Back Office (dallo staff) non attivano un evento Purchase. Mantieni questo abilitato a meno che tu non voglia specificamente tracciare gli ordini dello staff.
Usa Ajax per confermare l'invio della conversioneAbilitatoIl browser convalida la disponibilità del pixel tramite AJAX prima di attivare l'evento Purchase. Questo previene eventi mancati per i metodi di pagamento che reindirizzano il cliente fuori dalla pagina di conferma standard. Consigliato — lascia abilitato.
Usa Cookie per prevenire i duplicati di conversioneDisabilitatoImpedisce che l'evento Purchase si attivi una seconda volta per lo stesso ordine se la pagina di conferma viene ricaricata o servita dalla cache. Abilita questa opzione se noti conversioni duplicate causate da un modulo di caching o da Cloudflare.
Forza la modalità Base dell'evento Purchase perNessunoCaselle di controllo per singolo modulo di pagamento. La modalità Base forza l'evento Purchase ad attivarsi quando il cliente visita la pagina di conferma dell'ordine, bypassando il flusso di rilevamento standard. Richiesto per i moduli di pagamento che usano flussi di conferma ordine non standard. Abilita solo per i metodi di pagamento specifici che ne hanno bisogno. Nota: la modalità base non previene da sola i duplicati — abilita anche la modalità cookie se si verificano duplicati.
Ricarica dopo l'ordine?DisabilitatoForza un ricaricamento della pagina una tantum dopo il caricamento della pagina di conferma ordine. Per un piccolo numero di moduli di pagamento che mostrano la conferma prima che l'ordine sia completamente convalidato in PrestaShop. Solitamente non necessario.
Escludi la spedizione dal totale dell'ordineDisabilitatoRiporta il totale dell'ordine senza i costi di spedizione nel campo valore dell'evento Purchase. La spedizione viene salvata come campo personalizzato all'interno dell'evento.
Invia l'importo dell'ordine con le tasse?AbilitatoQuando abilitato, il valore Purchase include le tasse. Disabilita per riportare importi al netto delle tasse.
Traccia solo gli ordini con Pagamento ConvalidatoDisabilitatoFunzione beta. Quando abilitata, solo gli ordini che raggiungono uno stato di pagamento convalidato attivano immediatamente un evento Purchase. Gli ordini con pagamento non convalidato vengono trattenuti fino al numero di giorni impostato di seguito. Se vengono convalidati entro quel periodo, l'evento Purchase viene inviato retroattivamente tramite l'API di Conversione. Richiede che CAPI sia configurato.
Limite di Convalida Ordini Non Convalidati7 giorniPer quanti giorni un ordine in sospeso viene trattenuto prima di essere scartato. Si applica solo quando "Traccia solo gli ordini con Pagamento Convalidato" è attivo.
Stati d'ordine da escludereNessunoGli eventi Purchase vengono soppressi quando un ordine raggiunge uno degli stati selezionati. Usa questa opzione per escludere stati d'ordine contrassegnati come frode, di test o amministrativi.

La Modalità Debug dell'evento Purchase (descritta di seguito sotto Filtro Clienti) bypassa tutta la logica di deduplicazione. Non lasciarla mai attiva su un negozio in produzione.

Evento Rimborso / Cancellazione​

L'evento Refund è il segnale di rimborso canonico esclusivo per CAPI. La configurazione e le note si trovano nell'unica fonte di verità in Evento Rimborso.

Filtro Clienti​

Queste impostazioni ti permettono di sopprimere gli eventi Purchase per clienti o gruppi specifici.

CampoPredefinitoDescrizione
Gruppi di clienti da escludereNessunoGli eventi Purchase vengono soppressi per i clienti appartenenti ai gruppi selezionati (ad esempio, Dipendenti, Rivenditori, Interni). Questa è un'impostazione per singolo negozio.
ID Cliente da escludere—Elenco separato da virgole di ID cliente PrestaShop. Gli eventi Purchase vengono soppressi per questi clienti specifici. Questa è un'impostazione globale — si applica a tutti i negozi in una configurazione multi-negozio.
Modalità Debug dell'evento PurchaseDisabilitatoBypassa tutta la logica di deduplicazione e permette allo stesso ordine di attivare l'evento Purchase più volte. Usa solo per i test in un ambiente di sviluppo. Causa statistiche gonfiate in Meta se lasciata attiva.

Opzioni di Visualizzazione​

CampoValoriPredefinitoDescrizione
Uso External IDSolo su utenti registrati / Tutti gli utentiSolo su utenti registratiControlla quando viene generato l'identificatore di matching cross-device (external_id). Il valore predefinito è quello consigliato: generare un external_id per i visitatori ospiti e poi uno diverso dopo la registrazione crea due ID per la stessa persona, il che può causare problemi di attribuzione in Meta.

Opzioni di Registrazione​

CampoPredefinitoDescrizione
Usa Ajax per confermare le Registrazioni ClienteAbilitatoConvalida gli eventi CompleteRegistration tramite AJAX. Consigliato — lascia abilitato.

Opzioni PageView​

CampoPredefinitoDescrizione
Limita PageView ai controller conosciutiDisabilitatoQuando abilitato, gli eventi PageView si attivano solo sulle pagine standard di PrestaShop: prodotto, categoria, carrello, checkout, CMS e pagine di contatto. Quando disabilitato, PageView si attiva su ogni pagina, inclusi errori 404 e pagine di moduli personalizzati.

Rilevamento Inizio Checkout​

CampoValoriPredefinitoDescrizione
Modalità Inizio CheckoutPagina iniziale / Click sul pulsantePagina inizialePagina iniziale attiva l'evento InitiateCheckout quando il cliente arriva per la prima volta al checkout. Click sul pulsante si attiva quando il cliente clicca esplicitamente su "Procedi al Checkout". Usa la modalità pulsante se noti eventi InitiateCheckout duplicati in Meta Events Manager.

Prevenzione Cache​

CampoValoriPredefinitoDescrizione
Prevenzione Cache File StaticiDisabilitato / Sempre / Giornaliero / Settimanale / Mensile / TrimestraleDisabilitatoAggiunge un parametro dinamico anti-cache agli URL dei file statici di Pixel Plus. Abilita solo quando un CDN o una cache del server (LiteSpeed, Nginx, Cloudflare) sta servendo una versione obsoleta dello script del pixel dopo un aggiornamento del modulo. Scegli una frequenza che corrisponda a quanto spesso aggiorni il modulo.
Prevenzione Cache AvanzataDisabilitato / AbilitatoDisabilitatoAggiunge parametri extra alle chiamate AJAX per impedire che risposte in cache interferiscano con il tracciamento. Abilita solo se riscontri eventi mancanti o comportamenti del pixel incoerenti causati specificamente dal caching a livello di server.

Selettori Personalizzati​

Questi campi sono per i negozi i cui temi o moduli non corrispondono al layout standard di PrestaShop.

CampoDescrizione
Selettore personalizzato Aggiungi al CarrelloSelettore jQuery o CSS per un pulsante Aggiungi al Carrello personalizzato. Usa quando il tuo tema sovrascrive il pulsante predefinito e gli eventi AddToCart non si attivano.
Selettore avvio personalizzazioneSelettore CSS per un pulsante di personalizzazione prodotto — un pulsante che il cliente deve cliccare prima di personalizzare un prodotto. Lascia vuoto se il tuo negozio non usa la personalizzazione prodotto.
Nome modulo (Pagina Checkout Personalizzata)Nome tecnico di un modulo di checkout personalizzato se il tuo negozio non usa il checkout standard di PrestaShop. Usato per attivare eventi InitiateCheckout dalle pagine del modulo personalizzato.
Controller di ricercaNome del controller di un modulo di ricerca personalizzato. Visibile nell'URL dopo il parametro controller= quando viene eseguita una ricerca. Lascia vuoto per usare il SearchController predefinito di PrestaShop.
Parametro query di ricercaNome del parametro URL per la stringa di ricerca. Valori comuni: s, q, term. Lascia vuoto per usare il valore predefinito.

Come Funziona​

Strategia di Caricamento del Pixel​

Per impostazione predefinita, lo script del pixel si carica nel footer. Questo è l'approccio più sicuro: gli script nel footer non bloccano il rendering della pagina, quindi il tuo negozio sembra caricarsi più velocemente. Se il tuo tema non include gli hook displayFooter o displayBeforeBodyClosingTag, il pixel non si attiva mai — attiva Forza Pixel nell'Header per inserirlo invece dal tag <head>.

Il caricamento differito è una terza opzione: il pixel attende che l'intera pagina abbia terminato il rendering prima di inizializzarsi. Questo può migliorare i punteggi PageSpeed perché il pixel non è più nel percorso critico di rendering. Il compromesso è che le azioni del visitatore intraprese subito dopo il caricamento della pagina — prima che il ritardo configurato sia trascorso — non vengono catturate. L'affinamento "Differisci solo la prima volta" risolve la maggior parte di questo: una volta che lo script del pixel è nella cache del browser da una pagina precedente nella stessa sessione, si carica praticamente all'istante e il differimento diventa superfluo.

Consegna dell'Evento Purchase​

La maggior parte dei moduli di pagamento segue un flusso standard: il cliente completa il pagamento, il modulo di pagamento reindirizza alla pagina di conferma ordine di PrestaShop, e il modulo attiva l'evento Purchase da lì. Quando un modulo di pagamento usa una propria pagina di conferma o reindirizza il cliente fuori dal flusso standard di PrestaShop, il rilevamento standard fallisce. Forza la modalità Base dell'evento Purchase dice al modulo di ripiegare sull'attivazione nell'URL della pagina di conferma, indipendentemente da come è stato creato l'ordine.

Usa Ajax per confermare l'invio della conversione aggiunge un livello di convalida: prima di attivare l'evento Purchase dal browser, il modulo verifica tramite AJAX che l'ordine sia stato correttamente registrato. Questo previene il mancato invio dell'evento quando un reindirizzamento di pagamento interrompe il normale caricamento della pagina.

Filtro Clienti​

L'esclusione per gruppo cliente (FCTP_ORDER_CUSTOMER_GROUP_EXC) viene valutata nel momento in cui l'evento Purchase verrebbe normalmente inviato. Se il cliente che effettua l'ordine appartiene a un gruppo escluso, l'evento viene ignorato silenziosamente. L'ordine viene elaborato normalmente in PrestaShop — solo il tracciamento Meta viene soppresso.

L'esclusione per ID cliente (FCTP_ORDER_CUSTOMER_ID_EXCLUDE) funziona allo stesso modo per singoli individui anziché gruppi. Essendo un'impostazione globale, si applica a tutti i negozi in una configurazione multi-negozio — utile per escludere un account usato regolarmente per test cross-negozio.

Esempi d'Uso​

Esempio: Tema senza hook footer Il tuo negozio usa un tema personalizzato costruito senza gli hook footer standard di PrestaShop. Il pixel non si attiva mai perché il punto di inserimento del footer non esiste. Abilita Forza Pixel nell'Header — il pixel viene quindi inserito nell'<head> di ogni pagina, che tutti i temi includono.

Esempio: Ordini dello staff e dei rivenditori gonfiano le statistiche di conversione Noti che il conteggio degli eventi Purchase su Meta è più alto delle tue vendite reali perché sono inclusi ordini dello staff e dei rivenditori. Aggiungi i tuoi gruppi clienti "Dipendenti" e "Rivenditori" a Gruppi di clienti da escludere. Da quel momento in poi, gli ordini di quei gruppi non generano un evento Purchase, mentre gli ordini stessi continuano a essere elaborati normalmente in PrestaShop.

Esempio: Eventi Purchase duplicati da una cache di pagina Il tuo negozio usa un plugin di caching a pagina intera e stai vedendo eventi Purchase duplicati per lo stesso ordine in Meta. Abilita Usa Cookie per prevenire i duplicati di conversione — il modulo imposta un cookie di breve durata quando l'evento Purchase si attiva, e se la pagina di conferma si carica di nuovo (dalla cache) il cookie impedisce l'invio di un secondo evento.

Esempio: CDN che serve uno script pixel obsoleto Dopo aver aggiornato Pixel Plus, alcuni visitatori attivano ancora eventi usando la vecchia logica di tracciamento perché il tuo CDN ha memorizzato in cache la versione precedente dello script. Imposta Prevenzione Cache File Statici su Settimanale — questo aggiunge un parametro basato sulla data all'URL dello script che cambia settimanalmente, forzando il CDN a recuperare e servire il file aggiornato.

Esempio: InitiateCheckout si attiva due volte Vedi due eventi InitiateCheckout per sessione di checkout in Meta Events Manager. Questo accade quando il cliente sia arriva alla pagina di checkout sia clicca un pulsante "Procedi", entrambi i quali attivano l'evento. Passa Modalità Inizio Checkout da Pagina iniziale a Click sul pulsante in modo che l'evento si attivi solo al click esplicito.

Note Importanti​

  • Forza Pixel nell'Header e Caricamento differito possono essere abilitati contemporaneamente, ma il risultato è che il posizionamento nell'header prevale: lo script si carica immediatamente dall'<head>. Non c'è alcun beneficio combinato — scegli l'opzione adatta alla tua situazione.
  • La Modalità Debug dell'evento Purchase non deve mai essere lasciata attiva su un negozio in produzione. Bypassa tutti i controlli di deduplicazione e causa conteggi gonfiati degli eventi Purchase in Meta, il che corrompe i dati di ottimizzazione delle campagne.
  • ID Cliente da escludere è un'impostazione globale — si applica a tutti i negozi in una configurazione multi-negozio. L'esclusione per gruppo cliente è per singolo negozio.
  • Traccia solo gli ordini con Pagamento Convalidato è una funzione beta e richiede che l'API di Conversione sia attiva. Gli ordini trattenuti nella coda in sospeso vengono elaborati retroattivamente dalla CAPI — il pixel del browser non invia eventi ritardati.
  • Prevenzione Cache File Statici aumenta il tasso di cache miss del CDN per i file statici di Pixel Plus. Abilitala solo quando hai confermato che una cache di file obsoleti sta effettivamente causando un problema di tracciamento.
  • L'impostazione Uso External ID influisce sull'attribuzione cross-device in Meta. Cambiarla da "Solo su utenti registrati" a "Tutti gli utenti" genererà valori external_id per i visitatori ospiti. Se un ospite si registra successivamente, avrà due valori external_id diversi, il che può ridurre l'accuratezza dell'attribuzione.

Risoluzione dei Problemi​

ProblemaSoluzione
Il pixel non si attiva affatto sul negozioIl tuo tema probabilmente non include un hook footer. Abilita Forza Pixel nell'Header.
Eventi AddToCart mancanti su un tema personalizzatoAggiungi il selettore jQuery/CSS per il pulsante Aggiungi al Carrello del tuo tema in Selettore personalizzato Aggiungi al Carrello.
InitiateCheckout si attiva due volte per checkoutPassa Modalità Inizio Checkout da Pagina iniziale a Click sul pulsante.
Ordini dello staff o test interni compaiono nelle statistiche MetaAssicurati che Escludi ordini da Back Office sia abilitato. Aggiungi anche gli ID cliente interni o un gruppo cliente dello staff ai campi di esclusione.
Eventi PageView da pagine di errore 404 inquinano i dati MetaAbilita Limita PageView ai controller conosciuti.
Eventi Purchase duplicati in MetaAbilita Usa Cookie per prevenire i duplicati di conversione. Assicurati anche che il modulo di pagamento per cui si verificano i duplicati non sia impostato in modalità Base senza protezione cookie.
Eventi Purchase non tracciati per un metodo di pagamento specificoAbilita Forza la modalità Base dell'evento Purchase per quel modulo di pagamento. Se in seguito compaiono duplicati, abilita anche Usa Cookie per prevenire i duplicati di conversione.
Script pixel obsoleto servito dopo un aggiornamento del moduloAbilita Prevenzione Cache File Statici e scegli una frequenza adatta (Giornaliero o Settimanale).
Eventi mancanti che sembrano legati al caching AJAXAbilita Prevenzione Cache Avanzata per aggiungere parametri anti-cache alle chiamate AJAX.

Domande Frequenti​

Dovrei abilitare il caricamento differito sul mio negozio?

Solo se hai confermato che lo script del pixel è nel percorso critico di rendering e influisce sul tuo punteggio PageSpeed. Per la maggior parte dei negozi, il caricamento nel footer predefinito è sufficiente e garantisce che nessun evento venga perso. Se lo abiliti, abilita anche 'Differisci solo la prima volta' per minimizzare il rischio di perdere eventi sui visitatori di ritorno.

Dovrei riportare il valore Purchase con o senza spedizione?

La maggior parte degli inserzionisti include la spedizione per riportare l'importo di fatturato completo. Se confronti il valore Purchase riportato da Meta con i tuoi report di fatturato, la cosa più importante è la coerenza con il metodo usato dalla tua contabilità. Scegli l'impostazione che corrisponde a come misuri il fatturato altrove.

Qual è la differenza tra 'Solo su utenti registrati' e 'Tutti gli utenti' per External ID?

external_id è un identificatore di matching cross-device che Meta usa per collegare le azioni di un visitatore tra sessioni e dispositivi. Con 'Solo su utenti registrati', un ID stabile viene generato solo quando il visitatore ha un account. Con 'Tutti gli utenti', viene creato anche un ID temporaneo per i visitatori ospiti. Il rischio con 'Tutti gli utenti' è che un ospite che si registra successivamente riceverà un secondo ID diverso — Meta potrebbe trattarli come due persone separate, riducendo l'accuratezza dell'attribuzione.

Il mio modulo di pagamento personalizzato non viene tracciato. Cosa dovrei provare per primo?

Per prima cosa, abilita Forza la modalità Base dell'evento Purchase per quel modulo di pagamento. Questo forza l'evento Purchase ad attivarsi quando il cliente raggiunge la pagina di conferma ordine, indipendentemente da come è stato elaborato il pagamento. Se compaiono eventi duplicati dopo aver abilitato la modalità base, abilita anche Usa Cookie per prevenire i duplicati di conversione.

Posso escludere solo uno o due clienti specifici senza creare un intero gruppo cliente?

Sì. Inserisci i loro ID cliente PrestaShop come elenco separato da virgole in ID Cliente da escludere. Nota che questa è un'impostazione globale — si applica a tutti i tuoi negozi in una configurazione multi-negozio, non solo al negozio corrente.

Cosa succede agli ordini trattenuti nella coda in sospeso se il pagamento non viene mai convalidato?

Il modulo trattiene gli ordini non convalidati per il numero di giorni impostato in Limite di Convalida Ordini Non Convalidati (predefinito 7 giorni). Se l'ordine non viene convalidato entro quella finestra, l'evento Purchase viene scartato e mai inviato a Meta. Questo previene che ordini obsoleti o falliti generino falsi segnali di conversione.

Funzionalità Correlate​