Guida
Come installare il pixel di ChatGPT Ads su WooCommerce
ChatGPT Ads misura le vendite di WooCommerce tramite due interfacce di OpenAI: il Measurement Pixel nel browser di chi acquista e la Conversions API sul tuo server. Installare il pixel significa ottenere un Pixel ID e una chiave API da Ads Manager, poi collegarli a WooCommerce perché vengano inviati gli eventi reali di prodotti, carrello e ordini. Questa guida usa il plugin Pixel for ChatGPT Ads e si chiude spiegando come verificare che tutto funzioni.
Aggiornato il
In questa pagina
In breve: sette passaggi, più o meno il lavoro di una schermata di impostazioni
Prima di iniziare
Cinque cose da avere pronte e una da togliere.
- WordPress con WooCommerce attivo, servito in HTTPS.
- Accesso da amministratore a WordPress, per caricare e configurare un plugin.
- Accesso al tuo account ChatGPT Ads in OpenAI Ads Manager.
- Una chiave di licenza Pixel for ChatGPT Ads. La ricevi al momento dell'acquisto; i piani partono da un sito.
- Un server in grado di fare richieste HTTPS in uscita. Alcuni hosting e firewall le bloccano, ma l'acquisto lato server ne ha bisogno.
Da verificare
Passaggio 1 di 7
Recupera il Pixel ID
Il Pixel ID dice al Measurement Pixel a quale account ChatGPT Ads appartengono gli eventi. La documentazione di OpenAI indica di creare un nuovo Pixel ID nella scheda delle conversioni di Ads Manager (documentazione del Measurement Pixel, in inglese).
Il Pixel ID serve anche per il tracciamento lato server, perché fa parte dell'indirizzo dell'endpoint della Conversions API.
Risultato atteso
Errore frequente
Passaggio 2 di 7
Crea una chiave Conversions API
La chiave della Conversions API autorizza il tuo server a inviare eventi. OpenAI la genera nello stesso punto: secondo la documentazione, Pixel ID e chiave della Conversions API si ottengono entrambi dalla scheda delle conversioni di Ads Manager (documentazione della Conversions API).
Tratta la chiave API come una password
OpenAI è esplicita: gli eventi lato server vanno inviati esclusivamente dal tuo server. Il plugin salva la chiave per l'uso lato server e non la stampa nella pagina.
Risultato atteso
Errore frequente
Passaggio 3 di 7
Installa il plugin
- 1Scarica lo ZIP del plugin dalla conferma d'acquisto, oppure dalla pagina di download (in inglese) con la tua chiave di licenza.
- 2In WordPress vai su
Plugin → Aggiungi plugin → Carica plugin, scegli lo ZIP e fai clic suInstalla ora. - 3Attiva il plugin con
Attiva plugin.
Risultato atteso
Passaggio 4 di 7
Attiva la licenza
Apri la scheda Licence del plugin, incolla la chiave di licenza e attivala. Finché la licenza non è attiva non parte nessun evento.
Risultato atteso
Errore frequente
Passaggio 5 di 7
Collega le credenziali
Nella scheda Settings del plugin:
- Incolla il Pixel ID nel campo
OpenAI Pixel ID. - Incolla la chiave nel campo
Conversions API key. - Lascia attivo il tracciamento nel browser per inviare dalla pagina visualizzazioni di prodotto, aggiunte al carrello, inizi di checkout e acquisti.
- Lascia attivo il tracciamento lato server per inviare ogni ordine pagato tramite la Conversions API.
- Se il banner dei cookie implementa la WordPress Consent API, attiva la gestione del consenso, così il pixel aspetta il consenso marketing.
Le impostazioni di collegamento del plugin in WordPress (interfaccia in inglese).
- 1OpenAI Pixel ID: quello del passaggio 1.
- 2Conversions API key: quella del passaggio 2.
- 3Interruttori del tracciamento nel browser e lato server: lasciali entrambi attivi.
Risultato atteso
Da verificare
Passaggio 6 di 7
Verifica gli eventi del browser
- 1Apri il negozio in una finestra in incognito e accetta i cookie di marketing se compare un banner.
- 2Apri gli strumenti per sviluppatori del browser e vai alla scheda Rete.
- 3Filtra le richieste per
openai. Dovresti vedere lo script del Measurement Pixel caricato da un host openai.com. - 4Guarda un prodotto, aggiungilo al carrello e vai alla pagina di pagamento, osservando le nuove richieste che compaiono.
Risultato atteso
Errore frequente
Passaggio 7 di 7
Verifica un ordine pagato
Completa un ordine che WooCommerce segni come pagato (un vero ordine di basso importo, oppure un gateway di test che segna gli ordini come pagati). Poi apri la scheda Diagnostics del plugin e cerca l'ordine.
| Stato di invio | Cosa significa | Cosa fare |
|---|---|---|
| Accepted | OpenAI ha accettato l'acquisto. | Niente. Il tracciamento funziona. |
| Pending | In coda o in attesa di un nuovo tentativo. | Ricontrolla tra poco. |
| Not sent | L'acquisto non è stato inviato: di solito per quell'ordine manca il consenso marketing. | Apri l'ordine per vedere il motivo. |
| Failed | L'ultimo tentativo non è andato a buon fine. | Controlla il codice HTTP, risolvi la causa e, se l'ordine è idoneo, reinvialo. |
La diagnostica elenca gli ordini pagati e cosa è successo a ogni evento di acquisto.
- 1Trova l'ordine di prova dal suo numero.
- 2L'event ID è quello condiviso dall'acquisto inviato dal browser e da quello inviato dal server.
Risultato atteso
Da verificare
Risoluzione dei problemi
Errori frequenti
Quasi tutti i problemi di installazione rientrano in uno di questi cinque casi.
| Sintomo | Causa probabile | Soluzione |
|---|---|---|
| Le conversioni sembrano raddoppiate | Il pixel è installato anche nel tema o in un tag manager. | Rimuovi l'altra copia. |
| Failed con HTTP 401 | La chiave della Conversions API è stata rifiutata. | Incolla una chiave valida, poi reinvia da Diagnostics. |
| Resta Pending e continua a ritentare | Il server non riesce a raggiungere l'API. | Controlla HTTPS in uscita, firewall e regole del proxy. |
| Nessun evento dal browser | Consenso non dato, tracciamento spento o pagina in cache non aggiornata. | Dai il consenso, controlla le impostazioni, svuota la cache. |
| Ordini in stato Not sent | Per quegli ordini non risulta il consenso marketing. | Comportamento previsto con la gestione del consenso attiva. |
La sezione sulla risoluzione dei problemi della documentazione copre altri casi.
Senza plugin
Installarlo a mano
Il pixel si può installare anche senza plugin. Su WooCommerce, però, lo snippet è solo l'inizio.
Le istruzioni di OpenAI chiedono di aggiungere il suo snippet nel <head> di ogni pagina in cui vuoi rilevare conversioni. Dopodiché:
- Ogni evento (prodotto visto, aggiunta al carrello, checkout, acquisto) va programmato con i valori di WooCommerce.
- L'evento di acquisto deve partire una volta per ordine, non a ogni caricamento della pagina di conferma dell'ordine.
- Un acquisto lato server richiede un suo client API, attivato dallo stato pagato.
- Acquisto dal browser e acquisto dal server devono avere lo stesso event ID per essere deduplicati.
- Gli errori richiedono nuovi tentativi e un posto dove vederli.
La guida alla Conversions API di OpenAI per WooCommerce approfondisce tutta la parte lato server.
Domande
Servono sia il Pixel ID sia la chiave API?
Il Pixel ID serve per tutto. La chiave API serve per l'acquisto lato server. Tracciamento nel browser e lato server si possono spegnere separatamente, ma tenerli entrambi attivi dà all'acquisto un secondo canale che non dipende dal browser.
Il plugin ha bisogno di Google Tag Manager?
No. Carica il pixel e costruisce gli eventi direttamente da WooCommerce.
Cambiare tema interrompe il tracciamento?
No: non si tocca nessun template, quindi cambiare tema non rimuove il pixel. Se il checkout è molto personalizzato, conviene comunque ripetere la prova con un ordine.
Funziona con HPOS?
Sì. Sono supportati sia WooCommerce High-Performance Order Storage sia l'archiviazione classica degli ordini.
Pronto a installarlo?
Pixel for ChatGPT Ads è una licenza annuale per 1, 5 o 25 siti, con le stesse funzionalità in ogni piano.
Guide correlate
- Il pixel di ChatGPT Ads per WooCommerceCosa invia il plugin a ChatGPT Ads da un negozio WooCommerce, come si configura e cosa non fa.
- Conversions API di OpenAI per WooCommerce: inviare gli acquisti lato serverQuando e come un acquisto WooCommerce viene inviato lato server, e cosa il tracciamento lato server non risolve.
- Pixel di ChatGPT Ads o Conversions API: quale serve al tuo negozio?Il confronto tra misurazione nel browser e lato server per ChatGPT Ads, e perché un negozio usa entrambe.