DocumentazioneCommerceOptimizer Connector

[Solo PaaS]{class="badge informative" title="Applicabile solo ai progetti Adobe Commerce on Cloud (infrastruttura PaaS gestita da Adobe) e ai progetti on-premise."}

Mappatura dei campi per i feed del connettore

Ultimo aggiornamento: 3 ottobre 2026

Creato per:

  • Intermedio
  • Amministratore
  • Sviluppatore

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.

Campo Adobe Commerce
Campo API Commerce Optimizer
Dettagli mappatura
sku
sku
storeViewCode
source/locale
name
name
urlKey
slug
productId
externalIds[0].id
Imposta origin su "AdobeCommerce"
status
status
Converte lo stato in maiuscolo. Usa DISABLED se lo stato è mancante o se un prodotto configurabile o bundle non ha valori di opzione.
description
description
Se manca la descrizione, utilizza una stringa vuota.
shortDescription
shortDescription
Se manca la descrizione breve, utilizza una stringa vuota.
visibility
visibleIn
Divide il valore separato da virgole e mappa Catalog in CATALOG e Search in SEARCH. Elimina altri valori.
metaTitle
metaTags/title
metaDescription
metaTags/description
metaKeyword
metaTags/keywords
Divide le parole chiave separate da una nuova riga in un array e taglia gli spazi vuoti.
inStock, lowStock, weight, weightUnit
attributes[].code = "aco_ac_attributes"
Aggiunge sempre una voce aco_ac_attributes come primo attributo. Il valore JSON include inStock e lowStock come stringhe. Include weight e weightType quando tali valori sono disponibili.
attributes[]
attributes[]
Mappa ciascuna voce al relativo codice attributo, ai valori stringa e all’ID di riferimento della variante corrispondente, se disponibile. Ignora inStock, lowStock, categories, weight e weightType. I valori relativi all’inventario sono inclusi in aco_ac_attributes. Le categorie vengono esportate come cicli di lavorazione.
images[]
images[]
Ignora le immagini senza un URL.
Esporta url, label (vuoto se mancante) e sortOrder (numero intero, predefinito 0).
Ordina le immagini per sortOrder in ordine crescente.
Esegue il mapping dei ruoli standard: image a BASE, small_image a SMALL, thumbnail a THUMBNAIL e swatch_image a SWATCH. Esporta altri ruoli come customRoles[].
categoryData[].categoryPath
routes[].path
Ignora le voci con un percorso di categoria vuoto.
categoryData[].productPosition
routes[].position
Usa 0 se manca la posizione del prodotto.
links[].type + links[].sku
links[]
type in maiuscolo; voci senza sku eliminate
parents[].productType + parents[].sku
links[]
Esegue il mapping di configurable a VARIANT_OF e di bundle o bundle_fixed a IN_BUNDLE. Converte altri tipi di prodotto in maiuscolo. Ignora i genitori senza SKU.
configurable options
configurations[]
Esporta le opzioni che hanno un ID e almeno un valore.
Associa id a attributeCode. Imposta type su SWATCH quando swatchType è presente, e su CONFIGURABLE in caso contrario.
Utilizza l’ID del valore predefinito come defaultVariantReferenceId.
Mappa ogni valore su variantReferenceId, label, colorHex e imageUrl.
bundle options
bundles[]
Esporta le opzioni che contengono almeno un elemento.
Utilizza l’etichetta dell’opzione come group oppure Bundle group se l’etichetta è vuota. Copia required nell’output.
Imposta multiSelect su true per i tipi di rendering checkbox e multi.
Elenca gli SKU predefiniti in defaultItemSkus. Ogni elemento include sku, qty (impostazione predefinita: 0) e userDefinedQty (da qtyMutability, impostazione predefinita: false).

Metadati degli attributi del prodotto

Il feed productAttributes invia dati all’endpoint metadati.

Campo Adobe Commerce
Campo API Commerce Optimizer
Dettagli mappatura
attributeCode
code
storeViewCode
source/locale
label
label
dataType + frontendInput
dataType
Vedi la tabella di conversione seguente
dataType e frontendInput
dataType
Utilizza le regole di conversione seguenti.
visible, visibleInSearch, visibleInListing, visibleInCompareList
visibleIn[]
Quando un flag è true, aggiunge il valore corrispondente:
visible → PRODUCT_DETAIL
visibleInSearch → SEARCH_RESULTS
visibleInListing → PRODUCT_LISTING
visibleInCompareList → PRODUCT_COMPARE
filterable
filterable
sortable
sortable
searchable
searchable
searchWeight
searchWeight
searchTypes
searchTypes

Conversione del tipo di dati

