설명서CommerceAdobe Commerce용 서비스

Commerce Services Connector

Last update: Fri Jul 19 2024 00:00:00 GMT+0000 (Coordinated Universal Time)
  • 주제:

작성 대상:

  • 관리자
  • 사용자

일부 Adobe Commerce 및 Magento Open Source 기능은 Commerce Services에서 제공되며 SaaS(Software as a Service)로 배포됩니다. 이러한 서비스를 사용하려면 프로덕션 및 샌드박스 API 키를 사용하여 Commerce 인스턴스를 연결하고 구성에서 데이터 공간을 지정해야 합니다. 각 Commerce 인스턴스에 대해 연결을 한 번만 구성하면 됩니다.

사용 가능한 서비스 availableservices

다음은 Commerce Services Connector을(를) 통해 액세스할 수 있는 Commerce 기능을 나열합니다.

서비스
가용성
Adobe Sensei 제공 Product Recommendations
Adobe Commerce
Adobe Sensei 제공 Live Search
Adobe Commerce
Payment Services
Adobe Commerce 및 Magento Open Source
Site-Wide Analysis Tool
Adobe Commerce
Catalog Service
Adobe Commerce
Data Connection
Adobe Commerce

아키텍처

높은 수준에서 Commerce Services Connector은(는) 다음 핵심 요소로 구성됩니다.

Commerce 서비스 커넥터 아키텍처

다음 섹션에서는 이러한 각 요소에 대해 자세히 설명합니다.

자격 증명 apikey

프로덕션 및 샌드박스 API 키는 라이선스 소유자의 Commerce 계정에서 생성됩니다. Commerce 계정은 고유한 Commerce ID(MageID)로 식별됩니다. 판매자 조직의 라이선스 소유자는 계정이 양호한 경우 제품 Recommendations 또는 라이브 검색과 같은 서비스에 대한 API 키를 생성할 수 있습니다.

라이선스 소유자를 대신하여 프로젝트 및 환경을 관리하는 시스템 통합자 또는 개발 팀과 "필요한 정보"에 따라 키를 공유할 수 있습니다. 라이선스 소유자가 Shared Access을(를) 부여한 개발자는 해당 계정의 Switch Accounts 드롭다운에 판매자의 조직이 있더라도 해당 사용자를 대신하여 키를 생성할 수 없습니다.

또한 솔루션 통합자는 Commerce Services을(를) 사용할 수 있습니다. 솔루션 통합자인 경우 Commerce 파트너 계약의 서명자가 API 키를 생성해야 합니다.

NOTE
라이선스 소유자는 일반적으로 Adobe Commerce 계정의 기본 담당자이며 항상 Adobe Commerce on cloud infrastructure 프로젝트의 프로젝트 소유자와 동일하지 않습니다.

프로덕션 및 샌드박스 API 키 생성 genapikey

  1. https://account.magento.com{:target="_blank"}에서 Commerce 계정에 로그인합니다.

  2. Magento 탭에서 사이드바의 API 포털 ​을 선택합니다.

  3. 환경 메뉴에서 프로덕션 또는 샌드박스 ​를 선택합니다.

  4. API 키 섹션에 이름을 입력하고 새로 추가 ​를 클릭하여 대화 상자를 열어 새 키를 다운로드합니다.

    개인 키 다운로드

    note warning
    WARNING
    이 대화 상자는 키를 복사하거나 다운로드할 수 있는 유일한 기회를 제공합니다.

  5. 다운로드 ​를 클릭한 다음 취소 ​를 클릭합니다.

  6. 각 환경(프로덕션 및 샌드박스)에 대해 위의 단계를 반복합니다.

    이제 API 키 섹션에 API(공개) 키가 표시됩니다. SaaS 프로젝트를 선택하거나 생성할 때 프로덕션 키와 샌드박스 키(공개+비공개)가 모두 필요합니다.

SaaS 구성 saasenv

Commerce Services에서 올바른 위치에 데이터를 보낼 수 있도록 Commerce개의 인스턴스를 SaaS 프로젝트 및 SaaS 데이터 공간으로 구성해야 합니다. SaaS 프로젝트는 모든 SaaS 데이터 공간을 그룹화합니다. SaaS Data Spaces는 Commerce Services이(가) 작동할 수 있는 데이터를 수집하고 저장하는 데 사용됩니다. 이 데이터 중 일부는 Commerce 인스턴스에서 내보낼 수 있으며 일부는 상점 앞의 쇼핑객 활동에서 수집할 수 있습니다. 그런 다음 해당 데이터는 보안 클라우드 스토리지로 유지됩니다.

Product Recommendations의 경우 SaaS 데이터 공간에 카탈로그 및 동작 데이터가 포함되어 있습니다. Commerce 구성에서 선택하여 SaaS 데이터 공간으로 Commerce 인스턴스를 지정할 수 있습니다.

