DataFirefly Affiliate Program: programma di affiliazione per PrestaShop

Installazione

Installa il modulo da Moduli > Gestione moduli > Carica un modulo inviando il file ZIP, oppure copia la cartella dfaffiliate nella directory /modules/ del negozio e clicca su Installa.

All’installazione il modulo crea le sue tabelle, salva le impostazioni predefinite e aggiunge un menu Affiliazione nella sezione Vendi con cinque voci: Affiliati, Commissioni, Estratti e pagamenti, Regole di commissione e Impostazioni. Il pulsante Configura della gestione moduli apre la pagina delle impostazioni, che inizia con una panoramica del programma.

Per passare dalla versione 1.0.0 alla 1.1.0 basta caricare il nuovo ZIP: lo script di aggiornamento aggiunge le nuove impostazioni e i nuovi hook senza toccare affiliati, commissioni ed estratti esistenti.

Prime impostazioni

Controlla almeno questi punti prima di invitare i primi affiliati:

• Valore di commissione predefinito: 10 % dei prodotti IVA esclusa all’installazione, oppure un importo fisso per ordine.
• Durata del cookie: 30 giorni di default, intervallo tra il clic e l’ordine.
• Approva la commissione con e Rifiuta la commissione con: gli stati d’ordine che confermano il pagamento e quelli che annullano (annullato, rimborsato, errore di pagamento).
• Periodo di attesa: 30 giorni di default. Una commissione approvata entra in un estratto solo dopo questo periodo, per coprire i resi.
• Pagamento minimo: al di sotto, il saldo viene rinviato al mese successivo.
• Ragione sociale, IBAN e BIC dell’azienda: indispensabili per generare il file di bonifico SEPA.

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, per esempio ref;
• i link brevi che l’affiliato crea nella sua area partendo dall’indirizzo di un prodotto, di una categoria o di qualsiasi pagina. Reindirizzano alla pagina scelta e contano clic e ordini per link.

Al clic, un cookie firmato (dfaff_ref) registra l’affiliato. La firma impedisce a un visitatore di modificarlo. I robot dei motori di ricerca, i browser automatizzati e i clic dell’affiliato stesso non vengono contati, e uno stesso visitatore conta una sola volta ogni 30 minuti. Nessun indirizzo IP viene salvato in chiaro.

Ordine di attribuzione di un ordine

1. Il codice sconto personale di un affiliato usato nell’ordine, anche senza clic.
2. Il link o il cookie: il carrello viene collegato all’affiliato durante la visita, il che copre anche i pagamenti confermati più tardi dalla banca.
3. Un cliente già portato da quell’affiliato, se l’impostazione Commissioni sui clienti abituali è superiore a 0 giorni.

Il modello di attribuzione decide cosa succede quando un visitatore clicca sui link di due affiliati: ultimo clic (default), vince l’ultimo affiliato visitato; primo clic, il primo mantiene la vendita fino alla scadenza del cookie.

Protezioni

• Un affiliato non guadagna commissioni sui propri ordini, riconosciuti tramite account cliente e indirizzo email.
• Solo nuovi clienti: solo il primo ordine di un cliente genera una commissione.
• Importo minimo dell’ordine: prodotti IVA esclusa dopo gli sconti, 0 per nessun minimo.

Commissioni

Calcolo

La base è l’importo dei prodotti IVA esclusa. Con Detrai gli sconti i buoni dell’ordine vengono sottratti dalla base; un buono spedizione gratuita non la modifica. Le spese di spedizione non sono mai incluse. L’importo viene convertito nella valuta predefinita del negozio.

Il tasso applicato è, in quest’ordine: la commissione specifica dell’affiliato se esiste, altrimenti il tasso del programma. In percentuale, le regole per prodotto e poi per categoria sostituiscono il tasso riga per riga. Con un importo fisso viene creata una sola commissione per ordine, e una sola quando PrestaShop divide un carrello in più ordini per più corrieri.

Regole per categoria e per prodotto

La scheda Regole di commissione fissa una percentuale per una categoria o un prodotto, per esempio 3 % sull’elettronica e 15 % sugli accessori. Una regola prodotto prevale su una regola categoria. Per le categorie il modulo guarda prima la categoria predefinita del prodotto, poi la migliore delle altre. Un tasso di 0 esclude i prodotti dalle commissioni. Le regole si applicano solo alle commissioni in percentuale.

