在 Transporter 中的產品 CSV 欄說明

產品 CSV 檔案的欄說明。

如要使用 Transporter App 將產品匯入 Shopify,您需要僅含有這項記錄類型的 CSV 檔案。

CSV 範例檔案

下載範例產品 CSV 檔案:products.csv

您可以使用 Transporter 命令列工具來產生上述 CSV 檔案,或按照下方說明的格式自行建立。

欄說明

下表說明 CSV 檔案的欄標頭。

個別 CSV 欄標頭說明表格
說明
Handle
(必填)
產品的唯一識別碼。請指定可閱讀的字串,不含空格。通常識別代碼為產品名稱的小寫,當中的空格和特殊字元由連字號 (-) 取代,例如 titan-t-shirt。識別代碼會顯示在線上商店的產品頁面 URL 中 (例如 https://titan.plus/products/titan-t-shirt)。此欄為必填。
Title
(必填)
產品名稱,例如「titan-t-shirt」(Titan T 恤)。此欄為必填。
Body 產品說明。您可以在說明中加入 HTML 格式的標籤,例如「這件 <b>100% 純棉</b> T 恤會讓您愛不釋手」。
Vendor 產品的廠商名稱。預設值為您商店的名稱,例如「Titan Incorporated」。
Type 產品類型可作為自動商品系列的條件,或幫助您在 Shopify 管理員介面篩選產品。一項產品只能屬於一種產品類型。
Tags 以逗號分隔的一串標籤,供篩選和搜尋用。每個逗號分隔標籤最多可有 255 個字元。例如:Emotive, Flash Memory, MP3, Music (情緒感染力強, 快閃記憶體, MP3, 音樂)。預設值為「」。
Template Suffix 線上商店店面 Liquid 範本的尾碼,用於顯示產品及其子類選項。預設範本名稱為「product.liquid」,不含任何尾碼。如要使用此預設範本,請將欄留空。如要使用其他範本,請輸入範本尾碼的名稱。舉例來說,如果想要使用名稱為「product.mysuffix.liquid」的範本,請輸入「mysuffix」。
Published Scope

表示產品在 Shopify POS (銷售點) 管道是否可供貨。有效值:

  • web (網頁) - 產品不會在 Shopify POS 管道上顯示。
  • global (全域) - 產品會在 Shopify POS 管道上顯示。此為預設值。

值需區分大小寫。

Published 產品在線上商店是否可供貨。有效值:
  • true (是) - 產品已在線上商店上架。
  • false (否) - 產品未在線上商店上架 (此欄設為「false」時,請勿指定 Published At (發佈時間)。

值需區分大小寫。

Published At 產品在線上商店上架的日期和時間 (ISO 8601 格式),例如,2007-12-31T19:00:00-05:00Published (發佈時間) 設為 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'>) 中。如果您的產品有子類選項,請在標題中包含關於此子類選項的資訊,因為子類選項沒有個別的中繼標籤。此標題後不會有個別的中繼標籤子類選項。之後若要變更此值,可以在產品頁面中進行變更。如需更多的資訊,請參閱新增 SEO 關鍵字至您的 Shopify 商店。長度上限:70 個字元。
Metafields Global Description Tag 作為 SEO 用途的產品子類選項名稱會顯示在搜尋引擎中。如果您不提供其值,則會依預設使用 Body 欄位中的值。

中繼欄位全域說明標籤值會用在您商店產品頁面代碼的中繼說明標籤 (<meta name='description-of-product'>) 中。如果您的產品有子類選項,請在說明中包含關於此子類選項的資訊,因為子類選項沒有個別的中繼標籤。此標題後不會有個別的中繼標籤子類選項。之後若要變更此值,可以在 Shopify 管理員介面產品頁面中進行變更。如需更多的資訊,請參閱新增 SEO 關鍵字至您的 Shopify 商店。長度上限: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 (手動) - 手動出貨產品子類選項的訂單。此為預設值。如果將此欄留空,則系統會根據預設指定此值。
  • handle of the fulfillment service - 有一個出貨服務負責出貨此產品子類選項的訂單。如果您使用出貨服務,請同時包含 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 (識別代碼) 欄中輸入產品的識別代碼,並在此欄中輸入圖片 URL。如要指定圖片的任何其他資訊 (例如位置),請在相關的圖片欄輸入該資訊。

Image Position 您想要在店面的產品頁面中顯示的圖片順序 (以編號來表示)。例如,若您希望某幅產品圖片最先出現,請為其輸入「1」。
Image Alt Text 描述圖片的簡要替代文字。若圖片基於任何原因而無法載入,系統就會在店面中改為顯示替代文字。此外,搜尋引擎及輔助技術也會使用替代文字來進行搜尋引擎最佳化以及向視障客戶描述圖片。長度上限:512 個字元。
Variant Image 產品子類選項的 URL。在其中一項產品子類選項資料列中,將產品子類選項圖片的 URL 輸入此欄。產品子類選項只能包含一張圖片。
Variant Weight 產品子類選項的重量。如已使用 Variant Grams (子類選項公克) 欄,請勿再使用此欄。預設值為 0,請勿在值中加上重量單位。請使用 Variant Weight Unit (子類選項重量單位) 來指定重量單位。舉例來說,如果產品重約 45 公斤 (100 磅),且 Variant Weight Unit (子類選項重量單位) 已設為 lb,則請在此欄輸入 100
Variant Weight Unit 適用於 Variant Weight (子類選項重量) 欄中產品子類選項重量的測量單位。有效值有 g、kg、oz 和 lb。預設值為商店的預設測量單位。如已使用 Variant Grams (子類選項公克) 欄,請勿再使用 Variant Weight Unit (子類選項重量單位)。
Variant Tax Code 產品的 Avalara 稅務代碼。此參數僅適用於已安裝 Avalara AvaTax App 的商店。例如,實體商品稅務代碼為 P000000

檔案名稱

您的 CSV 檔案名稱必須包括 product (檔案中包含的物件類型名稱),例如 myproducts.csv。檔案必須為 UTF-8 格式。

多個產品子類選項

若您有多個產品子類選項,您必須建立資料列來描述各個子類選項。

在產品資料列中:

  • 請在選項名稱欄中輸入選項名稱 (例如輸入在 Option1 Name 輸入Color)。
  • 輸入套用至整體產品的詳細資訊,例如 HandleTitleType

在產品子類選項列中:

  • 將產品識別代碼輸入 Handle (識別代碼) 欄。
  • 請勿在產品子類選項列中使用重複的選項名稱 (例如 Option1 NameOption2 Name)。
  • 請在選項值欄中輸入選項值 (例如,如果您在 Option1 Name 輸入 Color 作為名稱,則您可以在 Option1 Value 輸入 WhiteBlackBlue 等值)。

例如:

含多個子類選項的產品螢幕擷取圖片

多張圖片

若要為不含子類選項的單一產品上傳多張圖片,請為每張圖片各建立一列。在每個列的 Handle (識別代碼) 欄中輸入產品的識別代碼,並在 Image Src 欄中輸入圖片 URL。如要指定該圖片的任何其他資訊 (例如位置),請在相關的欄中 (例如 Image Position (圖片位置) 欄) 輸入資訊。

若要為包含子類選項的產品上傳圖片,請為每項產品子類選項各建立一列。在每個產品子類選項列的 Handle (識別代碼) 欄中輸入產品的識別代碼,並在 Variant Image (子類選項圖片) 欄中輸入產品子類選項 URL。每個產品子類選項只能匯入一張圖片。

例如:

含多張圖片及多個子類選項的產品螢幕擷取圖片

多個中繼欄位

若要在單一產品匯入多個中繼欄位,請為每個中繼欄位建立一個列。在每個列的 Handle 欄輸入產品識別代號,並在相應的欄輸入中繼欄位資料。每一行應僅有 Handle 欄與所有中繼欄位欄包含資訊。

例如,以下將匯入擁有 3 個子類產品的產品。該產品有 2 個中繼欄位,名稱分別為 Surf Shoe Co 和 Rubber。每個子類選項都有一個中繼欄位。

含有中繼欄位子類選項的產品螢幕截圖

您可以下載並檢視擁有多個中繼欄位的產品範例 CSV 檔案做為參考範本。

相關連結

準備好開始透過 Shopify 銷售商品了嗎?

免費試用