产品 CSV 列描述

产品 CSV 文件的各列描述

若要使用 Transporter 应用将产品导入 Shopify,您需要一个仅包含此记录类型的 CSV 文件。

CSV 示例文件

下载示例产品 CSV 文件:products.csv

您可以使用 Transporter 命令行工具生成此 CSV 文件,或者按照下文描述的格式自己创建此文件。

列描述

下表介绍了 CSV 文件的列标头。

描述
Handle
(必填)
产品的唯一标识符。指定不含空格的人性化字符串。handle 通常是产品的小写标题,其中的空格和特殊字符均被替换为了连字符 (-)。例如,titan-t-shirt)。handle 显示在您的在线商店的产品页面的 URL 中(例如 https://titan.plus/products/titan-t-shirt)。必须填写此列。
Title
(必填)
产品名称。例如,Titan T 恤。必须填写此列。
Body 产品描述。您可以在此描述中添加 HTML 格式设置标记。例如,“穿上这款<b> 100% 纯棉</b> T 恤一定能让您吸引大家的目光”
Vendor 产品供应商的名称。默认值是商店的名称。例如,Titan Incorporated
Type 您可以将产品类型用作自动生成产品系列的条件,或者帮助您在 Shopify 后台筛选产品。产品只能有一种产品类型。
Tags 一串以逗号分隔的标签,用于筛选和搜索。每个以逗号分隔的标签最多可以包含 255 个字符。例如,“令人激动的、闪存、MP3、音乐”。默认值为“”
Template Suffix Liquid 模板的后缀,您的在线店面将使用此模板显示产品及其多属性。默认模板名为 product.liquid,没有任何后缀。要使用此默认模板,请将此列留空。要使用其他模板,请输入该模板的后缀名。例如,如果要使用名为 product.mysuffix.liquid 的模板,则输入 mysuffix
Published Scope

指示是否向 Shopify POS (POS) 渠道提供此产品。有效值:

  • web - 产品不能在 Shopify POS 渠道进行销售。
  • global - 产品可在 Shopify POS 渠道进行销售。这是默认值。
值区分大小写
Published 是否向在线商店提供此产品。有效值:
  • true - 已向在线商店提供了此产品。
  • false - 在线商店中不提供该产品(当此列设置为“false”时,请不要为 Published At(发布时间)指定值。
值区分大小写
Published At 产品在在线商店开售的日期和时间(ISO 8601 格式)。例如,2007-12-31T19:00:00-05:00。当 Published 设置为 false 时,请勿为此列指定值。
Option1 Name 自定义产品属性名称。例如,尺寸颜色材质。最大长度:255 个字符。
Option1 Value 自定义产品选项的值。例如小号红色羊毛
Option2 Name 自定义产品属性名称,例如“尺寸”、“颜色”和“材质”。最大长度:255 个字符。
Option2 Value 自定义产品选项的值。
Option3 Name 自定义产品属性名称,例如“尺寸”、“颜色”和“材质”。最大长度:255 个字符。
Option3 Value 自定义产品选项的值。
Variant SKU 商店中产品多属性的唯一标识符。如果您的商店使用发货服务(即,包括 Variant Fulfillment Service),则必须填写此列。例如,IPOD2008PINK
Metafields Global Title Tag 用于 SEO 目的的产品名称(包括产品多属性)。如果您不提供值,则默认采用 Title 列中的值。Metafields Global Title Tag 值显示在店面产品页面的元标题标签 (<meta name='title'>) 中。如果您的产品有多属性,请在此标题中包含多属性的相关信息(因为多属性没有单独的元标签)。最大长度:70 个字符。
Metafields Global Description Tag 用于 SEO 目的的产品描述(包括此产品的多属性)。如果您不为此列提供值,则默认采用“正文”列中的值。元字段全局描述标签值用于您店面的产品页面中的元描述标签 (<meta name='description-of-product'>)。如果您的产品有多属性,则在此描述中包含多属性的相关信息(多属性没有单独的元标签)。最大长度:320 个字符。
Metafield Namespace 一组元字段的容器。若要导入元字段,您需要包括以下 4 个元字段列中的值:Metafield NamespaceMetafield KeyMetafield ValueMetafield Value Type。您应该为元字段定义自定义命名空间,以区别于应用和 Shopify 使用的命名空间(包括默认的 global)。最大长度:20 个字符。
Metafield Key 元字段的名称。包含其他元字段列时必须填写此列。最大长度:30 个字符。
Metafield Value 要存储为元数据的信息。包含其他元字段列时,必须填写此列。
Metafield Value Type 元字段的信息类型。有效值:
  • string
  • integer
  • json_string
值要区分大小写。如果包含其他元字段列,则必须填写此列。
Variant Grams 产品多属性的重量值,以克为单位。如果将此列留空,则默认将其值设置为 0。请不要在此值中包含重量单位 (g)。对于克以外的任何重量单位,请改用 Variant Weight 列。请不要将 Variant Weight Unit 列与此列一同使用。
Variant Inventory Tracker 描述如何跟踪产品多属性的库存。有效值:
  • Shopify - Shopify 会跟踪库存数量的变化。
  • fulfillment-service-handle - 库存数量变化会由发货服务在 Shopify 外部跟踪。此列中的值需要与 Variant Fulfillment Service 列中的值相匹配。
值区分大小写
Variant Inventory Qty 可供销售的产品多属性的数量(正整数)。例如:5。默认值为 0。如果您将此列留空,它的值将设为 0。如果 Shopify 未跟踪您的库存(即 Variant Inventory Tracker 列设为 false),请将此列留空。库存数量将应用到商店的默认位置。有关更改不同位置的库存数量的信息,请参阅使用 CSV 文件导出或导入库存
Variant Inventory Policy 客户是否可以在缺货时订购产品多属性。有效值:
  • deny - 客户无法在产品多属性缺货的情况下订购产品多属性。此为默认值。
  • continue - 如果库存不足,客户可以订购产品多属性。
值区分大小写
Variant Fulfillment Service 发货服务,在客户订购产品多属性时进行发货。有效值:
  • manual - 手动为订单中的产品多属性发货。此为默认值。如果您将此列留空,则默认向此列分配该值。
  • 发货服务的处理 - 发货服务为产品多属性的订单进行发货。如果您使用发货服务,还需要包括 Variant SKU 列。
值区分大小写
Variant Price 产品多属性的价格。
多属性原价 产品多属性的比较价格或建议价格。
多属性库存成本 产品多属性的成本记录。
Variant Requires Shipping 多属性是否需要发货。有效值:
  • true - 客户在订购此产品多属性时需提供地址。此为默认值。
  • false - 客户地址为选填项。
值区分大小写
Variant Taxable 在销售产品多属性时是否收税。有效值:
  • true - 需要收税。此为默认设置。
  • false - 无需纳税。
值区分大小写
Variant Barcode 产品多属性的条码、UPC 或 ISBN 编号。
Image Attachment Base64 编码的图片。
Image Src

产品图片的 URL(例如 http://titan.plus/images/product-image.png)。不支持非 HTTP URL。Transporter 应用会在导入期间下载图片,然后将图片上传到商店。图片可以是 .png、.gif 或 .jpg 格式。上传图片后,无法更改其文件名。如果您具有特定于多属性的图片,请将它们添加到 Variant Image 列。

若要为单个产品上传多张图片,请为每张图片新建一行。在每行的 Handle 列中输入产品的 handle,并在此列输入图片的 URL。若要包含有关此图片的其他信息(例如图片位置),请将信息输入到相关的图片列中。

Image Position 输入表示图片要显示在您店面的产品页面上的顺序的数字。例如,如果希望图片显示在此产品页面的开头,则输入 1。
Image Alt Text 简要描述图片内容的替代文字。如果出于任何原因无法加载图片,则会改为在您的店面中显示替代文字。搜索引擎使用替代文字进行搜索引擎优化,辅助技术也使用替代文字为存在视觉障碍的客户描述图片。最大长度:512 个字符。
Variant Image 产品多属性的图片 URL。在产品多属性的其中一行中的此列中输入产品多属性图片的 URL。产品多属性只能有一张图片。
Variant Weight 产品多属性的重量值。请勿将此列与 Variant Grams 列一同使用。默认值为 0。请勿在此值中包含重量单位。使用 Variant Weight Unit 列指定重量单位。例如,如果产品重量为 100 磅 (lb) 并且 Variant Weight Unit 已设置为 lb,则在此列中输入 100
Variant Weight Unit Variant Weight 列中应用于产品多属性重量的度量单位。有效值为 g、kg、oz 和 lb。默认值是商店的默认度量单位。不要将 Variant Weight UnitVariant Grams 列一同使用。
Variant Tax Code 产品的 valara 税务代码。此参数仅适用于已安装 Avalara AvaTax 应用的商店。例如,实体商品的税务代码是 P000000

附注

文件名

CSV 文件的名称需要包含 product 一词(其所包含的对象类型的名称)。例如 myproducts.csv。该文件需要采用 UTF-8 格式。

多个产品多属性

如果您有多个产品多属性,则需要创建行来描述每个多属性。

在产品行中:

  • 在选项名称列中输入选项名称(例如 Option1 Name)。
  • 请勿在产品多属性行中重复选项名称。

在产品多属性行中:

  • Handle 列中输入产品 handle。
  • 在选项值列中输入选项值(例如 Option1 Value)。

例如:

具有多个多属性的产品的屏幕截图

多张图片

若要上传单个产品(没有多属性)的多张图片,请为每张图片新建一个行。在每一行的 Handle 列中输入产品 handle,并在 Image Src 列中输入图片 URL。若要包含有关该图片的任何其他信息(例如图片位置),请将信息输入相关列(例如 Image Position 列)中。

若要上传具有产品多属性的产品的图片,请为每个产品多属性创建一个行。在每个产品多属性行的 Handle 列中输入产品 handle,并在 Variant Image 列中输入产品多属性 URL。您只能为每个产品多属性导入一张图片。

例如:

具有多张图片和多个产品多属性的产品的屏幕截图

相关链接

准备好开始使用 Shopify 进行销售了吗?

免费试用