Ciclo di vita

• All’ordine, la commissione viene creata In attesa.
• Quando l’ordine raggiunge uno stato di approvazione diventa Approvata e la data di approvazione avvia il periodo di attesa.
• Quando l’ordine passa a uno stato di annullamento viene Rifiutata.
• Una nota di credito parziale riduce la commissione in proporzione all’importo dei prodotti rimborsato.
• Se la commissione è già in un estratto o pagata, il modulo non la modifica più: crea una rettifica negativa detratta dall’estratto successivo, senza periodo di attesa. Un secondo stato di annullamento sullo stesso ordine non crea un’altra detrazione.

Commissioni manuali

Nella scheda Commissioni, Aggiungi una commissione manuale accredita o addebita un affiliato (importo negativo per una detrazione), con una nota visibile nella sua area. Queste righe seguono lo stesso ciclo di estratto delle commissioni sugli ordini.

Affiliati

Candidature

La pagina pubblica del programma presenta le tue condizioni (tasso, durata del cookie, pagamento minimo), tre passaggi e delle FAQ generate dalle impostazioni. Il testo di presentazione si modifica nelle impostazioni, in ogni lingua. Se scegli una pagina CMS con le condizioni del programma, il candidato deve accettarla.

Il candidato deve aver effettuato l’accesso con un account cliente. Indica dove pubblica, descrive il suo pubblico e, facoltativamente, la sua azienda. Di default ogni candidatura attende la tua approvazione e l’email di notifica riceve un messaggio. Con Approva automaticamente le candidature l’account è attivo subito.

Scheda affiliato

La scheda mostra in alto una sintesi (clic, ordini, commissioni in attesa, dovute e pagate) e il link di tracciamento da copiare, poi tre blocchi:

• Identità e canale: nome, email, sito, pubblico, stato e nota interna. Passare lo stato ad Approvato invia l’email «Il tuo account affiliato è attivo».
• Tracciamento e commissione: codice affiliato, commissione specifica, durata del cookie propria, codice sconto personale. Se il codice non esiste ancora e indichi una percentuale di sconto, la regola carrello viene creata automaticamente, limitata a un utilizzo per cliente.
• Dati di pagamento: bonifico SEPA o PayPal, intestatario, IBAN, BIC, email PayPal.

Puoi creare un affiliato senza account cliente: riceve gli estratti via email ma non ha un’area online. Se un account cliente usa lo stesso indirizzo email, viene collegato automaticamente.

Un affiliato con commissioni aperte o un estratto non pagato non può essere eliminato: sospendilo o salda prima il suo conto.

Cosa vede l’affiliato

• Il mio account: un riquadro «Area affiliato», o «Diventa affiliato» per un cliente che non lo è.
• Panoramica: generatore di link, fascia di cifre (clic, ordini, conversione, in attesa, approvato, pagato), grafico degli ultimi 30 giorni, condizioni e link recenti.
• I miei link: tutti i link brevi con clic, ordini, copia ed eliminazione.
• Commissioni: data, riferimento d’ordine mascherato, origine, base, commissione, stato, filtro per stato e mese di pagamento previsto. Nessun dato cliente viene mostrato.
• Estratti: un estratto al mese, consultabile e stampabile in PDF.
• Dati di pagamento: scelta tra bonifico e PayPal, IBAN verificato con le cifre di controllo e mostrato mascherato. Un pallino e un avviso segnalano i dati mancanti.
• Scheda prodotto: un riquadro «Il tuo link affiliato», visibile solo all’affiliato connesso, dà il link del prodotto e il tasso guadagnato.

Estratti e pagamenti

Creazione degli estratti

Un estratto raggruppa, per un affiliato e un mese, le commissioni approvate create prima della fine del mese il cui periodo di attesa è terminato, più le rettifiche negative. Se il totale è inferiore al pagamento minimo, non viene creato nulla e il saldo viene rinviato.

Due modi per creare gli estratti:

• Estratti e pagamenti > Crea gli estratti mensili: scegli il mese, controlla in anteprima gli importi per affiliato, poi crea gli estratti e invia le email.
• L’URL cron, mostrato nella panoramica delle impostazioni. Richiamalo una volta al giorno: tra l’1 e il 5 del mese crea gli estratti del mese precedente. Aggiungi &period=AAAA-MM per forzare un mese specifico. È protetto da un token.

