Mappatura dei campi per i feed del connettore
In questa pagina viene illustrato come Adobe Commerce Optimizer Connector trasforma i campi del catalogo Adobe Commerce nel formato richiesto da Commerce Optimizer Catalog Data Ingestion API. Per un elenco dei feed supportati e dei relativi endpoint API, consulta il riferimento connettore.
Prodotti
Il feed products invia dati all’endpoint Products.
skuskustoreViewCodesource/localenamenameurlKeyslugproductIdexternalIds[0].idorigin risolto in "AdobeCommerce"statusstatusDISABLED per i prodotti compositi a cui non sono assegnati elementi figliodescriptiondescriptionshortDescriptionshortDescriptionvisibilityvisibleInCatalog→CATALOG, Search→SEARCH; valori non mappati eliminatimetaTitlemetaTags/titlemetaDescriptionmetaTags/descriptionmetaKeywordmetaTags/keywordsinStock, lowStock, weight, weightUnitattributes[].code = "aco_ac_attributes"{inStock, lowStock, weight, weightType}; sempre presente come prima voce di attributoattributes[]attributes[]{code, values[], variantReferenceId}; inStock, lowStock, weight, weightType sono esclusi (entrano in aco_ac_attributes)images[]images[]url, label; ruoli standard mappati: image→BASE, small_image→SMALL, thumbnail→THUMBNAIL, swatch_image→SWATCH; ruoli non standard vanno a customRoles[]categoryData[].categoryPathroutes[].pathcategoryData[].productPositionroutes[].positionlinks[].type + links[].skulinks[]type in maiuscolo; voci senza sku eliminateparents[].productType + parents[].skulinks[]configurable→VARIANT_OF, bundle/bundle_fixed→IN_BUNDLEconfigurable optionsconfigurations[]id→attributeCode, label; tipo di opzione SWATCH quando è impostato swatchType, altrimenti CONFIGURABLE; variante predefinita da isDefault; valori inclusi variantReferenceId, label, colorHex, imageUrlbundle optionsbundles[]label→group; required; renderType checkbox/multi→multiSelect: true; SKU predefinite da isDefault; elementi inclusi sku, qty, userDefinedQty (qtyMutability)Metadati degli attributi del prodotto
Il feed productAttributes invia dati all’endpoint metadati.
attributeCodecodestoreViewCodesource/localelabellabeldataType + frontendInputdataTypevisiblevisibleIn: "PRODUCT_DETAIL"truevisibleInSearchvisibleIn: "SEARCH_RESULTS"truevisibleInListingvisibleIn: "PRODUCT_LISTING"truevisibleInCompareListvisibleIn: "PRODUCT_COMPARE"truefilterablefilterablesortablesortablesearchablesearchablesearchWeightsearchWeightsearchTypessearchTypesConversione del tipo di dati
Il connettore deriva l’API dataType dai campi Commerce dataType e frontendInput nella tabella di mappatura precedente. Nella tabella seguente sono illustrate le regole di conversione applicate dal connettore.
dataTypefrontendInputdataTypeintbooleanBOOLEANinttext o selectTEXTintINTEGERdecimalDECIMALtext, varchar, static, datetimeTEXTOBJECTOBJECTTEXTdataType per un attributo è impostato su OBJECT, l'API products tratta il valore dell'attributo come un oggetto strutturato anziché come una stringa semplice. In fase di query, l’API tenta di analizzare il valore memorizzato come JSON. Se l'analisi ha esito positivo, il risultato viene restituito come oggetto nidificato nella risposta. Questo comportamento è particolarmente utile quando si forniscono attributi personalizzati in modo dinamico, ad esempio per inserire dati strutturati o a più campi che non possono essere rappresentati come valori scalari. Per istruzioni, consulta Aggiungere dinamicamente gli attributi del prodotto.Listino prezzi
Il feed priceBooks invia dati all’endpoint Listini prezzi.
A differenza degli altri feed del connettore, il feed priceBooks non viene raccolto da un indicizzatore SaaS Data Export in Adobe Commerce. Il connettore genera questo feed dal sito web e dalla configurazione del gruppo di clienti in Admin.
Viene creato un listino prezzi di base per sito Web, più un listino prezzi figlio per coppia sito-gruppo clienti.
Formula ID registro prezzi:
- Base (prezzi regolari):
priceBookId = websiteCode - Secondario (gruppo clienti o catalogo condiviso):
priceBookId = websiteCode::sha1(customerGroupId)dovesha1(customerGroupId)è il digest esadecimale SHA-1 dell’ID intero del gruppo clienti
Il feed dei prezzi utilizza la stessa formula per la risoluzione del listino prezzi a cui appartiene una voce di prezzo. Per informazioni sulla risoluzione di priceBookId per una sessione del cliente, vedere Integrazione della vetrina headless.
websiteCode, customerGroupIdpriceBookIdname"Group Name (Website Name)"websiteCodeparentIdcurrencyPrezzi
Il feed prices invia i dati all’endpoint Price.
skuskuwebsiteCode, customerGroupIdpriceBookIdregularregulardiscounts[]discounts[]tierPrices[]tierPrices[]Categorie
Il feed categories invia dati all’endpoint Categories.
Gli elementi con un urlPath vuoto (categorie radice logiche) vengono ignorati e non vengono mai inviati.
storeViewCodesource/localenamenameurlPathslugdescriptiondescriptionmetaTitlemetaTags/titlemetaDescriptionmetaTags/descriptionmetaKeywordsmetaTags/keywordsimageimages[].urlroles: ["BASE"]isActive + includeInMenufamilies["top_menu"] quando true, [] altrimenti