설명서CommerceAEM Assets 통합

Commerce 메타데이터를 지원하도록 AEM Assets 프로젝트 구성

마지막 업데이트: 2026년 5월 11일

작성 대상:

  • {"id":"b69b2659-1057-424e-8fc5-ed9e016dc554"}

AEM Assets을 Commerce용 DAM(디지털 에셋 관리 시스템)으로 사용하는 경우 assets-commerce 패키지를 설치하면 AEM 작성 환경에서 Commerce 제품의 이미지와 비디오를 관리할 수 있습니다.

다음 단계를 완료하여 AEM 작성 환경에서 Commerce 에셋을 관리하는 데 필요한 패키지 코드 및 메타데이터로 AEM Assets 프로젝트를 구성합니다.

  1. assets-commerce 패키지 콘텐츠에 대해 알아보기

  2. 설치 단계를 완료하여 Commerce 메타데이터를 지원하도록 AEM Assets 프로젝트를 구성합니다

AEM Commerce assets-commerce 패키지 콘텐츠

Adobe은 Experience Manager Assets as a Cloud Service 환경 구성에 Commerce 네임스페이스 및 메타데이터 스키마 리소스를 추가하기 위해 AEM Commerce 패키지 코드 assets-commerce을(를) 제공합니다.

이 패키지 코드는 AEM Assets 작성 환경에 다음 리소스를 추가합니다.

  • Commerce 관련 속성을 식별하기 위한 사용자 지정 네임스페이스, Commerce입니다.

    • Adobe Commerce 프로젝트와 연결된 Commerce 자산에 태그를 지정하는 레이블이 Eligible for Commerce인 사용자 지정 메타데이터 형식 commerce:isCommerce입니다.

    • Product Data 속성을 추가할 사용자 지정 메타데이터 형식 commerce:skus 및 해당 UI 구성 요소입니다. 제품 데이터에는 Commerce 에셋을 제품 SKU와 연결하는 메타데이터 속성이 포함됩니다.

      사용자 지정 제품 데이터 UI 컨트롤 {width="600" modal="regular"}

    • Commerce에서 자산이 시각화되는 방식을 보여 주는 사용자 지정 메타데이터 형식 commerce:roles 및 commerce:positions 특성입니다.

    • 편집자가 Commerce 스토어 보기 코드에서 입력한 대체 텍스트를 입력할 수 있도록 대체 텍스트 다중 필드(Alt texts) 메타데이터입니다. 따라서 카탈로그에서 제품 이미지가 지정되거나 범위가 지정되는 방식은 변경되지 않습니다. AEM Assets 메타데이터의 대체 텍스트를 참조하십시오.

  • Commerce 자산에 태그를 지정할 Eligible for Commerce 및 Product Data 필드가 포함된 Commerce 탭이 있는 메타데이터 스키마 양식입니다. 이 양식은 AEM Assets UI에서 roles 및 position 필드를 표시하거나 숨기는 옵션도 제공합니다.

    AEM Assets 메타데이터 스키마 양식에 대한 Commerce 탭 {width="600" modal="regular"}

  • 초기 에셋 동기화를 지원하기 위해 샘플 Commerce 에셋이 태그되고 승인되었습니다 equipment_6.jpg. 승인된 Commerce 자산만 AEM Assets에서 Adobe Commerce으로 동기화할 수 있습니다.

NOTE
AEM Commerce 패키지 코드​에 대한 자세한 내용은 GitHub의 readme 페이지를 참조하십시오.

AEM Assets 메타데이터의 대체 텍스트

Alt texts​다중 필드는 적격 이미지를 편집할 때​ Commerce ​탭의 AEM Assets 에셋 메타데이터 편집기에서 사용할 수 있습니다.

IMPORTANT
스토어별 보기 동작은 대체 텍스트에만 적용됩니다. AEM Assets 통합은 Adobe Commerce 스토어 보기당 다른 제품 이미지를 동기화하지 않습니다. AEM의 제품 이미지는 이 릴리스 전과 동일한 갤러리 할당 동작으로 Commerce에 계속 동기화됩니다.

다중 필드에는 Commerce 스토어 보기당 하나의 행이 포함됩니다. 각 행에는 두 개의 입력이 있습니다.

  • Store View Code — 저장소 보기 식별자(예: default 또는 en_US).

  • Alt Text — 255자로 제한된 해당 스토어 보기에 대한 대체 텍스트입니다.

저장소 보기를 추가할 행을 더 추가하려면 Add​을(를) 선택하십시오. 행을 제거하려면 해당 행에서 Delete 아이콘을 선택하여 제거합니다.

저장소 보기 코드와 대체 텍스트 입력이 있는 다중 필드 {width="600" modal="regular"}

