DokumentationCommerceOptimizer Connector

[Nur PaaS]{class="badge informative" title="Gilt nur für Adobe Commerce in Cloud-Projekten (von Adobe verwaltete PaaS-Infrastruktur) und lokale Projekte."}

Feldzuordnung für Connector-Feeds

Letzte Aktualisierung: 10. Juni 2026

Erstellt für:

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

Auf dieser Seite wird dokumentiert, wie die Adobe Commerce Optimizer Connector Adobe Commerce Katalogfelder in das für die Commerce Optimizer-Catalog Data Ingestion API erforderliche Format umwandelt. Unter Connector-Referenz finden Sie die Liste der unterstützten Feeds und ihrer API-Endpunkte.

PRODUCT

Adobe Commerce
API-Feld Commerce Optimizer
Notizen
sku
sku
storeViewCode
source/locale
name
name
urlKey
slug
productId
externalIds[0].id
origin auf "AdobeCommerce" festgelegt
status
status
Hochgestellt; für zusammengesetzte Produkte ohne zugewiesene untergeordnete Elemente auf DISABLED gesetzt
description
description
shortDescription
shortDescription
visibility
visibleIn
Kommagetrennte Werte, aufgeteilt und zugeordnet: Catalog→CATALOG, Search→SEARCH; nicht zugeordnete Werte gelöscht
metaTitle
metaTags/title
metaDescription
metaTags/description
metaKeyword
metaTags/keywords
Durch Zeilenumbruch getrennte Zeichenfolge in Array aufgeteilt
inStock, lowStock, weight, weightUnit
attributes[].code = "aco_ac_attributes"
JSON-kodierte {inStock, lowStock, weight, weightType}; immer als erster Attributeintrag vorhanden
attributes[]
attributes[]
Jeder Eintrag, der {code, values[], variantReferenceId} zugeordnet ist; inStock, lowStock, weight, weightType sind ausgeschlossen (sie gehen in aco_ac_attributes)
images[]
images[]
url, label; Standardrollen zugeordnet: image→BASE, small_image→SMALL, thumbnail→THUMBNAIL, swatch_image→SWATCH; Nicht-Standardrollen gehen an customRoles[]
categoryData[].categoryPath
routes[].path
categoryData[].productPosition
routes[].position
links[].type + links[].sku
links[]
type in Großbuchstaben; Einträge ohne sku werden gelöscht
parents[].productType + parents[].sku
links[]
Zugeordneter Typ: configurable→VARIANT_OF, bundle/bundle_fixed→IN_BUNDLE
configurable options
configurations[]
id→attributeCode, label; Optionstyp SWATCH, wenn swatchType festgelegt ist, andernfalls CONFIGURABLE; Standardvariante von isDefault; Werte umfassen variantReferenceId, label, colorHex, imageUrl
bundle options
bundles[]
label→group; required; renderType checkbox/multi→multiSelect: true; Standard-SKUs von isDefault; Elemente umfassen sku, qty, userDefinedQty (qtyMutability)

Metadaten der Produktattribute

Adobe Commerce
API-Feld Commerce Optimizer
Notizen
attributeCode
code
storeViewCode
source/locale
label
label
dataType + frontendInput
dataType
Siehe Konversionstabelle unten
visible
visibleIn: "PRODUCT_DETAIL"
Beim true zum Array hinzugefügt
visibleInSearch
visibleIn: "SEARCH_RESULTS"
Beim true zum Array hinzugefügt
visibleInListing
visibleIn: "PRODUCT_LISTING"
Beim true zum Array hinzugefügt
visibleInCompareList
visibleIn: "PRODUCT_COMPARE"
Beim true zum Array hinzugefügt
filterable
filterable
sortable
sortable
searchable
searchable
searchWeight
searchWeight
searchTypes
searchTypes

Datentypkonvertierung:

Adobe Commerce dataType
Adobe Commerce frontendInput
Commerce Optimizer API-dataType
int
boolean
BOOLEAN
int
text oder select
TEXT
int
Beliebige andere
INTEGER
decimal
-
DECIMAL
text, varchar, static, datetime
-
TEXT
OBJECT
-
OBJECT
Beliebige andere
-
TEXT

Preisbücher

Im Gegensatz zu den anderen Connector-Feeds wird der priceBooks-Feed nicht von einem SaaS Data Export Indexer in Adobe Commerce erfasst. Der Connector generiert diesen Feed aus der Website- und Kundengruppenkonfiguration im Admin-Bereich.

Pro Website wird ein Grundpreisbuch erstellt, plus ein Kinderpreisbuch pro Website-Kunden-Gruppenpaar.

Preisbuch-ID-Formel:

  • Basis (reguläre Preise): priceBookId = websiteCode
  • Child (Kundengruppe oder freigegebener Katalog): priceBookId = websiteCode::sha1(customerGroupId), wobei sha1(customerGroupId) der SHA-1-Hex-Auszug der Ganzzahl-ID der Kundengruppe ist

Der Preis-Feed verwendet dieselbe Formel, wenn er festlegt, zu welchem Preisbuch ein Preiseintrag gehört. Informationen dazu, wie Storefronts die priceBookId für eine Kundensitzung auflösen, finden Sie unter Headless-Storefront-Integration.

Erzeugtes Feld
API-Feld Commerce Optimizer
Notizen
websiteCode, customerGroupId
priceBookId
Website-Name
name
Basispreisbuch: Website-Name. Untergeordnet: "Group Name (Website Name)"
websiteCode
parentId
Nur bei untergeordneten Preisbüchern vorhanden; verweist auf das Grundpreisbuch
Website-Basiswährung
currency
Nur bei Grundpreisbüchern vorhanden; von Kindern übernommen

Preise

Adobe Commerce
API-Feld Commerce Optimizer
Notizen
sku
sku
websiteCode, customerGroupId
priceBookId
regular
regular
discounts[]
discounts[]
Beispiel für Rabatte: Sonderpreis, Katalogregel-Preis, Preis für freigegebenen Katalog
tierPrices[]
tierPrices[]

Kategorien

Elemente mit einem leeren urlPath (logische Stammkategorien) werden übersprungen und nie gesendet.

Adobe Commerce
API-Feld Commerce Optimizer
Notizen
storeViewCode
source/locale
name
name
urlPath
slug
description
description
metaTitle
metaTags/title
metaDescription
metaTags/description
metaKeywords
metaTags/keywords
Durch Zeilenumbruch getrennte Zeichenfolge in Array aufgeteilt
image
images[].url
Array mit einzelnen Elementen; roles: ["BASE"]
isActive + includeInMenu
families
["top_menu"] wenn beide true, [] andernfalls
Related Articles
recommendation-more-help
commerce-help-aco-connector