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: 20. Oktober 2026

Erstellt für:

  • Fortgeschritten
  • Admin
  • Entwicklerin/Entwickler

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

Der products-Feed sendet Daten an den Endpunkt products.

Adobe Commerce
API-Feld Commerce Optimizer
Zuordnungsdetails
sku
sku
storeViewCode
source/locale
name
name
urlKey
slug
productId
externalIds[0].id
Setzt origin auf "AdobeCommerce"
status
status
Wandelt den Status in Großbuchstaben um. Verwendet DISABLED, wenn der Status fehlt oder wenn ein konfigurierbares oder gebündeltes Produkt keine Optionswerte hat.
description
description
Verwendet eine leere Zeichenfolge, wenn die Beschreibung fehlt.
shortDescription
shortDescription
Verwendet eine leere Zeichenfolge, wenn die Kurzbeschreibung fehlt.
visibility
visibleIn
Teilt den kommagetrennten Wert und ordnet Catalog CATALOG und Search zu SEARCH zu. Löscht andere Werte.
metaTitle
metaTags/title
metaDescription
metaTags/description
metaKeyword
metaTags/keywords
Teilt Keywords mit Zeilenumbruch in ein Array auf und kürzt Leerzeichen.
inStock, lowStock, weight, weightUnit
attributes[].code = "aco_ac_attributes"
Fügt immer einen aco_ac_attributes Eintrag als erstes Attribut hinzu. Ihr JSON-Wert enthält inStock und lowStock als Zeichenfolgen. Sie enthält weight und weightType, wenn diese Werte verfügbar sind.
attributes[]
attributes[]
Ordnet jeden Eintrag seinem Attributcode, seinen Zeichenfolgenwerten und, sofern verfügbar, seiner übereinstimmenden Variantenreferenz-ID zu. Überspringt inStock, lowStock, categories, weight und weightType. Die inventarbezogenen Werte sind in aco_ac_attributes enthalten. Kategorien werden als Routen exportiert.
images[]
images[]
Überspringt Bilder ohne eine URL.
Exportiert url, label (leer, wenn fehlt) und sortOrder (Ganzzahl, Standardwert ist 0).
Sortiert Bilder nach sortOrder in aufsteigender Reihenfolge.
Ordnet Standardrollen zu: image zu BASE, small_image zu SMALL, thumbnail zu THUMBNAIL und swatch_image zu SWATCH. Exportiert andere Rollen nach customRoles[].
categoryData[].categoryPath
routes[].path
Einträge mit einem leeren Kategoriepfad werden übersprungen.
categoryData[].productPosition
routes[].position
Verwendet 0, wenn die Produktposition fehlt.
links[].type + links[].sku
links[]
type in Großbuchstaben; Einträge ohne sku werden gelöscht
parents[].productType + parents[].sku
links[]
Ordnet configurable VARIANT_OF und bundle oder bundle_fixed IN_BUNDLE zu. Wandelt andere Produktarten in Großbuchstaben um. Überspringt Eltern ohne SKU.
configurable options
configurations[]
Exportiert Optionen mit einer ID und mindestens einem Wert.
Ordnet id attributeCode zu. Legt type auf SWATCH fest, wenn swatchType vorhanden ist, und auf andernfalls CONFIGURABLE.
Verwendet die ID des Standardwerts als defaultVariantReferenceId.
Ordnet jeden Wert variantReferenceId, label, colorHex und imageUrl zu.
bundle options
bundles[]
Exportiert Optionen, die mindestens ein Element enthalten.
Verwendet die Optionsbeschriftung als group oder Bundle group, wenn die Beschriftung leer ist. Kopiert required in die Ausgabe.
Setzt multiSelect auf true für checkbox und multi Render-Typen.
Listet Standard-SKUs in defaultItemSkus auf. Jedes Element enthält sku, qty (standardmäßig 0) und userDefinedQty (ab qtyMutability standardmäßig false).

Metadaten der Produktattribute

Der productAttributes-Feed sendet Daten an den Metadaten-Endpunkt.

Adobe Commerce
API-Feld Commerce Optimizer
Zuordnungsdetails
attributeCode
code
storeViewCode
source/locale
label
label
dataType + frontendInput
dataType
Siehe Konversionstabelle unten
dataType und frontendInput
dataType
Verwendet die unten stehenden Konversionsregeln.
visible, visibleInSearch, visibleInListing, visibleInCompareList
visibleIn[]
Wenn ein Flag true wird, fügt den entsprechenden Wert hinzu:
visible → PRODUCT_DETAIL
visibleInSearch → SEARCH_RESULTS
visibleInListing → PRODUCT_LISTING
visibleInCompareList → PRODUCT_COMPARE
filterable
filterable
sortable
sortable
searchable
searchable
searchWeight
searchWeight
searchTypes
searchTypes

Datentypkonvertierung

Wenn dataType int wird, prüft der Connector frontendInput. Bei anderen Datentypen hat frontendInput keine Auswirkungen auf die Konvertierung.

