文件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摘要傳送資料至產品端點。

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摘要。 聯結器會從Admin的網站和客戶群組設定產生此摘要。

每個網站建立一個​基本價格簿，加上每個網站 — 客戶群組配對一個​子價格簿。

價格簿識別碼公式：

  • 基準 （一般價格）： priceBookId = websiteCode
  • 子項 （客戶群組或共用目錄）： priceBookId = websiteCode::sha1(customerGroupId)，其中sha1(customerGroupId)是客戶群組整數識別碼的SHA-1十六進位摘要

價格摘要在解析價格專案所屬的價格簿時，會使用相同的公式。 如需店面如何解析客戶工作階段的priceBookId，請參閱無頭店面整合。

產生的欄位
Commerce Optimizer API欄位
附註
websiteCode, customerGroupId
priceBookId
網站名稱
name
基本價格簿：網站名稱。 子項： "Group Name (Website Name)"
websiteCode
parentId
僅出現在子價格簿上；指向基本價格簿
網站基本貨幣
currency
僅存在於基礎價格簿上；由子項繼承

價格

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