Documentazione
Conversions API
Usa la Conversions API quando gli eventi nel browser non bastano, e condividi gli ID evento così la stessa conversione non viene contata due volte.
Ultimo aggiornamento: 2026-09-08. Scritto da PixelBridge team.
La OpenAI Ads Conversions API offre un metodo server-side per inviare eventi di conversione supportati ai sistemi di misurazione pubblicitaria di OpenAI. PixelBridge è progettato per inviare quegli eventi da WordPress e coordinarli con gli eventi del browser.
Perché esiste la misurazione server-side
I pixel nel browser possono essere bloccati da scelte di consenso, browser, estensioni o regole di Content Security Policy. Un evento server può comunque registrare una conversione supportata dopo che WordPress ha confermato l'azione.
La misurazione server-side non è un modo per aggirare il consenso. Se il consenso alla misurazione è richiesto, l'evento server deve seguire lo stesso permesso.
Pixel vs Conversions API
| Livello | Punto di forza | Limite |
|---|---|---|
| Browser Pixel | Visualizzazioni di pagina veloci e contesto client | Può essere bloccato nel browser |
| Conversions API | Parte dopo che WordPress conferma un'azione | Serve credenziali, ID evento e gestione errori |
Usarli entrambi può essere più solido. Non è obbligatorio per ogni sito.
ID evento
Quando la stessa conversione viene inviata due volte, i due payload devono condividere un ID evento. PixelBridge è progettato per generare o riutilizzare quell'ID così la misurazione OpenAI Ads può deduplicare la coppia.
Implementazione WordPress
Gli eventi server tipici arrivano da:
- Un hook di invio form confermato.
- Un hook di conferma prenotazione.
- Uno stato ordine WooCommerce che significa che l'acquisto è reale.
La connessione Conversions API del plugin fa parte del set di funzionalità Pro previsto e non è ancora disponibile pubblicamente.
Debug
Controlla la diagnostica per lo stato della connessione, poi ispeziona gli eventi più recenti. Se un evento browser riesce e l'evento server fallisce, tieni visibile il fallimento invece di ritentare alla cieca. Vedi Risoluzione problemi e la guida Conversions API.