Descrizioni colonne file CSV dei prodotti in Transporter

Descrizioni per le colonne del file CSV dei prodotti.

Per importare prodotti in Shopify utilizzando l'app Transporter, serve un file CSV che contenga solo questo tipo di record.

File CSV di esempio

Scarica un file di esempio per il CSV dei prodotti: products.csv.

Puoi utilizzare lo strumento riga di comando di Transporter per generare questo file CSV oppure puoi attenerti al formato descritto di seguito per crearne uno tu stesso.

Descrizione colonne

La tabella seguente indica le intestazioni delle colonne del file CSV.

Tabella relativa alle singole intestazioni delle colonne CSV
Colonna Descrizione
Handle
(Obbligatorio)
Identificatore univoco per il prodotto. Scegli una stringa leggibile e senza spazi. Di solito l'handle coincide con il titolo del prodotto in minuscolo, con spazi e caratteri speciali sostituiti da trattini (-). Ad esempio, titan-t-shirt). L'handle viene visualizzato nell'URL della pagina del prodotto del tuo negozio online (ad esempio, https://titan.plus/prodotti/titan-t-shirt). Questa colonna è obbligatoria.
Title
(Obbligatorio)
Nome del prodotto Ad esempio, Titan-t-shirt. Questa colonna è obbligatoria.
Body Descrizione del prodotto. In questa descrizione puoi aggiungere i tag di formattazione in HTML. Ad esempio, "Non passerai inosservato con questa maglietta <b>100% cotone</b>".
Vendor Nome del fornitore del prodotto. Il valore predefinito è il nome del negozio. Ad esempio, Titan Incorporated.
Category Una categoria di prodotto che può essere utilizzata come condizione per una collezione dinamica, per aiutarti a filtrare i prodotti nel pannello di controllo Shopify e per calcolare le imposte. Un prodotto può avere una sola categoria di prodotto.
Tags Stringa di tag separati da virgole, utilizzati per i filtri e la ricerca. Ciascuno dei tag separati da virgole può contenere fino a 255 caratteri. Ad esempio, Emozione, Memoria Flash, MP3, Musica. Il valore predefinito è "".
Template Suffix Il suffisso del modello che la vetrina virtuale online utilizza per mostrare il prodotto e le sue varianti. Il modello predefinito è denominato product, senza alcun suffisso. Per utilizzarlo, lascia vuota la colonna. Per utilizzare un modello diverso, inserisci il nome del suffisso del modello. Ad esempio, se desideri utilizzare un modello denominato product.mysuffix, inserisci mysuffix.
Published Scope

Indica se il prodotto è disponibile per il canale Shopify POS (Point of Sale). Valori validi:

  • web - il prodotto non è disponibile per il canale Shopify POS.
  • global - il prodotto è disponibile per il canale Shopify POS. Questo è il valore predefinito.

I valori tengono conto della differenza tra maiuscole e minuscole.

Published Se il prodotto è disponibile per il negozio online. Valori validi:
  • true - il prodotto è disponibile per il negozio online.
  • false - il prodotto non è disponibile per il negozio online. Se questa colonna è impostata su false, non specificare un valore per Published At.

I valori tengono conto della differenza tra maiuscole e minuscole.

