메인 콘텐츠로 건너뛰기

​
1단계: 백엔드 구성 (OAuth1 API)

이 단계를 통해 Kleep는 알고리즘 보정을 위해 귀하의 제품 카탈로그, 주문 이력 및 반품 데이터를 검색할 수 있습니다.

​
1. OAuth1 통합 생성

  1. Magento 관리자 패널에 로그인합니다.
  2. 시스템 > 통합으로 이동합니다.
  3. **“새 통합 추가”**를 클릭합니다.
  4. 이름 필드를 입력합니다 (예: “Kleep Integration”).
  5. 확인을 위해 관리자 비밀번호를 입력합니다.

​
2. API 권한 구성

경로세부 정보
/products/*모든 제품 리소스에 대한 액세스
/categories/*모든 카테고리 리소스에 대한 액세스
/orders/*모든 주문 리소스에 대한 액세스
/returns/*모든 반품 리소스에 대한 액세스
/returnsAttributeMetadata/*모든 반품 속성 리소스에 대한 액세스
/returnsItemAttributeMetadata/*모든 반품 항목 속성 리소스에 대한 액세스
/creditmemos/*모든 크레딧 메모 리소스에 대한 액세스
/creditmemo/*단일 크레딧 메모 리소스에 대한 액세스
/stockItems/*모든 재고 리소스에 대한 액세스
/store/*모든 스토어 리소스에 대한 액세스
/inventory/*모든 인벤토리 리소스에 대한 액세스
/customers/*모든 고객 리소스에 대한 액세스
Magento의 다음 ACL에 해당해야 합니다:
  • Magento_Catalog::products
  • Magento_Catalog::categories
  • Magento_Sales::sales
  • Magento_Sales::creditmemo
  • Magento_Sales::actions_view
  • Magento_Rma::rma
  • Magento_Rma::magento_rma
  • Magento_Rma::rma_attributes
  • Vendor_Module::returns
  • Magento_CatalogInventory::cataloginventory
  • Magento_Store::store
  • Magento_Config::config
  • Magento_Inventory::inventory
  • Magento_Customer::customer
⚠️ 중요:
  • Magento 인스턴스가 추가 API 레이어나 커스텀 엔드포인트(예: 사용자 정의 반품/RMA API)를 노출하는 경우, 당사와 협의하시기 바랍니다.
  • Magento API를 통한 통합 없이 외부 반품 제공업체를 사용하는 경우, 반품 데이터 문서를 참조하거나 올바른 통합 방법을 선택하기 위해 당사와 협의하시기 바랍니다.

​
3. 자격 증명 활성화 및 검색

  1. **“저장”**을 클릭하여 통합을 생성합니다.
  2. 새로 생성된 통합에서 **“활성화”**를 클릭합니다.
  3. 팝업에 귀하의 OAuth 자격 증명이 표시됩니다:
    • Consumer Key
    • Consumer Secret
    • Access Token
    • Access Token Secret
  4. 이 자격 증명을 복사하세요 – Kleep 담당자에게 전송해야 합니다.
Magento 2 API 자격 증명 생성 및 검색에 대한 안내는 다음을 참조하세요:
Subscribe Pro 튜토리얼: Magento 2 API 자격 증명 생성 및 가져오기 Adobe 공식 튜토리얼: Magento 2 OAuth 인증

​
4. Kleep에 자격 증명 전송

이메일을 통해 Kleep 담당자에게 다음 정보를 전송하세요:
  1. 스토어의 완전한 API 기본 URL을 제공해 주세요.
  2. OAuth1 자격 증명
    • Consumer Key
    • Consumer Secret
    • Access Token
    • Access Token Secret

​
2단계: 프론트엔드 통합 (위젯)

이 단계는 Kleep 스크립트를 제품 페이지(PDP)에 추가하는 것을 포함합니다. 모든 버전의 Magento와 호환됩니다. JS Library 위젯 가이드를 따라 제품 페이지에 프론트엔드 CTA를 설치하고 구성하세요.

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

이 섹션은 표준 API 엔드포인트를 통해 데이터를 검색할 수 없는 경우에 적용됩니다. Magento API가 반품 또는 특정 데이터 검색을 허용하지 않는 경우, CSV 파일 교환을 통해 진행합니다. 아래 문서를 참조하세요. 이 가이드는 누락 데이터 전송 과정을 단계별로 안내합니다:

​
4단계: 검증 및 프로덕션 배포

​
1. 테스트 환경

먼저 Preprod/Staging 환경에 배포합니다.

​
2. 시각적 검증

실서비스 전환 전에 다음을 확인하세요:
  • 버튼이 올바르게 표시되나요?
  • 클릭 시 팝업(Drawer)이 열리나요?
  • 브라우저 콘솔에 “CORS” 오류가 없나요?

​
3. 실서비스 전환

귀하와 Kleep 팀이 검증하면, 프로덕션 테마에 수정 사항을 배포하세요.---

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

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