DokumentationCommerceOptimizer Connector

[Endast PaaS]{class="badge informative" title="Gäller endast Adobe Commerce i molnprojekt (Adobe-hanterad PaaS-infrastruktur) och lokala projekt."}

Fältmappning för anslutningsflöden

Senast uppdaterad: 10 juni 2026

Skapat för:

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

Den här sidan visar hur katalogfälten i Adobe Commerce Optimizer Connector omformar Adobe Commerce till det format som krävs av Commerce Optimizer Catalog Data Ingestion API. I anslutningsreferensen finns en lista över feeds som stöds och deras API-slutpunkter.

Produkter

Fältet Adobe Commerce
API-fältet Commerce Optimizer
Anteckningar
sku
sku
storeViewCode
source/locale
name
name
urlKey
slug
productId
externalIds[0].id
origin har korrigerats till "AdobeCommerce"
status
status
Övre, anges till DISABLED för sammansatta produkter utan tilldelade underordnade
description
description
shortDescription
shortDescription
visibility
visibleIn
Kommaavgränsat värde delat och mappat: Catalog →CATALOG, Search →SEARCH; omappade värden tas bort
metaTitle
metaTags/title
metaDescription
metaTags/description
metaKeyword
metaTags/keywords
Newline-avgränsad sträng delad i matris
inStock, lowStock, weight, weightUnit
attributes[].code = "aco_ac_attributes"
JSON-kodat objekt {inStock, lowStock, weight, weightType}; finns alltid som den första attributposten
attributes[]
attributes[]
Varje post som är mappad till {code, values[], variantReferenceId}; inStock, lowStock, weight, weightType exkluderas (de går in i aco_ac_attributes)
images[]
images[]
url, label; standardroller mappas: image → BASE, small_image →SMALL, thumbnail¥THUMBNAIL, swatch_image¥SWATCH; roller som inte är standard går till customRoles[]
categoryData[].categoryPath
routes[].path
categoryData[].productPosition
routes[].position
links[].type + links[].sku
links[]
type överskreds; poster utan sku borttagna
parents[].productType + parents[].sku
links[]
Mappad typ: configurable →VARIANT_OF, bundle/bundle_fixed →IN_BUNDLE
configurable options
configurations[]
id¥attributeCode, label; alternativtyp SWATCH när swatchType är inställd, else CONFIGURABLE; standardvariant från isDefault; värdena är variantReferenceId, label, colorHex, imageUrl
bundle options
bundles[]
label¥group; required; renderType checkbox/multi¥multiSelect: true; SKU:er från isDefault; objekt är sku, qty, userDefinedQty (qtyMutability)

Metadata för produktattribut

Fältet Adobe Commerce
API-fältet Commerce Optimizer
Anteckningar
attributeCode
code
storeViewCode
source/locale
label
label
dataType + frontendInput
dataType
Se konverteringstabellen nedan
visible
visibleIn: "PRODUCT_DETAIL"
Tillagd i matris när true
visibleInSearch
visibleIn: "SEARCH_RESULTS"
Tillagd i matris när true
visibleInListing
visibleIn: "PRODUCT_LISTING"
Tillagd i matris när true
visibleInCompareList
visibleIn: "PRODUCT_COMPARE"
Tillagd i matris när true
filterable
filterable
sortable
sortable
searchable
searchable
searchWeight
searchWeight
searchTypes
searchTypes

Datatypskonvertering:

Adobe Commerce dataType
Adobe Commerce frontendInput
Commerce Optimizer API dataType
int
boolean
BOOLEAN
int
text eller select
TEXT
int
övriga
INTEGER
decimal
-
DECIMAL
text, varchar, static, datetime
-
TEXT
OBJECT
-
OBJECT
övriga
-
TEXT

Prisböcker

Till skillnad från andra anslutningsflöden samlas priceBooks-feeden inte in av en SaaS Data Export-indexerare i Adobe Commerce. Kopplingen genererar denna feed från webbplatsen och kundgruppskonfigurationen i Admin.

En basprisbok skapas per webbplats, plus en underordnad prisbok per grupppar för webbplats-kund.

ID-formel för prisbok:

  • Bas (normalpriser): priceBookId = websiteCode
  • Underordnad (kundgrupp eller delad katalog): priceBookId = websiteCode::sha1(customerGroupId) där sha1(customerGroupId) är SHA-1-hex-sammanfattningen för kundgruppens heltals-ID

Prismatningen använder samma formel när den löser vilken prisbok en prispost tillhör. Mer information om hur butiker löser priceBookId för en kundsession finns i Headless storefront-integrering.

Genererat fält
API-fältet Commerce Optimizer
Anteckningar
websiteCode, customerGroupId
priceBookId
Webbplatsnamn
name
Basprisbok: webbplatsnamn. Underordnad: "Group Name (Website Name)"
websiteCode
parentId
Finns endast i barnprisböcker, pekar på basprisboken
Basvaluta för webbplats
currency
Finns endast i basprisböcker, ärvs av underordnade

Priser

Fältet Adobe Commerce
API-fältet Commerce Optimizer
Anteckningar
sku
sku
websiteCode, customerGroupId
priceBookId
regular
regular
discounts[]
discounts[]
exempel på rabatter: specialpris, katalogregelpris, delat katalogpris
tierPrices[]
tierPrices[]

Kategorier

Objekt med tomma urlPath (logiska rotkategorier) hoppas över och skickas aldrig.

Fältet Adobe Commerce
API-fältet Commerce Optimizer
Anteckningar
storeViewCode
source/locale
name
name
urlPath
slug
description
description
metaTitle
metaTags/title
metaDescription
metaTags/description
metaKeywords
metaTags/keywords
Newline-avgränsad sträng delad i matris
image
images[].url
Arrayer med ett element; roles: ["BASE"]
isActive + includeInMenu
families
["top_menu"] om både true och [] annars
Related Articles
recommendation-more-help
commerce-help-aco-connector