[PaaS만]{class="badge informative" title="Adobe Commerce 온 클라우드 프로젝트(Adobe 관리 PaaS 인프라) 및 온프레미스 프로젝트에만 적용됩니다."}

커넥터 피드에 대한 필드 매핑

마지막 업데이트: 2026년 6월 10일

작성 대상:

{"id":"b5a62a22-46f7-4f0d-b151-3fc640bef588"}
{"id":"c66ffd68-0f65-42bb-aa23-b4020f12e0bd"},{"id":"ff6a42d2-313e-452e-93a6-792e4fad9ff8"}

이 페이지에서는 Adobe Commerce Optimizer Connector이(가) Adobe Commerce 카탈로그 필드를 Commerce Optimizer Catalog Data Ingestion API에 필요한 형식으로 변환하는 방법을 설명합니다. 지원되는 피드 및 해당 API 끝점에 대한 목록은 커넥터 참조를 참조하십시오.

제품

products 피드가 제품 끝점에 데이터를 보냅니다.

Adobe Commerce 필드

Commerce Optimizer API 필드

메모

sku

storeViewCode

source/locale

name

urlKey

slug

productId

externalIds[0].id

origin이(가) "AdobeCommerce"(으)로 수정됨

status

상위 항목입니다. 하위 항목이 할당되지 않은 복합 제품에 대해 DISABLED(으)로 설정합니다.

description

shortDescription

visibility

visibleIn

쉼표로 구분된 값 분할 및 매핑됨: Catalog→CATALOG, Search→SEARCH; 매핑되지 않은 값이 삭제됨

metaTitle

metaTags/title

metaDescription

metaTags/description

metaKeyword

metaTags/keywords

줄바꿈으로 구분된 문자열을 배열로 분할

inStock, lowStock, weight, weightUnit

attributes[].code = "aco_ac_attributes"

JSON 인코딩 개체 {inStock, lowStock, weight, weightType}; 항상 첫 번째 특성 항목으로 표시

attributes[]

{code, values[], variantReferenceId}; inStock, lowStock, weight, weightType에 매핑된 각 항목이 제외됩니다(aco_ac_attributes(으)로 이동).

images[]

url, label; 매핑된 표준 역할: image→BASE, small_image→SMALL, thumbnail→THUMBNAIL, swatch_image→SWATCH; 비표준 역할은 customRoles[](으)로 이동

categoryData[].categoryPath

routes[].path

categoryData[].productPosition

routes[].position

links[].type + links[].sku

links[]

type이(가) 우선함, sku이(가) 없는 항목이 삭제됨

parents[].productType + parents[].sku

links[]

매핑된 형식: configurable→VARIANT_OF, bundle/bundle_fixed→IN_BUNDLE

configurable options

configurations[]

id→attributeCode, label; swatchType이(가) 설정된 경우 옵션 유형 SWATCH, 기타 CONFIGURABLE; isDefault의 기본 변형; 값: variantReferenceId, label, colorHex, imageUrl

bundle options

bundles[]

label→group; required; renderType checkbox/multi→multiSelect: true; isDefault의 기본 SKU; 항목에 sku, qty, userDefinedQty(qtyMutability) 포함

제품 특성 메타데이터

productAttributes 피드가 메타데이터 끝점에 데이터를 보냅니다.

Adobe Commerce 필드

Commerce Optimizer API 필드

메모

attributeCode

code

storeViewCode

source/locale

label

dataType + frontendInput

dataType

아래의 전환 표를 참조하십시오.

visible

visibleIn: "PRODUCT_DETAIL"

true할 때 배열에 추가됨

visibleInSearch

visibleIn: "SEARCH_RESULTS"

true할 때 배열에 추가됨

visibleInListing

visibleIn: "PRODUCT_LISTING"

true할 때 배열에 추가됨

visibleInCompareList

visibleIn: "PRODUCT_COMPARE"

true할 때 배열에 추가됨

filterable

sortable

searchable

