产品 CSV 列描述

已于 Nov 17, 2019 打印了此页面。若要查看当前版本，请访问 https://help.shopify.com/zh-CN/manual/migrating-to-shopify/transporter-app/csv-products。

产品 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 Namespace、Metafield Key、Metafield Value 和 Metafield 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 Unit 和 Variant 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 进行销售了吗？

免费试用