상품 식별자 및 옵션#
스토어의 대상 요소는 판매자 카탈로그와 동일한 상품을 식별해야 합니다. 대부분의 연동 오류는 이 두 값이 일치하지 않아 발생합니다.
안정적인 식별자 선택#
준비된 상품에 표시된 productCode를 사용하세요. Shopify 튜토리얼에서는 상품 옵션의 SKU를 사용합니다. Product Import API 요청 필드는 가져오기 참조 문서에 정의되어 있습니다. 해당 필드 이름을 스토어 속성 이름으로 바꾸지 마세요.
대소문자를 포함하여 식별자를 정확히 일치시키세요. 변경될 수 있는 표시 이름으로 식별자를 생성하거나 플랫폼 내부 상품 ID가 SKU와 같다고 가정하지 마세요.
선택한 상품 옵션 매핑#
| 스토어 상태 | 대상 요소 동작 |
|---|---|
| 준비된 상품 옵션이 선택됨 | 해당 옵션의 정확한 productCode 설정 |
| 선택 항목이 변경됨 | 연동 가이드에 따라 대상 요소를 갱신하고 이전 SDK 상태 제거 |
| SKU 또는 일치하는 상품이 없음 | 직접 작성한 버튼을 숨기거나 비활성화한 상태로 유지 |
| 상품 카드가 기본 옵션을 가리킴 | 해당 옵션의 식별자를 일관되게 사용 |
Shopify에서는 튜토리얼의 동기화 헬퍼를 테마의 실제 상품 옵션 변경 콜백에 연결하세요. 다른 스토어는 동적 페이지를 따르세요.
매핑 검증#
시각적으로 다른 상품 옵션 두 개를 선택하세요. 카탈로그 코드를 기록하고 브라우저 개발자 도구에서 각각 렌더링된 data-product-code를 검사한 다음 각 상품의 Viewer를 열어 보세요. 전체 페이지를 새로고침하지 않고 이동한 후에도 반복하세요.
원본 시스템에서 식별자가 변경되면 카탈로그 가져오기와 스토어 배포 시점을 조율하세요. 성공한 HTTP 가져오기 응답은 요청이 접수되었다는 의미일 뿐입니다. 새 코드를 사용하기 전에 작업 상태와 항목별 실패 내역을 확인하세요.