Tracciamento conversioni OpenAI Ads per WooCommerce

Come dovrebbe funzionare il tracciamento acquisti WooCommerce con OpenAI Ads, inclusi ID ordine, valori di conversione, eventi browser e server, consenso e setup previsto di PixelBridge.

Ultimo aggiornamento: 8 settembre 2026. Scritto da PixelBridge team.

Il tracciamento acquisti WooCommerce per OpenAI Ads dovrebbe far partire un evento purchase dopo che l'ordine è confermato, non quando un acquirente apre il checkout o aggiunge un prodotto al carrello. L'evento dovrebbe portare un identificatore dell'ordine, un valore di conversione e una valuta dove è consentito, e un ID evento condiviso se la stessa conversione viene inviata anche tramite la Conversions API. Il consenso alla misurazione deve essere concesso prima che qualsiasi evento browser o server lasci il sito. PixelBridge è progettato per farlo da WordPress. L'hook del plugin non è ancora disponibile.

A cosa serve questa integrazione

WooCommerce registra già ordini, totali, dettagli cliente e stato ordine. La misurazione OpenAI Ads ha bisogno di un evento di conversione che rappresenti quell'acquisto, così i report pubblicitari possono collegare un ordine pagato o confermato all'attività di campagna.

PixelBridge è un plugin WordPress indipendente per quello strato di misurazione. Non è un prodotto ufficiale OpenAI o WooCommerce e non crea campagne. Il connettore WooCommerce è una delle prime integrazioni previste. Finché non arriva, niente in questa pagina è una funzionalità plugin funzionante.

Per la configurazione del negozio in sé, parti dalla documentazione ufficiale WooCommerce. Per il contratto di misurazione pubblicitaria, usa i docs Measurement Pixel di OpenAI e i docs Conversions API. Nomi degli eventi e campi obbligatori possono cambiare. Confermali nella documentazione ufficiale OpenAI prima di trattare un payload come definitivo.

Come dovrebbe funzionare il tracciamento acquisti

Un evento acquisto utile è un'azione commerciale completata. In WooCommerce di solito significa che un ordine esiste e ha raggiunto uno stato che il tuo negozio tratta come reale, come processing o completed, a seconda del metodo di pagamento.

La sequenza prevista è:

  1. L'acquirente completa il checkout.
  2. WooCommerce crea un ordine e assegna un identificatore.
  3. Se il consenso alla misurazione è concesso, un evento purchase nel browser può partire sullo stato order-received o thank-you.
  4. Se la Conversions API è attiva, WordPress può inviare un evento server corrispondente dopo che l'ordine è confermato in PHP.
  5. Entrambi i payload condividono un ID evento così la misurazione OpenAI Ads può trattarli come una sola conversione.

Non far partire purchase su:

  • Visualizzazioni di pagina prodotto
  • Add to cart
  • Caricamento della pagina di checkout
  • Pagamenti falliti o annullati
  • Bozze di ordine create dall'admin che un cliente non ha mai piazzato

Una visualizzazione di pagina su un URL prodotto o carrello resta un evento page_viewed se misuri le visualizzazioni di pagina. Non è un acquisto. Vedi eventi di conversione per come quei tipi di evento differiscono.

Identificatori dell'ordine

Ogni evento acquisto ha bisogno di un identificatore dell'ordine stabile. WooCommerce ne ha già uno: l'ID ordine, e spesso un numero d'ordine separato se usi un plugin di numerazione personalizzata.

L'identificatore è utile per tre lavori:

  • Debug: puoi abbinare un evento di misurazione a un ordine WooCommerce.
  • Deduplicazione: eventi browser e server possono puntare allo stesso ordine.
  • Operazioni successive: se verrà aggiunto il supporto rimborsi, l'ordine originale è la chiave di join.

Usa l'identificatore che non cambierà dopo il checkout. Se il tuo negozio mostra ai clienti un numero d'ordine formattato, decidi se la misurazione usa l'ID interno o il numero visibile al cliente, poi tieni quella scelta coerente su eventi browser e server.

