Pixel ChatGPT Ads e Conversions API: installare il monitoraggio delle conversioni
Ultimo aggiornamento: 24 agosto 2026, verificato sulla documentazione ufficiale OpenAI. I nomi di eventi e parametri citati qui provengono dalla documentazione per sviluppatori di OpenAI e possono cambiare durante la beta.
Senza misurazione delle conversioni, una campagna ChatGPT Ads resta cieca: sai quanto spendi, non cosa ottieni. E soprattutto non puoi attivare l'ottimizzazione sulla conversione. Questa pagina copre i due metodi ufficiali, il pixel lato browser e la Conversions API lato server, e il modo di farli convivere. Il quadro generale è nella nostra guida ChatGPT Ads.
Motori IA trattati in questa pagina
- ChatGPT
Perché la misurazione è un prerequisito, non un'opzione
Tre ragioni, di cui una bloccante:
- Bloccante: l'ottimizzazione sulla conversione (oCPC) richiede che il monitoraggio sia già configurato, con il pixel JavaScript, la Conversions API, o entrambi. Senza segnale, il sistema non ha nulla da ottimizzare.
- Il reporting di Ads Manager comprende una colonna conversioni che resta vuota se non è collegato nulla.
- Il calcolo del tuo costo per acquisizione dipende interamente da questo dato: senza di esso, piloti al CPC, cioè sulla spesa, non sul risultato.
Il principio generale posto da OpenAI è semplice: crei una fonte di dati (data source) in Ads Manager, poi le invii eventi di conversione tramite il pixel, l'API, o entrambi.
Pixel o Conversions API: quale scegliere?
| Pixel JavaScript | Conversions API | |
|---|---|---|
| Dove viene eseguito | Nel browser del visitatore | Sul tuo server, esclusivamente |
| Implementazione | Uno script da inserire nel head | Sviluppo lato back-end |
| Robustezza | Sensibile ai blocker e alle restrizioni del browser | OpenAI la presenta come una fonte più affidabile del solo pixel |
| Raccomandazione OpenAI | Punto di partenza | Da usare quando è possibile, per dati più precisi |
La risposta pragmatica non è «l'uno o l'altro» ma «entrambi, con deduplicazione». Il pixel si installa in un'ora e fa vivere subito le campagne; l'API si collega dopo e mette in sicurezza la misurazione nel tempo.
Installare il pixel di misurazione
Il pixel di misurazione ChatGPT Ads è un SDK per browser destinato a misurare gli eventi del tuo sito attribuibili a pubblicità dentro ChatGPT. Lo script si carica in modo asincrono da https://bzrcdn.openai.com/sdk/oaiq.min.js, da collocare nella sezione <head>, poi si inizializza con il tuo identificativo di pixel:
oaiq("init", { pixelId: "IL-TUO-PIXEL-ID" });
Il parametro pixelId è obbligatorio e si crea in Ads Manager. Un parametro debug facoltativo scrive l'attività dell'SDK nella console del browser, utile durante la fase di collaudo.
Tutta la misurazione passa poi da un unico comando: oaiq("measure", nomeEvento, datiEvento, opzioni).
Gli eventi standard, gli eventi personalizzati e i loro vincoli
Ogni evento standard si aspetta un oggetto di dati il cui campo type deve corrispondere. La documentazione per sviluppatori di OpenAI li raggruppa così:
| Famiglia | Eventi | Campo type atteso |
|---|---|---|
| Commercio | order_created, items_added, checkout_started | contents |
| Contenuto | page_viewed, contents_viewed | contents |
| Lead e registrazione | lead_created, registration_completed, appointment_scheduled | customer_action |
| Abbonamento | subscription_created, trial_started | plan_enrollment |
Per gli eventi di tipo contents, i campi documentati includono amount, currency e un array contents composto da voci con id, name, content_type e quantity. Gli eventi di tipo plan_enrollment si aspettano un plan_id. La documentazione precisa di usare valori interi per amount e quantity.
Quando nessun evento standard corrisponde, un evento personalizzato si dichiara con un terzo argomento e un oggetto di opzioni:
oaiq("measure", "custom", { type: "custom" }, { custom_event_name: "quote_requested" })
I nomi degli eventi personalizzati devono rispettare regole precise: da 1 a 64 caratteri, soltanto lettere, cifre, trattini bassi e trattini, e iniziare e finire con un carattere alfanumerico.
Attenzione a un limite strutturante: un evento personalizzato non può fare da obiettivo di ottimizzazione oCPC. Se la conversione che conta per il tuo business deve guidare l'ottimizzazione, va inviata come evento standard.
Collegare la Conversions API lato server
L'API si usa dal tuo server, esclusivamente. I punti di implementazione documentati:
- Crei una fonte di conversione web e il relativo Pixel ID tramite l'endpoint
POST /conversions/pixels. - Generi una chiave in grado di inviare eventi lato server per l'account pubblicitario corrente.
- Questa chiave va conservata in un gestore di segreti lato server. La documentazione è categorica: non metterla mai in codice eseguito dal browser, in variabili d'ambiente visibili lato client, nei log o in un repository di codice.
- L'API accetta lotti fino a 1.000 eventi. Punto critico per la gestione degli errori: se un solo evento del lotto fallisce, l'intero lotto fallisce.
Quest'ultima regola merita di essere affrontata già in fase di progettazione: un lotto respinto in blocco a causa di un campo mal formattato su un ordine può far sparire 999 conversioni valide dal tuo reporting.
Deduplicare pixel e API: la regola da non sbagliare
Se invii la stessa conversione dal pixel e dalla Conversions API, devi dirlo al sistema, altrimenti la conti due volte. Il metodo documentato:
- Riutilizzare lo stesso valore come id lato API e come event_id lato pixel.
- Inviare i due eventi con lo stesso Pixel ID.
- Per gli eventi personalizzati, usare lo stesso custom_event_name da entrambi i lati.
Lato pixel, la cosa somiglia a: oaiq("measure", "order_created", {...}, { event_id: "order_12345" }). L'abbinamento si basa sul Pixel ID, sul nome dell'evento e sull'event_id; per un evento personalizzato, il custom_event_name sostituisce il nome dell'evento in questa logica.
In pratica: usa il tuo identificativo di ordine o di lead come chiave di deduplicazione, è l'unico valore naturalmente disponibile da entrambi i lati.
oppref: preservarlo fino alla conversione, non solo catturarlo
Il pixel cattura oppref, il riferimento di clic di OpenAI, e lo memorizza in un cookie di prima parte (__oppref). Documentarne la cattura non basta: la documentazione ufficiale insiste su un punto che molte implementazioni mancano, oppref deve essere preservato attraverso i redirect e la navigazione fino alla pagina in cui la conversione viene effettivamente misurata. Un percorso di pagamento che passa per un sottodominio dedicato, un redirect dopo un modulo, o un carrello che cambia dominio perdono il cookie lungo il percorso se non è previsto nulla per farlo seguire.
Secondo punto spesso trascurato: la Conversions API non cattura oppref al posto tuo, a differenza del pixel. Se chiami l'API lato server, spetta al tuo codice andare a recuperare il valore di oppref (tipicamente depositato dal pixel in un cookie o trasmesso come parametro URL) e includerlo esplicitamente nella chiamata, quando è disponibile. Senza questo passaggio, un evento inviato solo tramite l'API perde il legame con il clic pubblicitario che lo ha preceduto.
L'architettura raccomandata da OpenAI si articola in tre parti: il pixel su ogni pagina per catturare oppref e gli eventi leggeri, la Conversions API per gli eventi ad alto valore inviati dal tuo back-end (dove hai l'ordine, e dove nulla può bloccare la chiamata), ed entrambi i canali che inviano la stessa conversione con lo stesso event_id.
L'advanced matching automatico
L'advanced matching automatico (AAM) serve a collegare conversioni ai tuoi annunci quando non è disponibile alcun identificativo di clic. Il pixel rileva automaticamente le informazioni cliente riconoscibili nei moduli e in altre fonti del tuo sito, le normalizza e le codifica in SHA-256 direttamente nel browser. La documentazione precisa che nessun dato grezzo viene trasmesso.
Puoi anche fornire tu stesso identificativi già codificati nell'oggetto user all'inizializzazione: email_sha256, phone_number_sha256, external_id_sha256, first_name_sha256, last_name_sha256, oltre ai campi non codificati country, city, region e postal_code.
Questa funzionalità tratta dati personali: la sua attivazione va decisa insieme al tuo responsabile della protezione dei dati, in particolare in Europa.
Consenso, GDPR e gestione del pixel
L'SDK espone un comando di consenso, da richiamare prima dell'inizializzazione per bloccare la misurazione finché l'utente non ha accettato:
oaiq("consent", false); poi oaiq("init", { pixelId: "..." }); poi oaiq("consent", true); una volta ottenuto il consenso.
Due punti da ricordare. Primo, il consenso vale true per impostazione predefinita, salvo che sia esplicitamente impostato a false o che sia stato registrato un rifiuto: su un sito europeo occorre quindi chiamare esplicitamente oaiq("consent", false) a monte, invece di contare sul comportamento predefinito. Secondo, quando il valore è false, gli eventi di misurazione non vengono inviati.
Un parametro opt_out permette inoltre di escludere un evento dalla personalizzazione a livello di utente; il suo valore predefinito è false. L'SDK gestisce anche un identificativo rispettoso della privacy, oppref, catturato dall'URL e conservato in un cookie __oppref.
Promemoria di contesto: le pubblicità personalizzate non sono disponibili al lancio nello Spazio economico europeo né in Svizzera. Questo non esime in alcun modo dal gestire il consenso per la misurazione stessa.
Content Security Policy: i domini da autorizzare
Causa di guasto silenzioso più frequente sui siti che applicano una CSP rigida: l'SDK viene bloccato prima ancora di inizializzarsi. Le direttive documentate:
| Direttiva | Sorgente da autorizzare | Ruolo |
|---|---|---|
| script-src | https://bzrcdn.openai.com | Caricamento dell'SDK |
| connect-src | https://bzr.openai.com e https://bzrcdn.openai.com | Invio e recupero degli eventi |
| img-src | https://bzr.openai.com | Fallback tramite richiesta immagine |
Se il pixel non trasmette nulla nonostante il codice sia al suo posto, apri la console con il parametro debug attivo: un errore CSP compare immediatamente.
Cosa il pixel non sa fare
Un limite esplicito, da conoscere prima di progettare il tuo piano di tracciamento: il pixel di misurazione non supporta gli eventi app_installed e app_opened. Questi eventi devono essere inviati lato server, tramite la Conversions API.
OpenAI documenta inoltre integrazioni con partner di misurazione, compresi i mobile measurement partner (MMP), per gli inserzionisti la cui conversione avviene dentro un'applicazione.
Altro punto di attenzione: l'uso di più Pixel ID su uno stesso sito richiede una configurazione particolare, documentata separatamente da OpenAI.
Attribuzione: cosa viene contato, e come
OpenAI valuta gli eventi di conversione rispetto agli eventi configurati per la tua campagna e alla finestra di attribuzione applicabile. Due regole da conoscere:
- L'attribuzione post-clic usa la finestra di clic configurata.
- Le conversioni post-impression (view-through) usano una finestra fissa di un giorno dopo un'impression idonea, indipendente dalla tua finestra di clic.
E la regola di lettura che evita errori di calcolo: la colonna Conversioni principale contiene solo le conversioni post-clic. Le conversioni post-impression sono un reporting aggiuntivo distinto che, secondo OpenAI, non deve essere sommato alle conversioni né usato per metriche di performance di base come il CPA.
Checklist di collaudo prima del lancio
- Fonte di dati creata in Ads Manager, Pixel ID recuperato.
- Script caricato nel head, inizializzazione richiamata con il Pixel ID corretto.
- Consenso cablato prima dell'init sui siti europei.
- Eventi standard attivati nei punti giusti, con il campo type corretto.
- Deduplicazione in atto se raddoppi con l'API: stesso valore in id ed event_id, stesso Pixel ID.
- CSP aggiornata per le tre direttive.
- Modalità debug attiva per il tempo del collaudo, poi disattivata.
- Landing page accessibile a OAI-AdsBot: una pagina bloccata può far rifiutare l'annuncio, indipendentemente dalla qualità del tracciamento. Il nostro checker della landing page ChatGPT Ads verifica questo punto.
- Un solo evento standard attivo scelto come obiettivo se punti all'oCPC, tenendo conto che non sarà più modificabile dopo la creazione della campagna.
Domande frequenti
Il monitoraggio delle conversioni è obbligatorio su ChatGPT Ads?
La Conversions API recupera oppref da sola?
Bisogna scegliere tra il pixel e la Conversions API?
Come evitare di contare una conversione due volte?
Un evento personalizzato può fare da obiettivo oCPC?
Il pixel rispetta il consenso dell'utente?
Il mio pixel non trasmette nulla, cosa verificare per primo?
Come misurare l'installazione di un'applicazione?
Qual è la finestra di attribuzione?
Punteggio SEO, punteggio GEO, performance e responsive: 49 punti controllati, verdetto AI Overview immediato.
Guide correlate
ChatGPT Ads: guida completa 2026 per fare pubblicità su ChatGPT
Come funziona ChatGPT Ads, dove è disponibile, come creare un account, strutturare una campagna, fare targeting con i context hints e stimare il budget: la guida di riferimento.
Leggi la guidaPrezzi ChatGPT Ads: aste, budget e costo reale di una campagna
Quanto costa davvero una campagna ChatGPT Ads: i tre modelli d'asta, l'offerta iniziale consigliata da OpenAI, il budget giornaliero minimo e la fatturazione a soglia.
Leggi la guidaChatGPT Ads per l'e-commerce: campagne a partire da un feed prodotto
Collegare il catalogo a ChatGPT Ads: i tre metodi di invio del feed, la scadenza degli articoli, il campo is_ads_eligible e la differenza con i risultati prodotto organici.
Leggi la guida