Introduzione al feed XML Awin
Il feed XML Awin è il formato standard per trasmettere i dati di catalogo alla piattaforma di affiliazione Awin. Questo canale consente ai merchant di distribuire le informazioni sui prodotti a una rete globale di editori affiliati, garantendo che i partner abbiano accesso a dati accurati e aggiornati per promuovere i vostri articoli.
A differenza di un semplice catalogo, il feed Awin funziona come un ponte tra il vostro sistema e-commerce e la rete di affiliati. Ogni campo nel feed influisce direttamente sulla capacità degli editori di presentare i vostri prodotti in modo efficace e sulla facilità con cui i clienti finali trovano ciò che cercano.
Struttura e campi fondamentali del feed
Il feed XML Awin contiene più di 50 campi disponibili. Non tutti sono obbligatori, ma quelli principali determinano l'approvazione del feed e la qualità della presentazione del prodotto.
Campi identificativi e di base
| Campo | Descrizione | Importanza |
|---|---|---|
| pid | Identificatore univoco del prodotto nel vostro sistema | Obbligatorio. Consente a Awin di tracciare ogni articolo |
| name | Nome del prodotto | Obbligatorio. Deve essere descrittivo e leggibile |
| brand | Marca del prodotto | Fortemente consigliato. Aiuta gli affiliati a filtrare e categorizzare |
| purl | URL del prodotto nel vostro negozio | Obbligatorio. Deve essere un link funzionante e diretto |
| condition | Stato del prodotto (nuovo, ricondizionato, usato) | Consigliato. Influisce sulla fiducia dell'acquirente |
Il campo pid deve essere stabile nel tempo. Se cambiate l'identificatore di un prodotto, Awin non riconoscerà più il collegamento con i dati precedenti e il tracciamento delle vendite si interromperà.
Campi di prezzo e disponibilità
| Campo | Descrizione | Importanza |
|---|---|---|
| price | Prezzo del prodotto in formato numerico | Obbligatorio. Deve corrispondere al prezzo sul vostro sito |
| currency | Codice valuta ISO (EUR, GBP, USD) | Obbligatorio se il prezzo è presente |
| instock | Stato di disponibilità (Y/N o true/false) | Critico. Un valore errato causa rifiuti di ordine |
| stockquant | Quantità disponibile in magazzino | Consigliato per prodotti con stock limitato |
| deltime | Tempo di consegna in giorni | Consigliato. Influisce sulla decisione di acquisto |
| delcost | Costo della spedizione | Consigliato. Deve essere accurato per evitare sorprese |
Il campo instock è critico per la performance. Se indicate un prodotto come disponibile quando in realtà è esaurito, gli ordini verranno rifiutati e gli affiliati perderanno fiducia nel vostro feed.
Campi descrittivi e di classificazione
| Campo | Descrizione | Importanza |
|---|---|---|
| desc | Descrizione completa del prodotto | Fortemente consigliato. Fornisce contesto agli acquirenti |
| category | Categoria merceologica del prodotto | Consigliato. Aiuta nella navigazione e nel filtering |
| keywords | Parole chiave associate al prodotto | Consigliato per migliorare la ricercabilità |
| ptype | Tipo di prodotto (es. libro, abbigliamento, elettronica) | Consigliato per la classificazione |
La descrizione deve essere leggibile e ben strutturata. Evitate testo in maiuscolo continuo o concatenazione di parole senza spazi. Una descrizione di qualità aumenta il tasso di conversione.
Campi di immagini
| Campo | Descrizione | Importanza |
|---|---|---|
| imgurl | URL dell'immagine principale del prodotto | Obbligatorio. Deve essere accessibile e in buona risoluzione |
| thumburl | URL dell'immagine in miniatura | Consigliato per visualizzazioni in lista |
| alternate_image | Immagine alternativa 1 | Consigliato per mostrare varianti o angolazioni diverse |
| alternate_image_two | Immagine alternativa 2 | Consigliato |
| alternate_image_three | Immagine alternativa 3 | Consigliato |
| alternate_image_four | Immagine alternativa 4 | Consigliato |
| large_image | Immagine ad alta risoluzione | Consigliato per visualizzazioni dettagliate |
Le immagini devono essere ospitate su server stabili e raggiungibili. Se un URL non funziona, Awin non potrà visualizzare il prodotto correttamente e gli editori non avranno una rappresentazione visiva da promuovere. Utilizzate formati standard (JPEG, PNG) e assicuratevi che le dimensioni siano ottimizzate per il web.
Campi di identificazione tecnica
| Campo | Descrizione | Importanza |
|---|---|---|
| ean | Codice EAN/GTIN europeo | Consigliato per prodotti fisici |
| upc | Codice UPC nordamericano | Consigliato per prodotti venduti negli USA |
| isbn | Codice ISBN per libri | Obbligatorio per libri |
| mpn | Numero di parte del produttore | Consigliato per elettronica e componenti |
| modelno | Numero di modello | Consigliato per identificare varianti specifiche |
Questi campi sono essenziali per il matching con altre piattaforme e per evitare duplicati. Se fornite un EAN valido, le piattaforme di comparazione prezzi possono collegare il vostro prodotto a quello di altri merchant, aumentando la visibilità.
Campi per varianti e attributi
Molti prodotti hanno varianti (colore, taglia, materiale). Awin supporta campi specifici per questi attributi:
| Campo | Descrizione | Utilizzo |
|---|---|---|
| colour | Colore del prodotto | Usate per abbigliamento, accessori, articoli per la casa |
| size | Taglia o dimensione | Usate per abbigliamento, scarpe, biancheria |
| material | Materiale di composizione | Usate per tessuti, mobili, articoli sportivi |
| pattern | Motivo o disegno | Usate per tessuti, carta da parati, abbigliamento |
| swatch | URL di un campione visivo del materiale | Usate per mostrare texture o pattern |
| dimensions | Dimensioni fisiche (larghezza x altezza x profondità) | Usate per mobili, scatole, articoli di grandi dimensioni |
Se il vostro catalogo include prodotti con molte varianti, considerate l'uso del campo item_group_id (noto come parentpid in alcuni sistemi) per raggruppare le varianti sotto un unico prodotto principale.
Campi per promozioni e offerte speciali
| Campo | Descrizione | Importanza |
|---|---|---|
| promotext | Testo della promozione | Consigliato per comunicare offerte limitate |
| validfrom | Data di inizio della promozione | Consigliato se usate promotext |
| validto | Data di fine della promozione | Consigliato se usate promotext |
| saving | Importo o percentuale di sconto | Consigliato per evidenziare il valore |
| preorder | Indicatore di pre-ordine | Usate se il prodotto non è ancora disponibile |
| weboffer | Indicatore che il prezzo è esclusivo online | Consigliato per distinguere offerte web |
Le promozioni devono essere accurate e aggiornate. Se indicate una validità scaduta, gli affiliati continueranno a promuovere un'offerta che non esiste più, danneggiando la reputazione.
Campi aggiuntivi e personalizzati
Awin consente fino a 9 campi personalizzati (custom1 attraverso custom9). Questi sono utili per trasmettere informazioni specifiche del vostro modello di business:
- custom1 - custom9: Campi liberi per dati aggiuntivi (es. codice interno, categoria interna, livello di commissione, target di pubblico)
I campi personalizzati non sono elaborati automaticamente da Awin, ma gli affiliati possono accedervi per filtri e selezioni avanzate.
Campi di tracciamento e gestione
| Campo | Descrizione | Utilizzo |
|---|---|---|
| lastupdated | Data e ora dell'ultimo aggiornamento | Awin usa questo per identificare i feed obsoleti |
| cg | Identificatore della commissione o categoria di commissione | Consente di applicare diverse percentuali di commissione per prodotto |
| basket_link | URL diretto al carrello con prodotto precaricato | Usate per semplificare il percorso di acquisto |
Il campo lastupdated deve essere presente e accurato. Se non aggiornate questo campo, Awin potrebbe considerare il vostro feed obsoleto e smettere di elaborarlo.
Campi per valutazioni e recensioni
| Campo | Descrizione | Importanza |
|---|---|---|
| reviews | Numero di recensioni ricevute | Consigliato per build trust |
| rating | Valutazione numerica (es. 4.5) | Consigliato |
| average_rating | Valutazione media calcolata | Consigliato |
Le valutazioni aumentano significativamente il tasso di conversione. Se disponibili, includetele sempre.
Campi per restrizioni e metadati
| Campo | Descrizione | Utilizzo |
|---|---|---|
| delivery_restrictions | Paesi o aree dove la consegna non è disponibile | Usate se avete limitazioni geografiche |
| warranty | Informazioni sulla garanzia | Consigliato per elettronica e articoli ad alto valore |
| suitable_for | Pubblico target (es. bambini, adulti, professionisti) | Consigliato per chiarire l'uso previsto |
| spec | Specifiche tecniche dettagliate | Consigliato per elettronica e articoli complessi |
Linee guida pratiche per l'ottimizzazione del feed
1. Validazione della struttura XML
Prima di caricare il feed, validate la struttura XML utilizzando uno strumento online gratuito. Un XML malformato verrà rifiutato completamente da Awin e non sarà elaborato.
Esempio di struttura corretta:
<?xml version="1.0" encoding="UTF-8"?>
<products>
<product>
<pid>12345</pid>
<name>Prodotto esempio</name>
<price>99.99</price>
<currency>EUR</currency>
<instock>Y</instock>
<purl>https://www.vostrosito.com/prodotto-esempio</purl>
<imgurl>https://www.vostrosito.com/images/prodotto.jpg</imgurl>
</product>
</products>
Assicuratevi che tutti i caratteri speciali (come &, <, >) siano codificati correttamente (&, <, >).
2. Coerenza dei dati nel tempo
Mantengono i valori dei campi coerenti tra gli aggiornamenti del feed. Se il prezzo di un prodotto cambia frequentemente, gli affiliati vedranno informazioni contraddittorie e perderanno fiducia.
Implementate un sistema di controllo di qualità che confronti il feed attuale con il precedente e segnali le variazioni anomale.
3. Completezza dei campi obbligatori
Non lasciate campi obbligatori vuoti. Se un prodotto non ha un valore per un campo richiesto, escludete il prodotto dal feed piuttosto che inviare dati incompleti.
I campi veramente obbligatori sono:
- pid
- name
- price
- currency
- instock
- purl
- imgurl
4. Formato dei prezzi
I prezzi devono essere in formato numerico con punto decimale (99.99, non 99,99). Non includete simboli di valuta nel campo price.
5. URL funzionanti e stabili
Tutti gli URL (purl, imgurl, alternate_image, ecc.) devono essere:
- Completamente qualificati (https://www.dominio.com/...)
- Funzionanti e raggiungibili
- Stabili nel tempo (non cambiate URL di prodotto frequentemente)
Se un URL non funziona, Awin segnalerà il prodotto come non valido.
6. Descrizioni di qualità
Le descrizioni devono essere:
- Leggibili e ben strutturate
- Lunghe almeno 50 caratteri
- Libere da caratteri speciali non codificati
- Accurate e aggiornate
Una descrizione scarsa riduce il tasso di conversione degli affiliati.
7. Immagini ad alta qualità
Le immagini sono il primo elemento visivo che gli acquirenti vedono. Assicuratevi che:
- Siano in buona risoluzione (almeno 500x500 pixel)
- Mostrino il prodotto chiaramente
- Siano ospitate su server affidabili
- Abbiano un tempo di caricamento rapido
Utilizzate più immagini alternative per mostrare diverse angolazioni o varianti.
8. Aggiornamenti frequenti
Aggiordate il feed almeno una volta al giorno, preferibilmente ogni ora per i dati critici come disponibilità e prezzo. Awin controlla il campo lastupdated per determinare se il feed è ancora attivo.
9. Gestione delle varianti
Se un prodotto ha multiple varianti (colori, taglie), avete due opzioni:
- Creare un prodotto separato per ogni combinazione di varianti, con pid univoci.
- Creare un prodotto principale con parentpid che raggruppa le varianti.
La scelta dipende da come il vostro sistema e-commerce gestisce le varianti. Comunicate chiaramente agli affiliati quale approccio state utilizzando.
10. Sincronizzazione con il vostro e-commerce
Implementate un processo automatico che sincronizzi il vostro catalogo e-commerce con il feed Awin. Manualmente aggiornare il feed è propenso a errori e ritardi.
Utilizzate API o sistemi di esportazione automatica per garantire che i dati siano sempre allineati.
Campi specifici per categorie di prodotti
Abbigliamento e accessori
Prioritizzate: colour, size, material, pattern, swatch. Includete immagini che mostrino il prodotto indossato o da diverse angolazioni.
Elettronica
Prioritizzate: spec, mpn, modelno, warranty, ean. Fornite specifiche tecniche dettagliate e garanzia.
Libri
Obbligatorio: isbn. Includete anche author se disponibile tramite un campo personalizzato.
Mobili e articoli per la casa
Prioritizzate: dimensions, material, colour, large_image. Fornite misure precise e immagini che mostrino il prodotto in contesto.
Articoli sportivi
Prioritizzate: size, material, suitable_for, spec. Specificate il pubblico target e le caratteristiche tecniche.
Troubleshooting e problemi comuni
Il feed non viene elaborato
Verificate:
- La struttura XML è valida (usate un validatore online)
- L'encoding è UTF-8
- Tutti i caratteri speciali sono codificati correttamente
- L'URL del feed è raggiungibile
I prodotti non vengono approvati
Verificate:
- Tutti i campi obbligatori sono presenti e compilati
- Gli URL funzionano
- Il prezzo è in formato numerico
- Le immagini sono accessibili
- La descrizione è di qualità
I prezzi non si aggiornano
Verificate:
- Il feed viene aggiornato frequentemente
- Il campo lastupdated è aggiornato
- Il prezzo nel feed corrisponde a quello del vostro sito
- Non ci sono errori di parsing nel vostro sistema
Gli affiliati segnalano dati mancanti o errati
Implementate un processo di controllo di qualità che verifichi:
- Completezza dei campi consigliati
- Coerenza dei dati nel tempo
- Assenza di duplicati
- Accuratezza delle informazioni
Integrazione con altre piattaforme
Awin è spesso una delle molte piattaforme di distribuzione che gestite. Se utilizzate anche Google Shopping, Idealo, Kelkoo o altre piattaforme, potete ottimizzare il vostro workflow mappando gli stessi dati sorgente a più feed.
Molti campi Awin corrispondono a quelli richiesti da altre piattaforme:
- pid corrisponde a id in Google Shopping
- price è universale
- imgurl corrisponde a image_link in Google Shopping
- purl corrisponde a link in Google Shopping
Documentate le vostre mappature di campo in modo che il vostro team possa mantenere la coerenza tra le piattaforme.
Monitoraggio e reporting
Awin fornisce report sulla performance del vostro feed:
- Numero di prodotti elaborati: Dovrebbe corrispondere al numero di prodotti nel vostro feed.
- Numero di prodotti approvati: Dovrebbe essere il più alto possibile.
- Numero di prodotti rifiutati: Investigate i motivi dei rifiuti e correggete i dati.
- Performance delle vendite per prodotto: Usate questi dati per identificare quali prodotti convertono meglio.
Verificate regolarmente questi report (almeno settimanalmente) per identificare e risolvere i problemi tempestivamente.
Considerazioni finali
Il feed XML Awin è uno strumento potente per raggiungere una rete globale di affiliati. La qualità del vostro feed determina direttamente la qualità della promozione che ricevete.
Investite nel mantenimento di dati accurati e aggiornati. Un feed di qualità elevata porta a:
- Maggiore approvazione dei prodotti
- Migliore performance degli affiliati
- Tassi di conversione più alti
- Relazioni più forti con i partner
Implementate processi automatici per la sincronizzazione, validate regolarmente i dati e monitorate la performance. Con questi accorgimenti, otterrete il massimo dalla vostra partnership con Awin.