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 en "AdobeCommerce"statusstatusDISABLED si falta el estado o si un producto configurable o agrupado no tiene valores de opción.descriptiondescriptionshortDescriptionshortDescriptionvisibilityvisibleInCatalog a CATALOG y Search a SEARCH. Elimina otros valores.metaTitlemetaTags/titlemetaDescriptionmetaTags/descriptionmetaKeywordmetaTags/keywordsinStock, lowStock, weight, weightUnitattributes[].code = "aco_ac_attributes"aco_ac_attributes como primer atributo. Su valor JSON incluye inStock y lowStock como cadenas. Incluye weight y weightType cuando esos valores están disponibles.attributes[]attributes[]inStock, lowStock, categories, weight y weightType. Los valores de inventario se incluyen en aco_ac_attributes. Las categorías se exportan como rutas.images[]images[]Exporta
url, label (vacío si falta) y sortOrder (entero, valor predeterminado 0).Ordena las imágenes por
sortOrder en orden ascendente.Asigna roles estándar:
image a BASE, small_image a SMALL, thumbnail a THUMBNAIL y swatch_image a SWATCH. Exporta otros roles como customRoles[].categoryData[].categoryPathroutes[].pathcategoryData[].productPositionroutes[].position0 si falta la posición del producto.links[].type + links[].skulinks[]type en mayúscula; se perdieron las entradas sin skuparents[].productType + parents[].skulinks[]configurable a VARIANT_OF, y a bundle o bundle_fixed a IN_BUNDLE. Convierte otros tipos de productos a mayúsculas. Omite elementos principales sin SKU.configurable optionsconfigurations[]Asigna
id a attributeCode. Establece type en SWATCH cuando swatchType está presente y en CONFIGURABLE en caso contrario.Utiliza el identificador del valor predeterminado como
defaultVariantReferenceId.Asigna cada valor a
variantReferenceId, label, colorHex y imageUrl.bundle optionsbundles[]Utiliza la etiqueta de opción como
group o Bundle group si la etiqueta está vacía. Copia required en el resultado.Establece
multiSelect en true para los tipos de procesamiento checkbox y multi.Muestra los SKU predeterminados en
defaultItemSkus. Cada elemento incluye sku, qty (el valor predeterminado es 0) y userDefinedQty (de qtyMutability, el valor predeterminado es false).Metadatos de atributos de producto
La fuente productAttributes envía datos a extremo de metadatos.
attributeCodecodestoreViewCodesource/localelabellabeldataType + frontendInputdataTypedataType y frontendInputdataTypevisible, visibleInSearch, visibleInListing, visibleInCompareListvisibleIn[]true, agrega su valor correspondiente:visible → PRODUCT_DETAILvisibleInSearch → SEARCH_RESULTSvisibleInListing → PRODUCT_LISTINGvisibleInCompareList → PRODUCT_COMPAREfilterablefilterablesortablesortablesearchablesearchablesearchWeightsearchWeightsearchTypessearchTypesConversión de tipo de datos
Cuando dataType es int, el conector comprueba frontendInput. Para otros tipos de datos, frontendInput no afecta a la conversión.
dataTypefrontendInputdataTypeintbooleanBOOLEANinttext o selectTEXTintINTEGERdecimalDECIMALtext, varchar, static, datetimeTEXTOBJECTOBJECTTEXTOBJECT, la API de productos intenta analizar su valor almacenado como JSON. Si el análisis se realiza correctamente, la API devuelve el valor como un objeto anidado. Use OBJECT para datos de atributos estructurados que no se puedan representar como un valor único. 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.
Para cada sitio web, el conector crea un libro de precios base y un libro de precios secundario para cada grupo de clientes.
Usar estas fórmulas para priceBookId:
- Libros de precios base para precios regulares:
priceBookId = websiteCode. - Libros de precios secundarios para grupos de clientes:
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 para asignar cada entrada de precio a un libro de precios. Para obtener información sobre cómo resuelve una tienda priceBookId para una sesión de cliente, consulte Integración de tienda sin encabezado.
websiteCodeparentIdnameCustomer group name (Website name) para los libros de precios secundarios.websiteCodeparentIdcurrencyPrecios
La fuente prices envía datos de Adobe Commerce al extremo Prices.
skuskuwebsiteCode, customerGroupCodepriceBookIdwebsiteCode con el hash SHA-1 del identificador del grupo de clientes en customerGroupCode. Si customerGroupCode es 0, solo usa websiteCode.regularregulardiscounts[]discounts[]null, exporta una matriz vacía.Para las entradas con
code establecido en special_price y un percentage, establece percentage en 100 - percentage cuando el valor está entre 0 y 100. Lo establece en 0 dentro o fuera de ese intervalo.Pasa sin cambios otras entradas, incluidos los precios especiales basados en precios.
tierPrices[]tierPrices[]null.Categorías
La fuente categories envía datos de Adobe Commerce al extremo Categories.
Los elementos con un urlPath vacío (categorías raíz lógicas) se omiten y nunca se envían.
storeViewCodesource/localenamenameurlPathslugdescriptiondescriptionpositionpositionmetaTitlemetaTags/titlemetaDescriptionmetaTags/descriptionmetaKeywordsmetaTags/keywordsimageimages[].urlroles: ["BASE"]isActive + includeInMenufamilies["top_menu"] cuando ambos true, [] en caso contrario| metaKeywords | metaTags/keywords | Divide las palabras clave delimitadas por una nueva línea en una matriz y recorta el espacio en blanco. |
| image | images[].url | Cuando image está presente, exporta una imagen con el rol BASE. Exporta una matriz vacía cuando la imagen está vacía o falta. |
| isActive + includeInMenu | families | Agrega top_menu solo cuando ambos valores son true. De lo contrario, exporta una matriz vacía. |
| attributes[] | attributes[] | Exporta entradas con un attributeCode no vacío como {code, values[]}. Convierte los valores en cadenas. Omite attributes cuando no existen entradas aptas. |