Destinations

Feed Webgains: guida tecnica ai campi e all'ottimizzazione

Guida completa ai campi del feed prodotti Webgains, con mappature tecniche, spiegazioni di ogni attributo e strategie pratiche per migliorare la visibilità e l'approvazione dei prodotti.

12 min di lettura 1 visualizzazioni Aggiornato il 8 Lug 2026

Nessun risultato trovato

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

    Introduzione a Webgains e il feed prodotti

    Webgains è una piattaforma di affiliazione e performance marketing che consente ai merchant di distribuire i propri dati prodotto a una rete di partner, affiliate e canali di vendita. A differenza dei marketplace tradizionali, Webgains funziona come un hub di integrazione dove i tuoi prodotti vengono sincronizzati continuamente e resi disponibili a editori, siti di confronto prezzi e altre fonti di traffico.

    I merchant utilizzano Webgains per tre motivi principali: espandere la portata dei propri prodotti senza gestire direttamente ogni canale, sfruttare la rete di affiliate per generare traffico qualificato, e mantenere una sincronizzazione automatica dei dati (prezzi, disponibilità, descrizioni) su molteplici punti di contatto. La qualità del feed prodotti è direttamente correlata al numero di affiliate che sceglieranno di promuovere i tuoi articoli e alla frequenza con cui i tuoi prodotti compariranno nei risultati di ricerca dei partner.

    Struttura e campi essenziali del feed Webgains

    Il feed Webgains è costituito da record strutturati, ciascuno rappresentante un singolo prodotto. Ogni record contiene attributi che descrivono il prodotto, il suo prezzo, la disponibilità, le immagini e i link di tracciamento. La completezza e l'accuratezza di questi campi determina direttamente se un prodotto verrà accettato dalla piattaforma, visualizzato dai partner e, infine, venduto.

    Identificazione e dati base del prodotto

    Campo Tipo Obbligatorio Descrizione e impatto
    product_id Stringa univoca Identificativo unico del prodotto nel tuo sistema. Deve rimanere costante nel tempo per tracciare correttamente le conversioni. Se cambia, Webgains lo tratterà come un prodotto nuovo e perderà la cronologia di performance.
    product_name Testo Nome del prodotto visibile ai potenziali clienti e negli annunci degli affiliate. Deve essere descrittivo, privo di caratteri speciali non necessari e coerente tra i feed. I nomi troppo generici ('Prodotto', 'Articolo') riducono il click-through rate.
    brand Testo Consigliato Marchio del prodotto. Gli affiliate lo usano per filtrare e categorizzare i prodotti. Un brand chiaro aumenta la fiducia e facilita la ricerca nei cataloghi partner.
    manufacturer Testo Facoltativo Nome del produttore (può differire dal brand). Utile per prodotti distribuiti dove il produttore e il venditore sono entità diverse.
    manufacturers_product_number Testo Facoltativo Numero di riferimento del produttore (MPN). Aiuta a identificare univocamente il prodotto anche al di fuori del tuo ecosistema e migliora la matching con altre piattaforme.
    european_article_number Codice Facoltativo Codice EAN / UPC del prodotto. Fondamentale per il matching con database di prodotti globali e per la conformità normativa in alcuni mercati.

    Descrizione e categorizzazione

    Campo Tipo Obbligatorio Descrizione e impatto
    description Testo lungo Descrizione completa del prodotto. Deve includere caratteristiche chiave, materiali, dimensioni e vantaggi. Webgains e i suoi partner usano questo testo per la ricerca e per generare annunci. Descrizioni incomplete o generiche causano basse impression nei risultati di ricerca.
    short_description Testo breve Consigliato Versione sintetica della descrizione (50-150 caratteri). Utilizzata in elenchi compatti e anteprime di annunci dove lo spazio è limitato. Se assente, Webgains tronca automaticamente la description, spesso in modo poco elegante.
    category_name Testo Categoria del prodotto nel tuo sistema di classificazione (ad esempio 'Abbigliamento > Uomo > Camicie'). Deve corrispondere alla tassonomia Webgains per garantire l'approvazione e la visibilità corretta. Categorie errate causano il rifiuto del prodotto o la sua visualizzazione in sezioni sbagliate.
    keywords Testo Consigliato Parole chiave separate da virgole associate al prodotto. Webgains le utilizza per migliorare la ricercabilità e per aiutare gli affiliate a trovare il tuo prodotto quando cercano articoli correlati. Parole chiave rilevanti aumentano le impression.
    language Codice lingua Codice ISO della lingua del feed (ad esempio 'it' per italiano). Deve corrispondere al mercato target. Un language errato può causare il rifiuto del feed o la visualizzazione in mercati sbagliati.

    Prezzo, disponibilità e costi di spedizione

    Campo Tipo Obbligatorio Descrizione e impatto
    price Numero decimale Prezzo di vendita attuale del prodotto nella valuta specificata. Deve essere aggiornato frequentemente per riflettere le promozioni e gli sconti. Prezzi non sincronizzati causano reclami dei clienti e riduzioni di credibilità presso gli affiliate.
    currency Codice valuta Codice ISO della valuta (ad esempio 'EUR', 'GBP'). Deve corrispondere al mercato target e al price fornito. Una valuta errata causa confusione nei prezzi e rifiuto del prodotto.
    normal_price Numero decimale Consigliato Prezzo originale o di listino prima di sconti. Se diverso da price, comunica chiaramente il valore dello sconto agli affiliate e ai clienti finali. Aumenta la percezione di convenienza e il tasso di conversione.
    baseprice Numero decimale Facoltativo Prezzo per unità di misura (ad esempio prezzo al litro, al chilo). Obbligatorio in alcuni mercati per la conformità normativa. Assente o errato, può causare il rifiuto del prodotto in determinate giurisdizioni.
    availability Stato Stato di disponibilità del prodotto ('in stock', 'out of stock', 'pre-order', 'discontinued'). Direttamente correlato alle conversioni: i clienti non cliccheranno su un prodotto se non sanno se è disponibile. Webgains sincronizza questo valore per evitare che gli affiliate promuovano prodotti non disponibili.
    in_stock Booleano Consigliato Valore vero/falso che indica se il prodotto è in magazzino. Utilizzato come filtro rapido dai partner. Se in conflict con availability, causa confusione e rifiuto del prodotto.
    delivery_cost Numero decimale Consigliato Costo di spedizione del prodotto. Critico per la conversione: clienti che vedono una spedizione costosa spesso abbandonano il carrello. Deve essere accurato e aggiornato per ogni zona geografica coperta.
    delivery_period Testo / Numero Consigliato Tempo di consegna stimato (ad esempio '2-3 giorni lavorativi', '5-7 giorni'). Influenza direttamente la decisione di acquisto. Periodi lunghi o non specificati riducono le conversioni.

    Immagini e media

    Campo Tipo Obbligatorio Descrizione e impatto
    image_url URL URL dell'immagine principale del prodotto. Deve essere un'immagine di alta qualità, ben illuminata, con sfondo neutro. Webgains e gli affiliate la usano negli annunci e nelle schede prodotto. Immagini di bassa qualità, lente da caricare o non raggiungibili causano il rifiuto del prodotto e basse impression.
    image_large_url URL Consigliato URL di una versione più grande dell'immagine principale. Utilizzata nei dettagli del prodotto su siti partner. Se assente, Webgains usa image_url, che potrebbe essere troppo piccola per i dettagli.
    image_thumbnail_url URL Facoltativo URL di una versione in miniatura dell'immagine. Usata negli elenchi compatti e nei risultati di ricerca. Se non fornita, Webgains ridimensiona automaticamente image_url, il che può degradare la qualità.

    Tutti gli URL di immagine devono essere raggiungibili, servire immagini valide (non placeholder o errori 404), e caricarsi entro pochi secondi. Webgains valida regolarmente gli URL: immagini non raggiungibili causano l'esclusione del prodotto dal feed.

    Link e tracciamento

    Campo Tipo Obbligatorio Descrizione e impatto
    deeplink URL URL diretto alla pagina di dettaglio del prodotto nel tuo negozio. Deve portare esattamente al prodotto descritto nel record, non a una pagina generica o di categoria. Un deeplink errato causa bounce rate elevati e penalizzazioni di performance. Webgains lo usa per tracciare le conversioni: se non è accurato, le vendite non verranno attribuite correttamente.

    Il deeplink deve includere parametri UTM o di tracciamento Webgains se richiesto dalla piattaforma. Deve essere stabile nel tempo: modificare i deeplink causa la perdita della cronologia di performance.

    Attributi promozionali e di visibilità

    Campo Tipo Obbligatorio Descrizione e impatto
    promotions Testo Facoltativo Descrizione di promozioni attive (ad esempio 'Sconto 20%', 'Spedizione gratuita'). Aumenta visibilmente il click-through rate e il tasso di conversione. Deve essere aggiornata frequentemente per riflettere le promozioni attuali. Promozioni scadute causano reclami e danneggiano la credibilità.
    best_sellers Booleano Facoltativo Indica se il prodotto è un best-seller o un prodotto popolare. Webgains e i partner possono usarlo per ordinare e evidenziare i risultati. Aumenta la visibilità e il posizionamento nei cataloghi partner.

    Pratiche di ottimizzazione del feed Webgains

    Sincronizzazione e frequenza di aggiornamento

    Webgains si aspetta aggiornamenti regolari del feed, idealmente giornalieri o ogni 48 ore. La sincronizzazione frequente garantisce che prezzi, disponibilità e immagini siano sempre attuali. Partner e clienti finali vedranno dati obsoleti se il tuo feed non viene aggiornato regolarmente, causando un calo di fiducia e conversioni.

    Implementa un sistema di sincronizzazione automatica che estrae i dati dal tuo database di prodotti e li invia a Webgains tramite API o upload di feed. Evita aggiornamenti manuali sporadici: sono soggetti a errori e ritardi.

    Completezza e validazione dei dati

    Prima di inviare il feed a Webgains, valida ogni record:

    • Verifica che product_id sia univoco e non cambi nel tempo.
    • Controlla che product_name, description e short_description siano privi di errori di ortografia, caratteri speciali non necessari e siano coerenti con il tuo sito web.
    • Assicurati che category_name corrisponda alla tassonomia Webgains ufficiale. Categorie non riconosciute causano il rifiuto del prodotto.
    • Valida che price, currency, normal_price e baseprice siano numeri validi e coerenti tra loro.
    • Controlla che availability sia uno dei valori accettati ('in stock', 'out of stock', 'pre-order', 'discontinued').
    • Verifica che image_url, image_large_url e deeplink siano URL validi e raggiungibili.
    • Assicurati che delivery_cost e delivery_period siano accurati e aggiornati per ogni zona geografica.

    Webgains fornisce strumenti di validazione nel dashboard: usali prima di pubblicare il feed per identificare e correggere errori.

    Ottimizzazione delle descrizioni per la ricerca

    Le descrizioni sono il principale fattore di ricercabilità nel feed Webgains. Scrivi description e short_description pensando ai termini che i clienti usano per cercare prodotti simili:

    • Includi il nome del brand e il modello all'inizio.
    • Elenca le caratteristiche principali in ordine di importanza (colore, taglia, materiale, funzionalità).
    • Usa parole chiave naturali, non keyword stuffing.
    • Spiega i vantaggi e i casi d'uso, non solo le specifiche tecniche.
    • Mantieni un linguaggio chiaro e professionale.

    Esempio:

    Pobero: 'Camicia da uomo'

    Migliore: 'Camicia in cotone 100% blu navy da uomo, taglia M, colletto classico, maniche lunghe, ideale per lavoro e occasioni formali. Tessuto morbido e traspirante, facile da lavare.'

    Gestione delle immagini

    Le immagini sono il secondo fattore di visibilità. Segui queste linee guida:

    • Usa immagini di almeno 800 x 800 pixel per image_url e image_large_url.
    • Mantieni immagini con sfondo neutro (bianco o grigio chiaro) per una presentazione professionale.
    • Assicurati che il prodotto occupi almeno il 70% dell'immagine.
    • Evita immagini sfocate, tagliate male o con watermark.
    • Usa image_thumbnail_url per versioni ridotte (200 x 200 pixel) se disponibili.
    • Ospita le immagini su server stabili e veloci: Webgains valida regolarmente gli URL.

    Prezzi e promozioni

    I prezzi sono il principale driver di conversione. Mantienili sempre accurati:

    • Sincronizza price con il tuo sistema di pricing in tempo reale o almeno giornalmente.
    • Se offri sconti, usa normal_price per il prezzo originale e price per il prezzo scontato. Questo comunica il valore dello sconto agli affiliate e ai clienti.
    • Aggiorna promotions ogni volta che avvii una promozione e rimuovila quando scade.
    • Assicurati che delivery_cost sia accurato per ogni zona geografica. Costi di spedizione sbagliati causano reclami post-vendita.

    Disponibilità e gestione dell'inventario

    L'availability deve riflettere lo stato reale del tuo inventario:

    • Usa 'in stock' solo se il prodotto è effettivamente disponibile per la spedizione immediata.
    • Usa 'pre-order' se il prodotto è disponibile per ordini futuri ma non ancora spedibile.
    • Usa 'out of stock' se il prodotto non è disponibile e non hai una data di restock prevista.
    • Usa 'discontinued' se il prodotto non sarà più disponibile.

    Webgains sincronizza questo valore con i suoi partner: se un affiliate promuove un prodotto 'out of stock' e riceve traffico, il tuo brand subisce un danno reputazionale.

    Deeplink e tracciamento

    I deeplink sono critici per il tracciamento delle conversioni. Assicurati che:

    • Ogni deeplink porti esattamente al prodotto descritto nel record, non a una pagina di categoria o di ricerca.
    • Il deeplink rimanga stabile nel tempo. Se cambi la struttura degli URL, configura reindirizzamenti 301 dal vecchio URL al nuovo.
    • Il deeplink includa parametri di tracciamento Webgains se richiesto (ad esempio utm_source=webgains, utm_medium=affiliate).
    • Il deeplink sia accessibile dai partner e dai clienti finali (non bloccato da firewall o restrizioni geografiche).

    Un deeplink errato è una delle cause più comuni di rifiuto del prodotto o di basse conversioni.

    Approvazione e troubleshooting

    Quando invii il feed a Webgains, la piattaforma esegue una serie di validazioni automatiche. Se un prodotto non passa la validazione, riceverai un messaggio di errore specifico. I motivi più comuni di rifiuto sono:

    • product_id mancante o duplicato: Verifica che ogni prodotto abbia un ID univoco.
    • product_name o description mancante: Questi campi sono obbligatori. Non possono essere vuoti.
    • category_name non riconosciuta: Usa la tassonomia ufficiale Webgains. Se non sei sicuro, contatta il supporto.
    • price non valido: Assicurati che sia un numero decimale valido nella currency specificata.
    • image_url non raggiungibile: Ospita le immagini su server stabili e verifica che gli URL siano corretti.
    • deeplink errato o non raggiungibile: Testa ogni deeplink manualmente prima di inviare il feed.
    • availability non valido: Usa solo i valori accettati.

    Webgains fornisce un report dettagliato di tutti gli errori nel dashboard. Scarica il report, correggi gli errori nel tuo feed e reinvia.

    Conclusione

    Il feed prodotti Webgains è lo strumento principale per distribuire i tuoi prodotti a una rete di affiliate, partner e canali di vendita. La qualità del feed determina direttamente il numero di partner che promuoveranno i tuoi prodotti, la frequenza con cui appariranno nei risultati di ricerca e il tasso di conversione finale.

    Mantieni il feed completo, accurato e aggiornato. Sincronizzalo regolarmente, valida i dati prima di inviare e monitora i report di Webgains per identificare e correggere problemi tempestivamente. Una gestione attenta del feed Webgains genera traffico qualificato, aumenta le conversioni e costruisce una reputazione solida presso la rete di affiliate.