searchWeight

searchTypes

데이터 유형 전환

커넥터가 위의 매핑 테이블에 있는 Commerce dataType 및 frontendInput 필드에서 API dataType을(를) 파생합니다. 다음 표는 커넥터가 적용되는 전환 규칙을 보여 줍니다.

Adobe Commerce dataType

Adobe Commerce frontendInput

Commerce Optimizer API dataType

int

boolean

BOOLEAN

int

text 또는 select

TEXT

int

기타

INTEGER

decimal

DECIMAL

text, varchar, static, datetime

TEXT

OBJECT

기타

TEXT

NOTE

특성에 대한 dataType이(가) OBJECT(으)로 설정되어 있으면 제품 API은(는) 특성 값을 일반 문자열이 아닌 구조화된 개체로 취급합니다. 쿼리 시간에 API는 저장된 값을 JSON으로 구문 분석하려고 합니다. 구문 분석이 성공하면 결과가 응답에서 중첩 객체로 반환됩니다. 이 동작은 사용자 지정 특성을 동적으로 제공할 때(예: 스칼라 값으로 표현할 수 없는 구조화된 또는 다중 필드 데이터를 전달할 때) 특히 유용합니다. 자세한 지침은 제품 특성을 동적으로 추가를 참조하십시오.

가격 장부

priceBooks 피드가 가격 장부 끝점에 데이터를 보냅니다.

다른 커넥터 피드와 달리 priceBooks 피드는 Adobe Commerce의 SaaS Data Export 인덱서에서 수집되지 않습니다. 커넥터는 관리자의 웹 사이트 및 고객 그룹 구성에서 이 피드를 생성합니다.

웹 사이트당 하나의 기본 가격 책이 만들어지고 웹 사이트-고객 그룹 쌍당 하나의 하위 가격 책이 만들어집니다.

가격 장부 ID 수식:

기본(정가): priceBookId = websiteCode
자식(고객 그룹 또는 공유 카탈로그): priceBookId = websiteCode::sha1(customerGroupId). 여기서 sha1(customerGroupId)은(는) 고객 그룹의 정수 ID에 대한 SHA-1 16진수 다이제스트입니다.

가격 피드는 가격 입력이 속한 가격 장부를 해결할 때 동일한 공식을 사용합니다. Storefront가 고객 세션에 대한 priceBookId을(를) 해결하는 방법은 Headless storefront 통합을(를) 참조하십시오.

생성된 필드

Commerce Optimizer API 필드

메모

websiteCode, customerGroupId

priceBookId

웹 사이트 이름

name

기본 가격 장부: 웹 사이트 이름. 자식: "Group Name (Website Name)"

websiteCode

parentId

아동 가격 장부에만 표시, 기본 가격 장부를 가리킵니다.

웹 사이트 기본 통화

currency

기본 가격 장부로만 제공, 자녀에게 상속

가격

prices 피드가 가격 끝점에 데이터를 보냅니다.

Adobe Commerce 필드

Commerce Optimizer API 필드

메모

sku

websiteCode, customerGroupId

priceBookId

regular

discounts[]

할인의 예: 특별 가격, 카탈로그 규칙 가격, 공유 카탈로그 가격

tierPrices[]

카테고리

categories 피드가 Categories 끝점으로 데이터를 보냅니다.

빈 urlPath(논리 루트 범주)이 있는 항목은 건너뛰고 제출되지 않습니다.

Adobe Commerce 필드

Commerce Optimizer API 필드

메모

storeViewCode

source/locale

name

urlPath

slug

description

metaTitle

metaTags/title

metaDescription

metaTags/description

metaKeywords

metaTags/keywords

줄바꿈으로 구분된 문자열을 배열로 분할

image

images[].url

단일 요소 배열; roles: ["BASE"]

isActive + includeInMenu

families

true과(와) 그렇지 않은 경우 ["top_menu"], 그렇지 않은 경우 []

recommendation-more-help

commerce-help-aco-connector