# DataFirefly Cross-selling nel carrello: suggerimenti di prodotti nel carrello PrestaShop
> Panoramica DataFirefly Cross-selling nel carrello mostra suggerimenti di prodotti nella pagina carrello, nella finestra di aggiunta al carrello e nel carrello vuoto. Il cliente aggiunge un suggerimento in un clic,…
- Pagina:
- Lingua: it
- Aggiornato il: 2026-11-02
- Altre lingue: [en](https://www.datafirefly.com/en/documentation/dfcartcrosssell/index.md), [fr](https://www.datafirefly.com/documentation/dfcartcrosssell/index.md), [es](https://www.datafirefly.com/es/documentation/dfcartcrosssell/index.md), [de](https://www.datafirefly.com/de/documentation/dfcartcrosssell/index.md), [pl](https://www.datafirefly.com/pl/documentation/dfcartcrosssell/index.md), [nl](https://www.datafirefly.com/nl/documentation/dfcartcrosssell/index.md), [pt](https://www.datafirefly.com/pt/documentation/dfcartcrosssell/index.md)
- Indice:
## Panoramica
DataFirefly Cross-selling nel carrello mostra suggerimenti di prodotti nella **pagina carrello**, nella **finestra di aggiunta al carrello** e nel **carrello vuoto**. Il cliente aggiunge un suggerimento in un clic, sceglie la combinazione direttamente nella scheda e il carrello si aggiorna senza ricaricare la pagina.
I suggerimenti provengono prima dalle tue **regole**, poi dalle **fonti automatiche**: prodotti correlati, spesso acquistati insieme, stessa categoria, stessa marca, stesse caratteristiche, più venduti, nuovi prodotti e prezzo simile. Una regola può ridurre il prezzo dei suoi prodotti finché il carrello contiene un prodotto che la attiva.
Il modulo funziona da PrestaShop 1.7.8 a 9.x con PHP da 7.1 a 8.5, con i temi Classic e Hummingbird. È tradotto in inglese, francese, spagnolo, tedesco, italiano, polacco, olandese e portoghese.
## Installazione e aggiornamento
1. In **Moduli > Gestione moduli**, fai clic su **Carica un modulo** e trascina il file `dfcartcrosssell-2.0.0.zip`.
2. Fai clic su **Configura** per aprire la pagina del modulo con le sue quattro schede: Dashboard, Regole, Impostazioni e Strumenti.
L'installazione costruisce l'indice «spesso acquistati insieme» a partire dagli ordini già presenti, quindi questa fonte funziona fin dalla prima visita.
Aggiornamento dalla versione 1.0: carica lo zip 2.0.0 sopra il vecchio modulo. Impostazioni e statistiche vengono conservate, i bundle della 1.0 diventano regole e la cache dei file JS/CSS combinati viene svuotata. Lo sconto «bundle» della 1.0 non è mai stato applicato ai carrelli: ora gli sconti passano dalle offerte delle regole.
## Dove compaiono i suggerimenti
### Pagina carrello
Per impostazione predefinita il blocco compare sotto i prodotti del carrello, come carosello, griglia o elenco compatto. Sopra di esso, il blocco **spesso acquistati insieme** elenca i prodotti ordinati spesso con quelli del carrello, con caselle di selezione, scelta della combinazione, totale reale dei prodotti selezionati e un pulsante per aggiungerli tutti.
Pagina carrello con il blocco spesso acquistati insieme e il carosello di suggerimenti con prezzi in offerta
Puoi anche collocare il blocco nella colonna del riepilogo dell'ordine: in questo caso diventa un elenco compatto di massimo 4 prodotti.
### Finestra di aggiunta al carrello
Quando un cliente aggiunge un prodotto da qualsiasi pagina, la finestra di conferma mostra suggerimenti per quel prodotto. Aggiungendone uno, la finestra resta aperta, il contatore del carrello si aggiorna e il nuovo totale viene annunciato ai lettori di schermo.
Finestra di conferma dell'aggiunta al carrello con suggerimenti per il prodotto appena aggiunto
### Carrello vuoto
Un carrello vuoto mostra i tuoi prodotti più venduti, così la pagina non è mai un vicolo cieco.
Pagina del carrello vuoto con i prodotti più venduti del negozio
### Mobile
Su mobile il carosello si scorre con il dito e la scheda successiva si intravede per invitare allo scorrimento. Frecce, navigazione da tastiera e scorrimento automatico facoltativo sono disponibili su desktop; lo scorrimento automatico si ferma al passaggio del mouse, al focus e se il visitatore preferisce ridurre le animazioni.
Carosello di suggerimenti su mobile
## Aggiunta al carrello in un clic
Ogni scheda mostra il prezzo, il prezzo normale quando è scontato, il badge di sconto o di offerta, la marca e, se il modulo Commenti prodotti è attivo, la valutazione media reale delle recensioni approvate. I prodotti con combinazioni hanno un menu a tendina nella scheda: il prezzo segue la combinazione scelta e le combinazioni non disponibili sono disattivate in grigio.
Il pulsante di aggiunta invia una richiesta verificata dal server: il prodotto deve essere attivo, visibile, ordinabile, disponibile a magazzino (salvo se gli ordini di prodotti esauriti sono consentiti), senza personalizzazione obbligatoria e accessibile al gruppo del cliente. Il modulo attiva poi l'aggiornamento del carrello del tema: totali, anteprima del carrello e il blocco stesso si aggiornano senza ricaricare la pagina, con uno scheletro di caricamento mentre i suggerimenti vengono ricalcolati.
Aggiunta al carrello in un clic con scelta della combinazione
## Regole
Le regole scelgono i prodotti da suggerire per determinati carrelli. Sono mostrate prima dei suggerimenti automatici, dalla priorità più alta alla più bassa. L'elenco mostra le condizioni di attivazione, i prodotti suggeriti, l'offerta, la priorità, lo stato (attiva, inattiva, programmata, scaduta) e le aggiunte e il fatturato degli ultimi 30 giorni.
Elenco delle regole di cross-selling con attivatori, prodotti suggeriti, offerte, priorità e stato
### Creare una regola
1. **Quando il carrello contiene**: prodotti, categorie (sottocategorie incluse) o valori di caratteristica. Lascia tutto vuoto per applicare la regola a tutti i carrelli. È possibile aggiungere un importo minimo del carrello.
2. **Suggerisci**: prodotti nell'ordine scelto, categorie o valori di caratteristica (vengono usati i prodotti più venduti).
3. **Offerta** (facoltativa): una percentuale o un importo IVA inclusa sui prodotti suggeriti elencati nella regola.
4. **Opzioni**: priorità da 0 a 100, mostra solo i prodotti di questa regola, date di inizio e fine, gruppi di clienti e un titolo del blocco specifico in ogni lingua.
L'anteprima a destra mostra le schede esattamente come le vedranno i clienti, con i prezzi in offerta.
Editor della regola
### Regole basate sulle caratteristiche dei prodotti
Una regola può essere attivata da valori di caratteristica (ad esempio _Collezione: Citazioni ispiranti_) e suggerire prodotti con altri valori (ad esempio _Composizione: Ceramica_). Cerca un valore con _Caratteristica: valore_; per ogni valore viene indicato il numero di prodotti.
Regola di cross-selling per caratteristiche
### Offerte
Un'offerta riduce il prezzo di un prodotto suggerito finché il carrello contiene anche **un altro** prodotto che attiva la regola. Viene calcolata dal server e applicata con un prezzo specifico limitato a quel carrello: nulla di ciò che invia il browser può modificarla. Viene verificata di nuovo a ogni modifica del carrello e rimossa non appena il carrello non soddisfa più la condizione. Le promozioni del catalogo esistenti vengono mantenute: l'offerta si applica al prezzo già scontato.
Suggerimenti di una regola con il proprio titolo e un'offerta a importo per un carrello con tè
Un'offerta si applica a tutte le unità del prodotto presenti nel carrello. Disattiva **Offerte delle regole** nelle impostazioni per fermare tutte le offerte in una volta.
## Suggerimenti automatici e caratteristiche dei prodotti
Ogni fonte automatica ha un peso da 0 (disattivata) a 10. I prodotti trovati da più fonti ottengono un punteggio più alto. La fonte **Stesse caratteristiche** suggerisce i prodotti che condividono più valori di caratteristica con il carrello; puoi limitarla ad alcune caratteristiche.
Peso delle fonti automatiche
DataFirefly Tag in caratteristiche trasforma i tag dei prodotti in caratteristiche native. Il cross-selling legge queste caratteristiche in tempo reale, senza alcuna impostazione: appena i tag sono convertiti, la fonte «stesse caratteristiche» e le regole per caratteristiche li usano subito.
I prodotti inattivi, invisibili e non disponibili, quelli con personalizzazione obbligatoria e quelli delle categorie nascoste al gruppo del cliente non vengono mai suggeriti. In **Filtri ed esclusioni** puoi anche nascondere i prodotti esauriti, quelli già nel carrello e prodotti o categorie specifici.
## Visualizzazione e aspetto
La scheda Impostazioni raccoglie la posizione nel carrello, il layout, il numero di prodotti, i titoli in ogni lingua, la finestra di aggiunta al carrello, il carrello vuoto, il blocco acquistati insieme, il contenuto delle schede, quattro stili di scheda, il colore d'accento (o i colori del tuo tema), l'arrotondamento degli angoli e l'ombra. In multinegozio le impostazioni vengono salvate per negozio.
Impostazioni di visualizzazione
## Dashboard
La dashboard mostra solo i dati registrati dal modulo sul tuo negozio: visualizzazioni del blocco, clic sui prodotti, aggiunte al carrello, tasso di aggiunta, ordini con un prodotto suggerito e **fatturato aggiuntivo**, cioè il totale IVA esclusa delle righe d'ordine dei prodotti aggiunti dal blocco, negli ordini validi. Confronta inoltre l'ordine medio con e senza prodotto suggerito, e ogni dato con il periodo precedente.
Dashboard del cross-selling
Le tabelle suddividono visualizzazioni, aggiunte, tasso e fatturato per fonte e per posizione (pagina carrello, finestra, carrello vuoto, blocco acquistati insieme) ed elencano i prodotti più performanti.
Rendimento dei suggerimenti per fonte e posizione
## Strumenti
Il **simulatore di carrello** mostra i suggerimenti per qualsiasi elenco di prodotti, con la fonte, la regola e il punteggio di ciascuno: il modo più rapido per verificare una regola o i pesi.
Simulatore di carrello
- **Indice «spesso acquistati insieme»**: aggiornato a ogni ordine; ricostruiscilo dopo un'importazione di ordini o una modifica della durata dello storico.
- **Attività pianificata** (facoltativa): richiama l'URL una volta al giorno per ricostruire l'indice e pulire i vecchi dati. Senza di essa, la pulizia viene eseguita automaticamente al massimo una volta al giorno.
- **Manutenzione**: numero di carrelli con un'offerta attiva ed eliminazione delle statistiche.
## Sicurezza e privacy
- L'aggiunta al carrello richiede una richiesta POST con il token del negozio; prezzi e quantità inviati dal browser vengono ignorati.
- Visualizzazioni e clic sono firmati dal server, quindi le statistiche falsificate vengono rifiutate.
- Le statistiche non contengono dati personali: contatori giornalieri per prodotto e l'ID del carrello solo per collegare un'aggiunta al relativo ordine.
- La disinstallazione elimina le tabelle, le impostazioni e le offerte sui carrelli del modulo.
## Risoluzione dei problemi
### Il blocco non compare
Verifica che **Mostra i suggerimenti** sia attivo, che la posizione nel carrello non sia impostata su _Non nella pagina carrello_ e che ci siano prodotti suggeribili: il simulatore di carrello mostra perché un elenco è vuoto.
### Dopo l'aggiornamento viene ancora caricato il vecchio script
L'aggiornamento svuota la cache dei file combinati. Se una cache del server o una CDN conserva una vecchia copia, svuota anche quella.
### Un'offerta non viene applicata
Il carrello deve contenere un altro prodotto che attiva la regola, la regola deve essere attiva e nel periodo di validità e l'offerta deve dare un prezzo inferiore a quello attuale.