저장할 때, 행에 빈 Store View Code​이(가) 있거나 두 행이 동일한 저장소 보기 코드를 사용하는 경우(대/소문자 구분 안 함) 클라이언트측 유효성 검사가 제출을 차단합니다.

대체 텍스트 항목은 JCR 자산 메타데이터에서 두 개의 인덱스 정렬 String[] 속성으로 유지됩니다.

  • commerce:altTextStoreViews: 각 행에 대한 보기 코드를 저장합니다.
  • commerce:altTextValues: commerce:altTextStoreViews의 각 항목과 동일한 인덱스에 있는 대체 텍스트와 일치합니다.

이러한 에셋이 Adobe Commerce과 동기화되면 일치하는 스토어 보기 코드에 대해 스토어별 보기 대체 텍스트가 제품 미디어 갤러리에 작성됩니다. 기본 이미지 매핑이 변경되지 않았습니다.

사전 요구 사항

assets-commerce 패키지 코드를 AEM Assets as a Cloud Service AEM 환경에 배포하려면 다음 리소스와 권한이 필요합니다.

제품 시각화

OpenAPI 기능이 있는 [SaaS 전용]{class="badge positive" title="Adobe Commerce as a Cloud Service 및 Adobe Commerce Optimizer 프로젝트에만 적용됩니다(Adobe 관리 SaaS 인프라)."} Dynamic Media는 AEM Assets에서 제공하는 제품 비주얼에 대해 셀프서비스입니다.

  1. Cloud Manager으로 이동합니다.

  2. 원하는 환경을 선택합니다.

  3. OpenAPI 기능을 사용하여 Dynamic Media를 활성화​합니다.

    OpenAPI 기능이 있는 Dynamic Media 단추가 활성화되지 않은 경우 지원 티켓을 엽니다.

AEM Assets

AEM as a Cloud Service에서 [PaaS 전용]{class="badge informative" title="Adobe Commerce on Cloud 프로젝트에만 적용됩니다(Adobe 관리 PaaS 인프라)."}, 다음 정보가 포함된 Adobe 지원 티켓을 제출하십시오.

  • 제목: Dynamic Media OpenAPI를 활성화하여 Adobe Commerce을 AEM Assets과 완전히 통합

    • 지원 티켓 컨텐츠:

      • AEM Program ID
      • Adobe Commerce URL
      • AEM Environment ID
      • IMS Org ID

지원 티켓을 제출하면 Adobe이 Cloud Services 환경에서 OpenAPI 기능을 갖춘 Dynamic Media를 활성화하고 IMS 클라이언트 ID 등의 세부 정보를 공유하여 통합을 계속할 수 있습니다.

1단계: assets-commerce 패키지 설치

  1. AEM Cloud Manager으로 이동하여 프로그램을 선택한 다음 Adobe Commerce과 통합할 프로덕션 및 스테이징 환경 만들기를 선택합니다.

  2. 선택한 프로그램에 대해 Adobe 관리 git 저장소를 복제합니다.

    Cloud Manager 저장소 자격 증명 및 복제 명령 {width="600" modal="regular"}

    Cloud Manager 파이프라인​에서 Access Repo Info​을(를) 선택하여 Repository Info​을(를) 엽니다. URL 또는 Git command line 값을 복사하고 필요한 경우 액세스 암호를 생성한 다음 Git 클라이언트로 로컬로 복제합니다.

  3. GitHub에서 AEM Assets Commerce 저장소에서 패키지 코드를 다운로드합니다.

  4. 로컬 AEM 개발 환경에서 다운로드한 코드를 기존 Adobe 관리 저장소에 수동으로 복사하십시오.

  5. 프로젝트의 모든 filter.xml 및 pom.xml 파일에서 모든 <my-app>을 사용자의 앱 이름으로 바꾸십시오.

    note
    NOTE
    또는 사용자 지정 코드를 AEM Assets 프로젝트 구성에 Maven 패키지로 설치할 수 있습니다.

  6. 변경 사항을 커밋하고 로컬 개발 분기를 Cloud Manager Git 저장소로 푸시합니다.

  7. 배포 파이프라인을 구성하거나 파이프라인이 선택한 환경에 변경 내용을 배포할 수 있는지 확인하십시오.

    Cloud Manager 파이프라인 {width="600" modal="regular"}

    파이프라인이 있으면 작업 메뉴(…)를 엽니다. Run, Edit, View/Edit variables 또는 기타 작업까지—위에 연결된 Cloud Manager 파이프라인 설명서를 참조하십시오.

  8. AEM Cloud Manager에서 파이프라인을 사용하여 코드를 배포하여 AEM 환경을 업데이트합니다.

  9. 변경 내용을 확인하려면 임의의 자산으로 이동하여 해당 속성을 편집하십시오.

    • 기본 메타데이터 스키마에는 Commerce 탭이 포함되어 있습니다.

    • 제품 SKU 및 Eligible for Commerce 필드가 표시됩니다.

