메인 콘텐츠로 건너뛰기

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 가이드를 따라 상품 페이지에 프론트엔드 CTA를 설치하고 설정하세요.

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

이 섹션은 표준 API 엔드포인트를 통해 데이터를 가져올 수 없는 경우에 적용됩니다. WooCommerce 스토어가 표준 WooCommerce REST API를 통해 반품 데이터를 제공하지 않는 서드파티 반품/RMA 플러그인을 사용하는 경우, CSV 파일 교환 방식으로 진행합니다. 아래 문서를 참고하세요. 이 가이드는 누락된 데이터를 단계별로 전송하는 과정을 안내합니다. 반품 데이터 부분에 집중해 주세요.

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

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