메인 콘텐츠로 건너뛰기

​
커스텀 사이트 환경설정

메타데이터를 가져온 후 BM > Merchant Tools > Site Preferences > Custom Preferences로 이동합니다. image.png Kleep를 선택합니다: image.png
환경설정설명
kleepRetailerUUID필수. Kleep 플랫폼에서 귀하의 리테일러를 식별하는 고유 식별자로, Kleep 어카운트 매니저가 제공합니다. 반드시 수동으로 입력해야 하며, 모든 Kleep API 호출에 전송되고 추천 iframe의 domain 파라미터로 사용되어 귀하의 계정을 확인합니다. 자동 폴백은 없습니다. 비워 두면 추적, 추천 기능 및 iframe이 작동하지 않습니다(구성 오류가 발생함).
isKleepRecommendationEnabledPDP에서 Kleep 버튼을 활성화/비활성화합니다. 추적이나 작업 내보내기에는 영향을 주지 않습니다.
kleepButtonColor버튼 색상(Black 또는 White). 커스텀 스타일링은 CSS로 재정의합니다.
kleepFontFamilyKleep 버튼과 iFrame의 글꼴 패밀리.
kleepCountryCode마켓 / 국가 코드 (ISO 3166 A-2).

​
서비스

Administration > Operations > Services에서 찾을 수 있습니다: image.png kleep.sftp — SFCC WebDAV에서 Kleep SFTP로 내보내기 파일을 전송합니다. 사용자를 Kleep이 제공한 사용자로 교체하고 .p12 인증서를 함께 설정합니다. 비밀번호는 설정하지 마세요. image.png kleep — 다른 모든 기능에 사용됩니다. 사용자/비밀번호가 필요 없습니다. 모든 Kleep API 호출의 페이로드에 전송되는 kleepRetailerUUID 사이트 환경설정을 통해 요청이 인증되어 귀하의 계정을 확인합니다.

​
개인 키 및 인증서

Administration > Operations > Private Keys and Certificates로 이동합니다:
  1. Import를 클릭합니다
  2. Select를 클릭하고 Kleep이 제공한 .p12 파일을 선택합니다
  3. 별칭으로 kleep을 사용합니다
  4. Save를 클릭합니다
image.png 결과는 다음과 같아야 합니다 — 유효해야 하며 이름이 kleep이어야 합니다: image.png

​
내보내기 작업

Administration > Operations > Jobs로 이동합니다. 두 개의 작업이 미리 구성되어 있습니다:
  • KleepExportProductsCSV — 사이트의 상품을 내보냅니다
  • KleepExportOrdersCSV — 고객의 주문 이력을 내보냅니다
image.png 둘 다 기본적으로 비활성화되어 있습니다. 하루에 한 번 실행되도록 활성화합니다: image.png

​
공통 설정(두 작업 모두)

Job Steps 탭으로 이동 → RefArch를 클릭하여 Kleep을 사용하는 사이트를 선택합니다.
  • Timeout — 내보내기를 중지하기 전 대기 시간(초)
  • OrdersMaxToExport — 내보낼 최대 주문 수 (주문 작업에만 해당)
image.png

​
KleepExportProductsCSV 설정

image.png
파라미터설명기본값
SkipMaster마스터 상품 내보내기 무시비활성화
OnlineOnly온라인 상품만 내보내기비활성화
ExportTypeDelta(마지막 내보내기 이후 업데이트된 항목만) 또는 FullDelta
MainViewType상품 이미지의 이미지 뷰 타입. PDP에서 사용하는 것과 동일하게 설정하세요.large
Locale내보내기에 사용할 특정 로케일. 비어 있으면 기본값을 사용합니다.—
내보낸 상품 수가 처리된 상품 수를 초과할 수 있습니다. 이는 분류되지 않은 상품이 분류된 VariationGroup과의 연결을 통해 포함될 때 발생합니다.
MainViewType 파라미터가 매장 구성과 일치하는지 확인하세요. 뷰 타입이 일치하지 않으면 상품 이미지가 누락되며, 이는 AI 분석에 필요합니다.
image.png

​
KleepResetLastExported(유틸리티 작업)

세 번째 작업인 KleepResetLastExported는 주문 전체 재내보내기를 강제하기 위해 제공됩니다. 이 작업의 ResetKleepExportAttributes 단계는 모든 주문의 내보내기 추적 속성을 초기화하여(kleepLastExported → 비움, isKleepExported → false) 다음 KleepExportOrdersCSV 실행 시 다시 처리되도록 합니다. 이 작업은 기본적으로 비활성화되어 있으며 필요할 때 수동으로 실행하도록 만들어졌습니다(예: Kleep 측 데이터 초기화 후). 파라미터를 받지 않습니다.

​
실시간 재고 확인

Kleep은 품절 사이즈를 추천하지 않도록 재고를 실시간으로 조회합니다. 아래 두 가지 방법 중 하나를 사용하여 액세스를 구성하세요.
어느 것을 선택해야 할지 잘 모르겠나요? OCAPI는 Business Manager Data API를 사용하는 전통적인 방식입니다. **SCAPI (IAS)**는 Inventory Availability Service를 사용하는 최신 Salesforce Commerce API입니다. 확실하지 않으면 Salesforce 관리자에게 문의하세요.
인스턴스가 재고 관리에 OCAPI를 사용하는 경우 이 방법을 사용하세요.1단계 — OCAPI 설정 열기Administration > Site Development > Open Commerce API Settings로 이동한 다음 Data API 설정을 편집합니다.2단계 — 클라이언트 ID 설정테스트용:
"client_id": "aaaaaaaaaaaaaaaaaaaaaaaaaaaaaa"
프로덕션의 경우 Salesforce 문서에 따라 새 클라이언트 ID를 생성합니다. 동영상 안내.3단계 — 리소스 액세스 구성OCAPI Data API 구성에 다음을 추가합니다:
Authorizations
(GET) /inventory_lists/*
(GET) /inventory_lists/*/product_inventory_records/*
4단계 — Kleep에 자격 증명 전송
  • Client ID
  • Client Secret
  • 재고 ID(마켓당 하나 — 매핑을 제공하세요)
  • 프로덕션 SBX URL(재고 확인은 프로덕션에서만 활성화됨)