# DataFirefly Affiliate Program: programma di affiliazione per PrestaShop

> 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,…

- Pagina: <https://www.datafirefly.com/it/documentation/dfaffiliate/>
- Lingua: it
- Aggiornato il: 2026-11-08
- Altre lingue: [fr](https://www.datafirefly.com/documentation/dfaffiliate/index.md), [en](https://www.datafirefly.com/en/documentation/dfaffiliate/index.md), [es](https://www.datafirefly.com/es/documentation/dfaffiliate/index.md), [de](https://www.datafirefly.com/de/documentation/dfaffiliate/index.md), [nl](https://www.datafirefly.com/nl/documentation/dfaffiliate/index.md), [pl](https://www.datafirefly.com/pl/documentation/dfaffiliate/index.md), [pt](https://www.datafirefly.com/pt/documentation/dfaffiliate/index.md)
- Indice: <https://www.datafirefly.com/it/documentation/llms.txt>

## 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

![Cruscotto del programma di affiliazione: clic, ordini attribuiti, fatturato generato, commissioni da pagare e attività da fare](https://www.datafirefly.com/wp-content/uploads/2026/11/cruscotto-programma-affiliazione-dfaffiliate-it-scaled.webp)

Cruscotto del programma di affiliazione: clic, ordini attribuiti, fatturato generato, commissioni da pagare e attività da fare

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).

![Impostazioni di tracciamento: parametro URL, durata del cookie, ultimo o primo clic, clic ripetuti e attesa del consenso](https://www.datafirefly.com/wp-content/uploads/2026/11/impostazioni-tracciamento-consenso-dfaffiliate-it.webp)

Impostazioni di tracciamento: parametro URL, durata del cookie, ultimo o primo clic, clic ripetuti e attesa del consenso

### 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 `tarteaucitron` e `dfaffiliate=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

1. Il **codice sconto personale** di un affiliato usato nell'ordine, anche senza clic.
2. Il **link o il cookie**.
3. 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

![Commissioni per fase: in attesa di pagamento, periodo di convalida fino a una data, pagabile, pagata o rifiutata](https://www.datafirefly.com/wp-content/uploads/2026/11/commissioni-periodo-convalida-dfaffiliate-it.webp)

Commissioni per fase: in attesa di pagamento, periodo di convalida fino a una data, pagabile, pagata o rifiutata

1. **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.
2. **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.
3. **Pagabile**: il periodo è trascorso, la commissione entrerà nel prossimo estratto.
4. **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

![Simulatore di regole: un ordine riprodotto riga per riga, tasso applicato e regola che prevale](https://www.datafirefly.com/wp-content/uploads/2026/11/simulatore-regole-commissione-dfaffiliate-it.webp)

Simulatore di regole: un ordine riprodotto riga per riga, tasso applicato e regola che prevale

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:

1. regola del prodotto;
2. regola della categoria predefinita del prodotto;
3. migliore regola delle altre categorie;
4. 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

![Frodi e pagamenti: confronto degli indirizzi, convivenza con il programma referral, pagamento minimo e file SEPA](https://www.datafirefly.com/wp-content/uploads/2026/11/impostazioni-frode-pagamenti-dfaffiliate-it.webp)

Frodi e pagamenti: confronto degli indirizzi, convivenza con il programma referral, pagamento minimo e file SEPA

- 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

![Pagina pubblica del programma di affiliazione: presentazione, condizioni, passaggi e risposte alle domande](https://www.datafirefly.com/wp-content/uploads/2026/11/pagina-programma-affiliazione-dfaffiliate-it.webp)

Pagina pubblica del programma di affiliazione: presentazione, condizioni, passaggi e risposte alle domande

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.

![Modulo di candidatura: sito o canale, pubblico e accettazione delle condizioni, poi esaminato dal commerciante](https://www.datafirefly.com/wp-content/uploads/2026/11/candidatura-affiliato-dfaffiliate-it.webp)

Modulo di candidatura: sito o canale, pubblico e accettazione delle condizioni, poi esaminato dal commerciante

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

![Elenco degli affiliati: codice, canale, stato, clic, ordini e saldi, approvazione in blocco delle candidature](https://www.datafirefly.com/wp-content/uploads/2026/11/elenco-affiliati-dfaffiliate-it.webp)

Elenco degli affiliati: codice, canale, stato, clic, ordini e saldi, approvazione in blocco delle candidature

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.

![Scheda completa dell’affiliato: indicatori, saldo per fase, condizioni, IBAN mascherato, link, commissioni, estratti e dati personali](https://www.datafirefly.com/wp-content/uploads/2026/11/scheda-affiliato-dfaffiliate-it.webp)

Scheda completa dell’affiliato: indicatori, saldo per fase, condizioni, IBAN mascherato, link, commissioni, estratti e dati personali

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

![Area affiliato: saldi in convalida, pagabile e pagato, link tracciato, statistiche degli ultimi 30 giorni e condizioni](https://www.datafirefly.com/wp-content/uploads/2026/11/area-affiliato-dfaffiliate-it.webp)

Area affiliato: saldi in convalida, pagabile e pagato, link tracciato, statistiche degli ultimi 30 giorni e condizioni

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.

![Generatore di link: link breve verso qualsiasi pagina del negozio, clic e ordini per link](https://www.datafirefly.com/wp-content/uploads/2026/11/generatore-link-affiliati-dfaffiliate-it.webp)

Generatore di link: link breve verso qualsiasi pagina del negozio, clic e ordini per link

![Statistiche dell’affiliato: clic, ordini, conversione, vendite generate per periodo, per origine e per link](https://www.datafirefly.com/wp-content/uploads/2026/11/statistiche-affiliato-dfaffiliate-it.webp)

Statistiche dell’affiliato: clic, ordini, conversione, vendite generate per periodo, per origine e per link

![Storico delle commissioni: fasi dal pagamento al versamento, numero d’ordine mascherato, nessun dato cliente](https://www.datafirefly.com/wp-content/uploads/2026/11/storico-commissioni-affiliato-dfaffiliate-it.webp)

Storico delle commissioni: fasi dal pagamento al versamento, numero d’ordine mascherato, nessun dato cliente

![Pagamenti dell’affiliato: estratti mensili, bonifico SEPA o PayPal, IBAN cifrato e mostrato mascherato](https://www.datafirefly.com/wp-content/uploads/2026/11/pagamenti-affiliato-dfaffiliate-it.webp)

Pagamenti dell’affiliato: estratti mensili, bonifico SEPA o PayPal, IBAN cifrato e mostrato mascherato

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

![Materiale promozionale: banner e testi proposti agli affiliati, con anteprima, dimensioni e pagina di destinazione](https://www.datafirefly.com/wp-content/uploads/2026/11/materiale-promozionale-banner-dfaffiliate-it.webp)

Materiale promozionale: banner e testi proposti agli affiliati, con anteprima, dimensioni e pagina di destinazione

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.

![Materiale promozionale per gli affiliati: banner e testo con il link di tracciamento già inserito, da copiare in un clic](https://www.datafirefly.com/wp-content/uploads/2026/11/materiale-promozionale-affiliato-dfaffiliate-it.webp)

Materiale promozionale per gli affiliati: banner e testo con il link di tracciamento già inserito, da copiare in un clic

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

![Estratti e pagamenti: estratti mensili, esportazione SEPA o PayPal, pagamento segnato una sola volta](https://www.datafirefly.com/wp-content/uploads/2026/11/estratti-pagamenti-affiliati-dfaffiliate-it.webp)

Estratti e pagamenti: estratti mensili, esportazione SEPA o PayPal, pagamento segnato una sola volta

Il pagamento avviene in quattro passaggi, riepilogati in cima alla pagina:

1. **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.
2. **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.
3. **Paga tramite la tua banca o PayPal**: il modulo non invia mai denaro.
4. **Segna come pagato**, con il riferimento e la data del bonifico.

![Estratto di un affiliato: righe di commissione, importo dovuto, coordinate bancarie mascherate e riferimento del bonifico](https://www.datafirefly.com/wp-content/uploads/2026/11/estratto-affiliato-dfaffiliate-it.webp)

Estratto di un affiliato: righe di commissione, importo dovuto, coordinate bancarie mascherate e riferimento 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.

## Email

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.

![E-mail «nuova vendita» inviata all’affiliato: commissione, importo dell’ordine e tasso, senza alcun dato cliente](https://www.datafirefly.com/wp-content/uploads/2026/11/email-nuova-vendita-affiliato-dfaffiliate-it.webp)

E-mail «nuova vendita» inviata all’affiliato: commissione, importo dell’ordine e tasso, senza alcun dato cliente

![E-mail dell’estratto mensile: periodo, importo, numero di commissioni e link all’estratto nell’area affiliato](https://www.datafirefly.com/wp-content/uploads/2026/11/email-estratto-mensile-affiliato-dfaffiliate-it.webp)

E-mail dell’estratto mensile: periodo, importo, numero di commissioni e link all’estratto nell’area affiliato

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.