WARNING
프로덕션 SaaS 데이터 공간은 프로덕션 Commerce 설치에서만 사용하여 데이터 충돌을 방지하십시오. 그렇지 않으면 테스트 데이터로 프로덕션 사이트 데이터를 오염시켜 배포가 지연될 위험이 있습니다. 예를 들어 스테이징 URL과 같은 스테이징 데이터에서 프로덕션 제품 데이터를 실수로 덮어쓸 수 있습니다.

SaaS 프로젝트 선택 또는 만들기 createsaasenv

SaaS 프로젝트를 선택하거나 만들려면 스토어의 Commerce 라이선스 소유자에게 Commerce API 키를 요청하십시오.

NOTE
Commerce 구성에 Commerce Services Connector 섹션이 표시되지 않으면 원하는 Commerce 서비스에 대한 Commerce 모듈을 설치해야 합니다.

  1. 관리자 사이드바에서 시스템 > 서비스 > Commerce 서비스 커넥터(으)로 이동합니다.

    Commerce 구성에 Commerce Services Connector 섹션이 표시되지 않으면 원하는 Commerce 서비스에 대한 Commerce 모듈을 설치하십시오. 또한 magento/module-services-id 패키지가 설치되어 있는지 확인하십시오.

  2. 샌드박스 API 키 및 프로덕션 API 키 섹션에 키 값을 붙여 넣으십시오.

    비공개 키에는 키 시작 부분의 ----BEGIN PRIVATE KEY--- 및 비공개 키 끝 부분의 ----END PRIVATE KEY----이(가) 포함되어야 합니다.

  3. 저장 ​을 클릭합니다.

키와 연결된 모든 SaaS 프로젝트가 SaaS 식별자 섹션의 프로젝트 필드에 나타납니다.

  1. SaaS 프로젝트가 없는 경우 프로젝트 만들기 ​를 클릭하십시오. 그런 다음 프로젝트 필드에 SaaS 프로젝트의 이름을 입력합니다.

    SaaS 프로젝트를 만들 때 Commerce은(는) Commerce 라이선스에 따라 하나 이상의 SaaS 데이터 공간을 생성합니다.

    • Adobe Commerce - 프로덕션 데이터 공간 1개, 테스트 데이터 공간 2개만 여러 스테이징 환경이 있는 Cloud Pro 프로젝트에서 지원 요청을 제출하여 각 스테이징 환경에 대한 추가 테스트 데이터 공간을 요청할 수 있습니다.
    • Magento Open Source - 프로덕션 데이터 공간 1개, 테스트 데이터 공간 없음

  2. Commerce 저장소의 현재 구성에 사용할 데이터 공간 ​을(를) 선택하십시오.

NOTE
Commerce 서비스와 통합할 인스턴스가 따로 있는 경우 지원 티켓을 제출하여 각 추가 인스턴스에 대해 새 SaaS 프로젝트를 요청하세요. 지원이 SaaS 프로젝트를 만든 후 동일한 API 키를 사용하여 인스턴스에 대한 Commerce Services 통합을 구성하고 데이터 공간에 대한 새 SaaS 프로젝트를 선택합니다.
WARNING
내 계정의 API 포털 섹션에서 새 키를 생성하는 경우 관리 구성에서 API 키를 즉시 업데이트합니다. 새 키를 생성하고 관리에서 업데이트하지 않으면 SaaS 확장이 더 이상 작동하지 않고 중요한 데이터를 잃게 됩니다.

SaaS 프로젝트 또는 데이터 공간의 이름을 변경하려면 둘 중 하나 옆에 있는 이름 바꾸기 ​를 클릭합니다. 이름은 프로젝트와 데이터 공간을 식별하고 구분하는 데 도움이 되는 레이블일 뿐이므로 이름을 변경해도 서비스에 영향을 주지 않습니다.

IMS 조직(선택 사항) organizationid

Adobe Commerce 인스턴스를 Adobe Experience Platform에 연결하려면 Adobe ID을 사용하여 Adobe 계정에 로그인합니다. 로그인하면 Adobe 계정과 연결된 IMS 조직이 이 섹션에 표시됩니다.

SaaS 데이터 내보내기

Commerce 인스턴스가 Commerce Services에 연결되면 SaaS 데이터 내보내기 프로세스는 연결된 Commerce 서비스와 동기화할 수 있도록 Commerce 서버의 Commerce 데이터를 Commerce SaaS Services (으)로 내보냅니다. 관리에서 데이터 관리 대시보드를 사용하여 동기화 상태를 확인할 수 있습니다. 자세한 내용은 SaaS 데이터 내보내기 안내서를 참조하십시오.

recommendation-more-help
3d5a1200-3287-4b90-a075-6c594f65d80e