스프레드시트로 상품 가져오기 및 업데이트#

카테고리별 템플릿을 다운로드하고 상품 정보를 입력한 뒤 카탈로그에 업로드하세요. 코드를 작성하거나 API 인증 정보를 사용할 필요가 없습니다.

시작하기 전에#

대시보드에서 올바른 스토어를 선택하세요. 해당 카탈로그를 편집할 권한이 필요합니다. 상품 스프레드시트 업로드 버튼이 보이지 않으면 선택한 스토어, 카탈로그 쓰기 권한, 계정의 읽기 전용 여부를 확인하세요.

카테고리 템플릿 다운로드#

1. 대시보드 → 카탈로그를 여세요.
2. 상품 스프레드시트 업로드를 클릭하여 상품 가져오기 대화상자를 여세요.
3. 상품 카테고리 선택에서 가져올 카테고리를 선택하세요. 선택 가능한 항목은 스토어 설정에 따라 달라집니다.
4. Excel 템플릿 다운로드를 클릭하세요. 카테고리마다 별도의 템플릿을 사용하고 따로 업로드하세요.

새 가져오기를 준비할 때는 최신 템플릿을 다운로드하여 열이 현재 카테고리 요구 사항과 일치하도록 하세요. 다운로드한 통합 문서는 템플릿이며, 기존 카탈로그를 내보낸 파일이 아닙니다.

통합 문서 작성#

통합 문서의 워크시트를 다음과 같이 사용하세요.

각 상품 행에는 sku, name, image_url, product_url과 해당 카테고리의 필수 치수가 필요합니다. 다운로드한 템플릿의 필수 필드 표시와 안내를 따르세요. 필드 이름을 번역하거나 알 수 없는 열 또는 중복된 열을 추가하지 마세요.

• 스프레드시트 프로그램이 앞자리 영을 삭제하거나 긴 식별자를 바꾸지 않도록 SKU 셀을 텍스트 형식으로 유지하세요. SKU당 한 행을 사용하세요. 대소문자만 다른 경우를 포함하여 같은 파일 안의 중복 값은 거부됩니다.
• image_url에는 공개적으로 접근 가능한 HTTP 또는 HTTPS 이미지 직접 주소를 사용하세요. 로그인, 쿠키 또는 사용자 지정 요청 헤더 없이 접근할 수 있어야 합니다. product_url에는 상품 상세 페이지 주소를 입력하세요.
• 템플릿 안내에 따라 치수와 단위를 지정하세요. 치수나 dimension_unit에 단위가 지정되어 있지 않으면 기본값은 in입니다.
• status는 Enums에 허용된 값 중에서 선택하세요. 비워 두면 기본값인 active가 적용됩니다. 상품을 업데이트할 때는 명시적으로 설정하세요.

.xlsx로 저장하는 것을 권장합니다. 상품 헤더 행과 데이터만 포함된 .csv도 사용할 수 있습니다. 이전 형식인 .xls 파일은 지원되지 않습니다. 파일마다 비어 있지 않은 상품 행을 최대 50,000개까지 포함할 수 있으며, 파일 크기는 50 MB 이하여야 합니다.

업로드 및 결과 확인#

1. 가져오기 대화상자로 돌아가 템플릿과 같은 카테고리를 선택하세요.
2. 작성 후 업로드에서 저장한 파일을 선택한 다음 가져오기 시작을 클릭하세요.
3. 최근 가져오기에서 파일 이름, 처리 상태, 성공 및 실패 행 수를 확인하세요. 제출 완료는 접수되었다는 의미이며, 처리는 백그라운드에서 계속됩니다.
4. 처리가 끝날 때까지 기다린 뒤 작업이 완료로 표시되더라도 실패한 행이 있는지 확인하세요. 카탈로그로 돌아가 가져온 상품 데이터와 준비 상태를 확인하세요.

실패한 행이 있으면 실패 파일을 클릭하여 오류 메시지를 확인하고 상품 데이터를 수정한 뒤 같은 카테고리로 수정된 파일을 업로드하세요. 다운로드한 실패 통합 문서에는 실패한 행과 진단용 열이 포함되며, 진단용 열은 다시 업로드할 때 무시됩니다.

일시적인 처리 오류가 발생하면 다시 시도가 표시될 때 사용하세요. 같은 작업을 다시 시도해도 잘못된 상품 데이터는 수정되지 않습니다. 화면에 지원팀의 행 검토가 필요하다고 표시되면 Contact support를 사용하세요. 해당 행은 자동으로 다시 시도되지 않습니다.

기존 상품 업데이트#

상품을 업데이트하려면 같은 카테고리 템플릿을 사용하고 각 상품의 기존 SKU를 유지하세요. 포함하는 각 행의 모든 필수 필드를 채우고 업데이트할 값을 변경한 다음 파일을 다시 업로드하세요.

• 같은 스토어의 같은 SKU는 기존 상품을 업데이트합니다. 아직 존재하지 않는 SKU는 새 상품을 만듭니다. 스프레드시트에서 SKU를 변경해도 원래 상품의 식별자가 바뀌지는 않습니다.
• 업데이트할 상품 행만 업로드할 수 있습니다. 파일에 없는 상품은 삭제되거나 비활성화되거나 게시가 중단되지 않습니다.
• 일부 필드만 업데이트하는 방식이 아니므로 필수 필드에는 여전히 값이 필요합니다. 선택 사항인 셀을 비워 두면 이전 값이 유지된다고 가정하지 마세요. 특히 status가 비어 있으면 기본값은 active이고, 치수 단위가 없으면 기본값은 in입니다.
• 나중에 업데이트할 수 있도록 작성한 통합 문서를 보관하세요. 다운로드한 템플릿에는 현재 상품 데이터가 포함되어 있지 않습니다.

작업이 끝나면 카탈로그에서 해당 상품을 확인하세요. 가져오기에 성공한 것만으로 스토어에 표시되는 것은 보장되지 않습니다. 상품 준비 상태와 SDK 출시 체크리스트를 확인하세요.

가져오기 자동화#

서버에서 주기적으로 동기화하려면 Product Import API를 사용하세요. 요청 필드, 제한 사항 및 일부 필드 업데이트 동작은 이 스프레드시트 방식과 별도로 문서화되어 있습니다.