Documentation Commerce Optimizer Connector

[PaaS uniquement]{class="badge informative" title="S’applique uniquement aux projets Adobe Commerce on Cloud (infrastructure PaaS gérée par Adobe) et aux projets On-premise."}

Mappage des champs pour les flux du connecteur

Dernière mise à jour : 9 octobre 2026

Rubriques :
Point de vente digital
Configuration
Outils et espace de travail des administrateurs
Intégrations
Integration

Créé pour :

Intermédiaire
Administrateur ou administratrice
Développeur

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.

champ Adobe Commerce

Champ API Commerce Optimizer

Détails du mappage

sku

storeViewCode

source/locale

name

urlKey

slug

productId

externalIds[0].id

Définit origin sur "AdobeCommerce"

status

Convertit le statut en majuscules. Utilise DISABLED si le statut est manquant ou si un produit configurable ou groupé ne comporte aucune valeur d’option.

description

Utilise une chaîne vide si la description est manquante.

shortDescription

Utilise une chaîne vide si la description courte est manquante.

visibility

visibleIn

Divise la valeur séparée par des virgules et mappe les Catalog à CATALOG et les Search à SEARCH. Ignore les autres valeurs.

metaTitle

metaTags/title

metaDescription

metaTags/description

metaKeyword

metaTags/keywords

Divise les mots-clés séparés par une nouvelle ligne en un tableau et supprime les espaces.

inStock, lowStock, weight, weightUnit

attributes[].code = "aco_ac_attributes"

Ajoute toujours une entrée aco_ac_attributes comme premier attribut. Sa valeur JSON inclut des inStock et des lowStock sous forme de chaînes. Cela inclut les weight et les weightType lorsque ces valeurs sont disponibles.

attributes[]

Mappe chaque entrée à son code d’attribut, à ses valeurs de chaîne et à l’identifiant de référence de variante correspondant, le cas échéant. Ignore inStock, lowStock, categories, weight et weightType. Les valeurs liées au stock sont incluses dans aco_ac_attributes. Les catégories sont exportées sous forme d’itinéraires.

images[]

Ignore les images sans URL.
Exporte les url, les label (vides si manquants) et les sortOrder (entiers, par défaut 0).
Trie les images par sortOrder dans l’ordre croissant.
Mappe les rôles standard : image à BASE, small_image à SMALL, thumbnail à THUMBNAIL et swatch_image à SWATCH. Exporte les autres rôles en tant que customRoles[].

categoryData[].categoryPath

routes[].path

Ignore les entrées dont le chemin d’accès à la catégorie est vide.

categoryData[].productPosition

routes[].position

Utilise 0 si la position du produit est manquante.

links[].type + links[].sku

links[]

type mis en majuscules ; entrées sans sku supprimées

parents[].productType + parents[].sku

links[]

Mappe les configurable à VARIANT_OF et les bundle ou bundle_fixed à IN_BUNDLE. Convertit d’autres types de produits en majuscules. Ignore les parents sans SKU.

configurable options

configurations[]

Exporte les options qui ont un identifiant et au moins une valeur.
Mappe les id aux attributeCode. Définit type sur SWATCH en cas de swatchType et sur CONFIGURABLE dans le cas contraire.
Utilise l’identifiant de la valeur par défaut en tant que defaultVariantReferenceId.
Mappe chaque valeur sur variantReferenceId, label, colorHex et imageUrl.

bundle options

bundles[]

Exporte les options contenant au moins un élément.
Utilise le libellé de l’option comme group ou Bundle group si le libellé est vide. Copie le required vers la sortie.
Définit multiSelect sur true pour les types de rendu checkbox et multi.
Répertorie les SKU par défaut dans defaultItemSkus. Chaque élément comprend sku, qty (par défaut 0) et userDefinedQty (de qtyMutability, par défaut false).

Métadonnées des attributs de produit

Le flux de productAttributes envoie des données au point d’entrée Métadonnées.

champ Adobe Commerce

Champ API Commerce Optimizer

Détails du mappage

attributeCode

code

storeViewCode

source/locale

label

dataType + frontendInput

dataType

Voir le tableau de conversion ci-dessous

dataType et frontendInput

dataType

Utilise les règles de conversion ci-dessous.

visible, visibleInSearch, visibleInListing, visibleInCompareList

visibleIn[]

Lorsqu’un indicateur est true, ajoute sa valeur correspondante :
visible → PRODUCT_DETAIL
visibleInSearch → SEARCH_RESULTS
visibleInListing → PRODUCT_LISTING
visibleInCompareList → PRODUCT_COMPARE

