Mappage des champs pour les flux du connecteur
Cette page décrit comment l’Adobe Commerce Optimizer Connector transforme Adobe Commerce champs du catalogue au format requis par le Catalog Data Ingestion API Commerce Optimizer. Consultez la référence du connecteur pour obtenir la liste des flux pris en charge et leurs points d’entrée d’API.
Produits
Le flux de products envoie des données au point d’entrée Products.
skuskustoreViewCodesource/localenamenameurlKeyslugproductIdexternalIds[0].idorigin fixe à "AdobeCommerce"statusstatusDISABLED pour les produits composites sans enfants affectésdescriptiondescriptionshortDescriptionshortDescriptionvisibilityvisibleInCATALOG, Search→SEARCH ; valeurs non mappées ignoréesCatalogmetaTitlemetaTags/titlemetaDescriptionmetaTags/descriptionmetaKeywordmetaTags/keywordsinStock, lowStock, weight, weightUnitattributes[].code = "aco_ac_attributes"{inStock, lowStock, weight, weightType} d’objet codé JSON ; toujours présent comme première entrée d’attributattributes[]attributes[]{code, values[], variantReferenceId} ; inStock, lowStock, weight et weightType sont exclus (ils vont dans aco_ac_attributes).images[]images[]url, label ; rôles standard mappés : image→BASE, small_image→SMALL, thumbnail→THUMBNAIL, swatch_image→SWATCH ; les rôles non standard vont dans customRoles[]categoryData[].categoryPathroutes[].pathcategoryData[].productPositionroutes[].positionlinks[].type + links[].skulinks[]type mis en majuscules ; entrées sans sku suppriméesparents[].productType + parents[].skulinks[]VARIANT_OF, bundle/bundle_fixed→IN_BUNDLEconfigurableconfigurable optionsconfigurations[]attributeCode, label ; type d’option SWATCH lorsque swatchType est défini, sinon CONFIGURABLE ; variante par défaut de isDefault ; les valeurs comprennent variantReferenceId, label, colorHex, imageUrlidbundle optionsbundles[]group; required; renderType checkbox/multi→multiSelect: true; SKU par défaut de isDefault; les éléments comprennent sku, qty, userDefinedQty (qtyMutability)labelMétadonnées des attributs de produit
Le flux de productAttributes envoie des données au point d’entrée Métadonnées.
attributeCodecodestoreViewCodesource/localelabellabeldataType + frontendInputdataTypevisiblevisibleIn: "PRODUCT_DETAIL"truevisibleInSearchvisibleIn: "SEARCH_RESULTS"truevisibleInListingvisibleIn: "PRODUCT_LISTING"truevisibleInCompareListvisibleIn: "PRODUCT_COMPARE"truefilterablefilterablesortablesortablesearchablesearchablesearchWeightsearchWeightsearchTypessearchTypesConversion du type de données
Le connecteur dérive le dataType d’API des champs dataType et frontendInput Commerce dans le tableau de mappage ci-dessus. Le tableau suivant indique les règles de conversion appliquées par le connecteur.
dataTypefrontendInputdataType de l’API Commerce OptimizerintbooleanBOOLEANinttext ou selectTEXTintINTEGERdecimalDECIMALtext, varchar, static, datetimeTEXTOBJECTOBJECTTEXTdataType d’un attribut est définie sur OBJECT, l’API products traite la valeur de l’attribut comme un objet structuré plutôt que comme une chaîne simple. Au moment de la requête, l’API tente d’analyser la valeur stockée au format JSON. Si l’analyse réussit, le résultat est renvoyé en tant qu’objet imbriqué dans la réponse. Ce comportement est particulièrement utile lorsque vous fournissez dynamiquement des attributs personnalisés, par exemple pour transporter des données structurées ou à champs multiples qui ne peuvent pas être représentées sous la forme d’une valeur scalaire. Pour obtenir des instructions, voir Ajouter dynamiquement des attributs de produit.Catalogues de prix
Le flux de priceBooks envoie des données au point d’entrée Prix des livres.
Contrairement aux autres flux du connecteur, le flux de priceBooks n’est pas collecté par un indexeur de SaaS Data Export dans Adobe Commerce. Le connecteur génère ce flux à partir de la configuration du site web et du groupe de clients dans l’Admin.
Un catalogue des prix de base est créé par site web, plus un catalogue des prix enfant par paire site web-groupe client.
Formule de l’ID du catalogue des prix :
- De base (prix réguliers) :
priceBookId = websiteCode - Enfant (groupe de clients ou catalogue partagé) :
priceBookId = websiteCode::sha1(customerGroupId)oùsha1(customerGroupId)correspond au résumé hexadécimal SHA-1 de l’ID entier du groupe de clients
Le flux de prix utilise la même formule lors de la résolution du portefeuille de prix auquel appartient une entrée de prix. Pour savoir comment les storefronts résolvent le priceBookId d’une session client, voir Intégration de storefront découplé.
websiteCode, customerGroupIdpriceBookIdname"Group Name (Website Name)"websiteCodeparentIdcurrencyPrix
Le flux de prices envoie des données au point d’entrée Prix.
skuskuwebsiteCode, customerGroupIdpriceBookIdregularregulardiscounts[]discounts[]tierPrices[]tierPrices[]Catégories
Le flux de categories envoie des données au point d’entrée Catégories.
Les éléments avec un urlPath vide (catégories racine logique) sont ignorés et ne sont jamais envoyés.
storeViewCodesource/localenamenameurlPathslugdescriptiondescriptionmetaTitlemetaTags/titlemetaDescriptionmetaTags/descriptionmetaKeywordsmetaTags/keywordsimageimages[].urlroles: ["BASE"]isActive + includeInMenufamilies["top_menu"] lorsque les deux true, [] dans le cas contraire