Come Configurare il Pixel degli Annunci ChatGPT
Per configurare il pixel degli annunci ChatGPT crea una data source in OpenAI Ads Manager, copia il Pixel ID, installa il JavaScript nelle pagine in cui avvengono le conversioni e configura l\'evento di conversione che vuoi misurare. Invia poi acquisti, lead ed eventi custom con oaiq("measure", ...), deduplica i segnali browser e server usando lo stesso event_id e mantieni il riferimento al clic oppref nell\'URL di destinazione.
Da settembre 2026, il sistema di misurazione pubblicitaria OpenAI si basa su due canali: il pixel di misurazione nel browser e la Conversions API sul server. Questa guida copre entrambi: snippet corretti, Google Tag Manager, WordPress e WooCommerce, consenso e una checklist di risoluzione problemi per dati di conversione puliti in Ads Manager.
Fonti: OpenAI — Documentazione Measurement Pixel ↗ · Documentazione Conversions API ↗ · Eventi supportati ↗
Cos\'è il Pixel degli Annunci ChatGPT
Il pixel di misurazione degli annunci ChatGPT è la tecnologia di misurazione basata su JavaScript di OpenAI. Lo installi sul sito per misurare cosa succede dopo che qualcuno clicca una card sponsorizzata di ChatGPT Ads: acquisti, invii di moduli, registrazioni o altre conversioni importanti per te.
| Livello | Funzione | Dove gira |
|---|---|---|
| Pixel OpenAI | SDK del browser (global oaiq) che cattura eventi e segnali di conversione. | HTML del tuo sito |
| OpenAI Conversions API | Endpoint server-to-server per eventi inviati dal tuo backend. | Il tuo server, non il codice di pagina |
| Riferimento al clic (oppref) | Valore nell\'URL di destinazione che collega la visita a un\'interazione pubblicitaria. | URL di destinazione + cookie di prima parte |
Il flusso è semplice: l\'utente clicca una card sponsorizzata, arriva al tuo sito con il riferimento al clic nell\'URL, il pixel lo cattura e invia l\'evento di conversione che compare in OpenAI Ads Manager.
Annuncio su ChatGPT ↓ L'utente clicca l'annuncio ↓ Il tuo sito (URL di destinazione con ?oppref=...) ↓ Pixel OpenAI ↓ Evento di conversione ↓ OpenAI Ads Manager → report conversioni
Pixel vs Conversions API
OpenAI offre due modi per inviare i dati di conversione, ognuno risponde a domande diverse:
| Metodo | Flusso | Ideale per |
|---|---|---|
| Pixel OpenAI | Utente → Browser → Pixel → OpenAI | Tutto ciò che accade nel browser: visualizzazioni prodotto, carrello, checkout. |
| Conversions API | Utente → Sito → Server → CAPI → OpenAI | Eventi confermati sul server: ordini, pagamenti, eventi app. |
| Entrambi (consigliato) | Browser + Server → OpenAI (stesso event_id) | Misurazione resistente a blocker e sessioni perse. |
Quando invii la stessa conversione da due canali, riutilizza lo stesso event_id così OpenAI la tratta come un unico evento senza doppio conteggio.
Prerequisiti
- Account OpenAI Ads Manager (self-serve o gestito) con accesso alle impostazioni di misurazione.
- Una data source (pixel) creata in Ads Manager — da qui arriva il tuo Pixel ID.
- Un sito che consenta di aggiungere script nel <head> (o tag manager / plugin / sviluppatore).
- L'evento di conversione da misurare, configurato in Ads Manager per combaciare con l'invio del sito.
- Se usi la Conversions API: accesso al server e gestione segreta del token.
Passo 1 — Installa il Pixel sul Sito
Crea la data source in Ads Manager, copia il Pixel ID (pId_...) e aggiungi il JavaScript a ogni pagina in cui può avvenire una conversione. L\'implementazione di base è questa:
<script>
(function (w, d, s, u) {
if (w.oaiq) return;
var q = function () {
q.q.push(arguments);
};
q.q = [];
w.oaiq = q;
var js = d.createElement(s);
js.async = true;
js.src = u;
var f = d.getElementsByTagName(s)[0];
f.parentNode.insertBefore(js, f);
})(window, document, "script", "https://bzrcdn.openai.com/sdk/oaiq.min.js");
oaiq("init", {
pixelId: "IL_TUO_PIXEL_ID"
});
</script>Due punti importanti. Il guard if (w.oaiq) returnimpedisce il doppio caricamento dell\'SDK se lo snippet viene installato due volte. E usa sempre lo snippet aggiornato dalla documentazione per sviluppatori OpenAI, perché l\'SDK evolve: verifica snippet e parametri prima della messa in produzione.
Passo 2 — Configura gli Eventi di Conversione
Installare il pixel non trasforma automaticamente un\'azione in conversione. Gli eventi inviati dal sito devono combaciare con le conversioni configurate in Ads Manager.
Evento sito: order_created Ads Manager: order_created Evento sito: quote_requested Ads Manager: Custom → quote_requested
Per gli eventi custom il nome deve combaciare esattamente: simile non basta. I nomi degli eventi sono snake_case minuscoli (order_created, non orderCreated).
Passo 3 — Traccia gli Acquisti
Nell\'e-commerce l\'evento di acquisto è la conversione più importante. Invialo quando l\'ordine viene confermato:
oaiq("measure", "order_created", {
type: "contents",
amount: 2599,
currency: "USD",
contents: [
{
id: "SKU-123",
name: "Pacchetto Starter",
content_type: "product",
quantity: 1
}
]
}, {
event_id: "order_12345"
});order_created è il nome dell\'evento, amount e currency descrivono il valore, contents porta gli articoli acquistati e event_id è l\'identificativo univoco per la deduplica. Segui lo schema degli eventi supportati nella documentazione OpenAI per il contratto corretto dei campi.
Passo 4 — Traccia i Lead
Per i siti di lead generation, invia l\'evento lead quando il modulo viene inviato:
oaiq("measure", "lead_created", {
type: "customer_action"
}, {
event_id: "lead_98765"
});Passo 5 — Eventi di Conversione Custom
Non tutte le conversioni sono acquisti o lead. Richieste di demo, richieste di preventivo, calcolatori completati, registrazioni e consulenze prenotate si adattano agli eventi custom:
oaiq("measure", "custom", {
type: "custom"
}, {
custom_event_name: "quote_requested"
});Configura in Ads Manager lo stesso identico nome di evento custom. I nomi custom ammettono lettere, numeri, underscore e trattini (1-64 caratteri) e non devono entrare in conflitto con i nomi degli eventi standard.
Automatic Advanced Matching
Quando l\'identificatore del clic non riesce a collegare una conversione, Automatic Advanced Matching (AAM) può migliorare la misurazione con informazioni cliente di prima parte idonee, ad esempio i campi del modulo. Il pixel normalizza e applica l\'hash SHA-256 a queste informazioni nel browser.
Non devi eseguire l\'hash delle email manualmente.Per il setup standard di Automatic Advanced Matching, la guida OpenAI attuale indica che non è richiesta alcuna modifica aggiuntiva al pixel e che i dati cliente grezzi non vengono inviati a OpenAI tramite AAM.
oppref: il Riferimento al Clic
oppref è il segnale di riferimento al clic OpenAI aggiunto all\'URL di destinazione degli annunci ChatGPT:
https://example.com/prodotti?oppref=gAAAAAb123
Il pixel salva questo valore in un cookie di prima parte così le pagine successive e gli eventi di conversione restano collegati all\'interazione pubblicitaria iniziale. Quando invii eventi server con la Conversions API, mantenere oppref quando disponibile migliora la qualità della misurazione.
Regola pratica: quando crei redirect, routing delle landing page o un sistema di tracking tuo, non eliminare mai oppref dall\'URL.
Deduplica Pixel + Conversions API
Con due canali attivi, un singolo ordine raggiunge OpenAI due volte: dal pixel del browser e dal tuo server. OpenAI rileva i duplicati tramite Pixel ID, nome evento ed event_id:
Ordine ORD-10001 ├── Pixel Browser ──→ event_id = ORD-10001 └── CAPI Server ─────→ event_id = ORD-10001 OpenAI salva il primo arrivato e ignora il duplicato.
Genera event_id una sola volta (l\'ID ordine reale funziona bene) e usa lo stesso identico valore sia nella chiamata pixel sia in quella server.
Setup Google Tag Manager
Google Tag Manager è un modo supportato per applicare il pixel, purché il tag manager non blocchi né alteri l\'ordine di inizializzazione e delle chiamate evento. Organizza il contenitore attorno a tre tag:
- Tag 1 — Pixel OpenAI di base: tag di init caricato su ogni pagina (esegue lo snippet con il tuo Pixel ID).
- Tag 2 — Pixel OpenAI acquisto: si attiva al conferma dell'ordine, usando il data layer.
- Tag 3 — Pixel OpenAI lead: si attiva all'invio del modulo lead.
Mappa gli eventi dal data layer esistente così il pixel si attiva sugli stessi trigger degli altri tuoi strumenti di analisi.
Setup WooCommerce
In WooCommerce il funnel di conversione di solito è: visualizzazione prodotto → aggiunta al carrello → avvio checkout → ordine creato. L\'evento ordine è la tua conversione di business.
WooCommerce
↓
Ordine creato
↓
Genera un ID Ordine univoco
↓
Pixel Browser ────┐
├── Annuncio OpenAI (stesso event_id)
CAPI Server ──────┘Usa l\'ID ordine WooCommerce come event_id: un valore davvero univoco rende la deduplica affidabile. In WordPress il plugin gratuito Ridoway Pixel gestisce pixel, chiamate server e deduplica event_id automaticamente.
Consenso e Privacy
Prima di implementare il tracking, verifica i requisiti di consenso del tuo paese, le giurisdizioni degli utenti e la tua privacy policy. La guida OpenAI è chiara: devi divulgare chiaramente quali dati raccogli e, se richiesto dalla legge, ottenere il consenso appropriato prima di inviare dati di conversione.
- Pubblica privacy policy e informativa su cookie/tracking.
- Collega la gestione del consenso quando richiesto (GDPR e equivalenti).
- Definisci la ritenzione dei dati e quali canali possono ricevere gli eventi.
- Ricorda: l'SDK di default parte con consenso "attivo" e supporta oaiq("consent", false) prima di init.
Conversioni Assenti? Controlla in Ordine
Un pixel attivo non significa che Ads Manager mostri subito le conversioni. Controlla in ordine:
- Il pixel è inizializzato? — DevTools/Network: l'SDK si carica da bzrcdn.openai.com.
- Pixel ID corretto? — Un ID sbagliato invia eventi a un'altra data source e la tua colonna resta vuota.
- Nome evento combaciante? — L'evento del sito deve combaciare con la conversione configurata (ortografia esatta per i custom).
- Conversione collegata? — La campagna deve avere un evento di conversione creato dai tuoi eventi.
- oppref mantenuto? — Un riferimento al clic perso abbassa la qualità dell'attribuzione.
- Deduplica corretta? — Gli eventi browser e server di una conversione devono condividere un unico event_id.
- Ritardo di reporting — OpenAI indica che le conversioni attribuite correttamente compaiono in 24-48 ore.
Un modo rapido per vedere il pixel attivo è il checker gratuito ChatGPT Ads Pixel Checker; l\'estensione Pixel Helpermostra ogni chiamata init e measure in diretta.
Perché Ads Manager e Google Analytics Differiscono
Totali di conversione diversi tra piattaforme sono normali. Annunci OpenAI e Google Analytics non usano la stessa metodologia di attribuzione. Le differenze derivano da finestre di attribuzione, timestamp, fusi orari, consenso, limitazioni del browser, disponibilità di storage, deduplica, configurazione della campagna e misurazione modellata.
OpenAI Ads: 100 conversioni Google Analytics: 82 conversioni
Una differenza del genere non è prova di pixel rotto. OpenAI stesso dichiara che i totali possono differire tra piattaforme di analisi.
Report e Finestre di Attribuzione Attuali
Ads Manager attuale (Beta) mostra impressions, clicks, spend, CTR, CPC medio, CPM medio e — con la misurazione configurata — conversioni. Le conversioni click-through e view-through idonee vengono riportate separatamente. A settembre 2026, le combinazioni di finestre di attribuzione disponibili includono:
| Click-through | Finestre di clic 7, 14 e 30 giorni |
| View-through | Finestre di visualizzazione 0 e 1 giorno |
Poiché report e attribuzione evolvono con Ads Manager Beta, verifica finestre e metriche attuali nella documentazione OpenAI prima di prendere decisioni di ottimizzazione.
Architettura di Misurazione Completa
Un setup moderno e robusto combina i due canali in un unico flusso:
CHATGPT ADS
│
▼
Clic sull'annuncio
│
▼
Landing Page (oppref)
│
┌───────────┴───────────┐
▼ ▼
Pixel OpenAI Sito / Server
│ │
│ Evento di conversione
│ │
▼ ▼
Browser Conversions API
│ │
└───────────┬───────────┘
│
stesso event_id
│
▼
Misurazione OpenAI
│
▼
Ads Manager
│
┌───────────┼───────────┐
▼ ▼ ▼
Clic Conversioni ROASQuesta è l\'architettura completa in un\'immagine: un clic, due canali di evento, un event_id condiviso e una superficie di report in Ads Manager.
Partner di Misurazione
OpenAI supporta anche partner di misurazione di terze parti se vuoi un livello extra di attribuzione, report o ottimizzazione. Esempi documentati da settembre 2026: Fospha, Hightouch, LiveRamp, Triple Whale e WorkMagic. Per la misurazione mobile sono documentate le integrazioni con AppsFlyer, Adjust e Branch. Le capacità variano per partner.
Best Practice
- Installa il pixel su tutte le pagine in cui la misurazione conta, non solo sulla home.
- Non eliminare oppref durante redirect, routing o tracking tuo.
- Esegui pixel + Conversions API insieme quando è ragionevole a livello tecnico e di business.
- Usa lo stesso event_id per la stessa conversione nel browser e nel server.
- Allinea i nomi degli eventi di conversione con precisione, soprattutto per i custom.
- Comprendi Automatic Advanced Matching: nel setup standard non serve hash manuale.
- Considera il ritardo di report di 24-48 ore prima di giudicare i numeri del weekend.
- Non confrontare alla cieca Ads Manager, GA4 e altre piattaforme: le metodologie di attribuzione differiscono.
Domande Frequenti
Come ottengo il pixel degli annunci ChatGPT?
Apri OpenAI Ads Manager, vai al menu Misurazione (Measurement) e crea una data source. Ads Manager ti fornirà l'ID pixel (inizia con pId_) e lo snippet JavaScript. Installa lo snippet nelle pagine dove avviene la conversione e configura in Ads Manager l'evento di conversione che vuoi misurare.
Dove installo il codice del pixel OpenAI sul sito?
Nel <head> di ogni pagina in cui misuri le conversioni. Lo snippet ufficiale carica l'SDK in modo asincrono da bzrcdn.openai.com e lo inizializza con il tuo ID pixel, senza bloccare il caricamento della pagina. Anche con tag manager o plugin, lo stesso tag di inizializzazione va installato su tutte le pagine.
Se uso il pixel, la Conversions API è necessaria?
Non è obbligatoria, ma è consigliata per gli eventi più importanti. Il pixel cattura gli eventi nel browser; la Conversions API invia la stessa categoria dal tuo server, quindi regge meglio ad ad-blocker e sessioni perse. Se usi entrambi, condividi lo stesso event_id su entrambi i lati così OpenAI li deduplica.
Perché le conversioni non compaiono in Ads Manager?
La reportistica non è in tempo reale. OpenAI spiega che le conversioni attribuite correttamente possono comparire entro 24-48 ore. Prima di dare la colpa al pixel controlla: ID pixel corretto, nome evento uguale alla conversione configurata, conversione collegata alla campagna e oppref mantenuto nell'URL di destinazione.
Cos'è oppref e devo mantenerlo nell'URL?
oppref è il riferimento al clic che OpenAI aggiunge all'URL di destinazione degli annunci ChatGPT. Il pixel lo salva in un cookie di prima parte in modo che gli eventi di conversione successivi restino collegati a quel clic. Non eliminare oppref durante redirect o routing personalizzati o la qualità dell'attribuzione calerà.
Posso inviare la stessa conversione da browser e server?
Sì, ed è l'architettura consigliata per gli eventi di valore. Invia l'acquisto sia dal pixel sia dalla Conversions API con lo stesso identico event_id (per esempio l'ID ordine). OpenAI confronta ID pixel + nome evento + event_id e salva quello che arriva per primo.
Con Automatic Advanced Matching devo eseguire io l'hash delle email?
No. Nell'implementazione standard OpenAI spiega che Automatic Advanced Matching (AAM) esegue l'hash SHA-256 delle informazioni cliente supportate direttamente nel browser e le invia in forma hashata. Non serve hash manuale né iniezione di dati cliente.
Quali eventi dovrei tracciare per primi?
Inizia dagli eventi davvero utili per l'ottimizzazione della campagna: order_created per gli acquisti, lead_created per la generazione lead, registration_completed per le registrazioni, oppure eventi custom come quote_requested. Ads Manager deve essere configurato per contare lo stesso nome evento che invii.
Nessun codice da incollare in WordPress
Il plugin gratuito Ridoway Pixel installa il pixel su tutto il sito, invia gli eventi di valore dal server e gestisce la deduplica event_id per te.