Commerce 탭이 속성에 표시되지 않음

Commerce 탭이 속성에 나타나지 않으면 메타데이터 스키마 편집기에서 다음 단계를 수동으로 완료해야 합니다.

  1. 메타데이터 스키마 편집기로 이동합니다.

  2. 기본 메타데이터 스키마 양식을 수정하려면 편집​을 선택하십시오.

  3. Commerce 탭을 만들고 선택합니다.

  4. Product 구성 요소를 Commerce 탭으로 끌어다 놓고 속성 commerce:skus에 매핑합니다.

  5. 역할 표시 및 순서 표시​에 대한 확인란을 선택하십시오.

  6. checkbox 구성 요소를 Commerce 탭으로 끌어다 놓고 속성 commerce:isCommerce에 매핑합니다. 옵션으로 예 및 아니요​를 정의합니다.

다른 문제가 발생하면 지원 티켓을 만들거나 AEM Assets 통합 영업 담당자에게 도움을 요청하십시오.

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

AEM Assets 작성 환경에서 메타데이터 프로필을 만들어 Commerce 에셋 메타데이터에 대한 기본값을 설정합니다. 그런 다음 AEM 자산 폴더에 새 프로필을 적용하여 이러한 기본값을 자동으로 사용합니다. 이 구성은 수동 단계를 줄여 자산 처리를 간소화합니다.

메타데이터 프로필을 구성할 때는 다음 구성 요소만 구성해야 합니다.

  • Commerce 탭을 추가합니다. 이 탭에서는 템플릿에서 추가한 Commerce 특정 구성 설정을 사용할 수 있습니다.

  • Commerce 탭에 Eligible for Commerce 필드를 추가합니다.

제품 데이터 UI 구성 요소는 템플릿을 기반으로 자동으로 추가됩니다.

메타데이터 프로필 정의

  1. Adobe Experience Manager 작성자 환경에 로그인합니다.

  2. Adobe Experience Manager 작업 영역에서 Adobe Experience Manager 아이콘을 클릭하여 AEM Assets용 작성자 컨텐츠 관리 작업 영역으로 이동합니다.

    AEM Assets 작성 {width="600" modal="regular"}

  3. 망치 아이콘을 선택하여 관리자 도구를 엽니다.

    AEM 작성자 관리자 관리 메타데이터 프로필 {width="600" modal="regular"}

  4. Metadata Profiles​을(를) 클릭하여 프로필 구성 페이지를 엽니다.

  5. Commerce 통합을 위한 메타데이터 프로필을 Create​합니다.

    AEM 작성자 관리자 메타데이터 프로필 추가 {width="600" modal="regular"}

  6. Commerce 메타데이터에 대한 탭을 추가합니다.

    1. 왼쪽에서 Settings​을(를) 클릭합니다.

    2. 탭 섹션에서 +​을(를) 클릭한 다음 Tab Name, Commerce을(를) 지정합니다.

  7. 양식에 Eligible for Commerce 필드를 추가합니다.

    AEM 작성자 관리자가 프로필에 메타데이터 필드 추가 {width="600" modal="regular"}

    • Build form​을(를) 클릭합니다.

    • Single Line text 필드를 양식으로 끕니다.

    • Field Label​을(를) 클릭하여 레이블에 대한 Eligible for Commerce 텍스트를 추가합니다.

    • 설정 탭에서 레이블 텍스트를 필드 레이블​에 추가합니다.

    • 자리 표시자 텍스트를 yes(으)로 설정하십시오.

    • Map to Property 필드에서 다음 값을 복사하여 붙여 넣습니다.

      code language-terminal 
      ./jcr:content/metadata/commerce:isCommerce

  8. 선택 사항입니다. 승인된 Commerce 자산이 AEM Assets 환경에 업로드될 때 자동으로 동기화하려면 Basic 탭의 Review Status​필드에 대한 기본값을 approved(으)로 설정합니다.

  9. 업데이트를 저장합니다.

Commerce 에셋 소스 폴더에 메타데이터 프로필 적용

  1. Metadata Profiles 페이지에서 Commerce 통합 프로필을 선택합니다.

  2. 작업 메뉴에서 Apply Metadata Profiles to Folders​을(를) 선택합니다.

  3. Commerce 자산이 포함된 폴더를 선택합니다.

    Commerce 폴더가 없는 경우 만듭니다.

  4. Apply​을(를) 선택합니다.

다음 단계

recommendation-more-help
commerce-help-aem-assets-integration