DataFirefly Affiliate Program: programma di affiliazione per PrestaShop
Installare, configurare e gestire il programma di affiliazione: cruscotto, tracciamento dei link, commissioni con periodo di convalida, regole e simulatore, estratti SEPA o PayPal, area affiliato e materiale promozionale.
Installazione e aggiornamento
Installa il modulo da Moduli > Gestione moduli > Carica un modulo inviando il file ZIP. Lo stesso ZIP funziona su PrestaShop 1.7.8, 8 e 9.
All’installazione, il modulo crea le sue tabelle e le impostazioni predefinite, e aggiunge il menu Vendi > Affiliazione con sette voci: Dashboard, Affiliati, Commissioni, Estratti e pagamenti, Regole di commissione, Materiale promozionale e Impostazioni. Un menu comune in cima a ogni pagina permette di passare dall’una all’altra.
Per passare dalla versione 1.0.0 o 1.1.0 alla 2.0.0, basta inviare il nuovo ZIP. Lo script di aggiornamento conserva affiliati, link, clic, commissioni, estratti, regole e impostazioni, e aggiunge le novità:
- gli IBAN già registrati vengono cifrati;
- le commissioni ancora entro il loro termine passano alla fase «periodo di convalida»;
- le nuove impostazioni ricevono il loro valore predefinito.
Prima di aprire il programma, verifica in Impostazioni lo stato o gli stati dell’ordine che confermano il pagamento, il periodo di convalida e il pagamento minimo. La Dashboard mostra poi una verifica della configurazione che segnala ciò che manca.
Dashboard

La dashboard riassume l’attività su 7 giorni, 30 giorni, 90 giorni o 12 mesi:
- Indicatori: clic e visitatori unici, ordini attribuiti e conversione dei clic, fatturato generato (base di commissione degli ordini, spese di spedizione escluse), commissioni maturate e la loro quota sul fatturato, commissioni da pagare, affiliati attivi, ordini rifiutati per ordine proprio o doppia ricompensa.
- Grafico dei clic e del fatturato al giorno, o al mese su 12 mesi.
- Dove si trovano le commissioni: in attesa del pagamento dell’ordine, in periodo di convalida, pagabili, in estratti da pagare, pagate.
- Da fare: candidature da esaminare, commissioni in attesa, estratti da creare o da pagare, affiliati senza dati di pagamento, ciascuno con un pulsante che apre l’elenco giusto.
- Verifica della configurazione, migliori affiliati, link più cliccati e ultime commissioni.
Tracciamento e attribuzione
I link di tracciamento
Ogni affiliato ha un codice. Due tipi di link lo trasportano:
- il parametro di tracciamento, aggiunto a qualsiasi indirizzo del negozio:
?aff=CODE. Il nome del parametro si cambia nelle impostazioni; - i link brevi
/go/…che l’affiliato crea nella sua area. Reindirizzano alla pagina scelta e contano i clic e gli ordini per link. Sono accettati solo gli indirizzi del negozio: un link non può mai rimandare a un altro sito.
Il cookie di attribuzione
Al clic, il cookie dfaff_ref registra l’affiliato. È firmato (un visitatore non può modificarlo), HttpOnly e SameSite=Lax, e la sua durata si imposta nelle impostazioni o per singolo affiliato. L’attribuzione viene copiata anche sul carrello, il che copre i pagamenti confermati più tardi dalla banca.
Non vengono mai contati:
- i robot e le anteprime dei link dei social network e delle app di messaggistica;
- i precaricamenti del browser e le richieste HEAD;
- i clic dell’affiliato stesso;
- i ricaricamenti e i clic ripetuti di uno stesso visitatore sullo stesso link durante l’intervallo scelto (30 minuti per impostazione predefinita).

