Smart Content – Documentazione

Panoramica

DataFirefly Smart Content personalizza i contenuti del tuo negozio PrestaShop in base al profilo, al comportamento, al carrello e al contesto di ogni visitatore. Il principio è semplice: definisci dei segmenti (pubblici) e poi delle campagne che associano un segmento a un contenuto HTML mostrato in una zona del tema. A ogni pagina, il modulo valuta il visitatore e mostra il contenuto della campagna a priorità più alta il cui segmento corrisponde.

Il modulo copre l’intero ciclo: segmentazione comportamentale, distribuzione multizona, A/B testing, statistiche di conversione e due assistenti IA (generazione di contenuti e suggerimento di segmenti).

Installazione

1. Inserisci la cartella dfsmartcontent nella directory /modules/ del tuo negozio, oppure installa lo ZIP da Moduli → Gestore moduli → Carica un modulo.
2. Clicca su Installa. Le tabelle e le schede di amministrazione vengono create automaticamente.
3. Compare un nuovo menu Smart Content, con quattro sottosezioni: Dashboard, Campagne, Segmenti e Impostazioni.

Configurazione delle impostazioni

Vai su Smart Content → Impostazioni. Lì sono disponibili due famiglie di parametri.

Parametri IA

• URL dell’endpoint IA: l’endpoint chat-completions (compatibile OpenAI / Mistral). Valore predefinito: https://api.mistral.ai/v1/chat/completions.
• Modello IA: ad esempio mistral-large-latest o gpt-4o-mini.
• Chiave API IA: la tua chiave, memorizzata lato server e mai esposta al front. Finché è vuota, le funzioni IA sono disattivate ma il resto del modulo funziona normalmente.

Privacy

• Rispettare il consenso ai cookie: attivo per impostazione predefinita. Le beacon di tracciamento (impressioni / clic) si attivano solo una volta rilevato il consenso.

Creare un segmento

Un segmento è un pubblico definito da una o più regole. Vai su Smart Content → Segmenti → Aggiungi segmento.

• Nome: un’etichetta interna (es. «Clienti VIP»).
• Logica di corrispondenza: Tutte le regole (E) richiede che ogni regola sia vera; Qualsiasi regola (O) basta che una lo sia.
• Priorità: i segmenti a priorità più alta vengono valutati per primi.
• Regole: aggiungi le tue condizioni riga per riga con il costruttore visuale.

Riferimento delle regole

Ogni regola ha un attributo, un operatore e un valore. Per gli elenchi, separa i valori con virgole. Per gli intervalli (operatore between), indica due valori separati da virgola.

• customer_group — gruppo cliente (ID). Operatori: in / not_in.
• logged_in — visitatore connesso (1 o 0). Operatore: eq.
• new_returning — new o returning in base alla cronologia ordini. Operatore: eq.
• country — paese (ID). Operatori: in / not_in.
• language — lingua (ID). Operatori: in / not_in.
• currency — valuta (ID). Operatori: in / not_in.
• device — desktop, tablet o mobile. Operatore: in.
• orders_count — numero di ordini validi. Operatori: gte / lte / eq / between.
• total_spent — totale speso. Operatori: gte / lte / between.
• days_since_order — giorni dall’ultimo ordine. Operatori: gte / lte / between.
• cart_total — totale del carrello attuale. Operatori: gte / lte / between.
• cart_has_category — categoria presente nel carrello (ID). Operatore: in.
• cart_has_product — prodotto presente nel carrello (ID). Operatore: in.
• newsletter — iscritto alla newsletter (1 o 0). Operatore: eq.
• source_utm — fonte UTM della sessione. Operatori: eq / contains.
• referrer — sito referrer. Operatori: contains / not_contains.
• hour_range — fascia oraria (es. 9,18). Operatore: between.
• weekday — giorno della settimana (1 = lunedì … 7 = domenica). Operatore: in.
• visits — numero di visite del visitatore. Operatori: gte / lte / eq.

Esempio — segmento «Grandi acquirenti da riattivare», logica E: total_spent gte 200 + days_since_order gte 60.

Creare una campagna

Una campagna distribuisce un contenuto a uno o più segmenti in una zona del tema. Vai su Smart Content → Campagne → Aggiungi campagna.

