Configuration

커스텀 사이트 환경설정

메타데이터를 가져온 후 BM > Merchant Tools > Site Preferences > Custom Preferences로 이동합니다.

Kleep를 선택합니다:

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

서비스

Administration > Operations > Services에서 찾을 수 있습니다:

kleep.sftp — SFCC WebDAV에서 Kleep SFTP로 내보내기 파일을 전송합니다. 사용자를 Kleep이 제공한 사용자로 교체하고 .p12 인증서를 함께 설정합니다. 비밀번호는 설정하지 마세요.

kleep — 다른 모든 기능에 사용됩니다. 사용자/비밀번호가 필요 없습니다. 모든 Kleep API 호출의 페이로드에 전송되는 kleepRetailerUUID 사이트 환경설정을 통해 요청이 인증되어 귀하의 계정을 확인합니다.

개인 키 및 인증서

Administration > Operations > Private Keys and Certificates로 이동합니다:

Import를 클릭합니다
Select를 클릭하고 Kleep이 제공한 .p12 파일을 선택합니다
별칭으로 kleep을 사용합니다
Save를 클릭합니다

결과는 다음과 같아야 합니다 — 유효해야 하며 이름이 kleep이어야 합니다:

내보내기 작업

Administration > Operations > Jobs로 이동합니다. 두 개의 작업이 미리 구성되어 있습니다:

KleepExportProductsCSV — 사이트의 상품을 내보냅니다
KleepExportOrdersCSV — 고객의 주문 이력을 내보냅니다

둘 다 기본적으로 비활성화되어 있습니다. 하루에 한 번 실행되도록 활성화합니다:

공통 설정(두 작업 모두)

Job Steps 탭으로 이동 → RefArch를 클릭하여 Kleep을 사용하는 사이트를 선택합니다.

Timeout — 내보내기를 중지하기 전 대기 시간(초)
OrdersMaxToExport — 내보낼 최대 주문 수 (주문 작업에만 해당)

KleepExportProductsCSV 설정

파라미터	설명	기본값
`SkipMaster`	마스터 상품 내보내기 무시	비활성화
`OnlineOnly`	온라인 상품만 내보내기	비활성화
`ExportType`	Delta(마지막 내보내기 이후 업데이트된 항목만) 또는 Full	Delta
`MainViewType`	상품 이미지의 이미지 뷰 타입. PDP에서 사용하는 것과 동일하게 설정하세요.	`large`
`Locale`	내보내기에 사용할 특정 로케일. 비어 있으면 기본값을 사용합니다.	—

내보낸 상품 수가 처리된 상품 수를 초과할 수 있습니다. 이는 분류되지 않은 상품이 분류된 VariationGroup과의 연결을 통해 포함될 때 발생합니다.

MainViewType 파라미터가 매장 구성과 일치하는지 확인하세요. 뷰 타입이 일치하지 않으면 상품 이미지가 누락되며, 이는 AI 분석에 필요합니다.

KleepResetLastExported(유틸리티 작업)

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

실시간 재고 확인

Kleep은 품절 사이즈를 추천하지 않도록 재고를 실시간으로 조회합니다. 아래 두 가지 방법 중 하나를 사용하여 액세스를 구성하세요.

어느 것을 선택해야 할지 잘 모르겠나요? OCAPI는 Business Manager Data API를 사용하는 전통적인 방식입니다. **SCAPI (IAS)**는 Inventory Availability Service를 사용하는 최신 Salesforce Commerce API입니다. 확실하지 않으면 Salesforce 관리자에게 문의하세요.

OCAPI (Open Commerce API)
SCAPI — Inventory Availability Service (IAS)

인스턴스가 재고 관리에 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(재고 확인은 프로덕션에서만 활성화됨)

인스턴스가 Inventory Availability Service (IAS) / Omnichannel Inventory (OCI)와 함께 SCAPI를 사용하는 경우 이 방법을 사용하세요.1단계 — API 클라이언트 생성

Salesforce Account Manager에 로그인합니다.
API Client → Add API Client를 클릭합니다.
표시 이름: 예) Kleep Inventory.
Token Endpoint Auth Method: client_secret_post.
Access Token Format: JWT.
Allowed Scopes: sfcc.inventory.availability
귀하의 Organization에 할당합니다.
저장합니다. Client ID와 Client Secret를 복사하세요 — 시크릿은 한 번만 표시됩니다.

SCAPI와 OCAPI 클라이언트는 공유할 수 없습니다. 각 API 프레임워크에는 자체 클라이언트가 필요합니다.

2단계 — 인스턴스 식별자 수집

식별자	찾는 위치	예시
Short Code	BM > Administration > Site Development > Salesforce Commerce API Settings	`kv7kzm78`
Organization ID	같은 페이지 또는 Account Manager	`f_ecom_zzzz_prd`
Tenant ID	Account Manager > Organizations	`zzzz_prd`
Location Group(s)	BM > Merchant Tools > Inventory > Inventory Availability	`WAREHOUSE_FR`, `WAREHOUSE_US`

3단계 — Kleep에 자격 증명 전송

Client ID 및 Client Secret
Short Code
Organization ID
Tenant ID
Location Group(s)(마켓당 하나 — 매핑을 제공하세요)

시작하기

CMS

모바일

대시보드

데이터

개인정보

커스텀 사이트 환경설정

서비스

개인 키 및 인증서