OpenAI Ads Conversions API: guida setup WordPress

Configura la OpenAI Ads Conversions API su WordPress: eventi server-side, confronto col pixel, ID evento, deduplicazione, WooCommerce, form e debug.

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

Su WordPress, di solito significa inviare un evento dopo che un form, una prenotazione o un ordine è confermato, invece di fare affidamento solo su uno script nel browser. PixelBridge è progettato per inviare quegli eventi e coordinarli con il pixel nel browser. La connessione Conversions API fa parte del set di funzionalità Pro previsto e non è ancora disponibile pubblicamente.

Che cos'è la Conversions API

La Conversions API è un percorso server-to-server. WordPress, o un altro backend, invia un evento di conversione supportato dopo aver già saputo che l'azione è riuscita. Il browser non deve essere l'unico messaggero.

Non è un secondo account pubblicitario e non è un sostituto della configurazione delle campagne. È un metodo di consegna per eventi di misurazione. Campi di richiesta ufficiali, autenticazione e tipi di evento supportati appartengono alla documentazione per sviluppatori di OpenAI. Conferma quei dettagli prima di costruire un client personalizzato.

PixelBridge è indipendente da OpenAI. Usare la Conversions API tramite il plugin non crea una partnership ufficiale.

Perché conta la misurazione server-side

I pixel nel browser falliscono in condizioni ordinarie:

• Il visitatore rifiuta i cookie di misurazione
• Un browser o un'estensione blocca lo script
• La Content Security Policy blocca il dominio dell'SDK
• Il cliente chiude la thank-you page prima che il pixel parta
• Un page builder o un plugin di cache riordina gli script

Un evento server può comunque registrare la conversione dopo che WordPress ha salvato il form, la prenotazione o l'ordine. Quella resilienza è il motivo per aggiungere la Conversions API. Non è un motivo per ignorare il pixel. Visualizzazioni di pagina e contesto della landing arrivano ancora dal browser.

La consegna server-side non aggira il consenso. Se il permesso di misurazione è richiesto, tieni l'evento server dietro lo stesso permesso. Vedi consenso.

Pixel vs Conversions API

Puoi partire solo col pixel. Aggiungi la Conversions API quando la consegna nel browser non basta, o quando acquisti e prenotazioni hanno bisogno di un segnale backend confermato. Usarli entrambi è una scelta di resilienza, non una tattica di ranking.

La guida di installazione del pixel è OpenAI Ads Pixel per WordPress. Docs prodotto: Conversions API.

Deduplicazione

Quando la stessa conversione viene inviata dal browser e dal server, la misurazione ha bisogno di un modo per trattarle come un'unica azione. Quel meccanismo è la deduplicazione.

Senza di essa, un checkout riuscito può diventare due acquisti. Con essa, entrambi i payload portano lo stesso ID evento e il sistema di misurazione pubblicitaria può comprimere la coppia.

La deduplicazione è rilevante solo quando entrambi i livelli inviano la stessa conversione. Un lead solo server non ha nulla da unire. Una visualizzazione di pagina solo browser non dovrebbe inventare un gemello server.

ID evento

Un ID evento è la chiave condivisa per una singola azione del cliente.

Il pattern WordPress previsto:

1. All'hook di successo, crea o riutilizza un ID evento.
2. Invia l'evento browser con quell'ID, se il pixel è autorizzato a girare.
3. Invia l'evento server con lo stesso ID, se la Conversions API è attiva e il consenso lo consente.
4. Conserva abbastanza dell'ID in log o diagnostica per fare debug di un mismatch più tardi.

Se l'evento browser usa un ID e l'evento server ne usa un altro, ottieni duplicati. Se ritenti una chiamata server fallita con un nuovo ID mentre l'evento browser originale è già riuscito, puoi ottenere duplicati anche così. Tieni l'ID stabile per quella conversione.

PixelBridge è progettato per generare o riutilizzare quell'ID così la coppia può essere deduplicata.

Implementazione WordPress

Una configurazione Conversions API WordPress è un lavoro backend:

1. Conserva le credenziali API nelle impostazioni del plugin o nella configurazione d'ambiente, non in un file JavaScript pubblico.
2. Ascolta hook WordPress confermati, non clic su pulsanti.
3. Costruisci un payload che corrisponda alla specifica ufficiale attuale degli eventi.
4. Includi l'ID evento usato dall'evento browser.
5. Rispetta il consenso prima che la richiesta lasci il server.
6. Registra successo e fallimento invece di ritentare alla cieca.

Fonti tipiche:

• Un hook di invio form confermato
• Un hook di conferma prenotazione
• Uno stato ordine WooCommerce che significa che l'acquisto è reale

Non inviare eventi server da wp_footer su ogni pagina. Quello ricrea le parti peggiori di un pixel senza il valore delle visualizzazioni di pagina.

La documentazione WordPress copre hook e architettura dei plugin. Non definisce i campi evento OpenAI.

WooCommerce

WooCommerce è una fonte naturale per la Conversions API perché l'ordine esiste sul server anche se il cliente non vede mai il pixel della thank-you.

Quando il tracciamento acquisti arriverà, l'evento dovrebbe:

• Partire sullo stato ordine che tratti come conversione
• Includere un identificatore dell'ordine
• Includere un valore di conversione dove consentito
• Condividere un ID evento con qualsiasi evento purchase nel browser

L'integrazione WooCommerce è in arrivo. Non è rilasciata. Non aspettarti che gli ordini inviino eventi OpenAI Ads finché quel connettore non esiste o finché non costruisci tu un hook personalizzato.

Invii di form

I form sono l'altra fonte server-side comune. Un hook PHP di successo può inviare lead_created dopo che il messaggio è salvato, il che è più affidabile di un listener JavaScript sul pulsante di invio.

I connettori form previsti (Elementor Forms, Contact Form 7, WPForms, Gravity Forms, Fluent Forms) sono in arrivo. Fino ad allora, un'implementazione personalizzata dovrebbe partire una volta per invio riuscito e saltare i fallimenti di validazione.

Se il form attiva anche un evento browser, usa lo stesso ID evento su entrambi.

Debug

Fai debug di browser e server come una coppia.

1. Conferma che il percorso pixel funzioni ancora. Un pixel rotto più una API rotta sembra "CAPI è giù" quando il vero problema è il consenso o un mismatch di Pixel ID.
2. Attiva una conversione.
3. Controlla se è stato inviato un evento browser.
4. Controlla se è stato inviato un evento server.
5. Confronta gli ID evento.
6. Ispeziona la risposta server. Tieni visibili i fallimenti.

La diagnostica di PixelBridge è progettata per mostrare lo stato di connessione della Conversions API e lo stato di invio degli eventi recenti. Un avviso previsto è "browser event was sent but server event failed". Quel controllo è previsto, non dichiarato come già disponibile. Vedi diagnostica e risoluzione problemi.

Errori comuni

Nomi degli eventi e campi obbligatori possono cambiare. Quando un payload viene rifiutato, controlla la documentazione ufficiale OpenAI prima di cambiare gli hook WordPress.

Setup PixelBridge

PixelBridge è progettato per inviare eventi Conversions API da WordPress e coordinarli con gli eventi del browser. Quel setup è previsto, non lanciato.

Configurazione prevista, una volta che Pro è disponibile:

1. Inserisci il Pixel ID e completa prima la misurazione nel browser.
2. Aggiungi le credenziali Conversions API nelle impostazioni del plugin.
3. Attiva solo le conversioni di cui ti fidi già nel browser, o che esistono solo sul server.
4. Conferma che la diagnostica mostri una connessione e un solo invio per azione di test.

Fino al lancio, iscriviti all'accesso anticipato dalla homepage. Leggi funzionalità e prezzi per la suddivisione prevista Free, Pro e Agency. Pro è la casa prevista per Conversions API, deduplicazione, WooCommerce e integrazioni di prenotazione.

Per il modello di misurazione più ampio, continua con Tracciamento conversioni OpenAI Ads.