• Nome: etichetta interna.
• Zona di visualizzazione: l’hook in cui appare il contenuto (vedi l’elenco più sotto).
• Segmenti target: uno o più segmenti. Lascia vuoto per rivolgerti a tutti i visitatori.
• Priorità: se più campagne puntano alla stessa zona, vince quella a priorità più alta che corrisponde.
• A/B testing: attivalo per distribuire più varianti (vedi la sezione dedicata).
• Limite di frequenza: numero massimo di impressioni per visitatore (0 = illimitato), su una finestra espressa in giorni.
• Date di inizio / fine: pianificazione opzionale della campagna.
• Varianti di contenuto: il contenuto HTML, modificabile per lingua.

Zone di visualizzazione disponibili

displayHome, displayTop, displayNav1, displayBanner, displayWrapperTop, displayWrapperBottom, displayLeftColumn, displayRightColumn, displayFooter, displayProductAdditionalInfo, displayShoppingCartFooter.

A/B testing

Attiva l’opzione A/B testing sulla campagna, poi aggiungi più varianti. Ogni variante ha un’etichetta (A, B, …) e un peso. Il modulo estrae una variante a sorte a ogni visualizzazione, proporzionalmente ai pesi. Senza A/B testing, viene usata la prima variante attiva.

Il contenuto di ogni variante si inserisce per lingua. La dashboard confronta poi le prestazioni di ogni variante (impressioni, CTR, CVR, ricavi).

Generatore di contenuti IA

Nell’editor di campagna, il pannello Generatore di contenuti IA redige un blocco HTML orientato alla conversione. Inserisci il nome del segmento, una descrizione del pubblico, l’obiettivo del messaggio e il tono, scegli la lingua e clicca su Genera. Il contenuto prodotto viene inserito nell’area di testo della variante / lingua attiva.

Suggerimento di segmenti IA

Da Smart Content → Segmenti, il pulsante Suggerimenti di segmenti IA apre una pagina che riassume le statistiche reali del tuo negozio (clienti attivi, ordini, acquirenti abituali, iscritti alla newsletter…). Clicca su Genera suggerimenti: l’IA propone da 3 a 5 segmenti ad alto valore, ciascuno con una descrizione, una motivazione e un insieme di regole pronte da copiare nel modulo di creazione.

Dashboard e statistiche

Smart Content → Dashboard aggrega le prestazioni sul periodo scelto: impressioni, clic e tasso di clic (CTR), conversioni e tasso di conversione (CVR) e ricavi attribuiti. Una tabella dettaglia i risultati per campagna e una seconda confronta le varianti A/B.

Come vengono attribuite le conversioni

Al clic su un blocco personalizzato, l’ultima interazione (campagna, variante, segmento) viene memorizzata nel cookie di sessione. Alla convalida di un ordine, il modulo attribuisce la conversione e i relativi ricavi a quella campagna, poi cancella l’attribuzione per evitare il doppio conteggio.

Privacy e GDPR

• Non viene memorizzato alcun dato personale: il tracciamento si basa su un identificatore di visitatore anonimo (un hash), usato per il limite di frequenza e la deduplicazione.
• L’opzione Rispettare il consenso ai cookie regola quando si attiva la misurazione. Segnali riconosciuti: window.dfscConsentGranted = true, oppure i cookie hideBanner=1, axeptio_authorized, cookieconsent_status=allow.
• Per collegare la tua CMP, imposta window.dfscConsentGranted a true una volta ottenuto il consenso.

Inserimento tramite widget

Il modulo implementa l’interfaccia widget di PrestaShop. Puoi quindi inserire un blocco direttamente in un template:

{widget name='dfsmartcontent' hook='displayHome'}

Il parametro hook indica quale zona valutare.

FAQ e risoluzione dei problemi

Il mio blocco non appare

Verifica che la campagna sia attiva, che la sua zona corrisponda a un hook presente nel tuo tema, che almeno una variante abbia contenuto per la lingua corrente e che il visitatore corrisponda effettivamente a un segmento target. Se viene raggiunto un limite di frequenza, il blocco non viene più mostrato a quel visitatore entro la finestra definita.

Le statistiche restano a zero

Se l’opzione di consenso è attiva, le beacon si attivano solo dopo l’approvazione. Verifica che il tuo banner dei cookie emetta uno dei segnali riconosciuti, oppure imposta window.dfscConsentGranted.

Le funzioni IA restituiscono un errore

Assicurati che la chiave API, l’URL e il modello siano corretti nelle Impostazioni e che il tuo server possa raggiungere l’endpoint in uscita.