OneTrace.pro Centro assistenza

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.

Pagina «Widget di raccomandazione»: elenco dei widget con statistiche e 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.

Editor del widget: sezione «Prodotti» e anteprima

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.

  1. Faccia clic su Stile da un’immagine.
  2. Trascini l'immagine, la incolli dagli appunti (Ctrl+V) o scelga un file: PNG, JPEG o WebP fino a 3 MB.
  3. Se il widget ha delle varianti, scelga a quale applicare lo stile.
  4. 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.

Stile da uno screenshot

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

Sezione «Visualizzazione»: regole, attivazione e codice per il sito

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.

Sezione «Varianti»: variante B con titolo e aspetto diversi

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.

Statistiche del widget: totali, grafico giornaliero e confronto delle varianti

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.