Quando dataType è int, il connettore controlla frontendInput. Per altri tipi di dati, frontendInput non influisce sulla conversione.

Input dataType
Input frontendInput
Output dataType
int
boolean
BOOLEAN
int
text o select
TEXT
int
Qualsiasi altro valore, incluso un valore mancante
INTEGER
decimal
Non utilizzato
DECIMAL
text, varchar, static, datetime
Non utilizzato
TEXT
OBJECT
Non utilizzato
OBJECT
Qualsiasi altro valore
Non utilizzato
TEXT
NOTE
Quando un attributo utilizza il tipo di dati OBJECT, l'API Products tenta di analizzare il valore memorizzato come JSON. Se l’analisi riesce, l’API restituisce il valore come oggetto nidificato. Utilizzare OBJECT per dati di attributi strutturati che non possono essere rappresentati come un singolo valore. 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.

Per ogni sito web, il connettore crea un listino prezzi base e un listino prezzi dedicato figlio per ogni gruppo di clienti.

Usa queste formule per priceBookId:

  • Libretti prezzi base per prezzi regolari: priceBookId = websiteCode.
  • Listini prezzi figlio per gruppi di clienti: priceBookId = websiteCode::sha1(customerGroupId), dove sha1(customerGroupId) è il digest esadecimale SHA-1 dell’ID intero del gruppo di clienti.

Il feed prezzi utilizza la stessa formula per assegnare ogni voce di prezzo a un listino prezzi dedicato. Per informazioni sulla risoluzione di priceBookId da parte di una vetrina per una sessione del cliente, vedi Integrazione della vetrina headless.

Campo o valore Source
Campo API Commerce Optimizer
Dettagli mappatura
websiteCode
parentId
Aggiunge questo campo ai listini prezzi figlio. Il valore identifica il listino prezzi base.
Nome del sito web
name
Utilizza il nome del sito Web per i listini prezzi base. Usa Customer group name (Website name) per i listini prezzi figli.
websiteCode
parentId
Presente solo sui libri prezzi per bambini; punta al listino prezzi base
Valuta di base sito Web
currency
Include questo campo solo nei listini prezzi base. I libri dei prezzi per bambini lo omettono.

Prezzi

Il feed prices invia Adobe Commerce dati all’endpoint Price.

Campo di input feed
Campo API Commerce Optimizer
Dettagli mappatura
sku
sku
Passa lo SKU senza modificarlo.
websiteCode, customerGroupCode
priceBookId
Combina websiteCode con l’hash SHA-1 dell’ID gruppo cliente in customerGroupCode. Se customerGroupCode è 0, usa solo websiteCode.
regular
regular
Trasmette il prezzo regolare senza modifiche.
discounts[]
discounts[]
Se il valore di origine è null, esporta un array vuoto.
Per le voci con code impostato su special_price e un percentage, imposta percentage su 100 - percentage quando il valore è compreso tra 0 e 100. Imposta su 0 all’interno o all’esterno dell’intervallo.
Le altre voci, inclusi i prezzi speciali basati sui prezzi, vengono passate senza modifiche.
tierPrices[]
tierPrices[]
Utilizza un array vuoto se manca il valore di origine o null.

Categorie

Il feed categories invia Adobe Commerce dati all’endpoint Categories.

Gli elementi con un urlPath vuoto (categorie radice logiche) vengono ignorati e non vengono mai inviati.

Campo Adobe Commerce
Campo API Commerce Optimizer
Dettagli mappatura
storeViewCode
source/locale
name
name
urlPath
slug
description
description
position
position
Esporta la posizione della categoria quando presente. Omette il campo quando manca.
metaTitle
metaTags/title
metaDescription
metaTags/description
metaKeywords
metaTags/keywords
Stringa delimitata da nuova riga divisa in matrice
image
images[].url
Matrice a elemento singolo; roles: ["BASE"]
isActive + includeInMenu
families
["top_menu"] quando true, [] altrimenti

| metaKeywords | metaTags/keywords | Divide le parole chiave delimitate da una nuova riga in un array e taglia gli spazi vuoti. |
| image | images[].url | Se è presente image, esporta un’immagine con la mansione BASE. Esporta una matrice vuota quando l’immagine è vuota o mancante. |
| isActive + includeInMenu | families | Aggiunge top_menu solo quando entrambi i valori sono true. In caso contrario, esporta un array vuoto. |
| attributes[] | attributes[] | Esporta le voci con attributeCode non vuoto come {code, values[]}. Converte i valori in stringhe. Omette attributes quando non esistono voci idonee. |

Related Articles
recommendation-more-help
commerce-help-aco-connector