Feed prodotti eBay: guida tecnica ai campi e all'ottimizzazione

Introduzione al feed prodotti eBay

Il feed prodotti eBay è il canale di distribuzione che consente ai merchant di caricare e gestire gli annunci in massa sulla piattaforma eBay. Invece di creare ogni annuncio manualmente nell'interfaccia web, i merchant inviano un file strutturato (CSV, XML o JSON) contenente i dati dei prodotti. eBay processa questo feed, convalida i campi e pubblica gli annunci secondo le regole della categoria e della piattaforma.

I merchant utilizzano il feed eBay per tre motivi principali: velocità (caricare centinaia di prodotti contemporaneamente), coerenza (applicare gli stessi standard a tutti gli annunci) e automazione (sincronizzare inventario, prezzi e disponibilità da sistemi esterni). Senza un feed correttamente strutturato, gli annunci rischiano rifiuti, downgrade di visibilità o approvazioni parziali che limitano le impressioni.

Campi obbligatori e loro impatto sulla visibilità

SKU e identificativi prodotto

Il campo sku è l'identificativo univoco interno che eBay utilizza per tracciare il tuo prodotto. Deve essere unico all'interno del tuo account eBay e rimane stabile nel tempo, anche se il titolo o il prezzo cambiano.

L'importanza dello SKU:
- Sincronizzazione dell'inventario: eBay abbina automaticamente i carichi successivi del feed usando lo SKU. Se lo SKU cambia, eBay crea un nuovo annuncio anziché aggiornare quello esistente, causando duplicati e confusione nei dati di inventario.
- Tracciamento delle vendite: i tuoi sistemi di gestione ordini usano lo SKU per collegare l'ordine al prodotto giusto. Uno SKU incoerente interrompe la catena di fulfillment.
- Regole di categoria: alcune categorie eBay richiedono identificativi globali (EAN, UPC, ISBN) oltre allo SKU. Se mancano, l'annuncio può essere rifiutato o limitato a visibilità ridotta.

I campi ean, upc e isbn servono esattamente a questo scopo. Sono codici standardizzati a livello mondiale che eBay utilizza per verificare l'autenticità del prodotto e per deduplicare annunci simili tra venditori diversi. Se il tuo prodotto ha un EAN o UPC valido, includilo sempre. Se manca, eBay potrebbe rifiutare l'annuncio in categorie ad alto rischio (elettronica, cosmetica, abbigliamento di marca).

Il campo mpn (manufacturer part number, numero di parte del produttore) è facoltativo ma utile per prodotti industriali, componenti elettronici e articoli di marca. Se presente, eBay lo usa per verificare che il prodotto sia autentico e per migliorare la ricerca degli acquirenti.

Il campo item_group_id raggruppa varianti dello stesso prodotto (ad esempio, la stessa maglietta in tre colori e due taglie). eBay crea un annuncio principale con varianti collegate, anziché tre annunci separati. Questo migliora l'esperienza dell'acquirente e concentra le visualizzazioni su un unico annuncio, aumentando il ranking.

Titolo e visibilità nei risultati di ricerca

Il campo title è il testo che appare nei risultati di ricerca eBay e nei feed di categoria. eBay lo indicizza direttamente, quindi le parole chiave nel titolo influenzano il posizionamento organico.

