Feldzuordnung für Connector-Feeds
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.
skuskustoreViewCodesource/localenamenameurlKeyslugproductIdexternalIds[0].idorigin auf "AdobeCommerce" festgelegtstatusstatusDISABLED gesetztdescriptiondescriptionshortDescriptionshortDescriptionvisibilityvisibleInCatalog→CATALOG, Search→SEARCH; nicht zugeordnete Werte gelöschtmetaTitlemetaTags/titlemetaDescriptionmetaTags/descriptionmetaKeywordmetaTags/keywordsinStock, lowStock, weight, weightUnitattributes[].code = "aco_ac_attributes"{inStock, lowStock, weight, weightType}; immer als erster Attributeintrag vorhandenattributes[]attributes[]{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[].categoryPathroutes[].pathcategoryData[].productPositionroutes[].positionlinks[].type + links[].skulinks[]type in Großbuchstaben; Einträge ohne sku werden gelöschtparents[].productType + parents[].skulinks[]configurable→VARIANT_OF, bundle/bundle_fixed→IN_BUNDLEconfigurable optionsconfigurations[]id→attributeCode, label; Optionstyp SWATCH, wenn swatchType festgelegt ist, andernfalls CONFIGURABLE; Standardvariante von isDefault; Werte umfassen variantReferenceId, label, colorHex, imageUrlbundle optionsbundles[]label→group; required; renderType checkbox/multi→multiSelect: true; Standard-SKUs von isDefault; Elemente umfassen sku, qty, userDefinedQty (qtyMutability)Metadaten der Produktattribute
Der productAttributes-Feed sendet Daten an den Metadaten-Endpunkt.
attributeCodecodestoreViewCodesource/localelabellabeldataType + frontendInputdataTypevisiblevisibleIn: "PRODUCT_DETAIL"true zum Array hinzugefügtvisibleInSearchvisibleIn: "SEARCH_RESULTS"true zum Array hinzugefügtvisibleInListingvisibleIn: "PRODUCT_LISTING"true zum Array hinzugefügtvisibleInCompareListvisibleIn: "PRODUCT_COMPARE"true zum Array hinzugefügtfilterablefilterablesortablesortablesearchablesearchablesearchWeightsearchWeightsearchTypessearchTypesDatentypkonvertierung
Der Connector leitet die API-dataType von den dataType- und frontendInput-Feldern in der obigen Zuordnungstabelle ab. Die folgende Tabelle zeigt die Konversionsregeln, die der Connector anwendet.
dataTypefrontendInputdataTypeintbooleanBOOLEANinttext oder selectTEXTintINTEGERdecimalDECIMALtext, varchar, static, datetimeTEXTOBJECTOBJECTTEXTdataType für ein Attribut auf OBJECT festgelegt ist, behandelt Produkt-API den Attributwert als strukturiertes Objekt und nicht als einfache Zeichenfolge. Zur Abfragezeit versucht die API, den gespeicherten Wert als JSON zu parsen. Wenn das Analysieren erfolgreich ist, wird das Ergebnis als verschachteltes -Objekt in der Antwort zurückgegeben. Dieses Verhalten ist besonders, wenn Sie benutzerdefinierte Attribute dynamisch bereitstellen, z. B. um strukturierte Daten oder Daten mit mehreren Feldern zu übertragen, die nicht als Skalarwert 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.
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), wobeisha1(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.
websiteCode, customerGroupIdpriceBookIdname"Group Name (Website Name)"websiteCodeparentIdcurrencyPreise
Der prices-Feed sendet Daten an den Endpunkt Preise.
skuskuwebsiteCode, customerGroupIdpriceBookIdregularregulardiscounts[]discounts[]tierPrices[]tierPrices[]Kategorien
Der categories-Feed sendet Daten an den Categories-Endpunkt.
Elemente mit einem leeren urlPath (logische Stammkategorien) werden übersprungen und nie gesendet.
storeViewCodesource/localenamenameurlPathslugdescriptiondescriptionmetaTitlemetaTags/titlemetaDescriptionmetaTags/descriptionmetaKeywordsmetaTags/keywordsimageimages[].urlroles: ["BASE"]isActive + includeInMenufamilies["top_menu"] wenn beide true, [] andernfalls