filterable

sortable

searchable

searchWeight

searchTypes

Conversion du type de données

Lorsqu’dataType est int, le connecteur vérifie les frontendInput. Pour les autres types de données, frontendInput n’affecte pas la conversion.

dataType d’entrée

frontendInput d’entrée

dataType de sortie

int

boolean

BOOLEAN

int

text ou select

TEXT

int

Toute autre valeur, y compris une valeur manquante

INTEGER

decimal

Non utilisé

DECIMAL

text, varchar, static, datetime

Non utilisé

TEXT

OBJECT

Non utilisé

OBJECT

Toute autre valeur

Non utilisé

TEXT

NOTE

Lorsqu’un attribut utilise le type de données OBJECT, l’API Products tente d’analyser sa valeur stockée au format JSON. Si l’analyse réussit, l’API renvoie la valeur sous la forme d’un objet imbriqué. Utilisez des OBJECT pour les données d’attribut structurées qui ne peuvent pas être représentées comme une valeur unique. 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.

Pour chaque site web, le connecteur crée un catalogue des prix de base et un catalogue des prix enfant pour chaque groupe de clients.

Utilisez ces formules pour les priceBookId :

Livres de prix de base pour les prix réguliers : priceBookId = websiteCode.
Annuaires de prix enfants pour les groupes de clients : 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 des prix utilise la même formule pour affecter chaque entrée de prix à un catalogue des prix. Pour plus d’informations sur la façon dont un storefront résout les priceBookId pour une session client, voir Intégration de storefront découplé.

Champ ou valeur Source

Champ API Commerce Optimizer

Détails du mappage

websiteCode

parentId

Ajoute ce champ aux tarifs enfant. Sa valeur identifie le prix comptable de base.

Nom du site web

name

Utilise le nom du site Web pour les livres de prix de base. Utilise des Customer group name (Website name) pour les livres de prix enfant.

websiteCode

parentId

Présent uniquement sur les livres de prix enfant ; pointe vers le livre de prix de base

Devise de base du site Web

currency

Inclut ce champ uniquement dans les registres de prix de base. Les livres sur le prix des enfants l’omettent.

Prix

Le flux de prices envoie Adobe Commerce données au point d’entrée Prix.

Champ de saisie du flux

Champ API Commerce Optimizer

Détails du mappage

sku

Transmet le SKU sans le modifier.

websiteCode, customerGroupCode

priceBookId

Combine websiteCode avec le hachage SHA-1 de l’ID de groupe client dans customerGroupCode. Si customerGroupCode est 0, utilise websiteCode seul.

regular

Fait passer le prix normal inchangé.

discounts[]

Si la valeur source est null, exporte un tableau vide.
Pour les entrées dont code est défini sur special_price et un percentage, définit percentage sur 100 - percentage lorsque la valeur est comprise entre 0 et 100. Définit cette valeur sur 0 à cette plage ou en dehors.
Transmet les autres entrées, y compris les prix spéciaux basés sur les prix, par inchangé.

tierPrices[]

Utilise un tableau vide si la valeur source est manquante ou null.

Catégories

Le flux de categories envoie Adobe Commerce 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.

champ Adobe Commerce

Champ API Commerce Optimizer

Détails du mappage

storeViewCode

source/locale

name

urlPath

slug

description

position

Exporte la position de la catégorie, le cas échéant. Omet le champ lorsqu’il est manquant.

metaTitle

metaTags/title

metaDescription

metaTags/description

metaKeywords

metaTags/keywords

Chaîne délimitée par une nouvelle ligne divisée en tableau

image

images[].url

Tableau à un seul élément ; roles: ["BASE"]

isActive + includeInMenu

families

["top_menu"] lorsque les deux true, [] dans le cas contraire

| metaKeywords | metaTags/keywords | Divise les mots-clés délimités par une nouvelle ligne en un tableau et supprime les espaces. |
| image | images[].url | Lorsqu’image est présent, exporte une image avec le rôle BASE. Exporte un tableau vide lorsque l’image est vide ou manquante. |
| isActive + includeInMenu | families | Ajoute des top_menu uniquement lorsque les deux valeurs sont true. Sinon, exporte un tableau vide. |
| attributes[] | attributes[] | Exporte les entrées dont le attributeCode n’est pas vide en tant que {code, values[]}. Convertit les valeurs en chaînes. Omet attributes lorsqu’il n’existe aucune entrée éligible. |

recommendation-more-help

commerce-help-aco-connector