Guida
Caratteristiche dell’oggetto eBay: cosa sono e come compilarle
Le caratteristiche dell’oggetto decidono se gli acquirenti trovano il tuo articolo quando filtrano la ricerca su eBay. Questa guida tratta i quattro livelli, gli identificativi di prodotto, i limiti di caratteri, come consultare gli aspetti di una categoria e come trasformare le specifiche tecniche dei fornitori in valori puliti.
Le caratteristiche dell’oggetto sono le coppie nome–valore strutturate di un’inserzione eBay: Marca: Nordlicht, Colore: Nero, Larghezza articolo: 45 cm. eBay le descrive come parole chiave descrittive che informano l’acquirente sul tuo articolo e, nelle API di eBay, si chiamano aspetti dell’articolo (item aspects).
Non sono un semplice abbellimento. eBay le usa per collocare il tuo articolo nei risultati di ricerca filtrati, per valutare quanto è completa un’inserzione e per abbinarla al proprio catalogo prodotti. Farle bene è soprattutto una questione di dati: sapere quali aspetti una categoria si aspetta e disporre di valori accurati da inserirvi.
Cosa sono le caratteristiche dell’oggetto eBay
Ogni categoria eBay ha il proprio insieme di aspetti. Una categoria di laptop potrebbe chiedere processore e dimensioni dello schermo, una categoria di abbigliamento taglia e reparto, e la maggior parte delle categorie chiede la marca. Ogni aspetto ha un nome scelto da eBay e un valore che fornisci tu, scelto dall’elenco di eBay oppure digitato come testo libero dove la categoria lo consente.
Le caratteristiche dell’oggetto affiancano, e non fanno parte di, titolo e descrizione. Gli acquirenti le vedono in un blocco strutturato nella pagina dell’inserzione e la ricerca di eBay le usa per i filtri nella colonna di sinistra — marca, taglia, colore, condizione e così via. Un dettaglio presente solo nella descrizione non può essere usato da quei filtri.
Obbligatorie, presto obbligatorie, consigliate e aggiuntive
Nel flusso di inserzione di Seller Hub, eBay raggruppa le caratteristiche dell’oggetto di una categoria in quattro livelli. Il livello indica cosa eBay impone ora, cosa imporrà in futuro e cosa cercano gli acquirenti.
| Livello | Cosa significa | Se lo lasci vuoto |
|---|---|---|
| Obbligatoria | Deve essere compilata per qualsiasi inserzione nuova o modificata | Non puoi pubblicare né modificare l’articolo |
| Presto obbligatoria | Diventerà obbligatoria; il flusso di inserzione mostra la data | Non ancora imposta; trattata come obbligatoria dalla data indicata |
| Consigliata | Basata sui dati di domanda degli acquirenti e sulle ricerche più diffuse | L’inserzione può non comparire nelle ricerche filtrate corrispondenti |
| Aggiuntiva | Dettaglio extra facoltativo per la categoria | Nessun blocco; l’inserzione ha semplicemente meno dettagli |
Come le caratteristiche dell’oggetto influenzano ricerca, filtri e acquirenti
eBay è esplicita sui filtri: il tuo articolo compare nei risultati di ricerca filtrati solo se hai aggiunto la caratteristica dell’oggetto corrispondente. Un acquirente che filtra una ricerca per Marca o Taglia non vedrà mai un’inserzione che ha lasciato vuoto quel campo, per quanto sia buono il titolo.
Le caratteristiche dell’oggetto influiscono anche sul posizionamento. Tra i fattori di Best Match di eBay figurano la completezza dell’inserzione e quanto corrisponde ai termini di ricerca dell’acquirente. Le indicazioni di eBay per i venditori affermano che le caratteristiche dell’oggetto aumentano le probabilità di essere trovati su eBay, Google Shopping e nei risultati dei motori di ricerca esterni, e il flusso di inserzione mostra quante volte ogni caratteristica è stata cercata negli ultimi 30 giorni — un modo utile per decidere quali aspetti consigliati privilegiare.
Per gli acquirenti, le caratteristiche dell’oggetto rispondono alle domande di confronto prima ancora che leggano la descrizione. Valori accurati riducono i messaggi del tipo “andrà bene?”, mentre valori errati portano a resi: un acquirente che ha filtrato per una larghezza di 45 cm si aspetta 45 cm.
Identificativi di prodotto: marca, MPN, UPC, EAN, ISBN e “Non applicabile”
Gli identificativi di prodotto sono un gruppo speciale di caratteristiche dell’oggetto. eBay li descrive come codici univoci creati dal produttore del prodotto — GTIN come UPC, EAN e ISBN, più la marca e il codice articolo del produttore (MPN) — e afferma che sono obbligatori nella maggior parte delle categorie.
Quando un identificativo corrisponde a un prodotto del catalogo eBay, eBay suggerisce la corrispondenza e può precompilare titolo, foto e altri dettagli. Accetta solo corrispondenze esatte: un anno di modello o un formato di confezione diversi sono un prodotto diverso. Nell’Inventory API, eBay preferisce un ID prodotto eBay (ePID) per l’abbinamento al catalogo, perché uno stesso GTIN può corrispondere a più di un prodotto del catalogo.
- Marca: la marca riportata sul prodotto, non il nome dell’azienda che te lo ha venduto. Per i prodotti generici, le buone pratiche per sviluppatori di eBay suggeriscono “Unbranded”.
- MPN: il codice articolo o numero di modello del produttore riportato nella scheda tecnica. Non inserire mai qui il tuo SKU. Quando una categoria richiede un MPN, l’Inventory API richiede anche la marca.
- UPC, EAN o ISBN: il GTIN del produttore per quella esatta variante. Convalida la cifra di controllo prima di usarlo.
- “Non applicabile”: per gli articoli che non hanno davvero un identificativo, come oggetti d’antiquariato o prodotti su misura, eBay consente di selezionare “Non applicabile”. La dicitura esatta varia a seconda del marketplace eBay.
Limiti di caratteri delle caratteristiche dell’oggetto eBay
I limiti differiscono tra le API di eBay, quindi controlla quale usa il tuo strumento di inserzione. Dove una fonte indica un numero, qui sotto, si tratta del massimo documentato; per alcuni aspetti le singole categorie possono restituire una propria lunghezza massima.
| Campo | Limite | Dove si applica |
|---|---|---|
| Titolo dell’inserzione | 80 caratteri | Tutte le inserzioni; eBay consiglia di usarli tutti e 80 |
| Sottotitolo | 55 caratteri | Opzione a pagamento facoltativa per l’inserzione |
| Valore di una caratteristica dell’oggetto | 65 caratteri (standard) | Trading API; alcuni aspetti ne consentono di più, indicato come aspectMaxLength |
| Nome dell’aspetto / valore dell’aspetto | 40 / 50 caratteri | Inventory API |
| Marca e MPN | 65 caratteri ciascuno | Campi prodotto dell’Inventory API |
| Valori in un aspetto a più valori | Fino a 30 | Aspetti con cardinalità MULTI (Taxonomy API) |
| Descrizione dell’articolo in inventario | 4.000 caratteri | Descrizione del prodotto nell’Inventory API |
| Foto | Fino a 24 per inserzione | Inventory API; fino a 12 per variante in un gruppo |
Come trovare le caratteristiche dell’oggetto obbligatorie di una categoria
Non esiste un unico elenco di caratteristiche dell’oggetto eBay: gli aspetti e i loro livelli dipendono dalla categoria foglia e dal marketplace, e cambiano nel tempo. Consultali per ciascuna categoria in cui vendi.
Per poche inserzioni basta Seller Hub: scegli la categoria nel flusso di inserzione e verrà mostrato l’elenco delle caratteristiche obbligatorie, presto obbligatorie, consigliate e aggiuntive, con i conteggi di ricerca ed eventuali date di “presto obbligatoria”. Per correggere in blocco le inserzioni esistenti, la pagina Inserzioni attive permette di scaricare un file Excel delle inserzioni prive di caratteristiche e ricaricarlo, oppure di selezionare più inserzioni e usare “Aggiungi caratteristiche dell’oggetto”.
Per un catalogo ampio o in continua evoluzione, usa la Taxonomy API, che restituisce gli stessi metadati in forma leggibile da dispositivo automatico:
- Individua la categoria foglia dell’articolo. Gli aspetti sono definiti per categoria foglia, non per categoria padre.
- Ottieni l’ID dell’albero delle categorie per il marketplace eBay su cui vendi.
- Chiama GET /commerce/taxonomy/v1/category_tree/{category_tree_id}/get_item_aspects_for_category?category_id={id}. Entrambi i parametri sono obbligatori.
- Leggi aspectConstraint.aspectRequired per stabilire cosa è obbligatorio. Non fare affidamento su aspectUsage: restituisce RECOMMENDED anche per gli aspetti obbligatori.
- Annota aspectMode (SELECTION_ONLY significa che devi usare uno dei valori di eBay) e itemToAspectCardinality (MULTI consente fino a 30 valori).
- Memorizza expectedRequiredByDate per gli aspetti “presto obbligatori”, così da compilarli prima della scadenza.
- Per molte categorie alla volta, chiama fetch_item_aspects sull’albero delle categorie, che restituisce gli aspetti di ogni categoria foglia, e aggiorna regolarmente la tua copia.
Come leggere i metadati degli aspetti
Ogni aspetto restituito da getItemAspectsForCategory include vincoli che indicano come compilarlo. Sono questi i campi che permettono di prevenire la maggior parte degli errori di mappatura.
| Campo | Valori | Cosa farne |
|---|---|---|
| aspectRequired | true o false | Il segnale affidabile per un aspetto obbligatorio |
| aspectUsage | RECOMMENDED o OPTIONAL | Dai priorità agli aspetti consigliati, ma ricorda che anche quelli obbligatori riportano RECOMMENDED |
| aspectMode | FREE_TEXT o SELECTION_ONLY | Per SELECTION_ONLY, normalizza il tuo valore su uno dei valori di eBay |
| itemToAspectCardinality | SINGLE o MULTI | Invia un valore, o fino a 30 per MULTI |
| aspectDataType / aspectFormat | ad es. DATE, NUMBER | Date nel formato YYYY, YYYYMM o YYYYMMDD; numeri come interi o decimali |
| aspectEnabledForVariations | true o false | Se l’aspetto può essere usato per definire varianti, come taglia o colore |
| aspectApplicableTo | PRODUCT o ITEM | Gli aspetti PRODUCT descrivono il prodotto a catalogo; gli aspetti ITEM descrivono il tuo articolo specifico |
Mappare gli attributi della scheda tecnica del fornitore sugli aspetti eBay
Se rivendi marchi di terzi, la maggior parte dei valori delle caratteristiche dell’oggetto esiste già nella scheda tecnica o nella scheda delle specifiche del fornitore — solo non con le parole di eBay. La mappatura consiste nel trasformare una riga della scheda tecnica in un nome di aspetto e in un valore che eBay accetta.
Gli esempi seguenti mostrano le trasformazioni tipiche. I nomi degli aspetti variano a seconda della categoria, quindi confermane ciascuno con i metadati della categoria prima di fare affidamento sulla mappatura.
| La scheda tecnica riporta | Aspetto candidato | Valore da inserire | Verifica |
|---|---|---|---|
| Larghezza complessiva 45 cm | Larghezza articolo | 45 cm | Usa la dimensione complessiva, non quella dell’imballaggio |
| Fabbricante: Nordlicht Leuchten GmbH | Marca | Nordlicht | La marca riportata sul prodotto, non la ragione sociale |
| N. articolo NL-2210-BK | MPN | NL-2210-BK | Il numero del fabbricante, non il tuo SKU |
| EAN 6291041500213 | EAN | 6291041500213 | Convalida la cifra di controllo; un GTIN per variante |
| Colore del corpo RAL 9005 nero intenso | Colore | Nero | Scegli il valore di eBay; lascia il codice RAL nella descrizione |
| Esterno: 100% cotone biologico | Materiale | Cotone | Indica “biologico” dove la categoria o la descrizione lo consentono |
| Tensione nominale 220–240 V CA | Tensione, se la categoria la prevede | 220–240 V | Nomi e formati degli aspetti variano a seconda della categoria |
Esempi per categoria: elettronica, abbigliamento e giocattoli
Gli aspetti seguenti vengono richiesti comunemente in queste categorie e mostrano da dove provengono di solito i valori. Hanno solo valore illustrativo: i nomi e i livelli effettivi dipendono dalla categoria foglia e dal marketplace, quindi consultali come descritto sopra.
Per abbigliamento e calzature, le pagine di aiuto di eBay descrivono il passaggio nel 2026 a valori di taglia standardizzati, per cui le inserzioni con taglie mancanti o poco chiare potrebbero essere nascoste. Consulta l’aiuto “Creare un’inserzione” di eBay, nella versione aggiornata, prima di fare affidamento su convenzioni di taglia precedenti.
| Categoria | Aspetti che incontrerai spesso | Dove si trovano di solito i dati | Attenzione a |
|---|---|---|---|
| Elettronica di consumo | Marca, Modello, MPN, Tipo, Connettività, Colore | Informazioni per l’ordine e tabelle dei dati tecnici | Nome del modello e codice articolo; varianti regionali di spina e tensione |
| Abbigliamento | Marca, Reparto, Tipo di taglia, Taglia, Colore, Stile, Materiale | Tabelle delle taglie ed etichette con la composizione delle fibre | Una taglia e un colore per variante; sistemi di taglie coerenti |
| Giocattoli | Marca, Tipo, Fascia di età, Personaggio o franchise, Materiale | Testo dell’imballaggio, fascia di età consigliata e avvertenze | I valori di età devono corrispondere alla fascia di età e alle avvertenze del fabbricante |
Errori comuni nelle caratteristiche dell’oggetto
La maggior parte dei problemi con le caratteristiche dell’oggetto nasce dal copiare i valori senza verificare cosa si aspetta eBay. Questi sono gli errori che più spesso costano visibilità o causano resi.
- Compilare solo gli aspetti obbligatori e ignorare quelli consigliati su cui gli acquirenti filtrano.
- Usare aspectUsage anziché aspectRequired per stabilire cosa è obbligatorio quando si lavora con l’API.
- Digitare un valore in testo libero in un aspetto SELECTION_ONLY, oppure una grafia della marca che non corrisponde all’elenco di eBay.
- Inserire il tuo SKU nell’MPN, o un codice a barre acquistato da un rivenditore in UPC o EAN.
- Scegliere “Non applicabile” per un identificativo che il prodotto ha effettivamente.
- Mescolare le unità di misura (45 cm in un’inserzione, 450 mm in un’altra) in modo che i filtri dividano lo stesso valore.
- Usare le dimensioni dell’imballaggio dove l’aspetto richiede quelle dell’articolo.
- Ripetere frasi di marketing nei valori degli aspetti invece di semplici valori di attributo.
- Impostare i valori una volta sola senza ricontrollare la categoria per nuovi aspetti “presto obbligatori”.
Checklist delle caratteristiche dell’oggetto eBay e preparazione dei valori su larga scala
Scorri questo elenco per ogni categoria prima di pubblicare un gruppo di inserzioni. La parte lenta è di solito raccogliere valori accurati dai documenti dei fornitori, non inserirli.
Doc2Shelf aiuta in questo primo passaggio. Legge i PDF dei fornitori, estrae gli attributi candidati — assegnando a ogni estrazione un punteggio di attendibilità e conservando la pagina di origine e una breve citazione per ogni fatto estratto — e prepara bozze di testo mirate per eBay e valori candidati delle caratteristiche dell’oggetto da sottoporre alla tua revisione. Le nuove connessioni eBay arriveranno presto; gli account già connessi possono continuare a pubblicare. I nuovi utenti esportano il testo revisionato in CSV o JSON generici, che non è uno schema di importazione eBay, e poi inseriscono i valori in Seller Hub o nel proprio strumento di inserzione.
- Categoria foglia confermata per il marketplace su cui vendi.
- Tutti gli aspetti obbligatori compilati; gli aspetti “presto obbligatori” compilati prima della loro data.
- Aspetti consigliati con molte ricerche compilati.
- Marca, MPN e GTIN presi dai documenti del fabbricante e verificati.
- Valori a sola selezione normalizzati sui valori di eBay.
- Unità di misura e formati coerenti tra le inserzioni.
- Valori entro i limiti di caratteri documentati.
- Corrispondenze di catalogo accettate solo se si tratta esattamente dello stesso prodotto.
Domande frequenti
- Cosa sono le caratteristiche dell’oggetto su eBay?
- Sono dettagli strutturati nome–valore su un articolo, come marca, taglia, colore e materiale. eBay li usa per i filtri di ricerca, per Best Match e per l’abbinamento al catalogo. Nelle API di eBay si chiamano aspetti dell’articolo (item aspects).
- Le caratteristiche dell’oggetto consigliate sono obbligatorie?
- No. Solo quelle obbligatorie bloccano un’inserzione. Quelle consigliate si basano sui dati di domanda degli acquirenti e sulle ricerche più diffuse, e il tuo articolo compare nei risultati filtrati solo per le caratteristiche che hai compilato, quindi vale la pena completarle.
- Le caratteristiche dell’oggetto aiutano il posizionamento nella ricerca eBay?
- Sì. Best Match di eBay considera quanto è completa un’inserzione, ed eBay afferma che le caratteristiche dell’oggetto aumentano le probabilità di essere trovati su eBay, Google Shopping e nei motori di ricerca esterni.
- Cosa significa “Non applicabile” su eBay?
- Indica a eBay che l’articolo non ha un identificativo di prodotto di quel tipo, ad esempio un oggetto d’antiquariato o un articolo realizzato su misura. Usalo solo se è vero; non usarlo per saltare un identificativo che il prodotto ha.
- Quanto può essere lungo il valore di una caratteristica dell’oggetto?
- Il massimo standard è 65 caratteri nella Trading API, e alcuni aspetti ne consentono di più. Nell’Inventory API, i nomi degli aspetti sono limitati a 40 caratteri e i valori a 50.
- Quanti caratteri può avere un titolo eBay?
- Ottanta. eBay consiglia di usare tutti gli 80 caratteri per dettagli rilevanti come marca, modello e attributi chiave. Un sottotitolo a pagamento ne consente altri 55.
- Perché l’API eBay mostra come RECOMMENDED un aspetto obbligatorio?
- In getItemAspectsForCategory, aspectUsage è RECOMMENDED oppure OPTIONAL, e anche gli aspetti obbligatori restituiscono RECOMMENDED. Controlla aspectConstraint.aspectRequired per vedere se un aspetto è obbligatorio.
- Come aggiungo le caratteristiche dell’oggetto a molte inserzioni insieme?
- In Inserzioni attive di Seller Hub, scarica il file Excel delle inserzioni prive di caratteristiche obbligatorie, presto obbligatorie o consigliate, compilalo e ricaricalo — oppure seleziona più inserzioni e usa “Aggiungi caratteristiche dell’oggetto”.