OpenAI / ChatGPT Ads per PrestaShop
Feed prodotti, pixel di misurazione e API delle conversioni
Verificare che tutto funzioni
Quattro controlli, in ordine. Il primo è l'elenco del modulo stesso; gli altri tre confermano, dal negozio e dal lato di OpenAI, ciò che il modulo non può vedere.
Controllo 1 — l'elenco del modulo
Dimostra: ogni parte della configurazione è a posto. Apri la scheda Stato o l'ultimo passo della procedura guidata: le verifiche mai eseguite partono da sole, ed Esegui le verifiche aggiorna le altre. Ogni riga dovrebbe essere spuntata. Un avviso non è un errore: indica qualcosa che il modulo non ha potuto confermare, come un pianificatore che non ha ancora chiamato o una verifica che il server non può fare su se stesso. Correggi → su una riga ti porta al passo che la corregge.
Controllo 2 — il pixel è nel negozio
Dimostra: il modulo viene visualizzato e l'ID del pixel è impostato. Apri una qualsiasi pagina prodotto e visualizza il sorgente (Ctrl+U). Cerca oaiq. Dovresti trovare uno script che carica l'SDK di OpenAI, una chiamata oaiq('init', …) con il tuo ID del pixel e una chiamata oaiq('measure','contents_viewed', …) il cui ID dei contenuti è l'ID del prodotto, oppure gli ID di prodotto e combinazione uniti da un trattino. Se sono presenti tutti e tre, il lato browser funziona. Con «Carica lo script del pixel solo dopo il consenso» attivo, il tag dell'SDK compare solo dopo aver accettato il banner dei cookie; le chiamate init e measure restano in coda fino ad allora.
Controllo 3 — gli eventi raggiungono OpenAI
Dimostra: i dati arrivano nel tuo account pubblicitario, non vengono solo emessi. In Ads Manager apri Conversions → Event Stream, poi naviga nel negozio in un'altra scheda. Gli eventi dovrebbero comparire entro un minuto o due; le copie lato server arrivano dopo la successiva esecuzione dell'attività eventi.
Controllo 4 — il feed viene consegnato e accettato
Dimostra: il catalogo ha raggiunto OpenAI e ne ha superato l'elaborazione. In Ads Manager apri Feeds e conferma che l'importazione è elencata con un numero di prodotti maggiore di zero. Un'importazione riuscita con zero prodotti significa quasi sempre che gli URL delle immagini non sono raggiungibili; vedi Risoluzione dei problemi. Con la consegna ospitata puoi anche aprire l'URL del feed ospitato nel browser con la password: deve scaricare un file compresso, non una pagina di errore.
Cosa viene tracciato
| Azione nel negozio | Evento OpenAI | Inviato da |
|---|---|---|
| Visualizzazione pagina prodotto | contents_viewed | Pixel |
| Aggiunta al carrello | items_added | Pixel + API delle conversioni |
| Inizio del checkout | checkout_started | Pixel + API delle conversioni |
| Ordine confermato | order_created | Pixel + API delle conversioni |
| Account creato | registration_completed | Pixel + API delle conversioni |
| Iscrizione alla newsletter o modulo di contatto | lead_created | Pixel + API delle conversioni |
| Altre pagine chiave | page_viewed | Pixel |
Gli eventi inviati da entrambi i canali condividono un identificativo evento deterministico, così OpenAI unisce ogni coppia in una sola conversione invece di contare la vendita due volte. Gli ordini usano order_ seguito dal numero d'ordine; l'aggiunta al carrello usa carrello, prodotto, combinazione e quantità risultante, calcolati in modo identico nel browser e sul server; l'inizio del checkout viene generato sul server e passato al browser.
Attribuzione al clic sull'annuncio
Quando un acquirente arriva da un annuncio ChatGPT, lo script di OpenAI salva il riferimento del clic nel cookie __oppref. Il modulo legge quel cookie e lo inoltra con ogni evento lato server, così le conversioni riportate tramite l'API delle conversioni vengono attribuite al clic anche quando il pixel del browser è stato bloccato. Non c'è nulla da configurare.