文档CommerceOptimizer Connector

[仅限PaaS]{class="badge informative" title="仅适用于云项目（Adobe管理的PaaS基础架构）和内部部署项目上的Adobe Commerce 。"}

连接器信息源的字段映射

最近更新： 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馈送将数据发送到Products终结点。

Adobe Commerce字段
Commerce Optimizer API字段
注释
sku
sku
storeViewCode
source/locale
name
name
urlKey
slug
productId
externalIds[0].id
origin已修复到"AdobeCommerce"
status
status
大写；对于未分配子项的复合产品，设置为DISABLED
description
description
shortDescription
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[]
attributes[]
已排除映射到{code, values[], variantReferenceId}；inStock、lowStock、weight、weightType的每个条目（它们进入aco_ac_attributes）
images[]
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
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
filterable
sortable
sortable
searchable
searchable
searchWeight
searchWeight
searchTypes
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
-
OBJECT
任何其他
-
TEXT
NOTE
当属性的dataType设置为OBJECT时，products API将该属性值视为结构化对象而不是纯字符串。 在查询时，API尝试将存储的值解析为JSON。 如果解析成功，则结果将作为响应中的嵌套对象返回。 当您动态提供自定义属性时（例如，用于承载不能表示为标量值的结构化或多字段数据），此行为特别有用。 有关说明，请参阅动态添加产品属性。

价格手册

priceBooks信息源将数据发送到价格手册终结点。

与其他连接器馈送不同，Adobe Commerce中的SaaS Data Export索引器不收集priceBooks馈送。 连接器从管理员的网站和客户组配置生成此信息源。

每个网站创建一个​基本价格手册，另外每个网站 — 客户组对创建一个​子价格手册。

价格簿ID公式：

  • 基数（正常价格）： priceBookId = websiteCode
  • 子（客户组或共享目录）： priceBookId = websiteCode::sha1(customerGroupId)，其中sha1(customerGroupId)是客户组的整数ID的SHA-1十六进制摘要

在解决价格条目所属的价格手册时，价格馈送使用相同的公式。 有关店面如何为客户会话解析priceBookId，请参阅Headless店面集成。

生成的字段
Commerce Optimizer API字段
注释
websiteCode, customerGroupId
priceBookId
网站名称
name
基本价格手册：网站名称。 子项： "Group Name (Website Name)"
websiteCode
parentId
仅显示在子价格手册中；指向基本价格手册
网站基础货币
currency
仅存在于基础价格手册中；由子代继承

价格

prices信息源向Prices终结点发送数据。

Adobe Commerce字段
Commerce Optimizer API字段
注释
sku
sku
websiteCode, customerGroupId
priceBookId
regular
regular
discounts[]
discounts[]
折扣示例：特殊价格、目录规则价格、共享目录价格
tierPrices[]
tierPrices[]

类别

categories馈送将数据发送到类别终结点。

将跳过具有空urlPath的项目（逻辑根类别），并且从不提交这些项目。

Adobe Commerce字段
Commerce Optimizer API字段
注释
storeViewCode
source/locale
name
name
urlPath
slug
description
description
metaTitle
metaTags/title
metaDescription
metaTags/description
metaKeywords
metaTags/keywords
新行分隔的字符串拆分为数组
image
images[].url
单元素数组；roles: ["BASE"]
isActive + includeInMenu
families
["top_menu"]，若两者均为true，否则[]
Related Articles
recommendation-more-help
commerce-help-aco-connector