Pagare gli affiliati

Nell’elenco degli estratti seleziona quelli da pagare e usa l’azione di gruppo che ti serve:

• Esporta file di bonifico SEPA (XML): file pain.001.001.03 da importare nella tua banca, per gli affiliati pagati con bonifico. Richiede EUR come valuta predefinita e l’IBAN dell’azienda.
• Esporta file PayPal Payouts (CSV): per i pagamenti multipli PayPal, affiliati pagati tramite PayPal.
• Esporta per la contabilità (CSV): tutti gli estratti selezionati, separati da punto e virgola.

Le esportazioni di pagamento vengono rifiutate, con un messaggio che indica l’estratto in questione, se un estratto selezionato è già pagato o se un IBAN manca o non è valido: un file incompleto lascerebbe un affiliato senza pagamento, e un estratto pagato potrebbe esserlo due volte.

Una volta effettuato il bonifico, segna gli estratti come pagati, in blocco o dal dettaglio di un estratto con riferimento e data del pagamento. Le commissioni interessate passano a Pagata.

Email

Il modulo invia quattro email, tradotte in 8 lingue e inviate nella lingua del destinatario, importi compresi:

• Nuova candidatura affiliato, all’indirizzo di notifica.
• Il tuo account affiliato è attivo, con il link all’area affiliato.
• Nuova vendita, con commissione, base e tasso, mai i dati del cliente. Disattivabile nelle impostazioni e da ogni affiliato nei suoi dati di pagamento.
• Estratto disponibile, con l’importo e il link all’estratto.

I modelli si trovano nella cartella mails/ del modulo e si personalizzano come qualsiasi email di PrestaShop.

Back office

• Panoramica (pagina delle impostazioni): affiliati attivi, candidature da esaminare, clic, ordini e vendite degli ultimi 30 giorni, commissioni in attesa, dovute e pagate, migliori affiliati.
• Pagina ordine: un riquadro indica l’affiliato, la commissione, il suo stato e la sua origine.
• Esportazioni CSV degli elenchi di affiliati e commissioni, con importi grezzi pronti per un foglio di calcolo.

GDPR ed eliminazione dell’account

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. La cancellazione anonimizza l’affiliato (nome, email, IBAN, sito e pubblico svuotati, link e clic eliminati) conservando commissioni ed estratti per la contabilità.

Quando un dipendente elimina un account cliente, l’affiliato collegato viene conservato senza account online e i suoi dati di pagamento restano.

Risoluzione dei problemi

Non viene contato alcun clic

Prova in una finestra di navigazione privata, senza aver effettuato l’accesso con l’account dell’affiliato: i suoi clic vengono ignorati. I browser automatizzati sono filtrati come robot. Se il negozio usa una cache di pagina completa, una pagina servita dalla cache non esegue PHP e il parametro ?aff= non viene visto: usa i link brevi, che passano sempre da PrestaShop, oppure escludi il parametro dalla cache.

Una commissione resta in attesa

Verifica che lo stato attuale dell’ordine sia selezionato in Approva la commissione con. Se lo stato è stato cambiato da un dipendente il cui profilo non ha il permesso Visualizza sul modulo (Parametri avanzati > Team > Permessi), PrestaShop non ha eseguito il modulo: rimetti l’ordine in quello stato con un account amministratore.

Il generatore di link rifiuta un indirizzo

Il generatore accetta solo indirizzi del tuo negozio. Incolla l’indirizzo completo come appare nel browser, sul dominio del negozio.

L’esportazione SEPA viene rifiutata

Leggi il messaggio mostrato: indica l’estratto già pagato o l’affiliato senza IBAN. Deselezionalo o completa i suoi dati. Verifica anche che ragione sociale e IBAN dell’azienda siano compilati.

Compatibilità

• PrestaShop da 8.0 a 9.x, lo stesso ZIP copre entrambe le versioni.
• Multilingua e multivaluta, commissioni calcolate nella valuta predefinita.
• Architettura ModuleAdminController, senza dipendenze Composer.
• Modulo ed email tradotti in inglese, francese, spagnolo, tedesco, italiano, olandese, polacco e portoghese.