dataType
frontendInput
dataType
int
boolean
BOOLEAN
int
text oder select
TEXT
int
Alle anderen Werte, einschließlich eines fehlenden Werts
INTEGER
decimal
Nicht verwendet
DECIMAL
text, varchar, static, datetime
Nicht verwendet
TEXT
OBJECT
Nicht verwendet
OBJECT
Beliebiger anderer Wert
Nicht verwendet
TEXT
NOTE
Wenn ein Attribut den Datentyp OBJECT verwendet, versucht die Products-API seinen gespeicherten Wert als JSON zu analysieren. Wenn das Analysieren erfolgreich ist, gibt die API den Wert als verschachteltes -Objekt zurück. Verwenden Sie OBJECT für strukturierte Attributdaten, die nicht als einzelner Wert dargestellt werden können. Anweisungen finden Sie Produktattribute dynamisch hinzufügen.

Preisbücher

Der priceBooks-Feed sendet Daten an den Preisbuchendpunkt.

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.

Für jede Website erstellt der Connector für jede Kundengruppe ein Basispreisbuch und ein untergeordnetes Preisbuch.

Verwenden Sie diese Formeln für priceBookId:

  • Grundpreis Bücher für reguläre Preise: priceBookId = websiteCode.
  • Untergeordnete Preislisten für Kundengruppen: priceBookId = websiteCode::sha1(customerGroupId), wobei sha1(customerGroupId) der SHA-1-Hex-Auszug der Ganzzahl-ID der Kundengruppe ist.

Der Preis-Feed verwendet dieselbe Formel, um jeden Preiseintrag einem Preisbuch zuzuordnen. Informationen dazu, wie eine Storefront priceBookId für eine Kundensitzung auflöst, finden Sie unter Headless-Storefront-Integration.

Source-Feld oder -Wert
API-Feld Commerce Optimizer
Zuordnungsdetails
websiteCode
parentId
Fügt dieses Feld den untergeordneten Preisbüchern hinzu. Sein Wert gibt den Grundpreis an.
Website-Name
name
Verwendet den Namen der Website für Grundpreisbücher. Verwendet Customer group name (Website name) für Kinderpreisbücher.
websiteCode
parentId
Nur bei untergeordneten Preisbüchern vorhanden; verweist auf das Grundpreisbuch
Website-Basiswährung
currency
Enthält dieses Feld nur für Basispreise. Kinderpreisbücher lassen es aus.

Preise

Der prices-Feed sendet Adobe Commerce Daten an den Endpunkt Preise.

Eingabefeld für den Feed
API-Feld Commerce Optimizer
Zuordnungsdetails
sku
sku
Übergibt die SKU unverändert an .
websiteCode, customerGroupCode
priceBookId
Kombiniert websiteCode mit dem SHA-1-Hash der Kundengruppen-ID in customerGroupCode. Wenn customerGroupCode 0 ist, verwendet websiteCode allein.
regular
regular
Gibt den regulären Preis unverändert weiter.
discounts[]
discounts[]
Wenn der Quellwert null ist, exportiert ein leeres Array.
Für Einträge mit code auf special_price und einem percentage setzt percentage auf 100 - percentage, wenn der Wert zwischen 0 und 100 liegt. Legt fest, dass der Wert 0 oder außerhalb dieses Bereichs liegt.
Passt andere Einträge, einschließlich preisbasierter Sonderpreise, unverändert an.
tierPrices[]
tierPrices[]
Verwendet ein leeres Array, wenn der Quellwert fehlt oder null.

Kategorien

Der categories-Feed sendet Adobe Commerce Daten an den Categories-Endpunkt.

Der Connector identifiziert Kategorie-Feed-Datensätze anhand des URL-Pfads und des Speicheransichts-Codes.

  • ​
    • Wenn eine Kategorie in der Kategoriestruktur in ein anderes übergeordnetes Element verschoben wird, sendet die Synchronisierung die neuen Pfade für diese Kategorie und ihre untergeordneten Elemente und entfernt deren vorherige Pfade aus Adobe Commerce Optimizer.
  • Elemente mit einem leeren urlPath (logische Stammkategorien) werden übersprungen und nie gesendet.
Adobe Commerce
API-Feld Commerce Optimizer
Zuordnungsdetails
storeViewCode
source/locale
name
name
urlPath
slug
description
description
position
position
Exportiert die Kategorieposition, sofern vorhanden. Lässt das Feld aus, wenn es fehlt.
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

| metaKeywords | metaTags/keywords | Teilt mit Zeilenumbruch getrennte Schlüsselwörter in ein Array auf und kürzt Leerzeichen. |
| image | images[].url | Wenn image vorhanden ist, exportiert ein Bild mit der Rolle BASE. Exportiert ein leeres Array, wenn das Bild leer ist oder fehlt. |
| isActive + includeInMenu | families | Fügt top_menu nur hinzu, wenn beide Werte true sind. Andernfalls exportiert ein leeres Array. |
| attributes[] | attributes[] | Exportiert Einträge mit einer nicht leeren attributeCode als {code, values[]}. Konvertiert Werte in Zeichenfolgen. attributes ausgelassen, wenn keine geeigneten Einträge vorhanden sind. |

Related Articles
recommendation-more-help
commerce-help-aco-connector