Configurare Kliq significa compilare due campi, non modificare il tema. Ecco esattamente cosa fa ogni passaggio, così sai cosa controllare prima di andare avanti.
Prima di iniziare
Ti servono un negozio Shopify e un account OpenAI Ads Manager (ads.openai.com) con un pixel attivo. Se non ne hai ancora creato uno, fallo prima di tutto — Kliq inoltra gli eventi tramite il tuo pixel e la tua chiave Conversions API, mai tramite un account controllato da Kliq.
Passaggio 1: recupera il tuo ID pixel e la chiave Conversions API
Nel tuo account OpenAI Ads Manager, trova l’ID del tuo pixel e genera una chiave Conversions API. Tienili a portata di mano: li incollerai una sola volta, e Kliq cifra la chiave a riposo.
Passaggio 2: incollali nella schermata di configurazione di Kliq
Apri Kliq dal tuo admin Shopify e vai su Setup. Incolla l’ID pixel e la chiave Conversions API, poi salva. Il salvataggio fa automaticamente una cosa: crea il Web Pixel sul tuo negozio tramite l’API propria di Shopify. Non c’è codice tema da aggiungere né alcuna sezione da trascinare — la scheda Pixel nella dashboard passa ad “Active” non appena questo si completa.
Passaggio 3: guarda arrivare i primi eventi
Naviga sul tuo negozio — guarda un prodotto, aggiungilo al carrello. In circa un minuto, la striscia di stato della dashboard dovrebbe mostrare conteggi di visualizzazioni pagina e visualizzazioni prodotto sotto la fonte “browser”. Se dopo qualche minuto non appare nulla, controlla prima che il Web Pixel risulti attivo in Setup prima di indagare oltre.
Passaggio 4: invia un evento di test
Setup ha un pulsante “Send test event”. Pubblica un evento contrassegnato come test usando la tua chiave; una risposta riuscita appare come accettata, e un fallimento mostra il testo di risposta proprio di OpenAI, così sai esattamente cosa correggere — una chiave sbagliata, un pixel inattivo o un campo malformato.
Passaggio 5: conferma gli eventi ordine, non solo quelli di navigazione
Effettua un ordine reale o di test (oppure attendi il tuo primo ordine reale). Dovrebbero succedere due cose: l’evento di checkout completato del pixel da browser, se il browser era ancora aperto e collaborativo, e il webhook orders/create di Shopify, che si attiva comunque. Entrambi portano lo stesso ID evento per quell’ordine, quindi OpenAI lo conta una volta sola. Basta uno solo dei due percorsi perché l’ordine appaia correttamente — l’app non li richiede entrambi.
Passaggio 6: attiva il feed prodotti (ogni piano, incluso Free)
Una volta che gli eventi fluiscono, attivare il feed costruisce in circa un minuto un file in formato Google dai tuoi prodotti e varianti, servito su un URL privato che puoi scaricare oppure consegnato via SFTP alla posizione indicata dal tuo Ads Manager. Si ricostruisce da solo ogni giorno, e di nuovo entro 10 minuti da una modifica al prodotto. Tagga un prodotto con kliq-exclude per escluderlo del tutto dal feed, o con kliq-no-ads per tenerlo nel feed ma segnato come non idoneo per gli annunci.
Passaggio 7: apri il report sui ricavi (Growth e Pro)
Con eventi e ordini che fluiscono, Revenue mostra ordini attribuiti, ricavi, valore medio dell’ordine e i migliori prodotti degli ultimi 7, 30 o 90 giorni, con esportazione CSV. Concedigli un giorno o due di traffico reale prima di valutare la percentuale abbinata — un’installazione appena fatta non avrà ancora molta cronologia.
Se qualcosa non torna
Setup mantiene un log di debug continuo dei tuoi eventi più recenti con il relativo stato di consegna, così vedi esattamente quali sono andati a buon fine, quali sono falliti e perché — senza dover prima controllare il tuo account OpenAI.
Kliq è un’app indipendente e non è affiliata, sostenuta né sponsorizzata da OpenAI. «ChatGPT» e «OpenAI» sono marchi di OpenAI. Le cifre di attribuzione sono calcolate a partire dagli eventi ricevuti dall’app e possono differire dall’Ads Manager.
Capyo è un'app indipendente e non è affiliata, sostenuta né sponsorizzata da OpenAI. «ChatGPT» e «OpenAI» sono marchi di OpenAI. Le cifre di attribuzione sono calcolate a partire dagli eventi ricevuti dall'app e possono differire dall'Ads Manager.