在 Transporter 中的產品 CSV 欄說明
產品 CSV 檔案的欄說明。
如要使用 Transporter App 將產品匯入 Shopify,您需要僅含有這項記錄類型的 CSV 檔案。
CSV 範例檔案
下載範例產品 CSV 檔案:products.csv
您可以使用 Transporter 命令列工具來產生上述 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 」。 |
Category | 商品類別可作為自動商品系列的條件,幫助您在 Shopify 管理介面篩選商品和計算稅金。每個商品只能屬於一種商品類別。 |
Tags | 以逗號分隔的一串標籤,供篩選和搜尋用。每個逗號分隔標籤最多可有 255 個字元。例如:Emotive, Flash Memory, MP3, Music (情緒感染力強, 快閃記憶體, MP3, 音樂)。預設值為「 」。 |
Template Suffix | 網路店面範本的尾碼將用於顯示產品及其子類。預設範本名稱為「product 」,不含任何尾碼。如要使用此預設範本,請將此欄留空。如要使用其他範本,請輸入該範本的尾碼名稱。舉例而言,如果想要使用名為「product.mysuffix 」的範本,請輸入「mysuffix 」。 |
Published Scope |
表示產品在 Shopify 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'> ) 中。如果您的產品有子類,請在標題中包含關於此子類的資訊,因為子類沒有個別的中繼標籤。此標題後不會有個別的中繼標籤子類。之後若要變更此值,可以在產品頁面中進行變更。如需更多的資訊,請參閱新增 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 Type 「中繼欄位值類型」)。您必須為中繼欄位定義自訂命名空間,才能區分應用程式和 Shopify 所個別使用命名空間的中繼欄位 (包括預設的 global 「全域」)。長度上限:20 個字元。 |
Metafield Key | 中繼欄位的名稱。如果其他中繼欄位欄已填,則此欄為必填。長度上限:30 個字元。 |
Metafield Value | 要儲存為中繼資料的資訊。如果其他中繼欄位欄已填,則此欄為必填。 |
Metafield Type | 中繼欄位的資訊類型。有效值:
值需區分大小寫。如果有其他中繼欄位欄,則此欄為必填。 |
Variant Grams | 產品子類的重量,以公克計。如果將此欄留空,則根據預設,該值會設為 0 ,請勿在此值中加入重量單位 (g)。若要使用公克以外的重量計算方式,請改為使用 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 |
產品圖片的網址 (例如 若要為單一產品上傳多張圖片,請為每張圖片建立新列。在每個列的 |
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
)。 - 輸入套用至整體產品的詳細資訊,例如
Handle
、Title
和Type
。
在產品子類列中:
- 將產品識別代碼輸入
Handle
(識別代碼) 欄。 - 請勿在產品子類列中使用重複的選項名稱 (例如
Option1 Name
、Option2 Name
)。 - 請在選項值欄中輸入選項值 (例如,如果您在
Option1 Name
輸入Color
作為名稱,則您可以在Option1 Value
輸入White
、Black
或Blue
等值)。
例如:
多張圖片
若要為不含子類的單一產品上傳多張圖片,請為每張圖片各建立一列。在每個列的 Handle
(識別代碼) 欄中輸入產品的識別代碼,並在 Image Src
欄中輸入圖片 URL。如要指定該圖片的任何其他資訊 (例如位置),請在相關的欄中 (例如 Image Position
(圖片位置) 欄) 輸入資訊。
若要為包含子類的產品上傳圖片,請為每項產品子類各建立一列。在每個產品子類列的 Handle
(識別代碼) 欄中輸入產品的識別代碼,並在 Variant Image
(子類圖片) 欄中輸入產品子類 URL。每個產品子類只能匯入一張圖片。
例如:
多個中繼欄位
若要在單一產品匯入多個中繼欄位,請為每個中繼欄位建立一個列。在每個列的 Handle
欄輸入產品識別代號,並在相應的欄輸入中繼欄位資料。每一行應僅有 Handle
欄與所有中繼欄位欄包含資訊。
例如,以下將匯入擁有 3 個子類產品的產品。該產品有 2 個中繼欄位,名稱分別為 Surf Shoe Co 和 Rubber。每個子類都有一個中繼欄位。
您可以下載並檢視擁有多個中繼欄位的產品範例 CSV 檔案做為參考範本。