Destinations

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

Guida completa al feed XML per Awin Affiliate Network. Scopri la struttura dei campi, le best practice per l'integrazione e come ottimizzare la visibilità dei prodotti.

19 min di lettura 40 visualizzazioni 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 è lo strumento standard per trasmettere i dati dei tuoi prodotti alla rete di affiliazione Awin. Questo formato consente ai merchant di sincronizzare il proprio catalogo prodotti con i partner affiliati, garantendo che le informazioni rimangano coerenti e aggiornate su tutta la rete.

    Awin è una delle maggiori reti affiliate a livello mondiale. I merchant utilizzano il feed XML per esporre i propri articoli ai publisher che promuovono i prodotti in cambio di una commissione. Senza un feed ben strutturato, i tuoi prodotti non compariranno correttamente nei materiali promozionali degli affiliati, riducendo la visibilità e le vendite potenziali.

    Questa guida copre ogni campo disponibile nel feed, spiega perché ciascuno è importante e fornisce indicazioni pratiche per ottimizzare la qualità del feed e migliorare le prestazioni della rete.

    Struttura e campi principali del feed XML Awin

    Il feed XML Awin utilizza una struttura gerarchica in cui ogni prodotto è rappresentato da un elemento contenente una serie di campi specifici. La corretta mappatura di questi campi influisce direttamente sulla qualità del listing, sull'approvazione del feed e sulla capacità degli affiliati di promuovere i tuoi prodotti in modo efficace.

    Campi di identificazione e base prodotto

    Campo Tipo Obbligatorio Descrizione e impatto
    pid Stringa Identificatore univoco del prodotto nel tuo sistema. Deve rimanere stabile nel tempo. Awin utilizza questo valore per tracciare gli aggiornamenti e collegare le conversioni al prodotto corretto. Un pid incoerente causa duplicati o perdita di dati di performance.
    name Stringa Nome del prodotto. Deve essere chiaro, accurato e contenere informazioni essenziali (marca, modello, variante). I nomi vaghi o generici riducono la rilevanza negli annunci degli affiliati e la probabilità di click.
    desc Testo Descrizione dettagliata del prodotto. Include caratteristiche, benefici e specifiche tecniche. Awin e i suoi affiliati utilizzano questo testo per creare annunci e schede prodotto. Descrizioni complete aumentano il tasso di conversione.
    purl URL URL della pagina prodotto sul tuo sito. Deve essere una URL diretta, valida e accessibile. Gli affiliati usano questo link per indirizzare il traffico verso il tuo negozio. URL errate o non funzionanti causano perdita di vendite e danneggiano la fiducia dei partner.
    brand Stringa Consigliato Marchio del prodotto. Facilita la ricerca degli affiliati e consente filtri più specifici. I prodotti con brand definito hanno tassi di conversione più alti perché gli affiliati possono rivolgersi a audience interessate a quella marca.
    category Stringa Consigliato Categoria merceologica del prodotto (ad esempio, 'Abbigliamento > Uomo > Magliette'). Awin utilizza questa informazione per organizzare il catalogo e permettere agli affiliati di cercare prodotti per categoria. Una categorizzazione precisa migliora la visibilità.
    ptype Stringa Consigliato Tipo di prodotto (ad esempio, 'Maglietta', 'Libro', 'Smartphone'). Simile a category, ma più specifico. Aiuta gli affiliati a identificare rapidamente cosa stai vendendo.

    Campi di prezzo e disponibilità

    Campo Tipo Obbligatorio Descrizione e impatto
    price Decimale Prezzo di vendita del prodotto nel formato numerico (ad esempio, 29.99). Questo è il prezzo che gli affiliati comunicheranno ai loro audience. Un prezzo errato causa reclami e restituzioni. Assicurati che corrisponda al tuo sito in tempo reale.
    currency Codice ISO Codice valuta ISO 4217 (ad esempio, EUR, GBP, USD). Awin ha bisogno di questa informazione per calcolare correttamente le commissioni e per permettere ai partner di comprendere il valore della transazione. Una valuta errata causa confusione e problemi di tracciamento.
    delcost Decimale Consigliato Costo della spedizione. Se omesso, gli affiliati non sapranno quale costo aggiungere al prezzo finale. Questo influisce sulla percezione del valore da parte dell'acquirente e sul tasso di conversione.
    deltime Stringa Consigliato Tempo di consegna (ad esempio, '2-3 giorni lavorativi'). Gli affiliati comunicano questo dato ai potenziali clienti. Tempi di consegna chiari e competitivi sono un fattore decisivo nell'acquisto.
    instock Booleano (true/false) Consigliato Indica se il prodotto è disponibile. Awin esclude automaticamente i prodotti non disponibili dalle campagne attive. Se non aggiornato, gli affiliati promuoveranno articoli esauriti, causando frustrazione e perdita di commissioni.
    stockquant Numero intero Consigliato Quantità disponibile in magazzino. Aiuta gli affiliati a comunicare urgenza ('Solo 3 disponibili') e consente a Awin di gestire meglio la distribuzione.
    preorder Booleano (true/false) Consigliato Indica se il prodotto è in pre-ordine. Distingue i prodotti ordinabili ma non ancora spediti da quelli in stock. Gli affiliati utilizzano questa informazione per impostare aspettative corrette.
    condition Stringa Consigliato Condizione del prodotto (ad esempio, 'Nuovo', 'Ricondizionato', 'Usato'). Prodotti ricondizionati o usati hanno commissioni diverse e pubblici diversi. Una condizione errata porta a reclami e restituzioni.

    Campi di immagine e media

    Campo Tipo Obbligatorio Descrizione e impatto
    imgurl URL URL dell'immagine principale del prodotto. Deve essere un'immagine di alta qualità, ben illuminata e rappresentativa. Awin e i suoi affiliati utilizzano questa immagine negli annunci. Un'immagine scadente riduce il tasso di click e le conversioni.
    thumburl URL Consigliato URL di una versione in miniatura dell'immagine. Utilizzata in elenchi e anteprime. Se omessa, Awin creerà una versione ridotta automaticamente, ma una miniatura ottimizzata appositamente migliora la visualizzazione.
    alternate_image URL Consigliato URL di un'immagine alternativa del prodotto (ad esempio, una vista diversa o un colore diverso). Consente agli affiliati di mostrare il prodotto da angolazioni multiple. Più immagini aumentano l'engagement.
    alternate_image_two URL Consigliato Seconda immagine alternativa.
    alternate_image_three URL Consigliato Terza immagine alternativa.
    alternate_image_four URL Consigliato Quarta immagine alternativa.
    large_image URL Consigliato URL di un'immagine ad alta risoluzione per visualizzazioni dettagliate. Utilizzata quando gli affiliati vogliono mostrare il prodotto in grande formato. Immagini ad alta risoluzione migliorano la percezione di qualità.
    swatch URL Consigliato URL di un'immagine campione (ad esempio, un campione di colore o tessuto). Particolarmente utile per prodotti di moda e home decor. I campioni aumentano la fiducia dell'acquirente.

    Campi di identificazione e codici prodotto

    Campo Tipo Obbligatorio Descrizione e impatto
    ean Stringa Consigliato Codice EAN (European Article Number) del prodotto. Utilizzato per identificare univocamente il prodotto a livello internazionale. Awin lo utilizza per collegare i tuoi dati con informazioni di terze parti. Un EAN corretto migliora la qualità del feed.
    upc Stringa Consigliato Codice UPC (Universal Product Code), utilizzato principalmente negli Stati Uniti. Simile all'EAN.
    isbn Stringa Consigliato Codice ISBN per libri. Necessario se vendi pubblicazioni. Awin utilizza questo codice per collegare i dati con database di libri.
    modelno Stringa Consigliato Numero di modello del prodotto. Particolarmente importante per elettronica e beni durevoli. Consente agli affiliati di identificare con precisione varianti specifiche.
    mpn Stringa Consigliato Numero di parte del produttore. Simile a modelno, ma è l'identificatore ufficiale del produttore. Awin utilizza questo per validare i dati e collegare i prodotti con informazioni di terze parti.

    Campi di specifiche e attributi prodotto

    Campo Tipo Obbligatorio Descrizione e impatto
    spec Testo Consigliato Specifiche tecniche del prodotto (ad esempio, 'Memoria: 8 GB, Processore: Intel Core i7'). Awin visualizza queste informazioni nei listing. Specifiche complete aiutano gli acquirenti a prendere decisioni informate e riducono i resi.
    size Stringa Consigliato Taglia o dimensione (ad esempio, 'L', 'XL', '42'). Se il prodotto ha varianti di taglia, includi la taglia specifica. Le taglie errate causano resi e reclami.
    colour Stringa Consigliato Colore del prodotto (ad esempio, 'Rosso', 'Blu scuro'). Per prodotti disponibili in più colori, includi il colore specifico di questo articolo.
    dimensions Stringa Consigliato Dimensioni fisiche (ad esempio, '30 x 20 x 10 cm'). Particolarmente importante per mobili e articoli voluminosi. Gli affiliati comunicheranno queste dimensioni ai clienti.
    material Stringa Consigliato Materiale del prodotto (ad esempio, 'Cotone 100%', 'Acciaio inossidabile'). Gli acquirenti spesso cercano materiali specifici.
    pattern Stringa Consigliato Motivo o design (ad esempio, 'A righe', 'Floreale'). Utile per abbigliamento e articoli decorativi.
    keywords Stringa Consigliato Parole chiave rilevanti per il prodotto, separate da virgola. Awin le utilizza per migliorare la ricerca. Parole chiave accurate aumentano la probabilità che il tuo prodotto compaia nei risultati di ricerca degli affiliati.

    Campi di promozione e validità

    Campo Tipo Obbligatorio Descrizione e impatto
    saving Decimale Consigliato Importo dello sconto o risparmio (ad esempio, 5.00 per uno sconto di 5 euro). Awin visualizza questa informazione per attirare l'attenzione. Uno sconto comunicato chiaramente aumenta il tasso di click.
    promotext Stringa Consigliato Testo promozionale breve (ad esempio, 'Sconto del 20%', 'Spedizione gratuita'). Awin lo visualizza in evidenza. Un messaggio promozionale accattivante migliora le conversioni.
    validfrom Data Consigliato Data di inizio della promozione (formato YYYY-MM-DD). Awin attiva automaticamente la promozione in questa data. Una data errata causa attivazione prematura o ritardata.
    validto Data Consigliato Data di fine della promozione. Awin disattiva automaticamente la promozione dopo questa data. Una data scaduta fa sì che gli affiliati promuovano offerte non più valide.
    warranty Stringa Consigliato Informazione sulla garanzia (ad esempio, '2 anni di garanzia'). Gli affiliati comunicano questo dato ai clienti. Una garanzia chiara aumenta la fiducia e il tasso di conversione.

    Campi di organizzazione e collegamento

    Campo Tipo Obbligatorio Descrizione e impatto
    parentpid Stringa Consigliato ID del prodotto padre, utilizzato quando un prodotto è una variante di un altro (ad esempio, una maglietta rossa è una variante di una maglietta generica). Awin utilizza questo per raggruppare varianti. Un parentpid corretto migliora l'organizzazione del catalogo.
    cg Stringa Consigliato Gruppo di commissione. Specifica quale commissione applicare a questo prodotto. Awin utilizza questo valore per calcolare automaticamente le commissioni dovute agli affiliati. Un cg errato causa calcoli di commissione scorretti.
    suitable_for Stringa Consigliato A chi è adatto il prodotto (ad esempio, 'Donne', 'Bambini', 'Professionisti'). Aiuta gli affiliati a indirizzare il prodotto al pubblico corretto.
    lang Codice ISO Consigliato Codice lingua ISO 639-1 (ad esempio, 'it', 'en', 'de'). Indica la lingua del prodotto e dei contenuti. Awin la utilizza per filtrare i prodotti per mercato. Una lingua corretta garantisce che il prodotto compaia nei mercati appropriati.

    Campi di consegna e restrizioni

    Campo Tipo Obbligatorio Descrizione e impatto
    delivery_restrictions Stringa Consigliato Restrizioni sulla consegna (ad esempio, 'Non spedito in Svizzera', 'Solo EU'). Awin esclude automaticamente il prodotto da affiliati in aree non servite. Restrizioni errate causano ordini che non possono essere evasi.
    basket_link URL Consigliato URL diretta al carrello con il prodotto già aggiunto. Consente agli affiliati di reindirizzare direttamente al checkout. Un basket_link funzionante riduce i passaggi e aumenta le conversioni.
    weboffer Stringa Consigliato Indicazione se il prodotto è un'offerta web esclusiva. Aiuta gli affiliati a comunicare l'esclusività.

    Campi di valutazione e feedback

    Campo Tipo Obbligatorio Descrizione e impatto
    reviews Numero intero Consigliato Numero di recensioni ricevute dal prodotto. Awin lo visualizza per indicare la popolarità. Un numero elevato di recensioni aumenta la fiducia dell'acquirente.
    average_rating Decimale (0-5) Consigliato Valutazione media del prodotto. Awin la visualizza accanto al numero di recensioni. Una valutazione alta (4+) aumenta significativamente il tasso di conversione.
    rating Decimale (0-5) Consigliato Valutazione del prodotto (alternativa a average_rating).

    Campi di metadata e aggiornamento

    Campo Tipo Obbligatorio Descrizione e impatto
    lastupdated Data/Ora Consigliato Timestamp dell'ultimo aggiornamento del prodotto (formato ISO 8601). Awin utilizza questo per identificare i prodotti aggiornati di recente e per rilevare feed non aggiornati. Un timestamp corretto garantisce che Awin sincronizzi i dati in tempo.
    custom1 fino a custom9 Stringa Facoltativo Campi personalizzati per dati specifici della tua attività non coperti dai campi standard. Ad esempio, custom1 potrebbe contenere il codice fornitore, custom2 il peso, ecc. Utilizza questi campi per trasmettere informazioni aggiuntive rilevanti per gli affiliati.

    Linee guida per l'ottimizzazione del feed XML Awin

    Completezza e coerenza dei dati

    Awin valuta la qualità del feed in base alla completezza e alla coerenza dei dati. Un feed con campi mancanti o incoerenti viene penalizzato e i prodotti ricevono meno esposizione.

    Compila sempre i campi obbligatori (pid, name, desc, purl, price, currency, imgurl) con dati accurati e completi. Verifica che i prezzi e la disponibilità corrispondano al tuo sito web in tempo reale. Se il prezzo nel feed differisce dal prezzo sul tuo sito, gli affiliati riceveranno reclami dagli acquirenti.

    Utilizza nomi di prodotto descrittivi e specifici. Invece di 'Maglietta', scrivi 'Maglietta in cotone blu scuro taglia L'. I nomi specifici migliorano la ricerca e aumentano le conversioni.

    Compila la descrizione con almeno 50 parole di informazioni utili. Includi caratteristiche principali, benefici, specifiche tecniche e qualsiasi informazione che un potenziale cliente troverebbe rilevante. Descrizioni complete riducono le domande dei clienti e i resi.

    Immagini di qualità

    L'immagine è il fattore più importante nella decisione di acquisto online. Fornisci sempre un'immagine principale (imgurl) di alta qualità, ben illuminata e rappresentativa del prodotto.

    L'immagine deve mostrare il prodotto chiaramente, senza persone o elementi distraenti. Uno sfondo bianco o neutro migliora la leggibilità. La risoluzione deve essere di almeno 500 x 500 pixel, preferibilmente 1000 x 1000 o superiore.

    Fornisci immagini alternative (alternate_image, alternate_image_two, ecc.) che mostrino il prodotto da angolazioni diverse o in colori diversi. Gli affiliati utilizzeranno queste immagini per creare annunci più attraenti. Più immagini aumentano l'engagement del 20-30%.

    Assicurati che gli URL delle immagini siano stabili e non cambino. Se gli URL cambiano frequentemente, Awin avrà difficoltà a visualizzare le immagini e gli affiliati riceveranno errori.

    Categorizzazione e organizzazione

    Utilizza una struttura di categoria coerente e logica. Awin consiglia di utilizzare 2-3 livelli di categoria (ad esempio, 'Abbigliamento > Uomo > Magliette > T-shirt'). Una categorizzazione precisa consente agli affiliati di trovare i tuoi prodotti rapidamente.

    Se vendi prodotti con varianti (colori, taglie, ecc.), considera se creare prodotti separati per ogni variante o un singolo prodotto con varianti indicate in custom fields. La scelta dipende da come gestisci le varianti nel tuo sistema.

    Utilizza il campo parentpid per collegare le varianti al prodotto padre. Questo aiuta Awin a organizzare il catalogo e consente agli affiliati di promuovere l'intera linea di prodotto.

    Prezzi, sconti e promozioni

    Mantieni i prezzi sincronizzati con il tuo sito web. Se il prezzo nel feed è diverso dal prezzo sul tuo sito, gli affiliati riceveranno reclami e i clienti effettueranno restituzioni. Sincronizza il feed almeno una volta al giorno, preferibilmente ogni ora.

    Se offri sconti o promozioni, comunica l'importo dello sconto nel campo saving e il messaggio promozionale in promotext. Includi anche le date di validità (validfrom e validto). Sconti chiaramente comunicati aumentano il tasso di click del 15-25%.

    Non gonfiare artificialmente i prezzi originali per fare sembrare lo sconto più grande. Awin valida i prezzi e i feed con prezzi incoerenti vengono penalizzati.

    Disponibilità e consegna

    Aggiorna il campo instock in tempo reale. Se un prodotto è esaurito, imposta instock su 'false' in modo che Awin lo escluda automaticamente dalle campagne attive. Promuovere prodotti esauriti causa frustrazione e perdita di commissioni.

    Fornisci il tempo di consegna (deltime) e il costo di spedizione (delcost). Questi dati influiscono sulla percezione del valore dell'acquirente. Consegne veloci e spedizione gratuita sono fattori decisivi.

    Se hai restrizioni geografiche (ad esempio, non spedisci in Svizzera), indica questo nel campo delivery_restrictions. Awin escluderà automaticamente il prodotto da affiliati in aree non servite.

    Identificatori univoci e validazione

    Fornisci identificatori univoci come EAN, UPC, ISBN o MPN quando disponibili. Awin li utilizza per validare i dati e collegare i tuoi prodotti con informazioni di terze parti. Identificatori corretti migliorano la qualità del feed e riducono i duplicati.

    Assicurati che il pid (identificatore prodotto) rimanga stabile nel tempo. Se cambi il pid, Awin lo tratterà come un prodotto nuovo e perderà la cronologia di performance. Utilizza lo stesso pid per la durata della vita del prodotto.

    Aggiornamento regolare del feed

    Aggiorni il feed almeno una volta al giorno, preferibilmente ogni poche ore. Awin utilizza il timestamp lastupdated per identificare i prodotti aggiornati di recente. Un feed non aggiornato per più di una settimana viene contrassegnato come 'stale' (obsoleto) e Awin lo esclude dalle campagne attive.

    Implementa un processo automatico che sincronizzi il tuo catalogo prodotti con il feed XML. Non aggiornare il feed manualmente per ogni prodotto: questo è inefficiente e soggetto a errori.

    Integrazione e sincronizzazione del feed

    Preparazione del feed

    Prima di inviare il feed a Awin, verifica che sia valido dal punto di vista XML. Utilizza uno strumento di validazione XML online per controllare la sintassi.

    Verifica che tutti i campi obbligatori siano presenti e non vuoti. Awin rifiuta i feed con campi obbligatori mancanti.

    Verifica che gli URL (purl, imgurl, basket_link) siano validi e accessibili. Testa alcuni URL manualmente per assicurarti che non restituiscano errori 404.

    Verifica che i prezzi, le valute e i codici lingua siano corretti. Un errore in questi campi causa problemi di tracciamento e calcolo delle commissioni.

    Invio del feed a Awin

    Awin supporta due metodi di invio:

    1. Upload manuale tramite il pannello di controllo Awin. Adatto per feed piccoli o aggiornamenti occasionali.

    2. Hosting del feed su un server e fornitura dell'URL a Awin. Awin scaricherà il feed automaticamente secondo una pianificazione. Questo è il metodo consigliato per feed grandi o aggiornamenti frequenti.

    Se ospiti il feed su un server, assicurati che:

    • Il server sia sempre disponibile (uptime del 99%+).
    • Il feed sia accessibile tramite HTTPS.
    • Il server supporti le richieste di Awin (ad esempio, user-agent Awin).
    • Il feed sia compresso (gzip) se di grandi dimensioni per ridurre il tempo di download.

    Monitoraggio e validazione

    Dopo aver inviato il feed, monitora il pannello di controllo Awin per verificare che il feed sia stato importato correttamente. Awin fornirà un rapporto che indica:

    • Numero di prodotti importati.
    • Numero di errori e avvertimenti.
    • Campi mancanti o non validi.
    • Prodotti duplicati o non validi.

    Risolvi tutti gli errori segnalati. Un feed con molti errori non verrà approvato e i tuoi prodotti non appariranno nelle campagne degli affiliati.

    Verifica regolarmente che i dati nel feed corrispondano ai dati sul tuo sito web. Esegui audit periodici per identificare discrepanze.

    Best practice per massimizzare la performance

    Ottimizzazione per la ricerca degli affiliati

    Gli affiliati cercano i tuoi prodotti utilizzando il nome, la categoria, le parole chiave e il brand. Ottimizza questi campi per aumentare la visibilità:

    • Utilizza nomi specifici e descrittivi che contengono le parole chiave rilevanti.
    • Categorizza i prodotti in modo logico e coerente.
    • Includi parole chiave nel campo keywords (separate da virgola).
    • Fornisci il brand corretto.

    Ad esempio, invece di 'Scarpe da corsa', scrivi 'Scarpe da corsa Nike Air Max 270 nero taglia 42'. Includi le parole chiave nel campo keywords: 'scarpe, corsa, Nike, Air Max, nero'.

    Comunicazione della proposta di valore

    Utilizza i campi desc, promotext e spec per comunicare chiaramente il valore del tuo prodotto. Rispondi alle domande che i potenziali clienti si pongono:

    • Che cos'è il prodotto?
    • Quali sono i principali benefici?
    • Come è diverso dai concorrenti?
    • Quale è il prezzo e il valore?
    • Quali sono le condizioni di consegna?

    Una proposta di valore chiara aumenta il tasso di conversione del 20-40%.

    Gestione delle varianti di prodotto

    Se vendi prodotti con varianti (colori, taglie, ecc.), decidi come rappresentarle nel feed:

    Opzione 1: Crea un prodotto separato per ogni variante. Ogni variante ha un pid univoco, un nome specifico (ad esempio, 'Maglietta blu taglia L') e un parentpid che punta al prodotto padre. Questa opzione offre il massimo controllo ma richiede più manutenzione.

    Opzione 2: Crea un singolo prodotto e includi le varianti nei custom fields. Questa opzione è più semplice ma offre meno flessibilità.

    La scelta dipende da come gestisci le varianti nel tuo sistema e quanto controllo vuoi avere su ogni variante.

    Valutazioni e recensioni

    Fornisci il numero di recensioni (reviews) e la valutazione media (average_rating) per ogni prodotto. Awin visualizza queste informazioni per indicare la popolarità e la qualità.

    Una valutazione alta (4+ stelle) aumenta significativamente il tasso di conversione. Se i tuoi prodotti hanno valutazioni basse, concentrati sul miglioramento della qualità e del servizio clienti.

    Tempistiche di aggiornamento

    Aggiorni il feed secondo una pianificazione coerente. Awin scaricherà il feed a intervalli regolari (ad esempio, ogni ora). Assicurati che il feed sia sempre disponibile e aggiornato.

    Se il feed non è disponibile per più di 24 ore, Awin lo markerà come 'offline' e lo escluderà dalle campagne. Se rimane offline per più di una settimana, Awin potrebbe disattivare il feed.

    Conclusione

    Il feed XML Awin è lo strumento essenziale per distribuire i tuoi prodotti alla rete di affiliazione Awin. Una corretta struttura del feed, dati completi e accurati, e un aggiornamento regolare sono fondamentali per il successo.

    Investi tempo nella preparazione di un feed di alta qualità. Completa tutti i campi consigliati, fornisci immagini di qualità, mantieni i dati sincronizzati con il tuo sito web e aggiorna il feed regolarmente. Questi sforzi si tradurranno in una maggiore visibilità dei tuoi prodotti, tassi di conversione più elevati e un miglior ROI dalla rete Awin.

    Monitora regolarmente le prestazioni del feed e apporta miglioramenti in base ai dati e al feedback degli affiliati. La qualità del feed è un processo continuo di ottimizzazione.