Widget di raccomandazione sul sito
Un widget è un blocco di prodotti pronto per il sito: «Potrebbe interessarLe anche» nella home page, «Acquistati insieme» nella scheda prodotto, «Visti di recente» nel carrello. Lo si configura in OneTrace.pro e si inserisce nel sito un breve codice una sola volta. In seguito tipo, aspetto, regole di visualizzazione e attivazione si modificano senza intervenire sul sito.
Per funzionare servono il tracker installato (Collegamento del sito), un catalogo prodotti e gli eventi di visualizzazione, carrello e acquisto (Raccomandazioni e catalogo prodotti). Creare e modificare i widget possono «Proprietario», «Amministratore» e «Manager»; gli altri vedono impostazioni e statistiche senza poter salvare.
Elenco dei widget
Apra Sito → Widget. La scheda di ogni widget mostra lo stato, le statistiche degli ultimi 30 giorni, il confronto delle varianti, se presenti, e il codice per il sito.

L'interruttore Mostra sul sito web disattiva il widget senza modificare il sito: lo stato diventa «In pausa» e il blocco sulla pagina viene svuotato. Riattivandolo, i prodotti ricompaiono. Il pulsante con il cestino elimina definitivamente il widget.
Per creare un widget, faccia clic su Crea widget. Per modificarlo, faccia clic sul nome o sul pulsante con la matita. Entrambe le azioni aprono la pagina dell'editor.
Editor del widget
A sinistra ci sono le impostazioni, divise in quattro sezioni: Prodotti, Aspetto, Mostra e Varianti. A destra c'è l'anteprima, che disegna il widget come sul sito, con i prodotti reali del Suo catalogo. Se una sezione contiene un errore, accanto al suo nome compare un segno. Faccia clic su Salva: le modifiche saranno visibili sul sito al successivo caricamento della pagina, senza cambiare il codice. Se lascia la pagina con modifiche non salvate, il browser La avvisa.

Il selettore Desktop / Telefono sopra l'anteprima mostra entrambi i layout. Sul sito il layout si adatta alla larghezza dello spazio disponibile, non dello schermo: in una colonna stretta il widget appare come sul telefono. Il widget eredita dal sito il carattere e il colore del testo, se non ne imposta di propri.
Prodotti
| Campo | Cosa definisce |
|---|---|
| Nome | nome del widget; visibile solo nel pannello di amministrazione |
| Cosa mostrare | tipo di raccomandazioni: Personali, Popolari, Di tendenza, Visti insieme, Acquistati insieme, Simili, Visti di recente, È ora di riacquistare |
| Categoria | per i prodotti popolari e di tendenza: id della categoria del catalogo; vuoto significa l'intero catalogo |
| Prodotti in totale | da 1 a 24 |
| Prodotto per l’anteprima | per «Visti insieme», «Acquistati insieme» e «Simili»: id del prodotto su cui si basa l'anteprima; vuoto significa il primo prodotto disponibile |
Se non ci sono prodotti adatti, l'anteprima mostra dei segnaposto grigi per valutare l'aspetto.
Aspetto
| Campo | Cosa definisce |
|---|---|
| Titolo | testo sopra i prodotti, ad esempio «Potrebbe interessarLe anche» |
| Pulsante | testo del pulsante nella scheda, ad esempio «Scopri di più»; vuoto significa nessun pulsante |
| Layout | Griglia o Carosello con scorrimento |
| Schede per riga | da 1 a 8 |
| Mostra il prezzo | prezzo nella scheda |
| Stili predefiniti | «Come sul sito», «Schede», «Minimal», «Contrasto»: compilano i campi dell'aspetto, che poi si possono modificare |
| Cosa mostra la scheda | brand, prezzo precedente, badge di sconto, bordo e ombra della scheda |
| Proporzioni dell'immagine e Immagine | 1:1, 3:4 o 4:3; immagine intera oppure che riempie lo spazio ritagliando i bordi |
| Colori | accento, sfondo della scheda, sfondo dell'immagine, testo, prezzo, pulsante e testo del pulsante; senza colore si usa quello del sito, e lo sfondo dell'immagine è bianco |
| Dimensione del testo, Dimensione del titolo, Titolo | dimensioni in percentuale rispetto al carattere del sito e allineamento del titolo |
| Raggio degli angoli, Spazio tra le schede, Spaziatura interna della scheda | in pixel |
| Frecce del carosello | pulsanti di scorrimento ai lati del carosello |
| Telefono | schede per riga su schermi stretti (da 1 a 3) e un layout proprio, ad esempio un carosello al posto della griglia |
| CSS personalizzato | regole per le classi del widget: .cdp-rec__name, .cdp-rec__price, .cdp-rec__button e altre |
Il CSS personalizzato agisce solo all'interno di questo widget e non modifica il resto della pagina. Non può caricare risorse esterne: @import, url() e costrutti simili vengono rifiutati al salvataggio.
Se il progetto ha più lingue, sopra il titolo compare il selettore Lingua dei testi. Nella lingua predefinita si compilano Titolo e Pulsante, nelle altre lingue le loro traduzioni; un campo vuoto mostra il testo della lingua predefinita. Il visitatore vede titolo e pulsante nella propria lingua, quella che il tracker invia al profilo (Lingua del cliente); senza traduzione, nella lingua predefinita. I prezzi sono mostrati nel formato della lingua del visitatore.
Stile da un'immagine
Il pulsante Stile da un’immagine nella sezione Aspetto sceglie l'aspetto a partire da uno screenshot con le schede dei prodotti, del Suo sito o di un sito che Le piace.
- Faccia clic su Stile da un’immagine.
- Trascini l'immagine, la incolli dagli appunti (Ctrl+V) o scelga un file: PNG, JPEG o WebP fino a 3 MB.
- Se il widget ha delle varianti, scelga a quale applicare lo stile.
- Faccia clic su Riprendi lo stile.
L'IA compila colori, dimensioni, arrotondamenti, layout e ciò che la scheda mostra, e quello che le impostazioni non prevedono lo aggiunge in CSS personalizzato. Ogni valore viene verificato come nell'inserimento manuale e quelli non validi vengono scartati. Il risultato è una bozza: controlli l'anteprima e salvi, oppure faccia clic su Ripristina.

