# 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 %}
---
# Agent Instructions: Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.
Perform an HTTP GET request on the current page URL with the `ask` query parameter:
```
GET https://docs.dealsbot.io/configurazione-base/configurazione-dei-ref.md?ask=
```
The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.
Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.