# REF Awin (es: Unieuro)

Esistono due modalità per la configurazione dei REF Awin sul BOT:<br>

* Mediante l'utilizzo delle API ufficiali fornite da Awin (**consigliata**, *la validità del REF è garantita dall'API di Awin*)<br>
* Attraverso la configurazione manuale del REF per il singolo store (*la validità del REF risultante dipende dalla correttezza nell'esecuzione della procedura*)

### Metodo 1: Configurazione API Awin

La modalità consigliata per l'applicazione dei REF Awin sui Link inviati al BOT è tramite l'utilizzo delle loro API ufficiali.<br>

#### Ottenimento del Token API

Prima di procedere con la configurazione sul BOT è necessario ottenere il Token API dal proprio account Awin, tramite la seguente procedura:<br>

1. Aprire la pagina <https://ui.awin.com/awin-api> ed effettuare il login con il proprio account Awin<br>
2. Dopo il login si potrebbe venir portati alla Home Page, se così fosse riaprire il link: <https://ui.awin.com/awin-api><br>
3. Ci si dovrebbe trovare nella pagina "*Credenziali API*", se così non fosse selezionare il nome del profilo in alto a destra e cercare la voce "*Credenziali API*" (o "*API Credentials*")<br>
4. Inserire quindi la password del proprio account Awin e cliccare il pulsante "*Mostra il mio codice API*", dovrebbe essere visualizzato il "*Codice OAuth2*" necessario sul BOT:\
   \
   ![](https://1389721046-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MQfZ2PM46mTwyJL4rjI-116534825%2Fuploads%2F8QHqgjlXn1n2AkPoGNWP%2Fimage.png?alt=media\&token=2cbff501-d6bc-45ac-b13a-d36d3e621062)<br>
5. Copiare il Codice OAuth2, ci servirà sul BOT.

#### Configurazione del Token API sul BOT

La configurazione sul BOT viene effettuata nella sezione:

<p align="center"><em>Impostazioni -> REF -> REF Awin</em></p>

IMG1<br>

Selezionare il pulsante "*Configura Token API*" ed inviare il token (*Codice OAuth2*) precedentemente copiato.

Se il codice è corretto il BOT lo accetterà e ci si troverà di fronte ad una schermata simile alla seguente:\
\
IMG2<br>

#### Configurazione delle Campagne Awin sul BOT

A questo punto non resta altro da fare che configurare le campagne (Siti Web) per le quali si vuole accorciare i link.<br>

1. Selezionare la voce "*Gestisci Campagne*" e poi "*Aggiungi Campagna*"<br>
2. Il BOT chiederà la selezione dell'account Publisher Awin tra quelli configurati all'interno del proprio account, selezionarlo<br>
3. Dopodiché verranno mostrate, in ordine alfabetico, tutte le campagne per le quali l'account risulta iscritto. Selezionare la campagna da aggiungere per completare la procedura.<br>
4. La campagna verrà quindi visualizzata in lista con un pallino verde, che sta a significare essere **attiva ed utilizzata dal BOT** per il REF dei link del corrispondente sito web.\
   Se selezionata il pallino diventerà **rosso** ad indicare che la campagna è **disattiva** (*ovvero il BOT non utilizzerà le API di Awin per applicare il REF per i link inviati relativi a quel sito web*). <br>
5. Aggiungere le campagne rimanenti, dopodiché tornare alla pagina precedente ed attivare la spunta all'opzione "*Utilizza API Awin*" per iniziare ad accorciare i link<br>

#### Altre opzioni disponibili con l'utilizzo delle API Awin

Tra le altre voci disponibili nella sezione "*REF Awin*" troviamo:<br>

* **Parametri Link:** permettono di configurare dei parametri di REF aggiuntivi, in particolare:
  * **Parametro ClickRef:** se si specifica un valore questo verrà applicato all'interno del link nel parametro "clickref", utile per tracciare lato statistiche Awin la provenienza dei click.\
    Il parametro ClickRef 2 ha la medesima funzionalità, andando a definire un eventuale "clickref2" nel link.<br>
* **Accorcia Link:** se attiva i link risultanti dal REF saranno accorciati direttamente da Awin (*utilizzando il servizio tidd.ly*). Altrimenti il BOT utilizzerà la configurazione di accorciamento link predefinita.\
  **Nota:** ogni account Awin ha un numero limitato di link giornalieri accorciabili, consultabile con la pressione del pulsante 📊. I link dei Post Automatici supportati (*ad esempio Unieuro*) verranno accorciati solamente alla pubblicazione.<br>
* **Rimuovi API Awin:** se selezionato rimuove l'intera configurazione di Awin sul BOT.

{% hint style="warning" %}
**ATTENZIONE**\
\
La presenza di una campagna configurata ed attiva per uno store dà automaticamente la priorità all'utilizzo delle API di Awin per l'applicazione del REF.\
Eventuali REF configurati all'interno dell'Admin (*tramite il "Metodo 2" elencato sotto*) per il medesimo sito NON verranno presi in considerazione.
{% endhint %}

### Metodo 2: Configurazione Manuale (senza utilizzo API)

In questo esempio si vedrà come configurare il REF Unieuro senza l'utilizzo delle API Awin (**sconsigliato**).&#x20;

{% hint style="info" %}
Questa procedura può essere applicata alla configurazione di **qualsiasi store** supportato da Awin (*adattandola allo store in questione*).
{% endhint %}

E' possibile configurare il REF di Unieuro tramite il network di affiliazione [Awin](https://www.awin.com/it).

Una volta completata l'iscrizione ad Awin e ottenuto accesso alla Dashboard, creare un link (non accorciato) ad un prodotto Unieuro con il proprio REF utilizzando lo strumento ufficiale.

Il link risultante sarà simile al seguente:

`https://www.awin1.com/cread.php?awinmid=xxxx&awinaffid=yyyy&platform=dl&ued=https%3A%2F%2Fwww.unieuro.it%2Fonline%2Fmanamana-black-friday`

{% hint style="info" %}
Si può notare come il link Awin contenga l'URL del prodotto (Unieuro) dopo il parametro `ued=`.

Si tratta dunque di una tipologia di REF`in URL`, in quanto il link del prodotto è contenuta come parametro.
{% endhint %}

Il link generato dovrà essere preso fino ad `ued=` (simbolo `=` incluso), la parte successiva va tagliata. Il link sopra diventa quindi:

`https://www.awin1.com/cread.php?awinmid=xxxx&awinaffid=yyyy&platform=dl&ued=`

**Sarà necessario quindi eseguire i seguenti Step sul BOT:**

* Navigare in `Impostazioni -> REF` e selezionare l'Admin a cui applicare il nuovo REF.
* Selezionare `Aggiungi REF` ed in seguito `Personalizzato`.
* Come Dominio inserire unieuro.it e premere invio.
* Come Tipologia REF selezionare `REF in URL`.
* Inviare ora il link **modificato** generato precedentemente da Awin (fino a ued=)
* Se l'operazione è stata eseguita correttamente il REF dovrebbe essere applicato e ci si dovrebbe trovare di fronte ad una schermata simile alla seguente:

  ![](https://1389721046-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MQfZ2PM46mTwyJL4rjI-116534825%2Fuploads%2FmOwwpVmFSIYBxdwM2Zjj%2Funieuro-ref.png?alt=media\&token=04f230d3-fc0c-429b-831f-53815e81b462) &#x20;

{% hint style="warning" %}
Molti ci chiedono se è possibile configurare il REF Unieuro tramite **Admitad**: il BOT supporta l'integrazione con le [API di Admitad](https://docs.dealsbot.io/configurazione-base/configurazione-dei-ref/..#configurazione-di-un-ref-admitad), ma purtroppo queste non sono ancora compatibili con i programmi LITE (ai quali Unieuro fa parte), pertanto non è al momento possibile configurare il REF Unieuro sul BOT tramite questo network di affiliazione!
{% endhint %}