L'immagine non viene salvata. L'analisi è pagata dal saldo del progetto in base al consumo effettivo; se il saldo non basta o l'IA non è inclusa nel piano, il pulsante non è disponibile e sotto è indicato il motivo.
Mostra

| Campo | Cosa definisce |
|---|---|
| Mostra sul sito web | attivazione del widget, come nell'elenco |
| Solo nelle pagine e Tranne le pagine | indirizzi delle pagine senza dominio, uno per riga; * indica qualsiasi carattere, ad esempio /catalog/*. Vuoto significa tutte le pagine |
| Dispositivi | tutti, solo computer o solo telefoni |
| Visitatori | tutti, solo nuovi o solo di ritorno |
| Solo ai membri dei segmenti e Tranne i membri dei segmenti | segmenti del visitatore; l'appartenenza viene verificata sul profilo a ogni visualizzazione |
Le regole vengono verificate dal server a ogni caricamento del widget. Fuori dalle regole lo spazio sulla pagina resta vuoto e il layout non si rompe. Le regole sono le stesse dei moduli di iscrizione.
Qui si trova anche il Codice per il sito web, descritto più avanti.
Varianti
Le varianti servono a verificare quale titolo, tipo di raccomandazioni o aspetto porta più clic e acquisti. Le impostazioni principali del widget sono la variante A. Con Aggiungi variante può aggiungere fino a tre varianti: B, C e D. In ognuna può cambiare:
- il tipo di raccomandazioni, Cosa mostrare;
- Titolo e Pulsante con le traduzioni;
- il layout e tutto l'aspetto.
I campi vuoti vengono ripresi dalla variante A.

I visitatori sono ripartiti in parti uguali tra le varianti e ogni visitatore vede sempre la stessa variante. Il selettore sopra l'anteprima mostra la variante scelta. I risultati del confronto sono nelle statistiche sotto l'editor.
Visualizzare sul proprio sito
Il pulsante Visualizzi sul Suo sito web sopra l'anteprima apre una pagina del Suo sito con il widget così come è stato salvato. Indichi l'indirizzo di una pagina in cui è inserito il codice del widget, scelga la variante e faccia clic su Apri.
In questo modo il widget è visibile anche se è disattivato o se la pagina non rientra nelle regole di visualizzazione. Impressioni e clic in questa modalità non entrano nelle statistiche. Il link è valido 24 ore; finché la scheda del browser resta aperta, la modalità di anteprima rimane attiva anche passando ad altre pagine del sito. Le modifiche non salvate non sono visibili sul sito: salvi prima.
Codice per il sito web
Il codice del widget si trova nella sua scheda dell'elenco e nella sezione Mostra dell'editor. Lo inserisca nel modello della pagina nel punto in cui deve comparire il blocco:
<div data-cdp-widget="a1b2c3d4e5f6" data-item="SKU-1"></div>
Attributi:
data-item: id del prodotto della pagina o dei prodotti del carrello separati da virgola:data-item="SKU-1,SKU-7". È obbligatorio per i tipi «Visti insieme», «Acquistati insieme» e «Simili»: lo inserisca dal modello della pagina.data-category: id della categoria per i prodotti popolari, se su pagine diverse servono categorie diverse.data-exclude: id dei prodotti, separati da virgola, da non mostrare, ad esempio quelli già nel carrello.
I prodotti personali e visti di recente vengono selezionati in base al visitatore, quindi non serve data-item.
Se non ci sono prodotti adatti, lo spazio sulla pagina resta vuoto e il layout non si rompe.
Statistiche
Sotto l'editor si trovano le statistiche del widget per 7, 30 o 90 giorni: totali, grafico giornaliero e confronto delle varianti. Sopra il grafico scelga l'indicatore: impressioni, clic, CTR o ricavi. Se il widget ha delle varianti, ognuna ha la propria linea nel grafico.

| Indicatore | Come viene calcolato |
|---|---|
| Impressioni | il widget è entrato nel campo visivo del visitatore almeno per metà. Il caricamento della pagina senza scorrere fino al blocco non viene conteggiato, per cui il CTR di un widget in fondo alla pagina è attendibile |
| Clic | clic sulle schede dei prodotti |
| CTR | clic divisi per impressioni |
| Acquisti | acquisti del prodotto da parte dello stesso cliente entro 7 giorni dal clic su di esso; nel grafico, nel giorno del primo clic |
| Ricavi | importo di questi acquisti |
I giorni sono calcolati in UTC. Impressioni e clic durante la visualizzazione sul proprio sito non vengono conteggiati.
La tabella delle varianti riporta impressioni, clic, CTR, acquisti e ricavi di ciascuna variante. Sotto c'è la valutazione dei clic e degli acquisti per impressione: quale variante è migliore e se i dati sono già sufficienti per fidarsi del risultato. Finché i dati sono pochi, la valutazione lo dice: attenda, invece di scegliere una variante per una differenza casuale.
L'effetto complessivo delle raccomandazioni sul sito per tipo si trova nella sezione Raccomandazioni.
Siti a pagina singola
Il tracker trova da solo i widget dopo il caricamento della pagina, quando compaiono nuovi elementi e quando cambia data-item. Per questo, sui siti in React, Vue e simili, basta modificare l'attributo: il blocco verrà ridisegnato.
Se occorre aggiornare i prodotti senza modificare gli attributi, ad esempio dopo una modifica del carrello, chiami:
cdp.widgets({ force: true });
Codice proprio al posto del widget
Gli sviluppatori possono visualizzare un blocco di raccomandazioni dal codice, senza configurarlo nel pannello di amministrazione:
window.addEventListener('load', () => {
cdp.renderRecommendations('#recs', {
type: 'viewed_with', item: 'SKU-1', title: 'Visti insieme', layout: 'carousel', columns: 4,
});
});
Il blocco ha lo stesso aspetto del widget e impressioni e clic vengono conteggiati automaticamente. Può chiamarlo anche prima del caricamento del tracker: la chiamata attende in coda. L'elemento deve essere già nella pagina, per questo l'esempio attende l'evento load. Un risultato vuoto svuota l'elemento. L'aspetto si imposta con le stesse opzioni dei widget del pannello di amministrazione, ad esempio imageRatio: '4:3', imageFit: 'cover', imageBackground: 'transparent', background: '#111827', textColor: '#f9fafb'; imageBackground è un colore o transparent. Regole di visualizzazione e varianti sono disponibili solo nei widget del pannello di amministrazione.