Cookie e consenso
L’impostazione Cookie di attribuzione e consenso propone due comportamenti:
- scrivi il cookie a ogni visita tracciata;
- attendi il consenso: il cookie viene scritto solo se il cookie del tuo banner di consenso è presente e contiene il testo indicato, per esempio
tarteaucitronedfaffiliate=true. Senza consenso, il clic resta contato nelle statistiche, ma solo un codice sconto dell’affiliato può attribuire l’ordine.
Lo status di questo cookie rispetto alla normativa dipende dal tuo paese e dal tuo utilizzo: fallo verificare dal tuo consulente. Il modulo non garantisce alcuna conformità.
Come viene attribuito un ordine
- Il codice sconto personale di un affiliato usato nell’ordine, anche senza clic.
- Il link o il cookie.
- Un cliente già portato da questo affiliato, se le commissioni sui clienti abituali sono attivate.
Il modello di attribuzione decide il caso in cui un visitatore clicca sui link di due affiliati: ultimo clic (predefinito), vince l’ultimo affiliato visitato; primo clic, il primo mantiene la vendita fino alla scadenza del cookie.
Commissioni
Ciclo di una commissione

- In attesa del pagamento dell’ordine: l’ordine è stato effettuato. Un ordine pagato con bonifico o assegno resta in questa fase finché non confermi il pagamento.
- Periodo di convalida: l’ordine raggiunge uno stato che conferma il pagamento. La commissione attende il numero di giorni scelto (30 per impostazione predefinita) per coprire il periodo di recesso e i resi. La data di fine è visualizzata.
- Pagabile: il periodo è trascorso, la commissione entrerà nel prossimo estratto.
- In un estratto, poi Pagato quando segni l’estratto come pagato.
I periodi di convalida terminano da soli: tramite il cron se lo usi, altrimenti all’apertura del back office del modulo o dell’area affiliato.
Casi particolari:
- Ordine annullato o rimborsato: la commissione viene rifiutata finché non è pagata. Se l’ordine viene poi pagato di nuovo, la commissione torna con un nuovo periodo di convalida.
- Rimborso parziale (nota di credito): la commissione viene ridotta in proporzione ai prodotti rimborsati.
- Dopo il pagamento: il modulo non tocca più la commissione pagata e crea una rettifica negativa, detratta dall’estratto successivo. Un secondo cambio di stato non crea una nuova trattenuta.
- Una sola commissione per ordine: ricaricare la pagina di conferma, ricevere due notifiche di pagamento o ripassare più volte per lo stesso stato non crea mai un doppione (blocco e chiave univoca nel database).
Nell’elenco delle commissioni, l’azione di gruppo Approva ora termina il periodo di convalida delle commissioni selezionate. Rifiuta gli ordini non ancora pagati e ne indica il riferimento.
Calcolo
- Base: prodotti IVA esclusa o IVA inclusa (a scelta), mai le spese di spedizione.
- Buoni sconto: detratti in proporzione su ogni riga se l’opzione è attivata. Un buono di spedizione gratuita non viene detratto.
- Valute: gli ordini effettuati in un’altra valuta vengono convertiti con il tasso registrato sull’ordine.
- Arrotondamento: una sola volta per ordine, al centesimo.
- Importo fisso: una commissione per ordine, una sola anche quando PrestaShop divide un carrello in più ordini.
- Clienti abituali: per il numero di giorni scelto, gli ordini successivi di un cliente portato generano una commissione, al tasso dell’affiliato o a un tasso specifico.
Nessun importo proviene dal browser: tutto viene ricalcolato a partire dall’ordine registrato da PrestaShop.
Regole di commissione e simulatore

Una regola fissa un tasso per una categoria o un prodotto, per tutti gli affiliati o per uno solo. Per ogni riga dell’ordine, la priorità è la seguente:
- regola del prodotto;
- regola della categoria predefinita del prodotto;
- migliore regola delle altre categorie;
- tasso dell’affiliato o del programma.
Una regola riservata a un affiliato prevale sulla stessa regola per tutti. Una regola può sostituire il tasso (una regola allo 0 % esclude i prodotti) o aggiungersi a esso: un affiliato al 10 % con una regola «+2» riceve il 12 %, con un tetto del 100 %. Le regole non si applicano agli importi fissi.
Il simulatore, in cima alla pagina delle regole, risponde alla domanda «quale tasso si applica, e perché?» per un prodotto e un affiliato, oppure riesegue un ordine esistente riga per riga, senza creare nulla.
Commissioni manuali
Aggiungi una commissione manuale accredita o addebita un affiliato (importo negativo per una detrazione), con una nota visibile nella sua area.
Frodi e doppie ricompense

