Mapeamento de campos para feeds de conector
Esta página documenta como o Adobe Commerce Optimizer Connector transforma campos de catálogo Adobe Commerce no formato exigido pelo Commerce Optimizer Catalog Data Ingestion API. Consulte a referência do conector para obter a lista de feeds com suporte e seus pontos de extremidade de API.
Produtos
O feed products envia dados para o ponto de extremidade de produtos.
skuskustoreViewCodesource/localenamenameurlKeyslugproductIdexternalIds[0].idorigin para "AdobeCommerce"statusstatusDISABLED se o status estiver ausente ou se um produto configurável ou agrupado não tiver valores de opção.descriptiondescriptionshortDescriptionshortDescriptionvisibilityvisibleInCatalog a CATALOG e Search a SEARCH. Descarta outros valores.metaTitlemetaTags/titlemetaDescriptionmetaTags/descriptionmetaKeywordmetaTags/keywordsinStock, lowStock, weight, weightUnitattributes[].code = "aco_ac_attributes"aco_ac_attributes como o primeiro atributo. Seu valor JSON inclui inStock e lowStock como cadeias de caracteres. Inclui weight e weightType quando esses valores estão disponíveis.attributes[]attributes[]inStock, lowStock, categories, weight e weightType. Os valores relacionados ao estoque estão incluídos em aco_ac_attributes. As categorias são exportadas como rotas.images[]images[]Exporta
url, label (vazio se ausente) e sortOrder (número inteiro, o padrão é 0).Classifica imagens por
sortOrder em ordem crescente.Mapeia funções padrão:
image para BASE, small_image para SMALL, thumbnail para THUMBNAIL e swatch_image para SWATCH. Exporta outras funções como customRoles[].categoryData[].categoryPathroutes[].pathcategoryData[].productPositionroutes[].position0 se a posição do produto estiver ausente.links[].type + links[].skulinks[]type em maiúsculas; entradas sem sku descartadasparents[].productType + parents[].skulinks[]configurable para VARIANT_OF e bundle ou bundle_fixed para IN_BUNDLE. Converte outros tipos de produto em maiúsculas. Ignora os pais sem um SKU.configurable optionsconfigurations[]Mapeia
id a attributeCode. Define type como SWATCH quando swatchType está presente, caso contrário, como CONFIGURABLE.Usa a ID do valor padrão como
defaultVariantReferenceId.Mapeia cada valor para
variantReferenceId, label, colorHex e imageUrl.bundle optionsbundles[]Usa o rótulo de opção como
group ou Bundle group se o rótulo estiver vazio. Copia required para a saída.Define
multiSelect como true para os tipos de renderização checkbox e multi.Lista as SKUs padrão em
defaultItemSkus. Cada item inclui sku, qty (o padrão é 0) e userDefinedQty (de qtyMutability, o padrão é false).Metadados de atributos do produto
O feed productAttributes envia dados para o ponto de extremidade de metadados.
attributeCodecodestoreViewCodesource/localelabellabeldataType + frontendInputdataTypedataType e frontendInputdataTypevisible, visibleInSearch, visibleInListing, visibleInCompareListvisibleIn[]true, adiciona seu valor correspondente:visible → PRODUCT_DETAILvisibleInSearch → SEARCH_RESULTSvisibleInListing → PRODUCT_LISTINGvisibleInCompareList → PRODUCT_COMPAREfilterablefilterablesortablesortablesearchablesearchablesearchWeightsearchWeightsearchTypessearchTypesConversão do tipo de dados
Quando dataType for int, o conector verificará frontendInput. Para outros tipos de dados, frontendInput não afeta a conversão.
dataTypefrontendInputdataTypeintbooleanBOOLEANinttext ou selectTEXTintINTEGERdecimalDECIMALtext, varchar, static, datetimeTEXTOBJECTOBJECTTEXTOBJECT, a API de produtos tenta analisar seu valor armazenado como JSON. Se a análise for bem-sucedida, a API retornará o valor como um objeto aninhado. Use OBJECT para dados de atributo estruturado que não podem ser representados como um valor único. Para obter instruções, consulte Adicionar atributos de produto dinamicamente.Catálogos de preços
O feed priceBooks envia dados para o ponto de extremidade de catálogos de preços.
Ao contrário dos outros feeds de conector, o feed priceBooks não é coletado por um indexador SaaS Data Export em Adobe Commerce. O conector gera esse feed a partir do site e da configuração do grupo de clientes no Administrador.
Para cada site, o conector cria um catálogo de preços base e um catálogo de preços filho para cada grupo de clientes.
Usar estas fórmulas para priceBookId:
- Catálogos de preços base para preços regulares:
priceBookId = websiteCode. - Catálogos de preços filhos para grupos de clientes:
priceBookId = websiteCode::sha1(customerGroupId), ondesha1(customerGroupId)é o resumo hexadecimal SHA-1 da ID do número inteiro do grupo de clientes.
O feed de preços usa a mesma fórmula para atribuir cada entrada de preço a um catálogo de preços. Para obter informações sobre como uma vitrine resolve priceBookId para uma sessão de cliente, consulte Integração de vitrine headless.
websiteCodeparentIdnameCustomer group name (Website name) para catálogos de preços filho.websiteCodeparentIdcurrencyPreços
O feed prices envia dados de Adobe Commerce para o ponto de extremidade de preços.
skuskuwebsiteCode, customerGroupCodepriceBookIdwebsiteCode com o hash SHA-1 da ID de grupo de clientes em customerGroupCode. Se customerGroupCode for 0, usa websiteCode sozinho.regularregulardiscounts[]discounts[]null, exporta uma matriz vazia.Para entradas com
code definido como special_price e um percentage, define percentage como 100 - percentage quando o valor está entre 0 e 100. Define como 0 nesse intervalo ou fora dele.Passa outras entradas, incluindo preços especiais com base em preços, sem alterações.
tierPrices[]tierPrices[]null.Categorias
O feed categories envia dados de Adobe Commerce para o ponto de extremidade Categorias.
Itens com um urlPath vazio (categorias de raiz lógica) são ignorados e nunca enviados.
storeViewCodesource/localenamenameurlPathslugdescriptiondescriptionpositionpositionmetaTitlemetaTags/titlemetaDescriptionmetaTags/descriptionmetaKeywordsmetaTags/keywordsimageimages[].urlroles: ["BASE"]isActive + includeInMenufamilies["top_menu"] quando ambos true, [] caso contrário|0} | metaTags/keywords | Divide as palavras-chave delimitadas por nova linha em uma matriz e elimina os espaços em branco. metaKeywords|
|0} | images[].url | Quando image está presente, exporta uma imagem com a função BASE. imageExporta uma matriz vazia quando a imagem está vazia ou ausente. |
| isActive + includeInMenu | families | Adiciona top_menu somente quando ambos os valores são true. Caso contrário, exporta uma matriz vazia. |
|0} | attributes[] | Exporta entradas com um attributeCode não vazio como {code, values[]}. attributes[]Converte valores em cadeias de caracteres. Omite attributes quando não existem entradas qualificadas. |