Destinations

Feed XML Awin: guida tecnica ai campi e all'ottimizzazione

Guida completa ai campi del feed XML Awin per affiliati e merchant. Scopri come mappare i dati prodotto, ottimizzare la visibilità e rispettare i requisiti della piattaforma.

12 min di lettura Aggiornato il 9 Lug 2026

Nessun risultato trovato

Provi parole chiave diverse o sfogli tutti gli articoli della guida.

    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:

    1. Creare un prodotto separato per ogni combinazione di varianti, con pid univoci.
    2. 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.