- Un ordine effettuato con lo stesso account cliente, lo stesso indirizzo email o, se l’opzione è attivata, spedito o fatturato a un indirizzo dell’affiliato viene registrato come rifiutato, con un motivo leggibile dal commerciante e dall’affiliato.
- Con il modulo DataFirefly Loyalty & Referral attivo, un ordine che ricompensa già un referente non genera una commissione di affiliazione (impostazione modificabile). I dati del modulo di referral vengono solo letti, mai modificati. I due moduli usano parametri URL e cookie diversi.
- Solo nuovi clienti e importo minimo dell’ordine completano queste protezioni.
Affiliati
Candidature

La pagina pubblica del programma presenta le tue condizioni (tasso, durata del cookie, periodo di convalida, pagamento minimo), i passaggi e delle domande frequenti generate a partire dalle tue impostazioni. Il testo di presentazione si modifica in ogni lingua.

Il candidato deve aver effettuato l’accesso con un account cliente. Indica dove pubblica e descrive il suo pubblico. Se è stata scelta una pagina CMS di condizioni, deve accettarla. Per impostazione predefinita, ogni candidatura attende la tua approvazione e l’indirizzo di notifica riceve un’email.
Elenco e scheda affiliato

L’elenco mostra il codice, il canale, lo stato, i clic, gli ordini e i saldi. Le azioni di gruppo approvano, rifiutano o sospendono più candidature alla volta. L’esportazione CSV neutralizza le celle che potrebbero essere lette come formule da un foglio di calcolo.

La scheda affiliato riunisce in una pagina:
- il profilo, con i pulsanti Approva, Rifiuta, Sospendi e Modifica;
- gli indicatori e il saldo per fase;
- le condizioni (tasso, regole dedicate, cookie, codice sconto) e il link di tracciamento;
- i dati di pagamento, con l’IBAN mascherato;
- la candidatura;
- i link degli ultimi 30 giorni, le ultime commissioni e gli estratti.
Il blocco Dati personali esporta in JSON ciò che il modulo conserva sull’affiliato. Permette anche di anonimizzarlo: nome, email, sito, dati di pagamento, link e clic vengono cancellati, mentre commissioni ed estratti restano per la tua contabilità.
Nel modulo di modifica, l’IBAN non viene mai mostrato di nuovo in chiaro: lascia il campo vuoto per mantenere quello registrato, oppure inseriscine uno nuovo.
Cosa vede l’affiliato

L’area affiliato si apre con un’intestazione che mostra il suo codice, il suo tasso e i suoi saldi (in convalida, pagabile, pagato), poi sei schede. Funziona con i temi Classic e Hummingbird.
- Panoramica: generatore di link, indicatori, grafico degli ultimi 30 giorni, condizioni e link recenti.
- Generatore di link: creazione di un link breve verso qualsiasi pagina del negozio, elenco dei link con clic, ordini, copia ed eliminazione.
- Statistiche: clic, ordini, conversione, vendite e commissioni da 7 giorni a 12 mesi, provenienza dei clic e rendimento per link.
- Commissioni: fase di ogni commissione, data prevista di pagamento, riferimento dell’ordine mascherato. Nessun dato del cliente viene mostrato.
- Pagamenti: estratti mensili consultabili e stampabili, scelta tra bonifico SEPA e PayPal, IBAN controllato tramite le cifre di controllo, cifrato e mostrato mascherato, email di vendita.
- Materiale promozionale: banner e testi pronti all’uso, con il link di tracciamento dell’affiliato già inserito.




Un affiliato vede solo i propri dati: i suoi link, le sue commissioni e i suoi estratti vengono controllati a ogni visualizzazione, e i moduli sono protetti da un token.
Materiale promozionale

In Materiale promozionale, aggiungi banner (JPG, PNG, GIF o WebP, massimo 2 MB) e testi pronti all’uso, con un nome e un testo alternativo in ogni lingua, e la pagina del negozio a cui portano. L’ordine si imposta con il trascinamento.

Ogni affiliato copia il codice HTML del banner, il testo e il link, con il suo link di tracciamento già incluso. La scheda compare nell’area affiliato solo se esiste almeno un elemento attivo.
Estratti e pagamenti