Published At Data e ora (formato ISO 8601) in cui il prodotto è stato reso disponibile per il negozio online. Ad esempio, 2007-12-31T19: 00: 00-05: 00. Non specificare un valore per questa colonna quando Published è impostato su false.
Option1 Name Nome della proprietà personalizzata del prodotto. Ad esempio, Taglia, Colore e Materiale. Lunghezza massima: 255 caratteri.
Option1 Value Valore dell'opzione di prodotto personalizzata. Ad esempio piccolo, rosso e di lana.
Option2 Name Nome della proprietà personalizzata del prodotto come Taglia, Colore e Materiale. Lunghezza massima: 255 caratteri.
Option2 Value Valore dell'opzione di prodotto personalizzata.
Option3 Name Nome della proprietà personalizzata del prodotto come Taglia, Colore e Materiale. Lunghezza massima: 255 caratteri.
Option3 Value Valore dell'opzione di prodotto personalizzata.
Variant SKU Identificatore univoco per la variante di prodotto nel tuo negozio. Se il tuo negozio utilizza un servizio logistico (ossia è incluso Variant Fulfillment Service), allora questa colonna è obbligatoria. Ad esempio, IPOD2008PINK
Metafields Global Title Tag Nome della variante di prodotto per scopi SEO, utilizzato per il nome che verrà visualizzato sui motori di ricerca. Se non fornisci un valore, per impostazione predefinita viene utilizzato il valore nella colonna Title.

Il valore Metafields Global Title Tag appare nel meta tag del titolo (<meta name='title'>) nel codice della pagina del tuo prodotto nel tuo negozio. Se il tuo prodotto ha delle varianti, includi le informazioni sulle varianti in questo titolo poiché non esiste un meta tag separato per una variante. Se devi modificare questo valore in un secondo momento, lo puoi fare nella pagina del prodotto. Per maggiori informazioni, consulta Aggiungere parole chiave per SEO al negozio Shopify. Massimo: 70 caratteri.
Metafields Global Description Tag Descrizione della variante di prodotto per scopi SEO, utilizzata per la descrizione che verrà visualizzata sui motori di ricerca. Se non fornisci un valore, per impostazione predefinita viene utilizzato il valore nella colonna Body.

Il valore di Metafields Global Description Tag viene utilizzato nel meta tag di descrizione (<meta name='description-of-product'>) nel codice della pagina del prodotto nel tuo negozio. Se il prodotto ha delle varianti, includi le informazioni sulle varianti in questa descrizione, poiché non esiste un meta tag separato per una variante. Se devi modificare questo valore in un secondo momento, lo puoi fare nella pagina del prodotto nel pannello di controllo Shopify. Per maggiori informazioni, consulta Aggiungere parole chiave per SEO al negozio Shopify. Massimo: 320 caratteri.
Metafield Namespace Contenitore per un serie di metafield. Per importare i metafield, devi includere dei valori nelle quattro colonne relative ai metafield seguenti: Metafield Namespace, Metafield Key, Metafield Value e Metafield Type. Devi definire uno spazio dei nomi personalizzato per i tuoi metafield in modo da distinguerli dagli spazi dei nomi usati dalle app e da Shopify (incluso lo spazio dei nomi predefinito global). Lunghezza massima: 20 caratteri.
Metafield Key Nome del metafield. Questa colonna è obbligatoria quando sono incluse altre colonne relative ai metafield. Lunghezza massima: 30 caratteri.
Metafield Value Informazioni da memorizzare come metadati. Questa colonna è obbligatoria quando sono incluse altre colonne relative ai metafield.
Metafield Type Tipo di informazione del metafield. Valori validi:
  • string
  • integer
  • json_string

I valori tengono conto della differenza tra maiuscole e minuscole. Questa colonna è obbligatoria se sono incluse altre colonne di metafield.

Variant Grams Peso della variante di prodotto in grammi. Se lasci questa colonna vuota, per impostazione predefinita il suo valore è impostato su 0. Non includere l'unità di peso (g) in questo valore. Per misurazioni di peso non espresse in grammi, usa invece la colonna Variant Weight. Non usare la colonna Variant Weight Unit con questa colonna.
Variant Inventory Tracker Descrive come vengono tracciate le scorte per la variante del prodotto. Valori validi:
  • Shopify: le modifiche nella quantità di scorte sono tracciate da Shopify.
  • fulfillment-service-handle : le modifiche delle quantità di scorte sono tracciate esternamente a Shopify da un servizio logistico. Il valore in questa colonna deve corrispondere al valore nella colonna Variant Fulfillment Service.

