제품 CSV 열 설명

제품 CSV 파일의 열에 대한 설명입니다.

플러스 : 트랜스포터 앱은 Shopify 플러스 판매자를 위한 Shopify 앱 스토어에서만 사용할 수 있습니다.

Transporter 앱을 사용하여 제품을 Shopify로 가져오려면 이 레코드 유형만 포함된 CSV 파일이 필요합니다.

CSV 샘플 파일

다음 products.csv에서 샘플 제품 CSV 파일을 다운로드합니다.

트랜스포터 명령 줄 도구를 사용하여 CSV 파일을 생성하거나 아래 설명된 형식에 따라 해당 파일을 직접 생성할 수 있습니다.

열 설명

다음 표는 CSV 파일에 대한 열 머리글을 설명합니다.

개별 CSV 열 머리글 설명 표
칼럼 설명
Handle
(필수)
제품의 고유 식별자입니다. 공백 없이 가독성 있는 문자열을 지정합니다. 일반적으로 핸들은 공백 및 특수 문자가 하이픈(-)으로 대체된 제품의 제목(소문자)입니다. (예: titan-t-shirt) 핸들은 온라인 스토어의 제품 페이지 URL에 표시됩니다(예: https://titan.plus/products/titan-t-shirt). 이 열은 필수 항목입니다.
Title
(필수)
제품의 이름입니다(예: Titan t-shirt). 이 열은 필수 항목입니다.
Body 제품에 대한 설명입니다. 이 설명에 HTML 서식 태그를 추가할 수 있습니다(예: "You'll be sure to turn heads in this t-shirt made of <b>100% cotton</b>").
Vendor 제품 공급업체의 이름입니다. 기본값은 스토어의 이름입니다(예: Titan Incorporated).
Type 제품 유형을 자동 컬렉션에 대한 조건으로 사용하거나 Shopify 관리자에서 제품을 필터링하는 데 사용할 수 있습니다. 제품당 제품 유형은 하나여야 합니다.
Tags 필터링 및 검색에 사용되는 쉼표로 구분된 태그의 문자열입니다. 쉼표로 구분된 각 태그는 최대 255자까지 사용할 수 있습니다(예: "Emotive, Flash Memory, MP3, Music"). 기본값은 "" 입니다.
Template Suffix 온라인 상점에서 제품 및 이형 상품을 표시하는데 사용할 리퀴드 템플릿의 접미사입니다. 기본 템플릿에는 접미사 없이 이름이 지정됩니다. product.liquid, 이 기본 템플릿을 사용하려면 열을 비워 둡니다. 다른 템플릿을 사용하려면 템플릿 접미사의 이름을 입력합니다. 예를 들어, 이름이 지정된 템플릿을 사용하려면 product.mysuffix.liquid을(를) 입력 mysuffix 합니다.
Published Scope

제품이 Shopify POS(Point of Sale) 채널에서 사용 가능한지 여부를 나타냅니다. 유효한 값:

  • 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 사용자 지정 제품 속성 이름입니다. 예) Size, Color, Material. 최대 길이: 255자.
Option1 Value 사용자 지정 제품 옵션값입니다. 예) small red wool.
Option2 Name 사용자 지정 제품 속성의 이름입니다(예: Size, Color, Material). 최대 길이는 255자입니다.
Option2 Value 사용자 지정 제품 옵션의 값입니다.
Option3 Name 사용자 지정 제품 속성의 이름입니다(예: Size, Color, Material). 최대 길이는 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 스토어에 SEO용 키워드 추가를 참조하십시오. 최대값: 70자입니다.
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 이미지를 간략하게 설명하는 대체 텍스트입니다. 이미지를 로드할 수 없는 경우 대체 텍스트가 상점에 대신 표시됩니다. 또한, 대체 텍스트는 SEO의 검색 엔진과 보조과학기술로 시각 장애가 있는 고객에게 이미지를 설명하는 데 사용됩니다. 최대값: 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 Grams 열에는 Variant Weight Unit을(를) 사용하지 마십시오.
Variant Tax Code 제품에 대한 Avalara 세금 코드입니다. 이 매개 변수는 Avalara AvaTax 앱을 설치한 스토어에만 적용됩니다. 예를 들어, 실제 세금 코드는 P000000입니다.

파일 이름

CSV 파일의 이름에는 product 단어(포함된 개체 유형 이름)가 포함되어야 합니다. 예를 들어, myproducts.csv을(를) 사용합니다. 파일은 UTF-8 형식이어야 합니다.

여러 제품 이형

제품 이형이 여러 개 있는 경우 각 이형 상품을 설명하는 행을 생성해야 합니다.

제품 행에서 다음을 수행합니다.

  • 옵션 이름 열에 옵션 이름을 입력합니다(예: Option1 NameColor 입력).
  • 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개의 이형 상품이 있는 제품을 가져옵니다. 이 제품에는 Surf Shoe Co 및 Rubber라는 2개의 메타 필드가 있습니다. 각 이형 상품에는 메타 필드가 하나 있습니다.

메타 필드 이형 상품이 있는 제품의 스크린샷

템플릿으로 사용하기 위해 여러 메타 필드가 있는 제품의 샘플 CSV 파일을 다운로드하고 확인 할 수 있습니다.

관련 링크

Shopify와 함께 사업을 시작할 준비가 되셨습니까?

무료 체험