Asignación de campos para fuentes de conector
Esta página documenta cómo Adobe Commerce Optimizer Connector transforma los campos del catálogo Adobe Commerce en el formato requerido por Commerce Optimizer Catalog Data Ingestion API. Consulte la referencia de conector para ver la lista de fuentes admitidas y sus extremos de API.
Productos
La fuente products envía datos al extremo Products.
skuskustoreViewCodesource/localenamenameurlKeyslugproductIdexternalIds[0].idorigin se corrigió a "AdobeCommerce"statusstatusDISABLED para productos compuestos sin elementos secundarios asignadosdescriptiondescriptionshortDescriptionshortDescriptionvisibilityvisibleInCatalog→CATALOG, Search→SEARCH; valores no asignados quitadosmetaTitlemetaTags/titlemetaDescriptionmetaTags/descriptionmetaKeywordmetaTags/keywordsinStock, lowStock, weight, weightUnitattributes[].code = "aco_ac_attributes"{inStock, lowStock, weight, weightType}; siempre presente como la primera entrada de atributoattributes[]attributes[]{code, values[], variantReferenceId}; inStock, lowStock, weight, weightType (van a aco_ac_attributes)images[]images[]url, label; funciones estándar asignadas: image→BASE, small_image→SMALL, thumbnail→THUMBNAIL, swatch_image→SWATCH; las funciones no estándar van a customRoles[]categoryData[].categoryPathroutes[].pathcategoryData[].productPositionroutes[].positionlinks[].type + links[].skulinks[]type en mayúscula; se perdieron las entradas sin skuparents[].productType + parents[].skulinks[]configurable→VARIANT_OF, bundle/bundle_fixed→IN_BUNDLEconfigurable optionsconfigurations[]id→attributeCode, label; tipo de opción SWATCH cuando swatchType está establecido; de lo contrario, CONFIGURABLE; variante predeterminada de isDefault; los valores incluyen variantReferenceId, label, colorHex, imageUrlbundle optionsbundles[]label→group; required; renderType checkbox/multi→multiSelect: true; SKU predeterminadas de isDefault; los elementos incluyen sku, qty, userDefinedQty (qtyMutability)Metadatos de atributos de producto
La fuente productAttributes envía datos a extremo de metadatos.
attributeCodecodestoreViewCodesource/localelabellabeldataType + frontendInputdataTypevisiblevisibleIn: "PRODUCT_DETAIL"truevisibleInSearchvisibleIn: "SEARCH_RESULTS"truevisibleInListingvisibleIn: "PRODUCT_LISTING"truevisibleInCompareListvisibleIn: "PRODUCT_COMPARE"truefilterablefilterablesortablesortablesearchablesearchablesearchWeightsearchWeightsearchTypessearchTypesConversión de tipo de datos
El conector deriva la API dataType de los campos Commerce dataType y frontendInput de la tabla de asignación anterior. La siguiente tabla muestra las reglas de conversión que aplica el conector.
dataTypefrontendInputdataTypeintbooleanBOOLEANinttext o selectTEXTintINTEGERdecimalDECIMALtext, varchar, static, datetimeTEXTOBJECTOBJECTTEXTdataType de un atributo se establece en OBJECT, la API de productos trata el valor del atributo como un objeto estructurado en lugar de como una cadena sin formato. En el momento de la consulta, la API intenta analizar el valor almacenado como JSON. Si el análisis se realiza correctamente, el resultado se devuelve como un objeto anidado en la respuesta. Este comportamiento es especialmente útil cuando se proporcionan atributos personalizados de forma dinámica, por ejemplo, para transportar datos estructurados o de varios campos que no se pueden representar como un valor escalar. Para obtener instrucciones, consulte Agregar atributos de producto dinámicamente.Libros de precios
La fuente priceBooks envía datos al extremo de libros de precios.
A diferencia de otras fuentes de conector, la fuente priceBooks no la recopila un indizador SaaS Data Export en Adobe Commerce. El conector genera esta fuente a partir del sitio web y la configuración del grupo de clientes en el Administrador.
Se crea un libro de precios base por sitio web, más un libro de precios secundario por par de grupo de sitio web-cliente.
Fórmula de id. de libro de precios:
- Base (precios normales):
priceBookId = websiteCode - Secundario (grupo de clientes o catálogo compartido):
priceBookId = websiteCode::sha1(customerGroupId)dondesha1(customerGroupId)es el resumen hexadecimal SHA-1 del identificador entero del grupo de clientes
La fuente de precios utiliza la misma fórmula al resolver a qué libro de precios pertenece una entrada de precio. Para saber cómo resuelven las tiendas el(la) priceBookId de una sesión de cliente, consulte Integración de tiendas sin encabezado.
websiteCode, customerGroupIdpriceBookIdname"Group Name (Website Name)"websiteCodeparentIdcurrencyPrecios
La fuente prices envía datos al extremo Prices.
skuskuwebsiteCode, customerGroupIdpriceBookIdregularregulardiscounts[]discounts[]tierPrices[]tierPrices[]Categorías
La fuente categories envía datos al extremo Categories.
Los elementos con un urlPath vacío (categorías raíz lógicas) se omiten y nunca se envían.
storeViewCodesource/localenamenameurlPathslugdescriptiondescriptionmetaTitlemetaTags/titlemetaDescriptionmetaTags/descriptionmetaKeywordsmetaTags/keywordsimageimages[].urlroles: ["BASE"]isActive + includeInMenufamilies["top_menu"] cuando ambos true, [] en caso contrario