Non generare un nuovo ID casuale sulla thank-you page se un evento server invierà anche l'ID ordine. I due lati non sembrerebbero più la stessa conversione.

Valori di conversione

Una conversione acquisto è molto più utile quando include un valore e una valuta. Le fonti tipiche in WooCommerce sono il totale dell'ordine e la valuta del negozio.

Pianifica il valore con attenzione:

  • Decidi se il valore include tasse, spedizione e commissioni.
  • Usa la stessa regola su eventi browser e server.
  • Invia la valuta del negozio, non un fallback hardcoded, a meno che l'ordine stesso non sia in un'altra valuta.
  • Non inviare un valore per un ordine non pagato o fallito.

Il valore non è lo stesso del fatturato nei report del negozio. I totali WooCommerce possono includere sconti, rimborsi successivi o aggiustamenti multi-valuta. La misurazione OpenAI Ads vedrà solo ciò che invii. Tieni la mappatura semplice e documentala per il tuo team.

Se il consenso o la tua informativa sulla privacy non consentono di inviare il valore, omettilo invece di indovinare. Un evento acquisto senza valore è comunque una conversione. Un valore inventato è peggio di nessun valore.

Eventi nel browser

L'evento browser è la chiamata purchase lato client dopo che il pixel si è caricato. Su WooCommerce, il posto naturale è la pagina order-received, dopo che WooCommerce ha renderizzato un ordine riuscito.

Un evento browser previsto dovrebbe aspettare:

  1. Che l'OpenAI Ads Pixel si inizializzi con il tuo Pixel ID.
  2. Il consenso alla misurazione, se il tuo sito lo richiede.
  3. La prova che questa pagina appartiene a un ordine reale, non a un template thank-you generico senza oggetto ordine.

Le thank-you page sono facili da sbagliare. Alcuni temi caricano lo stesso template per i pagamenti falliti. Alcuni plugin di checkout sostituiscono l'endpoint core order-received. Alcune cache servono una thank-you page senza contesto ordine. L'integrazione dovrebbe leggere l'oggetto ordine WooCommerce, non assumere che qualsiasi visita a /checkout/order-received/ sia un acquisto.

Gli eventi browser possono essere bloccati da estensioni, browser rigorosi, regole di Content Security Policy o da un banner di consenso che non concede mai la misurazione. È per questo che un evento server fa parte del disegno. È un complemento, non un modo per ignorare il consenso. Vedi la guida OpenAI Ads Pixel per WordPress per come dovrebbe caricarsi il pixel.

Eventi server-side

La Conversions API invia la stessa conversione da WordPress dopo che l'ordine è confermato in PHP. È utile quando la thank-you page non si carica mai, l'acquirente chiude il tab o il pixel nel browser è bloccato.

Un evento server WooCommerce previsto dovrebbe partire da un hook del ciclo di vita dell'ordine, non da una callback generica wp_footer. L'hook dovrebbe rappresentare un ordine confermato. I metodi di pagamento differiscono: alcuni marcano l'ordine come processing subito, altri aspettano un webhook. L'integrazione dovrebbe seguire lo stato che significa "questo acquisto è reale" per quel gateway.

Gli eventi server hanno comunque bisogno di:

  • Il Pixel ID
  • Il nome evento (purchase)
  • L'identificatore dell'ordine
  • Valore e valuta dove consentiti
  • L'ID evento condiviso
  • Dati di attribuzione come oppref quando disponibili
  • La stessa regola di consenso dell'evento browser

La connessione Conversions API del plugin fa parte del set di funzionalità Pro previsto e non è ancora disponibile pubblicamente. Leggi Conversions API e la documentazione ufficiale Conversions API per il contratto attuale dei campi.

Deduplicazione

Se invii sia un evento browser sia un evento server per un ordine WooCommerce, la misurazione OpenAI Ads ha bisogno di un modo per vedere che sono la stessa azione. Quello è un ID evento condiviso.

Il modello previsto è:

  1. WordPress genera o conserva un ID evento per l'ordine.
  2. L'evento browser include quell'ID.
  3. L'evento server include lo stesso ID.
  4. Entrambi gli eventi usano lo stesso Pixel ID e lo stesso nome evento.