I valori tengono conto della differenza tra maiuscole e minuscole.

Variant Inventory Qty La quantità (numero intero positivo) della variante di prodotto disponibile per la vendita. Ad esempio, 5. Il valore predefinito è 0. Se lasci questa colonna vuota, il valore è impostato su 0. Se le tue scorte non sono tracciate da Shopify (cioè la colonna Variant Inventory Tracker è impostata su false), lascia questa colonna vuota. La quantità di scorte sarà applicata alla sede del negozio predefinita. Per informazioni su come modificare le quantità di scorte per diverse sedi, vedi Esportare o importare le scorte con un file CSV .
Variant Inventory Policy Se i clienti possono effettuare un ordine per la variante di prodotto quando è esaurita. Valori validi:
  • deny - I clienti non possono ordinare la variante di prodotto se è esaurita. Questo è il valore predefinito.
  • continue - I clienti possono ordinare la variante di prodotto se è esaurito.

I valori tengono conto della differenza tra maiuscole e minuscole.

Variant Inventory Cost Indicazione del costo della variante di prodotto.
Variant Fulfillment Service Il fornitore che evade la variante di prodotto quando viene ordinata. Valori validi:
  • manual - Evadi manualmente gli ordini per la variante di prodotto. Questo è il valore predefinito. Se lasci la colonna vuota, per impostazione predefinita viene assegnato questo valore.
  • handle of the fulfillment service : un servizio logistico evade gli ordini per la variante di prodotto. Se utilizzi un servizio logistico, devi includere anche la colonna Variant SKU.

I valori tengono conto della differenza tra maiuscole e minuscole.

Variant Price Il prezzo della variante di prodotto.
Prezzo di Confronto Variante Prezzo di confronto o prezzo suggerito per la variante di prodotto.
Variant Requires Shipping Se la variante deve essere spedita. Valori validi:
  • true - il cliente deve fornire un indirizzo quando ordina questa variante di prodotto. Questo è il valore predefinito.
  • false - l'indirizzo del cliente è facoltativo.

I valori tengono conto della differenza tra maiuscole e minuscole.

Variant Taxable Se viene applicata un'imposta quando viene venduta la variante di prodotto. Valori validi:
  • true - vengono addebitate imposte. Questa è l'impostazione predefinita.
  • false - non vengono addebitate imposte.

I valori tengono conto della differenza tra maiuscole e minuscole.

Variant Barcode Numero del codice a barre, UPC o ISBN della variante di prodotto.
Image Attachment Un'immagine codificata in Base64.
Image Src

