Riferimento attributi dati prodotto
Ultimo aggiornamento: 26 febbraio 2025
- Argomenti:
- Attributi
Creato per:
- Principiante
- Intermedio
- Amministratore
- Leader
Nella tabella seguente sono elencati gli attributi di un'esportazione di prodotti tipica, nell'ordine predefinito in cui vengono visualizzati. Ogni attributo è rappresentato nel file CSV come una colonna e i record dei prodotti sono rappresentati da righe. Le colonne che iniziano con un carattere di sottolineatura contengono dati del servizio quali proprietà o valori di opzione per dati complessi. Puoi esportare un prodotto dal catalogo, per vedere come ogni attributo è rappresentato nei dati.
Nell’installazione utilizzata per esportare questi dati sono installati i dati di esempio, oltre a due siti web e diverse visualizzazioni dello store. Anche se questo elenco include tutte le colonne esportate in genere, sku è l'unico valore richiesto. Per importare i dati, è possibile includere solo le colonne con le modifiche. sku deve essere la prima colonna, ma l'ordine degli altri attributi non ha importanza.
Struttura semplice dei file CSV dei prodotti
| Attributo | Descrizione |
|---|---|
sku | (Obbligatorio) L’unità di gestione delle scorte è un identificatore alfanumerico univoco utilizzato per tenere traccia delle scorte. Una SKU può contenere fino a 64 caratteri. Ad esempio: sku123Nota: un SKU più lungo di 64 caratteri impedisce l'importazione. |
store_view_code | Identifica le visualizzazioni specifiche dello store in cui il prodotto è disponibile. Se questo campo viene lasciato vuoto, il prodotto sarà disponibile nella visualizzazione predefinita del Negozio. Esempio: storeview1, english, spanish |
attribute_set_code | Assegna il prodotto a una serie di attributi o a un modello di prodotto specifici, in base al tipo di prodotto. Ad esempio: defaultDopo la creazione del prodotto, non è possibile modificare il set di attributi utilizzando la funzionalità di importazione. Tuttavia, puoi modificare il set di attributi da Amministratore ed esportare nuovamente il prodotto per aggiornare il file CSV . |
product_type | Indica il tipo di prodotto. Valori:simple — Articoli materiali di solito venduti come unità singole o in quantità fisse.grouped — Gruppo di prodotti separati venduti come set.configurable — Prodotto con più opzioni che il cliente deve selezionare prima di effettuare un acquisto. L'inventario può essere gestito per ogni set di varianti perché rappresenta un prodotto separato con una SKU distinta. Ad esempio, una combinazione di colore e dimensioni per un prodotto configurabile è associata a una SKU specifica nel catalogo.virtual — Prodotto non tangibile che non richiede spedizione e che non è conservato in magazzino. Alcuni esempi includono servizi, appartenenze e abbonamenti.bundle: un set di prodotti personalizzabile di prodotti semplici venduti insieme. |
categories | Indica ogni categoria assegnata al prodotto. Separa le categorie e le sottocategorie con una barra. Per indicare più percorsi di categoria, separare ogni percorso con una barra verticale | simbolo. Esempio: Default Category/Gear|Default Category/Gear/Bags |
product_websites | Il codice del sito web di ciascun sito web in cui il prodotto è disponibile. Un singolo prodotto può essere assegnato a più siti web o limitato a uno solo. Se si specificano più siti Web, separarli con una virgola e senza spazi. Ad esempio: base o base,website2 |
name | Il nome del prodotto viene visualizzato in tutti gli elenchi di prodotti e corrisponde al nome utilizzato dai clienti per identificare il prodotto. |
description | La descrizione del prodotto fornisce informazioni dettagliate sul prodotto e potrebbe includere semplici tag HTML. |
short_description | L’utilizzo della breve descrizione del prodotto dipende dal tema. Può apparire negli elenchi dei prodotti e a volte viene utilizzato negli elenchi dei feed RSS inviati ai siti di acquisto. |
weight | Peso del singolo prodotto. Il peso effettivo del prodotto è determinato dal vettore al momento della spedizione. |
| product_online | Determina se il prodotto è disponibile per la vendita nel negozio. Valori:1 — (Sì) Il prodotto è abilitato e disponibile per la vendita.2 - (No) Il prodotto è disabilitato e non è disponibile per la vendita. |
tax_class_name | Nome della classe fiscale associata al prodotto. |
visibility | Determina se il prodotto è visibile nel catalogo e reso disponibile per la ricerca. Valori:Not Visible Individually — Il prodotto non è incluso negli elenchi di prodotti, anche se potrebbe essere disponibile come variante di un altro prodotto.Catalog - Il prodotto viene visualizzato in tutte le voci del catalogo.Search - Il prodotto è disponibile per le operazioni di ricerca.Catalog, Search — Il prodotto è incluso nelle inserzioni del catalogo ed è disponibile anche per la ricerca. |
price | Il prezzo al quale il prodotto è offerto in vendita nel tuo negozio. |
special_price | Il prezzo scontato del prodotto durante l’intervallo di date specificato. |
special_price_from_date | Data di inizio del periodo di tempo in cui è in vigore il prezzo speciale. |
special_price_to_date | L'ultima data del periodo di tempo in cui è in vigore il prezzo speciale. |
url_key | La parte dell’URL che identifica il prodotto. Il valore predefinito è basato sul nome del prodotto. Esempio: product-name |
| save_rewrites_history | Se viene fornito il valore 1 con un nuovo url_key, viene generata una nuova riscrittura dell'URL 301 in modo che l'URL precedente venga reindirizzato al nuovo URL. |
meta_title | Il metatitolo viene visualizzato nella barra del titolo e nella scheda del browser e degli elenchi dei risultati della ricerca. Il metatitolo deve essere univoco per il prodotto, contenere parole chiave di alto valore e contenere meno di 70 caratteri. |
meta_keywords | Le parole chiave meta sono visibili solo ai motori di ricerca e vengono ignorate da alcuni motori di ricerca. Scegli parole chiave di valore elevato, separate da una virgola. Esempio: keyword1, keyword2, keyword3 |
meta_description | Le metadescrizioni forniscono una breve panoramica del prodotto per l’elenco dei risultati di ricerca. Idealmente, una metadescrizione dovrebbe avere una lunghezza compresa tra 150 e 160 caratteri, anche se il campo accetta fino a 255 caratteri. |
base_image | Percorso relativo per l’immagine principale nella pagina del prodotto. Commerce memorizza i file internamente in una struttura di cartelle alfabetiche. Puoi visualizzare la posizione esatta di ogni immagine nei dati esportati. Ad esempio: /sample_data/m/b/mb01-blue-0.jpgPer caricare una nuova immagine o sovrascrivere un'immagine esistente, immettere il nome del file preceduto da una barra. Esempio: /image.jpg |
base_image_label | Etichetta associata all'immagine di base. |
small_image | Il nome file della piccola immagine utilizzata nelle pagine del catalogo, preceduto da una barra. Esempio: /image.jpg |
small_image_label | Etichetta associata all'immagine piccola. Esempio: Small Image 1, Small Image 2 |
thumbnail_image | Nomi dei file di qualsiasi miniatura da visualizzare nella raccolta nella pagina del prodotto, preceduti da una barra. Esempio: /image.jpg |
thumbnail_image_label | Etichetta associata alle miniature. Esempio: Thumbnail 1, Thumbnail 2 |
created_at | Indica la data di creazione del prodotto. La data viene generata automaticamente al momento della creazione del prodotto, ma può essere modificata in un secondo momento. |
updated_at | Indica la data dell’ultimo aggiornamento del prodotto. |
new_from_date | Specifica la data di inizio per i nuovi elenchi di prodotti e determina se il prodotto viene presentato come un nuovo prodotto. |
new_to_date | Specifica la data "a" per i nuovi elenchi di prodotti e determina se il prodotto viene presentato come un nuovo prodotto. |
display_product_options_in | Se il prodotto dispone di più opzioni, determina dove vengono visualizzate nella pagina del prodotto. Valori: Colonna informazioni prodotto/Blocca dopo Colonna informazioni |
map_price | Il prezzo minimo pubblicizzato del prodotto. (Viene visualizzato solo se MAP è abilitato.) |
msrp_price | Il prezzo al dettaglio consigliato dal produttore per il prodotto. (Viene visualizzato solo se MAP è abilitato.) |
map_enabled | Determina se il prezzo minimo annunciato è abilitato nella configurazione. Valori:1 — (Sì) MAP è abilitato.0 (o vuoto) - (No) MAP non è abilitato. |
gift_message_available | Determina se un messaggio regalo può essere incluso nell'acquisto del prodotto. Valori:1 — (Sì) L'opzione per includere un messaggio regalo viene presentata al cliente.0 (o vuoto) - (No) L'opzione per includere un messaggio regalo non viene presentata al cliente. |
custom_design | Elenca i temi disponibili che possono essere applicati alla pagina del prodotto. |
custom_design_from | Specifica la data di inizio in cui il tema selezionato viene applicato alla pagina prodotto. |
custom_design_to | Specifica la data di fine in cui il tema selezionato viene applicato alla pagina prodotto. |
custom_layout_update | Codice XML aggiuntivo applicato come aggiornamento del layout alla pagina di prodotto. |
page_layout | Determina il layout di pagina della pagina prodotto. Valori:No layout updates — Non viene apportata alcuna modifica al layout della pagina.1 column - Applica un layout a una colonna alla pagina del prodotto.2 columns with left bar - Applica un layout a due colonne con barra laterale a sinistra alla pagina del prodotto.2 columns with right bar — Applica un layout a due colonne con barra laterale a destra alla pagina del prodotto.3 columns - Applica un layout a tre colonne alla pagina del prodotto.empty — Applica un layout vuoto alla pagina del prodotto. |
product_options_container | Se il prodotto dispone di più opzioni, determina dove vengono visualizzate nella pagina del prodotto. Valori: Colonna informazioni prodotto/Blocca dopo Colonna informazioni |
msrp_display_actual_price_type | Determina dove il prezzo effettivo di un prodotto è visibile al cliente. Valori:In Cart - Visualizza il prezzo effettivo del prodotto nel carrello.Before Order Confirmation - Visualizza il prezzo effettivo del prodotto al termine del processo di pagamento, immediatamente prima della conferma dell'ordine.On Gesture - Visualizza il prezzo effettivo del prodotto in un popup quando il cliente fa clic su Fai clic per il prezzo o Cos'è questo?Collegamento. |
country_of_manufacture | Identifica il paese in cui il prodotto è stato fabbricato. |
additional_attributes | Attributi aggiuntivi creati per il prodotto. Esempio:has_options=0,required_options=0color=Black,has_options=0,required_options=0,size_general=XS |
qty | Quantità del prodotto attualmente in magazzino. |
out_of_stock_qty | Livello di stock che determina l'esaurimento del prodotto. |
use_config_min_qty | Determina se viene utilizzato il valore predefinito della configurazione e corrisponde alla casella di controllo Usa impostazioni di configurazione. Valori:1 — (Sì) Per il valore di questo attributo viene utilizzata l'impostazione di configurazione predefinita.0 (o vuoto) - (No) La configurazione predefinita può essere ignorata per il valore di questo attributo. |
is_qty_decimal | Determina se l'attributo qty ha un valore decimale. Valori:1 — (Sì) Il valore dell'attributo qty è un valore decimale.0 (o vuoto) - (No) Il valore dell'attributo qty è un numero intero (numero intero). |
allow_backorders | Determina se lo store consente gli ordini inevasi e come vengono gestiti. |
use_config_backorders | Determina se viene utilizzata l'impostazione di configurazione predefinita per gli ordini inevasi e corrisponde allo stato della casella di controllo Usa impostazioni di configurazione. Valori:1 — (Sì) Il valore dell'attributo qty è un valore decimale.0 (o vuoto) - (No) Il valore dell'attributo qty è un numero intero (numero intero). |
min_cart_qty | Specifica la quantità minima dell'articolo che può essere acquistato in un singolo ordine. |
use_config_min_sale_qty | Determina se viene utilizzata l'impostazione di configurazione predefinita per la quantità minima e corrisponde allo stato della casella di controllo Usa impostazioni di configurazione. Valori:1 — (Sì)0 (o vuoto) — (No) |
max_cart_qty | Specifica la quantità massima del prodotto che può essere acquistata in un singolo ordine. |
use_config_max_sale_qty | Determina se viene utilizzata l'impostazione di configurazione predefinita per la quantità massima e corrisponde allo stato della casella di controllo Usa impostazioni di configurazione. Valori:1 — (Sì)0 (o vuoto) — (No) |
is_in_stock | Indica se il prodotto è in magazzino. |
notify_on_stock_below | Specifica il livello di azioni che attiva una notifica esaurita. |
use_config_notify_stock_qty | Determina se l'impostazione di configurazione predefinita viene utilizzata per attivare la notifica a livello di stock e corrisponde allo stato della casella di controllo Usa impostazioni di configurazione. Valori:1 — (Sì)0 (o vuoto) — (No) |
manage_stock | Determina se il controllo dell'inventario viene utilizzato per gestire il prodotto. Valori:1 - (Sì) Attiva il controllo completo dell'inventario per gestire i livelli di scorte del prodotto.0 (o vuoto) - (No) Il sistema non tiene traccia del numero di elementi attualmente in magazzino. |
use_config_manage_stock | Determina se viene utilizzata l'impostazione di configurazione predefinita per la gestione del materiale e corrisponde allo stato della casella di controllo Usa impostazioni di configurazione. Valori:1 — (Sì)0 (o vuoto) — (No) |
use_config_qty_increments | Determina se viene utilizzata l'impostazione di configurazione predefinita per gli incrementi di quantità e corrisponde allo stato della casella di controllo Usa impostazioni di configurazione. Valori:1 — (Sì)0 (o vuoto) — (No) |
qty_increments | Stabilisce il numero di prodotti che compongono un incremento di quantità. |
use_config_enable_qty_inc | Determina se viene utilizzata l'impostazione di configurazione predefinita per abilitare gli incrementi di quantità e corrisponde allo stato della casella di controllo Usa impostazioni di configurazione. Valori:1 — (Sì)0 (o vuoto) — (No) |
enable_qty_increments | Determina se gli incrementi di quantità sono abilitati per il prodotto. |
is_decimal_divided | Determina se le parti del prodotto possono essere spedite separatamente. Opzioni: Yes / No |
website_id | Per le installazioni con più siti web, identifica un sito web specifico in cui il prodotto è disponibile. Se vuoto, il prodotto è disponibile in tutti i siti web. |
related_skus | Elenca lo SKU di ciascun prodotto identificato come prodotto correlato. Esempio: 24-WG080,24-UG03,24-UG01,24-UG02 |
related_position | Determina la posizione (ordinamento) degli SKU elencati come Prodotti correlati nella colonna related_skus. Esempio: 1,2,3,4 |
crosssell_skus | Elenca lo SKU di ciascun prodotto identificato come cross-selling. |
crosssell_position | Determina la posizione (ordinamento) degli SKU elencati come Prodotti di cross-selling nella colonna crosssell_skus. |
upsell_skus | Elenca lo SKU di ciascun prodotto identificato come upselling. |
upsell_position | Determina la posizione (ordinamento) degli SKU elencati come prodotti di upselling nella colonna upsell_skus. |
additional_images | I nomi dei file di qualsiasi immagine aggiuntiva da associare al prodotto, preceduti da una barra. Esempio: /image.jpg |
additional_image_labels | Etichette associate a eventuali immagini aggiuntive. Esempio: Label 1, Label 2 |
custom_options | Specifica le proprietà e i valori assegnati a ciascuna opzione personalizzata. Esempio: `name=Color, type=drop_down, required=1, price= price_type=fixed, sku=, option_title=Black |
Dati del servizio per le varianti di prodotto
| Attributo | Descrizione | Applicabile a |
|---|---|---|
_super_products_sku | SKU generata per una variante di prodotto configurabile. Ad esempio: WB03-XS-Green | Prodotti configurabili |
_super_attribute_code | Il codice attributo di una variante di prodotto configurabile. Ad esempio: color | Prodotti configurabili |
_super_attribute_option | Valore di una variante di prodotto configurabile. Ad esempio: verde | Prodotti configurabili |
_super_attribute_price_corr | Adeguamento di prezzo associato a una variante di prodotto configurabile. | Prodotti configurabili |
_associated_sku | SKU di un prodotto associato a un prodotto raggruppato. | Prodotti Raggruppati Prodotti Del Bundle |
_associated_default_qty | Determina la quantità del prodotto associato incluso. | Prodotti Configurabili Prodotti Raggruppati Prodotti In Bundle |
_associated_position | Determina la posizione del prodotto associato quando viene elencato con altri prodotti associati. | Prodotti Configurabili Prodotti Raggruppati Prodotti In Bundle |
Attributi complessi dei dati del prodotto
Il termine dati complessi si riferisce ai dati associati a più opzioni di prodotto. I seguenti tipi di prodotto utilizzano dati provenienti da prodotti separati per creare varianti di prodotto e più opzioni.
Se esportate un prodotto configurabile, troverete gli attributi standard che compongono un prodotto semplice, oltre agli attributi aggiuntivi necessari per gestire dati complessi.
Prodotti configurabili
Attributo
Descrizione
configurable_variation_labelsEtichette che identificano le varianti di prodotto. Ad esempio:
Choose Color: o Choose Size:configurable_variationsDescrive i valori associati a una variante di prodotto. Esempio: `sku=sku-red xs,color=red,size=xs,price=10.99,display=1,image=/pub/media/import/image1.png
Prodotti raggruppati
Attributo
Descrizione
associated_skusIdentifica gli SKU dei singoli prodotti che compongono il gruppo.
Prodotti bundle
Attributo
Descrizione
bundle_price_typeDetermina se il prezzo di un articolo bundle è fisso o dinamico.
bundle_sku_typeDetermina se a ogni elemento viene assegnato uno SKU dinamico, variabile o se per il bundle viene utilizzato uno SKU fisso. Opzioni: Fisso / Dinamico
bundle_weight_typeDetermina se il peso di un elemento bundle è variabile o fisso.
bundle_valuesDescrive il valore di apprendimento associato a un’opzione bundle. Esempio:
name=Bundle Option One,type=dropdown; required=1, sku=sku-option2,price=10, price_type=fixedAttributi di determinazione prezzi avanzati
Advanced Price Import/Export consente di aggiornare rapidamente le informazioni sui prezzi per gruppi di prodotti e prezzi di livello. Il processo per importare e esportare dati di prezzo avanzati è lo stesso di qualsiasi altro tipo di entità. Il file CSV di esempio contiene i prezzi di livello e gruppo per ciascun tipo di prodotto che supporta prezzi avanzati. La modifica del prezzo avanzato non influisce sul resto del record del prodotto.
Attributo
Descrizione
sku(Obbligatorio) L’unità di gestione delle scorte è un identificatore alfanumerico univoco utilizzato per tenere traccia delle scorte. Una SKU può contenere fino a 64 caratteri. Ad esempio:
Nota: un SKU più lungo di 64 caratteri impedisce l'importazione.
sku123Nota: un SKU più lungo di 64 caratteri impedisce l'importazione.
tier_price_websiteIl codice sito Web identifica ogni sito Web in cui è disponibile il piano tariffario. Esempio:
- website1 - All Websites [USD]tier_price_customerIdentifica i gruppi di clienti in cui è disponibile il prezzo del livello. Esempio:
- ALL GROUPS - NOT LOGGED IN - General - Wholesale - Retailertier_price_customer_groupIdentifica i gruppi di clienti in cui è disponibile la determinazione dei prezzi per livello. Esempio:
- ALL GROUPS - NOT LOGGED IN - General - Wholesale - Retailertier_price_qtyQuantità del prodotto che deve essere ordinata per ricevere lo sconto sul prezzo del livello.
tier_pricePrezzo di livello scontato del prodotto. Per prodotti bundle, il prezzo livello viene calcolato come percentuale.
group_price_websiteIl codice del sito Web di ogni sito Web in cui è disponibile la determinazione prezzi di gruppo. Se si specificano più siti Web, separarli con una virgola e senza spazi. Esempio:
- website1 - All Websites [USD]group_price_customer_groupIdentifica i gruppi dei clienti in cui è disponibile il prezzo di gruppo. Esempio:
- NOT LOGGED IN - General - Wholesale - Retailergroup_priceIl prezzo di gruppo scontato del prodotto. Per prodotti bundle, il prezzo di gruppo viene calcolato come percentuale.
recommendation-more-help
d3c62084-5181-43fb-bba6-1feb2fcc3ec1