> ## Documentation Index
> Fetch the complete documentation index at: https://docs.kleep.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# WooCommerce

## 1단계: 백엔드 설정 (REST API)

*이 단계를 통해 Kleep이 알고리즘 보정을 위해 상품 카탈로그, 주문 내역, 반품/환불 데이터를 가져올 수 있습니다.*

### 1. REST API 키 생성

1. **WordPress 관리자 패널**에 로그인합니다.
2. **WooCommerce > 설정 > 고급 > REST API**로 이동합니다.
3. \*\*"키 추가"\*\*를 클릭합니다.
4. 다음 필드를 입력합니다:
   * **설명:** 이름 입력 (예: "Kleep Integration")
   * **사용자:** 관리자 계정 선택
   * **권한:** **읽기** 선택
5. \*\*"API 키 생성"\*\*을 클릭합니다.

### 2. 자격 증명 확인 및 저장

생성 후 WooCommerce에 두 가지 자격 증명이 표시됩니다:

* **Consumer Key** (`ck_`로 시작)
* **Consumer Secret** (`cs_`로 시작)

**⚠️ 중요:** Consumer Secret은 한 번만 표시됩니다. 두 값을 즉시 복사하여 안전한 곳에 보관하세요.

### 3. 요구 사항

* API 키가 안전하게 작동하려면 WooCommerce 스토어가 **HTTPS를 사용해야 합니다**.
* WooCommerce REST API 버전 **v3**이 필요합니다 (WooCommerce 3.5 이상).
* **커스텀 반품/RMA 플러그인** (예: YITH WooCommerce RMA, ReturnGO)을 사용하는 경우, 올바른 연동 방식을 조율할 수 있도록 미리 알려주세요.

### 4. 방화벽 설정

If your store is behind a firewall or uses IP-based access restrictions, please whitelist the following Kleep IP addresses to ensure uninterrupted API access:

* `34.1.4.3`
* `82.66.252.201`
* `176.148.67.162`

### 5. Kleep에 자격 증명 전송

다음 정보를 이메일로 Kleep 담당자에게 보내주세요:

1. **스토어 URL** (예: `https://yourstore.com`)
2. **Consumer Key** (`ck_...`)
3. **Consumer Secret** (`cs_...`)

***

## 2단계: 프론트엔드 연동 (위젯)

*이 단계는 상품 상세 페이지(PDP)에 Kleep 스크립트를 추가하는 과정입니다. WooCommerce의 모든 버전과 호환됩니다.*

[**JS Library Widget 가이드**](/ko/cms/js-library)를 따라 상품 페이지에 프론트엔드 CTA를 설치하고 설정하세요.

***

## 3단계: 누락 데이터 관리 (SFTP)

*이 섹션은 표준 API 엔드포인트를 통해 데이터를 가져올 수 없는 경우에 적용됩니다.*

WooCommerce 스토어가 표준 WooCommerce REST API를 통해 반품 데이터를 제공하지 않는 서드파티 반품/RMA 플러그인을 사용하는 경우, CSV 파일 교환 방식으로 진행합니다.

아래 문서를 참고하세요. 이 가이드는 누락된 데이터를 단계별로 전송하는 과정을 안내합니다. 반품 데이터 부분에 집중해 주세요.

***

## 쿠키 및 데이터 개인정보 보호

Kleep은 방문자 동의에 의해 완전히 제어됩니다. 스크립트는 CMP를 통해 동의가 수집된 **이후에만** 로드되며, 이에 맞게 로딩 조건을 설정해야 합니다. 트래커 전체 목록, 처리되는 데이터, 목적 및 법적 근거, 호스팅, 하위 처리자, 보안에 관한 내용은 [쿠키, CMP 및 데이터 개인정보 보호](/ko/cookie-consent)를 참고하세요.