Transporter 中的产品 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 。 |
Category | 产品类别,可用作自动生成的产品系列的条件,旨在帮助您在 Shopify 后台筛选产品以及计算税费。一种产品只能有一个产品类别。 |
Tags | 一串以逗号分隔的标签,用于筛选和搜索。每个以顿号分隔的标签最多可以包含 255 个字符。例如,“令人激动的、闪存、MP3、音乐” 。默认值为“” 。 |
Template Suffix |
模板的后缀,您的在线店面使用此模板来显示产品及其多属性。默认模板名为 product ,没有任何后缀。若要使用此默认模板,请将此列留空。若要使用其他模板,请输入模板的后缀名。例如,如果要使用名为 product.mysuffix 的模板,则输入 mysuffix 。 |
Published Scope |
说明是否向 Shopify POS (POS) 渠道提供此产品。有效值:
值区分大小写。 |
Published | 是否向在线商店提供此产品。有效值:
值区分大小写。 |
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'> ) 中。如果您的产品有多属性,请在此标题中包含多属性的相关信息,因为多属性没有单独的元标签。如果稍后需要更改此值,您可以在产品页面执行此操作。有关详细信息,请参阅向 Shopify 商店添加 SEO 关键字。最大长度:70 个字符。 |
Metafields Global Description Tag | 面向 SEO 目的的产品多属性描述,用于将出现在搜索引擎中的描述。如果您不提供值,则默认采用 Body 列中的值。元字段全局描述标签 值用于您商店产品页面代码中的元描述标签 (<meta name='description-of-product'> )。如果您的产品有多属性,请在此描述中包含多属性的相关信息,因为多属性没有单独的元标签。如果稍后需要更改此值,您可以在 Shopify 后台中的产品页面执行此操作。有关详细信息,请参阅向 Shopify 商店添加 SEO 关键字。最大长度:320 个字符。 |
Metafield Namespace | 一组元字段的容器。若要导入元字段,您需要包括以下 4 个元字段列中的值:Metafield Namespace 、Metafield Key 、Metafield Value 和 Metafield Type 。您应该为元字段定义自定义命名空间以区分应用和 Shopify 使用的应用(包括默认的 global )。最大长度:20 个字符。 |
Metafield Key | 元字段的名称。包含其他元字段列时必须填写此列。最大长度:30 个字符。 |
Metafield Value | 要存储为元数据的信息。包含其他元字段列时,必须填写此列。 |
Metafield Type | 元字段的信息类型。有效值:
值区分大小写。如果包含其他元字段列,则必须填写此列。 |
Variant Grams | 产品多属性的重量值,以克为单位。如果将此列留空,则默认将其值设置为 0 。请不要在此值中包含重量单位(克)。对于克以外的任何重量单位,请改用 Variant Weight 列。请不要将 Variant Weight Unit 列与此列一同使用。 |
Variant Inventory Tracker | 描述如何跟踪产品多属性的库存。有效值:
值区分大小写。 |
Variant Inventory Qty | 可供销售的产品多属性的数量(正整数)。例如:5 。默认值为 0 。如果您将此列留空,它的值将设为 0 。如果 Shopify 未跟踪您的库存(即 Variant Inventory Tracker 列设为 false ),请将此列留空。库存数量将应用到商店的默认地点。有关更改不同地点的库存数量的信息,请参阅使用 CSV 文件导出或导入库存。 |
Variant Inventory Policy | 客户是否可以在缺货时订购产品多属性。有效值:
值区分大小写。 |
多属性库存成本 | 产品多属性的成本记录。 |
Variant Fulfillment Service | 发货服务,在客户订购产品多属性时进行发货。有效值:
值区分大小写。 |
Variant Price | 产品多属性的价格。 |
多属性原价 | 产品多属性的比较价格或建议价格。 |
Variant Requires Shipping | 多属性是否需要发货。有效值:
值区分大小写。 |
Variant Taxable | 在销售产品多属性时是否收税。有效值:
值区分大小写。 |
Variant Barcode | 产品多属性的条码、UPC 或 ISBN 编号。 |
Image Attachment | Base64 编码的图片。 |
Image Src |
产品图片的 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
输入Color
)。 - 输入适用于整个产品的详细信息,例如
Handle
、Title
和Type
。
在产品多属性行中:
- 在
Handle
列中输入产品 handle。 - 请勿在产品多属性行中重复选项名称(例如
Option1 Name
、Option2 Name
)。 - 在选项值列中输入选项值(例如,如果您在
Option1 Name
中输入了Color
作为您的名字,则可以在Option1 Value
中输入White
、Black
或Blue
等值)。
例如:
多张图片
若要上传单个产品(没有多属性)的多张图片,请为每张图片新建一个行。在每一行的 Handle
列中输入产品 handle,并在 Image Src
列中输入图片 URL。若要包含有关该图片的任何其他信息(例如图片位置),请将信息输入相关列(例如 Image Position
列)中。
若要上传具有产品多属性的产品的图片,请为每个产品多属性创建一个行。在每个产品多属性行的 Handle
列中输入产品 handle,并在 Variant Image
列中输入产品多属性 URL。您只能为每个产品多属性导入一张图片。
例如:
多个元字段
若要为单个产品导入多个元字段,请为每个元字段创建一行。在每行中,在 Handle
列中为产品输入 Handle,并在相应的列中输入元字段数据。每条新行应仅包含 Handle
列和所有元字段列中的信息。
例如,下面将导入一个包含 3 个多属性的产品。该产品有 2 个元字段称为“Surf Shoe Co”和“Rubber”。每个多属性都有一个元字段。
您可以下载和查看具有多个元字段的产品的示例 CSV 文件以用作模板。