Il pagamento avviene in quattro passaggi, riepilogati in cima alla pagina:
- Crea gli estratti: scegli il mese, visualizza in anteprima gli importi per affiliato e poi crea gli estratti. Un estratto raggruppa le commissioni pagabili create prima della fine del mese e le rettifiche negative. Sotto il pagamento minimo, il saldo viene rinviato.
- Esporta il file di pagamento: seleziona gli estratti e poi l’azione di gruppo File di bonifico SEPA (XML, pain.001.001.03) o File PayPal Payouts (CSV). L’esportazione contabile CSV riporta l’IBAN mascherato.
- Paga tramite la tua banca o PayPal: il modulo non invia mai denaro.
- Segna come pagato, con il riferimento e la data del bonifico.

Un estratto pagato non può più essere esportato né pagato una seconda volta. Un’esportazione di pagamento viene rifiutata per intero se un estratto selezionato è già pagato o se mancano dei dati: il messaggio indica l’affiliato interessato e dove completarli.
Cron (facoltativo)
L’URL del cron è indicato nelle impostazioni. Termina i periodi di convalida e, se l’opzione è attivata, crea tra il 1° e il 5 del mese gli estratti del mese precedente. È protetto da un token, non viene mai eseguito due volte contemporaneamente e non paga mai nulla.
Il modulo invia quattro email, tradotte in 8 lingue e inviate nella lingua del destinatario, oggetto e importi compresi: nuova candidatura (al commerciante), account affiliato attivato, nuova vendita ed estratto disponibile.


L’email di nuova vendita indica la commissione, l’importo dell’ordine e il tasso, mai i dati del cliente. Ogni affiliato può disattivarla. I modelli si trovano nella cartella mails/ del modulo.
Impostazioni
La pagina delle impostazioni è organizzata in cinque blocchi:
- Tracciamento e attribuzione: parametro URL, durata del cookie, modello di attribuzione, intervallo anti-doppione, consenso, clienti abituali.
- Commissioni: tipo e tasso predefiniti, base IVA esclusa o IVA inclusa, detrazione dei buoni, solo nuovi clienti, minimo d’ordine, stati che confermano il pagamento o che rifiutano la commissione, periodo di convalida.
- Frodi e doppie ricompense.
- Estratti e pagamenti: pagamento minimo, estratti tramite cron, dati SEPA dell’azienda.
- Candidature e pagina del programma: approvazione automatica, email, testo di presentazione, pagina delle condizioni, colore di accento.
I messaggi di errore indicano cosa correggere, per esempio «IBAN dell’azienda: le cifre di controllo non corrispondono».
GDPR
Il modulo si registra presso il modulo GDPR ufficiale di PrestaShop. L’esportazione dei dati di un cliente include il suo profilo affiliato e le sue commissioni, con l’IBAN mascherato. La cancellazione anonimizza l’affiliato conservando commissioni ed estratti. Le stesse azioni sono disponibili dalla scheda affiliato. Questi strumenti ti aiutano a gestire le richieste, senza costituire una garanzia di conformità.
Risoluzione dei problemi
Nessun clic viene contato
Fai una prova in una finestra di navigazione privata, senza aver effettuato l’accesso con l’account dell’affiliato. I browser automatizzati vengono filtrati come robot. Con l’opzione «attendi il consenso», accetta prima il servizio nel tuo banner. Se il tuo negozio usa una cache delle pagine complete, usa i link brevi /go/, che passano sempre da PrestaShop.
Una commissione resta «in attesa del pagamento»
Verifica che lo stato attuale dell’ordine sia selezionato in Ordine pagato con. Un ordine con bonifico o assegno resta in attesa finché non hai confermato il pagamento.
L’esportazione SEPA viene rifiutata
Leggi il messaggio visualizzato: indica l’estratto già pagato o l’affiliato di cui manca l’IBAN. Verifica anche la ragione sociale e l’IBAN dell’azienda, e che l’euro sia la valuta predefinita.
Compatibilità
- PrestaShop 1.7.8, 8 e 9: lo stesso ZIP copre i tre rami, con i temi Classic e Hummingbird.
- Multinegozio: affiliati, commissioni e statistiche filtrati per negozio. Multivaluta: conversione al tasso dell’ordine.
- Modulo ed email in inglese, francese, spagnolo, tedesco, italiano, olandese, polacco e portoghese.