Vai al contenuto

FAQ

Domande frequenti sul tracciamento di ChatGPT Ads su WooCommerce

Cosa fa il plugin, cosa non fa e come funzionano le licenze. Se manca qualcosa, scrivici.

Prodotto

Che cos'è Pixel for ChatGPT Ads?

È un plugin WooCommerce che implementa il tracciamento delle conversioni per ChatGPT Ads. Carica l'OpenAI Measurement Pixel nel browser e invia gli eventi di acquisto lato server tramite la OpenAI Conversions API, usando i dati degli ordini WooCommerce.

Un negozio WooCommerce può tracciare le conversioni di ChatGPT Ads?

Sì. ChatGPT Ads misura le conversioni con l'OpenAI Measurement Pixel nel browser e con la OpenAI Conversions API sul server. A un negozio WooCommerce serve qualcosa che invii a queste due interfacce i dati di prodotti, carrello, checkout e ordini, con event ID corrispondenti.

Pixel for ChatGPT Ads è un plugin WooCommerce che fa proprio questo: invia quattro eventi dal browser e un evento di acquisto lato server, costruiti con i dati di WooCommerce, senza codice personalizzato.

Come si installa il pixel di ChatGPT Ads su WooCommerce?

Con questo plugin: caricalo e attivalo in WordPress, attiva la chiave di licenza, poi incolla il Pixel ID di OpenAI e la chiave della Conversions API nella schermata delle impostazioni. È il plugin a caricare il Measurement Pixel sul negozio, quindi non c'è nessuno snippet da incollare nel tema.

La guida all'installazione passo passo spiega anche come verificare che gli eventi del browser e l'acquisto lato server arrivino davvero.

Serve uno sviluppatore per configurarlo?

No. L'installazione è il normale caricamento e l'attivazione di un plugin WordPress. La configurazione sta in una sola schermata, dove inserisci il Pixel ID di OpenAI, la chiave della Conversions API e la chiave di licenza.

Niente modifiche al tema, niente ritocchi ai template del checkout, nessun contenitore di tag manager da mantenere. Uno sviluppatore serve solo se il checkout è molto personalizzato o se c'è un sistema di cache da regolare.

È un plugin ufficiale di OpenAI?

No. Pixel for ChatGPT Ads è un prodotto indipendente, non affiliato a OpenAI né approvato da OpenAI. Si integra con le interfacce di misurazione pubblicitaria di OpenAI, ma non è sviluppato, verificato o certificato da OpenAI.

Tracciamento

Quali eventi vengono tracciati?

Prodotto visualizzato (contents_viewed), aggiunta al carrello (items_added) e checkout iniziato (checkout_started) partono dal browser. L'acquisto (order_created) parte dal browser e anche lato server tramite la Conversions API.

Supporta il tracciamento lato server?

Sì, per gli acquisti. Quando un ordine WooCommerce raggiunge uno stato pagato, order_created viene inviato dal tuo server alla OpenAI Conversions API.

Visualizzazioni di prodotto, aggiunte al carrello e inizi di checkout sono solo eventi del browser. Il sito non dichiara una copertura lato server per eventi che non vengono inviati lato server.

Tutti gli eventi vengono inviati lato server?

No. Solo l'acquisto (order_created) viene inviato lato server. Prodotto visualizzato, aggiunta al carrello e checkout iniziato partono solo dal browser, quindi dipendono dal fatto che il browser del visitatore carichi il pixel e, se la gestione del consenso è attiva, dal consenso marketing.

Cosa succede se un evento di acquisto lato server non va a buon fine?

Gli errori temporanei, come timeout, limiti di frequenza ed errori del server, vengono ritentati in automatico. Ogni tentativo viene registrato sull'ordine nella diagnostica, con il relativo codice HTTP.

Se l'invio continua a fallire, per esempio perché la chiave della Conversions API è stata rifiutata, l'ordine risulta Failed. Una volta risolta la causa, un ordine idoneo può essere reinviato a mano dalla stessa schermata.

Come funziona la deduplica tra browser e server?

