Documentazione di Pixel for ChatGPT Ads

1. 1Scarica lo ZIP del plugin dalla conferma d'acquisto.
2. 2In WordPress vai su Plugin → Aggiungi plugin → Carica plugin, seleziona lo ZIP e fai clic su Installa ora.
3. 3Attiva il plugin con Attiva plugin.
4. 4Apri la scheda Licence, incolla la chiave di licenza e attivala.

Prima che partano gli eventi di conversione serve una licenza attiva. La schermata della licenza mostra il piano, le attivazioni rimanenti e la data di scadenza della licenza. L'interfaccia del plugin è in inglese, per questo le etichette delle schede e dei campi sono riportate in inglese.

• Un sito WordPress con WooCommerce installato e attivo.
• Negozio servito in HTTPS.
• Richieste HTTPS in uscita consentite dal tuo server, perché gli eventi di acquisto possano raggiungere la Conversions API.
• Un Pixel ID di OpenAI per la misurazione nel browser.
• Una chiave della OpenAI Conversions API per gli eventi di acquisto lato server.
• Una chiave di licenza Pixel for ChatGPT Ads.

Sono supportati sia WooCommerce High-Performance Order Storage sia l'archiviazione classica degli ordini basata sui post. Non serve modificare il tema né i template del checkout.

Nella scheda Settings, incolla il Pixel ID di OpenAI nel campo OpenAI Pixel ID e salva. Con il tracciamento nel browser attivo, l'OpenAI Measurement Pixel si carica sul negozio e gli eventi del browser cominciano a partire.

Se la gestione del consenso è attiva, il pixel resta bloccato finché quel visitatore non dà il consenso marketing: vedi Consenso.

Nella stessa schermata, incolla la chiave della Conversions API nel campo Conversions API key. La chiave viene salvata solo per l'uso lato server: non viene stampata nel markup della pagina e non viene mai inviata al browser.

Con il tracciamento lato server attivo, order_created parte dal tuo server quando un ordine WooCommerce raggiunge uno stato pagato. Ogni tentativo viene registrato nella diagnostica con la sua risposta HTTP, così una chiave rifiutata o un limite di frequenza diventano visibili invece di passare inosservati.

Questi eventi partono dalla pagina:

• Prodotto visualizzatocontents_viewed
• Aggiunta al carrelloitems_added
• Checkout iniziatocheckout_started
• Acquistoorder_created

Se spegni il tracciamento nel browser, si fermano tutti e quattro gli eventi del browser. Il tracciamento lato server degli acquisti non ne risente e continua a funzionare. Il confronto tra pixel e Conversions API spiega cosa può e non può vedere ciascun canale.

order_created è l'evento inviato tramite la Conversions API. Parte quando in WooCommerce l'ordine passa a uno stato pagato, non al caricamento di una pagina: anche il cliente che chiude la scheda prima della pagina di conferma dell'ordine genera un evento di acquisto. Lo stesso vale per i metodi di pagamento differiti.

L'event ID è ricavato dall'ordine, quindi l'evento del server e quello del browser per lo stesso acquisto hanno lo stesso identificativo e possono essere unificati in una sola conversione. Ricaricare la pagina di conferma dell'ordine non crea un secondo identificativo.

Gli invii falliti vengono ritentati in automatico. Ciò che continua a fallire dopo i nuovi tentativi resta nel registro e può essere reinviato a mano.

Per il contesto (perché solo l'acquisto parte lato server, la regola dei 7 giorni di OpenAI sul timestamp e cosa l'invio lato server non può risolvere) leggi la guida alla Conversions API di OpenAI per WooCommerce.

Il plugin legge il consenso marketing tramite la WordPress Consent API. Se il tuo plugin di gestione del consenso implementa questa API, viene usato senza altre configurazioni.

• Gli eventi del browser restano bloccati finché non viene dato il consenso marketing.
• L'evento di acquisto lato server usa lo stato di consenso registrato per quell'ordine: se il cliente cambia preferenza in seguito, gli ordini passati non vengono riscritti.
• Gli ordini senza consenso marketing compaiono nella diagnostica come Not sent, non come errori.

Gli strumenti di consenso che non implementano la WordPress Consent API non vengono rilevati automaticamente. I tuoi obblighi di conformità dipendono dal negozio, dalla configurazione e dalla giurisdizione.

La scheda Diagnostics elenca gli ordini pagati e cosa è successo al loro evento di acquisto:

• Order: l'ordine WooCommerce a cui appartiene l'evento.
• WC paid: se l'ordine ha raggiunto uno stato pagato.
• Consent: lo stato del consenso marketing registrato per l'ordine.
• Delivery: inviato, in attesa di un nuovo tentativo, fallito o non inviato.
• Attempts: quante volte è stato tentato l'invio.
• HTTP status: il codice di risposta restituito all'ultimo tentativo.

Un invio fallito può essere reinviato dalla stessa schermata, una volta risolta la causa.

Le licenze sono annuali e coprono un numero fisso di attivazioni, una per ogni installazione di WordPress. Disattivando un sito liberi la sua attivazione per un altro negozio.

Active

Tracciamento consentito. Gli eventi vengono inviati, gli aggiornamenti arrivano e l'assistenza è disponibile.

Expired

Nessun nuovo tracciamento delle conversioni. Rinnova la licenza per riprendere l'invio degli eventi, gli aggiornamenti e l'assistenza.

Disabled

Nessun nuovo tracciamento delle conversioni. La licenza è stata disattivata e non viene inviato nessun nuovo evento.

I nomi degli stati compaiono così nel plugin, la cui interfaccia è al momento in inglese.

Gli aggiornamenti del plugin arrivano dalla normale schermata degli aggiornamenti di WordPress finché la licenza è attiva. Vedi prezzi e limiti dei piani.

Nessun evento del browser sul negozio

Verifica che il tracciamento nel browser sia attivo, che il Pixel ID sia salvato e, se la gestione del consenso è attiva, che sia stato dato il consenso marketing. Anche una cache a pagina intera può servire una copia della pagina precedente alla configurazione del plugin.

Un ordine pagato risulta Not sent

Per quell'ordine non è stato dato il consenso marketing, quindi non è partito nessun evento dal server. È il comportamento previsto del tracciamento che rispetta il consenso.

Invio fallito con 401

La chiave della Conversions API è stata rifiutata. Aggiorna la chiave nella scheda Settings, poi reinvia l'evento da Diagnostics.

L'invio mostra 429

La richiesta ha superato il limite di frequenza. Viene ritentata in automatico: non devi fare nulla, a meno che non finisca in Failed.

Gli invii continuano a essere ritentati

Il tuo server potrebbe non riuscire a raggiungere l'API. Controlla le richieste HTTPS in uscita, le regole del firewall e qualsiasi proxy davanti a WordPress.

Un ordine manca dal registro

L'evento di acquisto viene registrato quando l'ordine raggiunge uno stato pagato. Gli ordini ancora in attesa di pagamento non sono stati ancora inviati.

Le conversioni sembrano raddoppiate

Controlla che non ci sia un secondo pixel installato altrove. Uno snippet nel tema o un contenitore di tag manager si attiva senza l'event ID assegnato dal plugin, quindi non può essere deduplicato rispetto all'evento del server.

Il problema persiste? Mandaci il numero dell'ordine e il codice HTTP che vedi nella diagnostica: contatta l'assistenza.