설명서CommerceAEM Assets 통합 안내서

Adobe Commerce Optimizer에 대한 AEM Assets 구성

Last update: Mon Mar 02 2026 00:00:00 GMT+0000 (Coordinated Universal Time)

작성 대상:

  • 사용자

[SaaS만]{class="badge positive" title="Adobe Commerce Optimizer 프로젝트에만 적용됩니다."}

Adobe Commerce Optimizer용 AEM Assets 통합을 통해 판매자는 제품 이미지에 대한 중앙 집중식 디지털 에셋 관리 솔루션으로 AEM Assets을 사용할 수 있습니다. 이 안내서에서는 Commerce Optimizer과(와) 관련된 구성을 다룹니다.

Adobe Commerce(PaaS) 또는 Adobe Commerce as a Cloud Service(ACCS)와 달리 Commerce Optimizer에는 관리자 구성 UI가 없습니다. 통합을 사용하려면 Adobe Commerce Optimizer 및 AEM Assets 세부 정보로 지원 티켓을 만드십시오. Adobe 지원은 통합을 구성하고 테넌트를 Assets 통합 서비스에 등록합니다.

다음 다이어그램은 Adobe Commerce Optimizer과(와) AEM Assets 통합 간의 제품 동기화에 대한 개요입니다.

AEM Assets에서 Commerce Optimizer 흐름으로 {width="700"}

이 통합에는 다음과 같은 두 가지 기본 흐름이 있습니다.

  • AEM Assets에서: 에셋이 승인, 거부 또는 제거되면 이벤트가 Adobe 파이프라인을 통해 Assets 통합 서비스로 흐릅니다. 이 서비스는 match-by-SKU(메타데이터 기반) 또는 사용자 지정 선택기(App Builder)를 사용하여 제품에 자산을 일치시킨 다음 product-asset 매핑을 Commerce Optimizer에 보내 제품 계층으로 저장합니다.

  • 시작Adobe Commerce Optimizer: Commerce Optimizer에서 제품을 업데이트하면 이벤트가 Adobe 파이프라인을 통해 Assets 통합 서비스로 이동합니다. 서비스가 일치하는 모든 자산 매핑을 다시 Adobe Commerce Optimizer​(으)로 동기화합니다.

사전 요구 사항

통합을 구성하기 전에 다음을 확인합니다.

  • 제품 시각화 권한이 있는 활성 Adobe Commerce Optimizer 인스턴스 또는 Dynamic Media가 있는 모든 AEM Assets 라이선스.
  • AEM Assets as a Cloud Service 환경에 액세스합니다.
  • Commerce Optimizer과(와) AEM Assets이 모두 동일한 Adobe IMS 조직에 있습니다.
  • AEM Assets 환경에서 OpenAPI가 활성화된 Dynamic Media.

온보딩

Commerce Optimizer과(와) AEM Assets 통합을 온보딩하려면 지원 티켓을 만들기해야 합니다.

Adobe 지원에서는 티켓의 정보를 사용하여 테넌트를 Assets 통합 서비스에 등록하고 통합을 구성합니다.

지원 티켓에 다음 정보를 포함하십시오.

  • Adobe Commerce Optimizer테넌트 ID(인스턴스 ID)이(가) Commerce Optimizer URL 또는 Commerce Cloud Manager UI에 있습니다.
  • AEM 프로그램 ID.
  • AEM 환경 ID.
  • 일치 규칙: SKU 또는 외부 일치 항목(App Builder)별로 일치합니다.
  • 계층: 테넌트를 등록할 카탈로그 계층 이름입니다. 필요한 경우 사용자 지정 이름을 지정합니다. 그렇지 않으면 기본값 AEM-Assets이(가) 사용됩니다.
  • 로케일: 테넌트를 등록할 카탈로그 원본 로케일(예: en-US)입니다.
IMPORTANT
통합은 하나의 로케일과 하나의 레이어의 조합인 테넌트당 하나의 소스를 지원합니다.

Adobe 지원에서 티켓을 처리하면 통합이 구성되고 테넌트가 Assets 통합 서비스에 등록됩니다.

온보딩이 완료되면:

  1. Assets Integration Service에 등록: Commerce Optimizer 테넌트가 Adobe Commerce Optimizer 테넌트 ID, AEM 프로그램 ID, AEM 환경 ID 및 테넌트를 사용하여 Assets Integration Service에 등록되었습니다.

  2. 인증 설정: 보안 통신을 위해 Commerce Optimizer과(와) Assets 통합 서비스 간에 IMS 서비스 토큰 인증이 구성되었습니다.

  3. 이벤트 구독: Assets Integration Service는 다음을 구독합니다.

    • AEM Assets 이벤트(자산 승인, 업데이트, 제거됨)
    • Commerce Optimizer개의 카탈로그 이벤트(제품 생성, 업데이트)

제한 사항

