Configura AEM Assets per Adobe Commerce Optimizer
[Solo SaaS]{class="badge positive" title="Applicabile solo ai progetti Adobe Commerce Optimizer."}
L'integrazione di AEM Assets per Adobe Commerce Optimizer consente ai commercianti di utilizzare AEM Assets come soluzione centralizzata per la gestione delle risorse digitali per le immagini dei prodotti. Questa guida descrive la configurazione specifica di Commerce Optimizer.
A differenza di Adobe Commerce (PaaS) o Adobe Commerce as a Cloud Service (ACCS), Commerce Optimizer non dispone di un'interfaccia utente di configurazione amministratore. Per abilitare l'integrazione, creare un ticket di supporto con i dettagli di Adobe Commerce Optimizer e AEM Assets. Il supporto Adobe configura l’integrazione e registra il tenant con il servizio di integrazione Assets.
Il diagramma seguente offre una panoramica della sincronizzazione dei prodotti tra Adobe Commerce Optimizer e l'integrazione di AEM Assets.
Questa integrazione ha due flussi principali:
-
Da AEM Assets: quando una risorsa viene approvata, rifiutata o rimossa, l'evento passa attraverso la pipeline di Adobe al servizio di integrazione di Assets. Il servizio associa le risorse ai prodotti utilizzando
match-by-SKU(basato su metadati) o un programma di corrispondenza personalizzato (App Builder), quindi invia i mappingproduct-asseta Commerce Optimizer, dove vengono memorizzati come livelli di prodotto. -
DaAdobe Commerce Optimizer: quando un prodotto viene aggiornato in Commerce Optimizer, l'evento passa attraverso la pipeline di Adobe al servizio di integrazione di Assets. Il servizio sincronizza eventuali mapping di risorse corrispondenti con Adobe Commerce Optimizer.
Prerequisiti
Prima di configurare l’integrazione, assicurati di disporre di:
- Un'istanza Adobe Commerce Optimizer attiva con adesione a Product Visuals o qualsiasi licenza AEM Assets con Dynamic Media.
- Accesso a un ambiente AEM Assets as a Cloud Service.
- Sia Commerce Optimizer che AEM Assets nella stessa organizzazione Adobe IMS.
- Dynamic Media con OpenAPI abilitata nell’ambiente AEM Assets.
Onboarding
Per integrare AEM Assets con Commerce Optimizer, è necessario creare un ticket di supporto.
Il supporto Adobe utilizza le informazioni contenute nel ticket per registrare il tenant con Assets Integration Service e configurare l’integrazione.
Includi le seguenti informazioni nel ticket di supporto:
- Adobe Commerce OptimizerID tenant (ID istanza) trovato nell'URL Commerce Optimizer o nell'interfaccia utente di Commerce Cloud Manager.
- ID programma AEM.
- ID ambiente AEM.
- Regola corrispondente: corrisponde per SKU o corrispondenza esterna (App Builder).
- Livello: il nome del livello del catalogo con cui registrare il tenant. Se necessario, specifica un nome personalizzato. In caso contrario, viene utilizzato il valore predefinito
AEM-Assets. - Impostazioni locali: le impostazioni locali di origine del catalogo con cui registrare il tenant (ad esempio,
en-US).
Dopo che il supporto Adobe elabora il ticket, l’integrazione viene configurata e il tenant viene registrato con il servizio di integrazione Assets.
Una volta completato l’onboarding:
-
Registrazione con Assets Integration Service: il tenant Commerce Optimizer è registrato con Assets Integration Service utilizzando l'ID tenant Adobe Commerce Optimizer, l'ID programma AEM, l'ID ambiente AEM e il tenant.
-
Impostazione dell'autenticazione: l'autenticazione del token del servizio IMS è configurata tra Commerce Optimizer e il servizio di integrazione Assets per una comunicazione sicura.
-
Sottoscrizione evento: Assets Integration Service si abbona a:
- Eventi AEM Assets (risorsa approvata, aggiornata, rimossa)
- Commerce Optimizer eventi catalogo (prodotto creato, aggiornato)
Limitazioni
L'integrazione di Commerce Optimizer presenta le seguenti limitazioni:
- Livello singolo per commerciante: l'integrazione AEM Assets supporta un livello AEM-Assets per commerciante (un'origine per tenant). Al momento, la configurazione di più livelli per esercente non è supportata.
- Solo immagini - L'integrazione non supporta video o altri tipi di file multimediali.
- Nessuna immagine categoria - La sincronizzazione immagine categoria non è disponibile. Le immagini delle categorie da AEM Assets per il selettore Assets (inserimento nell’interfaccia utente) non sono supportate.
- Nessuna distinzione tra più siti. L'integrazione non gestisce più siti. Un'immagine associata a un prodotto viene visualizzata allo stesso modo su tutti i canali e i criteri.
- Posizione/ordinamento immagine. La posizione e l'ordinamento delle immagini non sono supportati.
- Il prodotto deve esistere. Se il prodotto non esiste in Commerce Optimizer, il livello non verrà creato per la mappatura prodotto-risorsa.
- Sovrascrittura campo livello - I valori in un livello sovrascrivono il catalogo di base. Se un campo non viene inviato nel payload del livello, può essere sovrascritto con un valore vuoto. Utilizza un livello dedicato per il contenuto di AEM Assets; il riutilizzo di un livello esistente per altri scopi può causare una perdita di dati non intenzionale.
Configurare AEM Assets
Il processo di installazione e configurazione di AEM Assets per Commerce Optimizer è lo stesso di Adobe Commerce as a Cloud Service. Consulta Configurare il progetto AEM Assets per supportare i metadati di Commerce per i passaggi completi.
Assicurati che l’ambiente AEM Assets sia pronto:
-
Configurazione di AEM Assets: configurare il profilo metadati di Commerce. Consulta Configurare un profilo di metadati.
-
Abilitazione Dynamic Media: verifica che Dynamic Media con funzionalità OpenAPI sia abilitato nell'ambiente AEM Assets.
Configurare AEM Assets
Per abilitare la sincronizzazione prodotto-risorsa, configura l’ambiente AEM Assets.
Passaggio 1: abilitare Dynamic Media con OpenAPI
Dynamic Media con OpenAPI deve essere abilitato nell’ambiente AEM Assets. Product Visuals e le nuove licenze AEM Assets consentono di abilitarlo in modo autonomo tramite Cloud Manager. Le licenze AEM Assets precedenti richiedono il supporto Adobe per abilitarlo. Consulta Configurare il progetto AEM Assets per i passaggi di abilitazione.
Passaggio 2: facoltativo. Configurare il profilo di metadati Commerce
Configura il profilo metadati in AEM Assets per memorizzare i metadati specifici di Commerce.
Per istruzioni dettagliate, consulta Configurare un profilo di metadati.
Passaggio 3: Applicare i metadati alle risorse
Aggiungi metadati Commerce alle immagini del prodotto in AEM Assets.
Consulta il contenuto del pacchetto AEM Commerce per le definizioni dei campi e Configura un profilo di metadati per i passaggi di configurazione.
La risorsa deve essere in uno stato approvato per poter attivare la sincronizzazione dati. Il salvataggio dei metadati da solo non attiva l'evento.
AEM-Assets alla vista catalogo. Se il livello non è assegnato, i dati immagine prodotto potrebbero essere sovrascritti in modo imprevisto.Ssincronizzazione
Una volta configurata, l'integrazione sincronizza automaticamente product-asset mappature.
Per ulteriori informazioni, vedere Corrispondenza automatica personalizzata.
Esempio di flusso di lavoro Corrispondenza per SKU
Un flusso tipico quando si aggiunge una risorsa esistente a un nuovo prodotto:
-
Crea il prodotto in Commerce Optimizer (tramite API o acquisizione dati). Il prodotto può esistere inizialmente senza immagini.
-
In AEM Assets, apri la risorsa da mappare sul prodotto.
-
Aggiungi lo SKU del prodotto ai metadati commerce:skus e assegna i ruoli immagine (ad esempio,
thumbnail,image). -
Approva la risorsa per la consegna. Questo attiva l’evento elaborato da Assets Integration Service.
-
Il servizio di integrazione di Assets invia la mappatura prodotto-immagine a Commerce Optimizer. Il prodotto in Commerce Optimizer è stato aggiornato con le immagini della risorsa.
-
Verifica che l’immagine sia visibile. Attendere il completamento della sincronizzazione (in genere entro pochi minuti), quindi controllare il prodotto nell'interfaccia utente Commerce Optimizer (ad esempio, Sincronizzazione dati o visualizzazione catalogo) oppure eseguire una query sulle API storefront (Catalog Service, Live Search, API Storefront GraphQL) per confermare che l'immagine è stata restituita.
Gestione ruolo immagine
Quando un prodotto dispone di più risorse che utilizzano lo stesso ruolo immagine (ad esempio, due risorse con il ruolo thumbnail), l'integrazione assicura che solo una risorsa mantenga tale ruolo per evitare ruoli duplicati nel livello Commerce Optimizer e comportamenti imprevisti nella vetrina.
Comportamento: Quando viene inviato un aggiornamento da AEM Assets, la risorsa aggiornata più di recente riceve il ruolo immagine (ad esempio, thumbnail) e il ruolo viene rimosso dalla risorsa precedente che lo aveva. Questo impedisce la visualizzazione di ruoli immagine duplicati nella vetrina.