Senza quell'ID condiviso, una thank-you page riuscita più un hook server riuscito possono sembrare due acquisti. Con esso, un evento browser bloccato può comunque lasciare una conversione server valida.

Non riutilizzare un ID evento su ordini diversi. Non creare un nuovo ID a ogni refresh della thank-you page. L'ordine è l'unità di conversione.

Consenso

Il tracciamento acquisti è comunque misurazione pubblicitaria. Se la tua configurazione legale la tratta come opzionale, l'integrazione WooCommerce non dovrebbe caricare il pixel, far partire un acquisto nel browser o inviare un evento Conversions API finché il permesso richiesto non esiste.

Il consenso non è un'impostazione WooCommerce. Di solito arriva da un banner cookie o da un plugin di consenso. PixelBridge è progettato per leggere quello stato invece di aggiungere un secondo banner. Vedi consenso.

Alcune trappole specifiche WooCommerce:

  • Il checkout può completarsi mentre il banner è ancora senza risposta.
  • Alcuni negozi concedono il consenso statistico ma non quello di marketing o misurazione.
  • Gli eventi server devono seguire lo stesso permesso degli eventi browser. Un hook PHP non è una scappatoia.

Questa pagina è una guida di implementazione, non un parere legale.

Rimborsi

WooCommerce può rimborsare un ordine in tutto o in parte. Eventi di rimborso o aggiustamento OpenAI Ads non sono ancora supportati da PixelBridge.

Finché non esiste il supporto rimborsi:

  • Non inviare un secondo purchase con un valore negativo come workaround.
  • Non cancellare l'evento acquisto originale dai tuoi log e assumere che i report pubblicitari seguiranno.
  • Tratta l'acquisto originale come la conversione che è stata inviata, poi aspetta una mappatura rimborsi documentata.

Se in seguito verranno aggiunti eventi rimborso, dovrebbero fare riferimento all'identificatore dell'ordine originale e seguire le regole ufficiali di misurazione OpenAI Ads. Quel lavoro non è rilasciato.

Setup previsto

Quando l'integrazione WooCommerce arriverà, il percorso WordPress previsto è:

  1. Installa PixelBridge quando il plugin è disponibile. La scheda pubblica non è ancora live. Vedi installazione.
  2. Inserisci il tuo OpenAI Ads Pixel ID.
  3. Attiva il tracciamento acquisti WooCommerce nelle impostazioni del plugin.
  4. Scegli lo stato ordine che deve contare come acquisto per i tuoi metodi di pagamento.
  5. Decidi se devono partire eventi browser, eventi server o entrambi.
  6. Conferma le regole di consenso prima che qualsiasi evento sia consentito.
  7. Piazza un ordine di test su un sito di staging e controlla la diagnostica.

Finché non arriva, non incollare JavaScript di acquisto in un template thank-you WooCommerce e assumere che corrisponda al plugin futuro. Un test manuale temporaneo è possibile, ma non è l'integrazione supportata.

Risoluzione problemi

Se un acquisto WooCommerce non compare nella misurazione OpenAI Ads, affronta il problema in quest'ordine:

  1. Conferma che l'integrazione sia davvero rilasciata. Se questa pagina dice ancora in arrivo, l'hook non è live.
  2. Conferma che il Pixel ID coincida con l'account pubblicitario.
  3. Conferma che l'acquirente abbia raggiunto un ordine confermato, non una schermata di checkout o di pagamento fallito.
  4. Concedi il consenso alla misurazione e riprova.
  5. Controlla se la thank-you page è in cache senza contesto ordine.
  6. Controlla se un plugin di checkout personalizzato ha sostituito il flusso core order-received.
  7. Se sono previsti sia eventi browser sia eventi server, conferma che condividano un ID evento.
  8. Ispeziona la diagnostica e la guida alla risoluzione problemi.

Un valore oppref mancante non significa sempre che il tracciamento è fallito. Può significare che la visita non proviene da un annuncio OpenAI. Vedi attribuzione oppref.

Correlati

Guide correlate