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

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

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

작성 대상:

중급
관리자
개발자

이 페이지에서는 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"

aco_ac_attributes 항목을 항상 첫 번째 특성으로 추가합니다. 해당 JSON 값에는 문자열로 inStock 및 lowStock이(가) 포함되어 있습니다. 해당 값을 사용할 수 있는 경우 weight 및 weightType이(가) 포함됩니다.

attributes[]

사용 가능한 경우 각 항목을 해당 특성 코드, 문자열 값 및 일치하는 변형 참조 ID에 매핑합니다. inStock, lowStock, categories, weight 및 weightType을(를) 건너뜁니다. 인벤토리 관련 값이 aco_ac_attributes에 포함되어 있습니다. 범주는 경로로 내보내집니다.

images[]

URL 없이 이미지를 건너뜁니다.
url, label(누락된 경우 비어 있음), sortOrder(정수, 기본값: 0)을 내보냅니다.
이미지를 sortOrder별로 오름차순으로 정렬합니다.
표준 역할 image을(를) BASE에, small_image을(를) SMALL에, thumbnail을(를) THUMBNAIL에, swatch_image을(를) SWATCH에 매핑합니다. 다른 역할을 customRoles[](으)로 내보냅니다.

categoryData[].categoryPath

routes[].path

빈 범주 경로가 있는 항목을 건너뜁니다.

categoryData[].productPosition

routes[].position

제품 위치가 누락된 경우 0을(를) 사용합니다.

links[].type + links[].sku

links[]

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

parents[].productType + parents[].sku

links[]

configurable을(를) VARIANT_OF에 매핑하고 bundle 또는 bundle_fixed을(를) IN_BUNDLE에 매핑합니다. 다른 제품 유형을 대문자로 변환합니다. SKU 없이 상위 항목을 건너뜁니다.

configurable options

configurations[]

ID와 하나 이상의 값이 있는 옵션을 내보냅니다.
id을(를) attributeCode에 매핑합니다. swatchType이(가) 있는 경우 type을(를) SWATCH(으)로 설정하고, 그렇지 않은 경우 CONFIGURABLE(으)로 설정합니다.
기본 값의 ID를 defaultVariantReferenceId(으)로 사용합니다.
각 값을 variantReferenceId, label, colorHex 및 imageUrl에 매핑합니다.

bundle options

bundles[]

하나 이상의 항목이 포함된 옵션을 내보냅니다.
옵션 레이블을 group(으)로 사용하거나 레이블이 비어 있는 경우 Bundle group(으)로 사용합니다. required을(를) 출력으로 복사합니다.
렌더링 형식 checkbox 및 multi에 대해 multiSelect을(를) true(으)로 설정합니다.
defaultItemSkus에 기본 SKU를 나열합니다. 각 항목에는 sku, qty(기본값: 0) 및 userDefinedQty(기본값: qtyMutability, 기본값: false)이(가) 포함됩니다.

제품 특성 메타데이터

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

Adobe Commerce 필드

Commerce Optimizer API 필드

매핑 세부 정보

attributeCode

code

storeViewCode

source/locale

label

dataType + frontendInput

dataType

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

dataType 및 frontendInput

dataType

아래의 전환 규칙을 사용합니다.

visible, visibleInSearch, visibleInListing, visibleInCompareList

visibleIn[]

플래그가 true이면 해당 값
visible → PRODUCT_DETAIL
visibleInSearch → SEARCH_RESULTS
visibleInListing → PRODUCT_LISTING
visibleInCompareList → PRODUCT_COMPARE을(를) 추가합니다.

filterable

sortable

searchable

searchWeight

searchTypes

데이터 유형 전환

dataType이(가) int이면 커넥터가 frontendInput을(를) 확인합니다. 다른 데이터 형식의 경우 frontendInput은(는) 변환에 영향을 주지 않습니다.

dataType 입력

frontendInput 입력

출력 dataType

int

boolean

BOOLEAN

int

text 또는 select

TEXT

int

누락된 값을 포함한 기타 모든 값

INTEGER

decimal

사용되지 않음

DECIMAL

text, varchar, static, datetime

사용되지 않음