Commerce Optimizer 통합에는 다음과 같은 제한 사항이 있습니다.

  • 판매자당 단일 레이어 - AEM Assets 통합은 판매자당 하나의 AEM-Assets 레이어(테넌트당 하나의 소스)를 지원합니다. 지금은 판매자당 여러 계층을 구성할 수 없습니다.
  • 이미지만—통합에서 비디오 또는 다른 미디어 형식을 지원하지 않습니다.
  • 범주 이미지 없음—범주 이미지 동기화를 사용할 수 없습니다. Assets 선택기(UI 삽입)에 대한 AEM Assets의 카테고리 이미지가 지원되지 않습니다.
  • 다중 사이트 구분 안 함 - 통합에서 다중 사이트를 처리하지 않습니다. 제품과 연결된 이미지가 모든 채널 및 정책에 동일하게 표시됩니다.
  • 이미지 위치/순서 지정—이미지 위치와 순서 지정은 지원되지 않습니다.
  • 제품이 있어야 함 - 제품이 Commerce Optimizer에 없는 경우 해당 제품-자산 매핑에 대한 레이어가 만들어지지 않습니다.
  • 레이어 필드 덮어쓰기 - 레이어의 값이 기본 카탈로그를 덮어씁니다. 필드가 레이어 페이로드에서 전송되지 않으면 빈 값으로 덮어쓸 수 있습니다. AEM Assets 컨텐츠에 전용 레이어를 사용하십시오. 기존 레이어를 다른 용도로 다시 사용하면 의도하지 않은 데이터 손실이 발생할 수 있습니다.

AEM Assets 구성

Commerce Optimizer에 대한 AEM Assets 설치 및 구성 프로세스는 Adobe Commerce as a Cloud Service과 동일합니다. 전체 단계는 Commerce 메타데이터를 지원하도록 AEM Assets 프로젝트 구성을 참조하십시오.

AEM Assets 환경이 준비되었는지 확인합니다.

  1. AEM Assets 구성: Commerce 메타데이터 프로필을 구성합니다. 메타데이터 프로필 구성을 참조하십시오.

  2. Dynamic Media 지원: AEM Assets 환경에서 OpenAPI 기능을 사용하는 Dynamic Media가 활성화되어 있는지 확인하십시오.

AEM Assets 구성

제품-에셋 동기화를 활성화하려면 AEM Assets 환경을 구성합니다.

1단계: OpenAPI를 사용하여 Dynamic Media 활성화

AEM Assets 환경에서 OpenAPI를 사용하는 Dynamic Media를 활성화해야 합니다. 제품 비주얼과 새로운 AEM Assets 라이선스를 사용하면 Cloud Manager을 통해 셀프서비스 방식으로 활성화할 수 있습니다. 이전 AEM Assets 라이선스를 사용하려면 Adobe 지원이 필요합니다. 활성화 단계는 AEM Assets 프로젝트 구성을 참조하십시오.

2단계: 선택 사항입니다. Commerce 메타데이터 프로필 구성

AEM Assets에서 메타데이터 프로필을 설정하여 Commerce 관련 메타데이터를 저장합니다.

자세한 지침은 메타데이터 프로필 구성을 참조하십시오.

3단계: 에셋에 메타데이터 적용

AEM Assets의 제품 이미지에 Commerce 메타데이터를 추가합니다.

필드 정의는 AEM Commerce 패키지 콘텐츠를 참조하고 설정 단계는 메타데이터 프로필 구성을 참조하십시오.

데이터 동기화를 트리거하려면 자산이 승인됨 상태여야 합니다. 메타데이터만 저장해도 이벤트가 트리거되지 않습니다.

CAUTION
AEM-Assets카탈로그 보기에 ​ 레이어를 할당하세요. 레이어를 할당하지 않으면 예기치 않게 제품 이미지 데이터를 덮어쓸 수 있습니다.

동기화

구성이 완료되면 통합은 product-asset 매핑을 자동으로 동기화합니다.

자세한 내용은 사용자 지정 자동 일치를 참조하십시오.

SKU별 일치 워크플로우 예

새 제품에 기존 에셋을 추가할 때의 일반적인 흐름:

  1. API 또는 데이터 수집을 통해 Commerce Optimizer에서 제품을 만듭니다. 처음에 이 제품은 이미지 없이 존재할 수 있습니다.

  2. AEM Assets에서 제품에 매핑할 자산을 엽니다.

  3. 제품 SKU를 commerce:skus 메타데이터에 추가하고 이미지 역할(예: thumbnail, image)을 할당합니다.

  4. 게재할 자산을 승인합니다. 이렇게 하면 Assets 통합 서비스가 처리하는 이벤트가 트리거됩니다.

  5. Assets Integration Service가 제품-이미지 매핑을 Commerce Optimizer에 보냅니다. Commerce Optimizer의 제품이 자산의 이미지로 업데이트되었습니다.

  6. 이미지가 표시되는지 확인합니다. 동기화가 완료될 때까지(일반적으로 몇 분 이내) 기다린 다음 Commerce Optimizer UI에서 제품(예: 데이터 동기화 또는 카탈로그 보기)을 확인하거나 상점 API(카탈로그 서비스, 라이브 검색, 상점 GraphQL API)를 쿼리하여 이미지가 반환되는지 확인하십시오.

이미지 역할 처리

제품에 동일한 이미지 역할을 사용하는 여러 에셋이 있는 경우(예: thumbnail 역할을 가진 두 에셋) 통합에서는 하나의 에셋만 해당 역할을 유지하여 Commerce Optimizer 계층의 역할 중복 및 예기치 않은 상점 첫 번째 동작을 방지합니다.

동작: AEM Assets에서 업데이트를 보낼 때 가장 최근에 업데이트된 에셋이 이미지 역할(예: thumbnail)을 받고 해당 역할이 있는 이전 에셋에서 제거됩니다. 이렇게 하면 중복 이미지 역할이 상점 앞에 표시되지 않습니다.

다음과 같음

recommendation-more-help
520dd1d6-1a61-4b98-a41f-0ee905eafadc