L'evento del browser e l'evento del server per lo stesso ordine vengono inviati con lo stesso event ID. L'ID è ricavato dall'ordine WooCommerce invece di essere generato a ogni caricamento di pagina, quindi ricaricare la pagina di conferma dell'ordine non produce un secondo identificativo.

Far coincidere gli identificativi è compito del plugin; unire i due invii in una sola conversione spetta poi a OpenAI.

Usa l'OpenAI Measurement Pixel?

Sì. La misurazione nel browser è implementata con l'OpenAI Measurement Pixel, configurato con il Pixel ID che inserisci nelle impostazioni del plugin.

Supporta la OpenAI Conversions API?

Sì. Gli eventi di acquisto vengono inviati da server a server tramite la Conversions API, con la chiave API salvata nelle impostazioni del plugin. La chiave viene usata solo lato server e non viene mai esposta al browser.

Compatibilità

Serve Google Tag Manager?

No. Il plugin carica l'OpenAI Measurement Pixel e costruisce gli eventi direttamente da WooCommerce. Non c'è nessun contenitore di tag manager, data layer o snippet nel tema da mantenere.

Se il pixel di ChatGPT Ads è installato anche tramite un tag manager o uno snippet nel tema, rimuovilo: una seconda copia si attiva senza gli event ID del plugin e può generare doppi conteggi.

Funziona sui siti WordPress senza WooCommerce?

No. È un plugin per WooCommerce: ogni evento nasce da prodotti, carrelli, checkout e ordini di WooCommerce. Non traccia invii di moduli, iscrizioni, lead o altre conversioni estranee a WooCommerce.

Funziona con WooCommerce?

WooCommerce è la piattaforma per cui è stato creato. Gli eventi vengono composti a partire da prodotti, carrelli, checkout e ordini di WooCommerce, non da regole generiche sugli URL, quindi valori d'acquisto e identificativi dell'ordine arrivano dall'ordine stesso.

Supporta WooCommerce HPOS?

Sì. Il plugin è compatibile con WooCommerce High-Performance Order Storage e con l'archiviazione classica degli ordini basata sui post.

Licenze

Cosa succede quando la licenza scade?

Il nuovo tracciamento delle conversioni si ferma. Il plugin resta installato e le impostazioni vengono conservate, ma non parte nessun nuovo evento e terminano aggiornamenti e assistenza. Rinnovando la licenza tornano tutti e tre.

Posso spostare la licenza su un altro sito?

Sì. Una licenza ha un numero fisso di attivazioni, non un legame permanente con un dominio. Disattiva la licenza sul sito che lasci per liberare l'attivazione, poi attivala sul nuovo sito.

Le agenzie possono usarlo sui negozi dei clienti?

Sì. Growth copre fino a 5 attivazioni e Agency fino a 25. Ogni negozio cliente usa un'attivazione e i passaggi di configurazione sono gli stessi su tutti i negozi.

Come arrivano gli aggiornamenti?

Dalla normale schermata degli aggiornamenti di WordPress, come per qualsiasi altro plugin, finché la licenza è attiva.

Privacy

Funziona con i plugin di gestione del consenso?

Supporta la WordPress Consent API. Se il tuo plugin di gestione del consenso implementa questa API, gli eventi del browser possono restare bloccati finché non viene dato il consenso marketing, e lo stato di consenso registrato per un ordine viene usato per l'evento di acquisto lato server.

Gli strumenti di consenso che non implementano la WordPress Consent API non vengono rilevati automaticamente. I tuoi obblighi di conformità dipendono dal negozio, dalla configurazione e dalla giurisdizione.

Conservate i dati dei miei clienti?

Il plugin gira sul tuo sito WordPress e invia gli eventi di conversione dal tuo negozio direttamente a OpenAI. I dati degli ordini e dei visitatori non vengono inviati a noi.

Il sistema di licenze scambia solo la chiave di licenza e l'indirizzo del sito, per attivare, verificare e disattivare una licenza. Cosa riceve OpenAI dipende dagli eventi che attivi e dalla configurazione del consenso.

Pronto a configurarlo?

La documentazione copre installazione, credenziali, consenso e risoluzione dei problemi.