# Referrals (Link Affiliati)
La sezione relativa alla configurazione dei Referrals all'interno del BOT si trova in:\
\&#xNAN;*Impostazioni -> REF*
{% hint style="info" %}
Eventuali Admin secondari all'interno del BOT utilizzeranno di default i REF impostati per l'Admin principale, a meno che questi non vengano sovrascritti.
{% endhint %}
Selezionare quindi dalla lista l'Admin per cui si vogliono modificare i REF (l'*Admin 1* è l'amministratore principale del BOT):
## Aggiunta di un REF tramite la *Procedura Guidata*:
Tramite il pulsante *➕ Aggiungi REF* viene mostrata una selezione di Store per i quali il BOT supporta l'estrazione automatica del referral. \
\
Selezioniamo ad esempio `Amazon` ed il paese corrispondente al REF che andiamo ad inserire (ad esempio `amazon.it`). Il BOT ci chiederà di inviare un link contenente il Referral e generato tramite la SiteStripe (il pannello) di Amazon:
Dopo l'invio del link il BOT estrarrà ed applicherà automaticamente il REF.\
Dovremo trovarci di fronte ad una schermata simile:
{% hint style="info" %}
Nel caso in cui devi modificare il REF inserito per l'Admin, puoi selezionare `🗑 Elimina REF` e ricrearlo seguendo la **procedura guidata**.
{% endhint %}
{% hint style="warning" %}
Quando modifichi un REF per un Admin **la modifica si applica solamente ai nuovi post creati**. I post eventualmente già presenti in coda continueranno ad essere pubblicati con il vecchio REF. Puoi utilizzare il comando `/resetqueue` dopo la modifica del REF per forzare la rimozione di tutti i prodotti in coda.
{% endhint %}
{% hint style="danger" %}
E' **altamente sconsigliato** apportare ulteriori modifiche tramite la sezione `⚒ Modifica Avanzata` in quanto si corre il rischio di commettere errori che andrebbero a minare il funzionamento del REF.\
Preferisci sempre la **procedura guidata** di aggiunta dei REF quando possibile, a meno che non capisci perfettamente le modifiche che stai compiendo.
{% endhint %}
## Aggiunta di un REF Personalizzato:
Il BOT supporta la configurazione di REF per ogni dominio, compatibilmente con la tipologia di referral che questo dominio offre.\
\
Si distinguono in particolare tre tipologie di REF che il BOT supporta:
* **REF su Parametro:** il REF è contenuto all'interno di un parametro dell'URL.\
Ad esempio il REF Amazon:\
`https://www.amazon.it/dp/ABCDE/?psc=1&tag=ilmioref-21`\
\
In questo caso il parametro è `tag` e il valore `ilmioref-21`.
* **REF in Parametri Multipli:** il REF è composto da più coppie parametro-valore all'interno dell'URL.\
Ad esempio il REF eBay:\
`https://www.ebay.it/ABCDE/?mkevt=1&mkcid=1&mkrid=ABC&campid=123`\
\
In questo caso le coppie parametro-valore sono rispettivamente:\
parametro `mkevt` - valore `1`\
parametro `mkcid` - valore `1`\
parametro `mkrid` - valore `ABC`\
parametro `campid` - valore `123`
* **REF in URL:** il REF è composto da una URL che precede il link del prodotto che, solitamente, è contenuto all'interno di un parametro di questa.\
Ad esempio il REF [ibs.it](https://www.ibs.it) configurato tramite il network di affiliazione [tradedoubler](https://www.tradedoubler.com/it/)\
`https://redir.tradedoubler.com/projectr/?utm_source=tradedoubler&utm_campaign=1234&_td_deeplink=https%3A%2F%2Fwww.ibs.it%2Fsotto-cenere-libro-camilla-grebe%2Fe%2F9788806244934`
{% hint style="warning" %}
Quando si configura un REF personalizzato è importante comprendere a fondo come funziona il sistema REF del servizio che si sta utilizzando, in modo da individuare la tipologia da utilizzare tra quelle sopra riportate. \
\
In caso di dubbi è consigliabile chiedere supporto sul gruppo clienti dedicato, qualcuno potrebbe aver già configurato un REF per il servizio che stai cercando di utilizzare.
{% endhint %}
Premendo il pulsante *➕ Aggiungi REF* sarà possibile selezionare la voce *⚒ Personalizzato ⚒*
{% hint style="info" %}
Utilizzare questa voce solamente per i servizi per i quali il BOT non supporta la configurazione guidata (tutti i siti non riportati all'interno della tastiera)
{% endhint %}
Nello step successivo sarà necessario introdurre il **dominio** del sito che si vuole configurare. Ipotizziamo che disponibiamo di una affiliazione al sito [ibs.it](https://www.ibs.it) tramite il network di affiliazione [tradedoubler](https://www.tradedoubler.com/it/). \
\
Inseriamo dunque `ibs.it` nella schermata relativa al dominio:
Nella schermata successiva ci verrà chiesta la **Tipologia del REF**.\
Generando un link con REF per **IBS** dal pannello **Tradedoubler** otteniamo un qualcosa di simile in output:\
\
`https://redir.tradedoubler.com/projectr/?utm_source=tradedoubler&utm_campaign=1234&_td_deeplink=https%3A%2F%2Fwww.ibs.it%2Fsotto-cenere-libro-camilla-grebe%2Fe%2F9788806244934`\
Possiamo notare come l'URL del prodotto (*ibs.it*) venga inserita come parametro all'interno di `_td_deeplink`, e che il tutto venga anticipato da una nuova URL (*redir.tradedoubler.com*).\
\
Il tipo di REF è dunque un **REF in URL**, selezioniamolo:
Ci viene ora chiesto di inviare la parte relativa all'URL che precede il link del prodotto. Nel caso dell'esempio sopra dovremo quindi inviare solamente:\
`https://redir.tradedoubler.com/projectr/?utm_source=tradedoubler&utm_campaign=1234&_td_deeplink=`
{% hint style="info" %}
Assicurati di includere anche il *parametro finale* comprensivo di simbolo **=**
{% endhint %}
Il REF sarà dunque salvato e correttamente configurato nel BOT. Ogni qual volta che creeremo un post inviando un link *ibs.it* questo verrà applicato al link del prodotto:
{% hint style="success" %}
Per verificare la corretta applicazione di un REF è consigliabile creare un Post di prova sul BOT, dopodiché inserire l'URL generata su [questo sito](https://www.expandurl.net/expand).\
Tra i **Redirects** dovremo essere in grado di verificare la presenza del REF all'interno dell'URL.
{% endhint %}