L'URL per l'immagine del prodotto (ad esempio, http://titan.plus/images/product-image.png). Gli URL senza HTTP non sono supportati. L'app Transporter scaricherà le immagini durante l'importazione e le caricherà nel tuo negozio. Le immagini possono essere in formato .png, .gif o .jpg . Dopo il caricamento, il nome del file dell'immagine non può essere modificato. Se disponi di immagini relative a varianti specifiche, aggiungile alla colonna Variant Image.

Per caricare più immagini di un singolo prodotto, crea una nuova riga per ogni immagine. In ogni riga inserisci l'handle del prodotto nella colonna Handle e l'URL dell'immagine in questa colonna. Per includere altre informazioni riguardo l'immagine (ad esempio la sua posizione), inseriscile nella colonna associata all'immagine.

Image Position Il numero che rappresenta l'ordine in cui desideri che l'immagine appaia sulla pagina di prodotto nella tua vetrina virtuale. Ad esempio, inserisci 1 se desideri che l'immagine appaia per prima per il prodotto.
Image Alt Text Testo alternativo che descrive brevemente l'immagine. Se per qualsiasi motivo un’immagine non viene caricata, al suo posto nella tua vetrina virtuale appare il testo alternativo. Il testo alternativo viene anche utilizzato dai motori di ricerca per la SEO e dalla tecnologia assistiva per descrivere un'immagine a un cliente ipovedente. Massimo: 512 caratteri.
Variant Image L'URL dell'immagine della variante di prodotto. In una delle righe della variante di prodotto, inserisci l'URL dell'immagine della variante di prodotto in questa colonna. Una variante di prodotto può avere una sola immagine.
Variant Weight Peso della variante di prodotto. Non utilizzare questa colonna con la colonna Variant Grams. Il valore predefinito è 0. Non includere l'unità di peso nel valore. Usa la colonna Variant Weight Unit per specificare l'unità di peso. Ad esempio, se il prodotto pesa 45,3 kg (100 lb) e Variant Weight Unit è impostata su lb, inserisci 100 in questa colonna.
Variant Weight Unit Unità di misura che si applica al peso della variante di prodotto nella colonna Variant Weight. I valori validi sono g, kg, oz e lb. Il valore predefinito è l'unità di misura predefinita del tuo negozio. Non utilizzare Variant Weight Unit con la colonna Variant Grams.
Variant Tax Code Il codice imposta Avalara per il prodotto. Questo parametro si applica solo ai negozi che hanno installato l'app Avalara AvaTax. Ad esempio, il codice imposta per i beni fisici è P000000.

Nomi dei file

Il nome del tuo file CSV deve includere la parola product (il nome del tipo di articolo che contiene). Ad esempio, mieiprodotti.csv. Il file deve essere nel formato UTF-8.

Varianti di prodotto multiple

Se hai più di una variante di prodotto, devi creare una riga per descrivere ciascuna variante.

Nella riga del prodotto:

  • Inserisci i nomi delle opzioni nelle colonne dei nomi delle opzioni (ad esempio, inserisci Color in Option1 Name).
  • Inserisci i dettagli che si applicano al prodotto generale, ad esempio Handle, Title e Type.

Nelle righe delle varianti di prodotto:

  • Inserisci l'handle del prodotto nella colonna Handle.
  • Non ripetere i nomi delle opzioni (ad esempio, Option1 Name, Option2 Name) nelle righe delle varianti di prodotto.
  • Inserisci i valori delle opzioni nelle colonne dei valori delle opzioni (ad esempio, se hai scelto Color come nome su Option1 Name, allora in Option1 Value puoi inserire valori come White, Black o Blue).

Ad esempio:

Screenshot of a product with multiple variants

Immagini multiple

Per caricare più immagini di un singolo prodotto (che non ha varianti), crea una riga per ogni immagine. In ogni riga inserisci l'handle del prodotto nella colonna Handle e l'URL dell'immagine nella colonna Image Src. Per includere altre informazioni riguardo l'immagine (ad esempio, la sua posizione), inseriscile nella colonna associata (ad esempio, nella colonna Image Position).

Per caricare le immagini di un prodotto che presenta varianti, crea una riga per ogni variante di prodotto. Nella riga di ogni variante di prodotto inserisci l'handle del prodotto nella colonna Handle e l'URL della variante di prodotto nella colonna Variant Image. Puoi importare una sola immagine per ogni variante di prodotto.

Ad esempio:

Screenshot of a product that has multiple images and multiple product variants

Più metafield

Per importare più metafield per un singolo prodotto, crea una riga per ogni metafield. Su ogni riga, inserisci l'handle del prodotto nella colonna Handle e i dati dei metafield nelle colonne appropriate. Ogni nuova riga deve contenere informazioni solo nella colonna Handle e in tutte le colonne dei metafield.

Nell'esempio seguente, si importa un prodotto con 3 varianti. Il prodotto ha 2 metafield chiamati Surf Shoe Co e Rubber. Ogni variante ha un solo metafield.

Schermata di un prodotto con varianti di metafield

Puoi scaricare e visualizzare un file CSV di esempio di un prodotto con più metafield e utilizzarlo come modello.

Sei pronto per iniziare a vendere con Shopify?

Provalo, è gratis