TEXT

OBJECT

사용되지 않음

OBJECT

기타 값

사용되지 않음

TEXT

NOTE

특성이 OBJECT 데이터 형식을 사용하는 경우 Products API에서 저장된 값을 JSON으로 구문 분석하려고 합니다. 구문 분석이 성공하면 API는 값을 중첩 객체로 반환합니다. 단일 값으로 표현할 수 없는 구조화된 특성 데이터에 OBJECT을(를) 사용하십시오. 자세한 지침은 제품 특성을 동적으로 추가를 참조하십시오.

가격 장부

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

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

각 웹 사이트에 대해 커넥터는 각 고객 그룹에 대해 하나의 기본 가격 장부와 하나의 하위 가격 장부를 만듭니다.

priceBookId에 대해 다음 수식 사용:

정가에 대한 기본 가격 장부: priceBookId = websiteCode.
고객 그룹에 대한 하위 가격 장부: priceBookId = websiteCode::sha1(customerGroupId). 여기서 sha1(customerGroupId)은(는) 고객 그룹의 정수 ID에 대한 SHA-1 16진수 다이제스트입니다.

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

Source 필드 또는 값

Commerce Optimizer API 필드

매핑 세부 정보

websiteCode

parentId

하위 가격표에 이 필드를 추가합니다. 이 값은 기본 가격 장부를 식별합니다.

웹 사이트 이름

name

기본 가격 장부에 웹 사이트 이름을 사용합니다. 하위 가격표에 Customer group name (Website name)을(를) 사용합니다.

websiteCode

parentId

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

웹 사이트 기본 통화

currency

기본 가격 장부에만 이 필드를 포함합니다. 아동용 가격 책에는 그것이 빠져 있다.

가격

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

피드 입력 필드

Commerce Optimizer API 필드

매핑 세부 정보

sku

SKU를 변경되지 않은 상태로 전달합니다.

websiteCode, customerGroupCode

priceBookId

customerGroupCode에서 websiteCode을(를) 고객 그룹 ID의 SHA-1 해시와 결합합니다. customerGroupCode이(가) 0인 경우 websiteCode만 사용합니다.

regular

변경되지 않은 상태로 일반 가격을 전달합니다.

discounts[]

원본 값이 null인 경우 빈 배열을 내보냅니다.
값이 0에서 100 사이인 경우 code이(가) special_price 및 percentage(으)로 설정된 항목의 경우 percentage을(를) 100 - percentage(으)로 설정합니다. 해당 범위 또는 외부에서 0(으)로 설정합니다.
가격 기반 특별 가격을 포함한 다른 항목을 변경되지 않은 상태로 전달합니다.

tierPrices[]

원본 값이 없거나 null인 경우 빈 배열을 사용합니다.

카테고리

categories 피드가 Categories 끝점에 Adobe Commerce 데이터를 보냅니다.

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

Adobe Commerce 필드

Commerce Optimizer API 필드

매핑 세부 정보

storeViewCode

source/locale

name

urlPath

slug

description

position

존재하는 경우 카테고리 위치를 내보냅니다. 누락된 경우 필드를 생략합니다.

metaTitle

metaTags/title

metaDescription

metaTags/description

metaKeywords

metaTags/keywords

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

image

images[].url

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

isActive + includeInMenu

families

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

| metaKeywords | metaTags/keywords | 줄바꿈으로 구분된 키워드를 배열로 분할하고 공백을 트리밍합니다. |
| image | images[].url | image이(가) 있으면 BASE 역할이 있는 하나의 이미지를 내보냅니다. 이미지가 비어 있거나 누락된 경우 빈 배열을 내보냅니다. |
| isActive + includeInMenu | families | 두 값이 모두 true인 경우에만 top_menu을(를) 추가합니다. 그렇지 않으면 빈 배열을 내보냅니다. |
| attributes[] | attributes[] | 비어 있지 않은 attributeCode의 항목을 {code, values[]}(으)로 내보냅니다. 값을 문자열로 변환합니다. 적격한 항목이 없으면 attributes을(를) 생략합니다. |

recommendation-more-help

commerce-help-aco-connector