Linee guida per il titolo eBay:
- Lunghezza massima: 80 caratteri (alcuni annunci più lunghi vengono troncati nei risultati mobili).
- Includi la marca, il modello e l'attributo principale (ad esempio, "Nike Air Max 90 Bianche Taglia 42").
- Evita keyword stuffing (ripetere la stessa parola più volte). eBay penalizza il ranking degli annunci con titoli innaturali.
- Inserisci le parole chiave a sinistra (all'inizio del titolo). eBay assegna peso maggiore ai termini iniziali.
- Non usare simboli speciali o caratteri HTML. Usa solo lettere, numeri e spazi.

Il campo subtitle aggiunge una riga aggiuntiva sotto il titolo principale. È visibile nei risultati di ricerca desktop e mobile. Usa il subtitle per specificare dettagli secondari (ad esempio, "Condizioni come nuovo, mai indossato") che non rientrano nel titolo principale.

Descrizione e approvazione del feed

Il campo description contiene il corpo dell'annuncio. eBay lo indicizza per la ricerca, ma con peso minore rispetto al titolo. La descrizione è il luogo dove fornisci dettagli, specifiche, condizioni e istruzioni per l'acquirente.

Requisiti della descrizione:
- Lunghezza minima: almeno 20 caratteri. Descrizioni troppo brevi vengono rifiutate.
- Lunghezza massima: fino a 4000 caratteri (consigliato: 500-1500 caratteri per leggibilità).
- Formato: puoi usare HTML semplice (tag <p>, <br>, <b>, <i>, <ul>, <li>) per strutturare il testo. eBay rimuove JavaScript, CSS e iframe per motivi di sicurezza.
- Informazioni critiche: specifica la condizione fisica (graffi, usura), le funzionalità (se tutto funziona), i difetti noti e la politica di restituzione.
- Evita dichiarazioni false o fuorvianti. eBay respinge gli annunci con descrizioni che contraddicono il campo condition.

Il campo conditionDescription è un campo aggiuntivo per spiegare lo stato del prodotto in dettaglio. Usalo per descrivere difetti minori, segni di usura o motivi per cui il prodotto non è in condizioni perfette. Questo riduce i resi perché gli acquirenti sanno esattamente cosa aspettarsi.

Attributi prodotto e ricerca sfaccettata

Condition (Condizione)

Il campo condition è obbligatorio e accetta solo valori predefiniti:
- New (Nuovo)
- Refurbished (Ricondizionato)
- Used (Usato)

eBay usa la condizione per filtrare i risultati di ricerca. Se selezioni "New" ma la descrizione dice "usato", eBay rifiuta l'annuncio per incoerenza. La condizione influenza anche il trust dell'acquirente: "New" attira compratori che cercano garanzie, mentre "Used" attira chi cerca prezzi bassi.

Attributi visivi: colore, taglia, materiale, genere, fascia d'età

I campi color, size, material, gender e age_group sono attributi facoltativi che eBay usa per la ricerca sfaccettata (filtri laterali). Se li includi, gli acquirenti possono restringere la ricerca per colore, taglia, ecc., aumentando la probabilità di trovare il tuo annuncio.

Linee guida per gli attributi:
- Usa valori standardizzati. Ad esempio, per il colore, usa "Red", "Blue", "Green" anziché "Rosso scuro" o "Blu navy". eBay ha un vocabolario controllato per ogni categoria.
- Se il prodotto ha varianti (ad esempio, una maglietta in tre colori), usa item_group_id per raggrupparle, quindi specifica color e size per ogni variante.
- Non lasciare questi campi vuoti se il prodotto li ha. Un annuncio di scarpe senza taglia è inutile per la ricerca.

Brand e autenticità

Il campo brand è il nome del produttore. eBay lo usa per verificare l'autenticità e per permettere agli acquirenti di filtrare per marca. Se il tuo prodotto è di marca sconosciuta o generico, puoi omettere questo campo o scrivere "Generic" / "Unbranded".

In categorie ad alto rischio (moda, lusso, elettronica), eBay verifica che il brand nel feed corrisponda ai codici EAN/UPC. Se il brand non corrisponde, l'annuncio viene rifiutato automaticamente.

Immagini e video

imageUrls e additionalImageUrls

Il campo imageUrls contiene l'URL dell'immagine principale (quella che appare nei risultati di ricerca). Il campo additionalImageUrls contiene fino a 11 immagini aggiuntive visibili nella pagina di dettaglio dell'annuncio.

Requisiti delle immagini eBay:
- Formato: JPEG, PNG, GIF, BMP. eBay sconsiglia GIF animate (rallentano il caricamento).
- Dimensione minima: 300x300 pixel. eBay le ridimensiona automaticamente, ma immagini troppo piccole appaiono pixelate.
- Dimensione massima: 12 MB per file. URL non validi o non raggiungibili causano il rifiuto dell'annuncio.
- Sfondo: eBay preferisce sfondi bianchi o trasparenti. Immagini con sfondi complessi hanno ranking inferiore.
- Contenuto: non includere filigrane, loghi di competitor o testo sovrapposto che ostruisce il prodotto.

Per il feed, fornisci URL assoluti e verificati (ad esempio, https://cdn.example.com/product-123.jpg). eBay scarica l'immagine e la ospita sui suoi server. Se l'URL è irraggiungibile al momento del caricamento del feed, eBay rifiuta l'annuncio.

Migliore pratica: carica almeno 3-5 immagini per aumentare il trust dell'acquirente e il ranking nei risultati di ricerca. Annunci con una sola immagine hanno tassi di conversione inferiori.

videoUrls

Il campo videoUrls contiene URL di video ospitati su piattaforme supportate (YouTube, Vimeo, ecc.). I video aumentano l'engagement e il ranking. eBay limita a 1 video per annuncio nel feed.

Formato: fornisci l'URL pubblico del video (ad esempio, https://www.youtube.com/watch?v=abc123). eBay lo incorpora direttamente nell'annuncio.

Prezzo e inventario

sale_price (Prezzo)

Il campo sale_price è il prezzo di vendita in formato numerico (ad esempio, 19.99). eBay lo usa per ordinare i risultati di ricerca per prezzo e per calcolare i costi di spedizione stimati.

Linee guida:
- Formato: numero decimale con fino a 2 cifre decimali (ad esempio, 19.99, non 19,99).
- Valuta: eBay determina la valuta in base al sito (eBay.it usa EUR, eBay.co.uk usa GBP). Non includere il simbolo di valuta nel feed.
- Prezzo minimo: eBay ha prezzi minimi per categoria (ad esempio, 0,99 EUR per molte categorie). Prezzi inferiori vengono arrotondati automaticamente.
- Prezzo massimo: nessun limite, ma prezzi molto alti (migliaia di euro) richiedono approvazione manuale.

quantity (Quantità)

Il campo quantity è il numero di unità disponibili. eBay lo usa per gestire l'inventario e per mostrare il badge "Solo X rimasti" quando le scorte sono basse.

Linee guida:
- Valore minimo: 1 (almeno un'unità deve essere disponibile).
- Valore massimo: 9999999 (eBay non ha un limite superiore, ma quantità molto alte sono rare).
- Sincronizzazione: se carichi il feed due volte con quantità diverse, eBay aggiorna il valore. Se la quantità scende a 0, l'annuncio viene disattivato automaticamente (non rimosso, ma nascosto dai risultati di ricerca).
- Gestione del magazzino: usa il feed per sincronizzare l'inventario da un sistema esterno. Se il tuo magazzino vende tramite più canali (eBay, Amazon, sito web), assicurati che il feed rifletta la quantità reale, altrimenti rischi di vendere più unità di quelle disponibili.

shipping_weight

Il campo shipping_weight è il peso del pacco in chilogrammi (ad esempio, 0.5 per 500 grammi). eBay lo usa per calcolare automaticamente le spese di spedizione se usi il servizio di calcolo dei costi.

Formato: numero decimale (ad esempio, 1.25 per 1,25 kg). Includi il peso dell'imballaggio, non solo il prodotto nudo.

Pratica: mappatura e ottimizzazione del feed

Passaggio 1: Struttura e validazione del feed

Prima di caricare il feed su eBay, valida la struttura:
- Se usi CSV: assicurati che le colonne corrispondano ai nomi dei campi eBay (sku, title, description, ecc.). Usa virgole come separatori e virgolette per valori con virgole interne.
- Se usi XML o JSON: valida la sintassi con uno strumento online (ad esempio, JSONLint) e verifica che i nomi dei campi siano esatti.
- Test di caricamento: carica una piccola porzione del feed (ad esempio, 10 prodotti) prima di caricare il file completo. eBay fornisce un rapporto di errori che mostra quali campi sono stati rifiutati.

Passaggio 2: Mappatura dei campi dal tuo sistema

Se i tuoi prodotti sono archiviati in un database interno (ad esempio, un e-commerce custom, un ERP o un foglio di calcolo), devi mappare i tuoi campi ai campi eBay:

Passaggio 3: Ottimizzazione dei titoli

Esempio di titolo non ottimizzato:
"Bellissima maglietta"

Esempio ottimizzato:
"Nike Air Max 90 Bianche Taglia 42 Condizioni Perfette"

Il secondo titolo include:
- Marca (Nike)
- Modello (Air Max 90)
- Colore (Bianche)
- Taglia (42)
- Condizione (Perfette)

Questo migliora il ranking perché gli acquirenti che cercano "Nike Air Max 90 42" trovano il tuo annuncio tra i primi risultati.

Passaggio 4: Descrizione strutturata

Invece di un blocco di testo non strutturato, usa HTML semplice:

<p><b>Condizione:</b> Nuovo, mai indossato</p>
<p><b>Specifiche:</b></p>
<ul>
<li>Marca: Nike</li>
<li>Modello: Air Max 90</li>
<li>Taglia: 42</li>
<li>Colore: Bianco</li>
<li>Materiale: Mesh + pelle sintetica</li>
</ul>
<p><b>Difetti noti:</b> Nessuno</p>
<p><b>Politica di restituzione:</b> 30 giorni, rimborso completo</p>

Questa struttura è leggibile sia per eBay che per gli acquirenti e riduce le domande post-vendita.

Passaggio 5: Gestione delle varianti con item_group_id

Se vendi la stessa maglietta in tre colori (rosso, blu, verde) e due taglie (M, L), crea 6 annunci separati (3 colori × 2 taglie) ma raggruppa con item_group_id:

eBay crea un annuncio principale con un selettore di colore e taglia. L'acquirente sceglie la variante e la quantità da un'unica pagina. Questo concentra le visualizzazioni e migliora il ranking complessivo.

Passaggio 6: Validazione pre-caricamento

Prima di inviare il feed a eBay, esegui un controllo di qualità interno:
- Verifica che tutti gli SKU siano univoci (nessun duplicato).
- Controlla che i codici EAN/UPC siano validi (usa un validatore online).
- Assicurati che tutti gli URL delle immagini siano raggiungibili (prova a scaricarli).
- Verifica che i prezzi siano coerenti (nessun prezzo negativo o zero se non intenzionale).
- Controlla che la quantità sia > 0 per gli annunci che vuoi pubblicare.
- Valida la sintassi del file (CSV, XML o JSON) con uno strumento online.

Errori comuni e come evitarli

SKU duplicati: se carichi due prodotti con lo stesso SKU, eBay li considera lo stesso annuncio e aggiorna il primo. Risultato: il secondo prodotto non viene caricato. Soluzione: assicurati che ogni SKU sia univoco.

EAN/UPC non validi: eBay verifica i codici contro un database globale. Se il codice non esiste o non corrisponde al prodotto, l'annuncio viene rifiutato. Soluzione: usa solo codici verificati dal produttore.

Titoli troncati: se il titolo supera 80 caratteri, eBay lo tronca nei risultati mobili. Soluzione: mantieni i titoli sotto 80 caratteri e inserisci le parole chiave importanti all'inizio.

Immagini irraggiungibili: se l'URL dell'immagine non è valido o l'hosting è offline al momento del caricamento, eBay rifiuta l'annuncio. Soluzione: usa un hosting affidabile e verifica gli URL prima di caricare il feed.

Incoerenza tra titolo e descrizione: se il titolo dice "Nuovo" ma la descrizione dice "usato", eBay rifiuta l'annuncio. Soluzione: assicurati che titolo, descrizione e campo condition siano coerenti.

Quantità non sincronizzata: se carichi il feed manualmente ogni settimana, la quantità potrebbe non riflettere le vendite real-time. Risultato: sovravendite. Soluzione: usa un'integrazione API (se disponibile) per sincronizzare l'inventario in tempo reale.

Riepilogo e best practice

Per un feed eBay di qualità alta:

1. Usa SKU univoci e stabili: non cambiarli tra i caricamenti.
2. Includi codici globali: EAN, UPC o ISBN se disponibili. Aumentano l'approvazione e il ranking.
3. Scrivi titoli chiari e keyword-friendly: marca, modello, colore e taglia negli 80 caratteri.
4. Struttura la descrizione con HTML: rendi facile la lettura e riduci le domande degli acquirenti.
5. Specifica la condizione accuratamente: incoerenze tra titolo e condition causano rifiuti.
6. Carica immagini di qualità: almeno 3-5 per annuncio, sfondi puliti, nessuna filigrana.
7. Raggruppa le varianti: usa item_group_id per colori, taglie e materiali diversi.
8. Sincronizza l'inventario: aggiorna la quantità regolarmente per evitare sovravendite.
9. Valida il feed prima di caricare: controlla SKU, EAN, URL e sintassi.
10. Monitora i rapporti di errore di eBay: leggi i messaggi di rifiuto e correggi i campi problematici.

Un feed ben strutturato riduce i rifiuti di approvazione, migliora il ranking nei risultati di ricerca e aumenta la fiducia degli acquirenti. Investire tempo nella mappatura e nell'ottimizzazione iniziale paga dividendi nel lungo termine.