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.
Prepara AEM Assets prima di inviare il ticket. La registrazione del tenant presuppone che il lato AEM sia utilizzabile per Commerce. Ad esempio, dopo aver distribuito il pacchetto AEM Commerce assets-commerce in modo che i metadati e gli eventi funzionino come descritto. L’apertura di un ticket prima della configurazione di AEM può ritardare l’onboarding.
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 abilitato nell’ambiente AEM Assets (consulta Configurare il progetto AEM Assets per i passaggi di abilitazione).
Configurare prima AEM Assets
Completa i passaggi di AEM Assets prima di aprire un ticket di supporto per la registrazione del tenant. Il modello di installazione corrisponde a Adobe Commerce as a Cloud Service. Vedere Configurare il progetto AEM Assets per il supporto dei metadati di Commerce.
Passaggio 1: distribuire il pacchetto AEM Commerce
Installa e distribuisci il pacchetto assets-commerce nel progetto AEM in modo che siano disponibili schemi di metadati, eventi e interfaccia utente di Commerce.
Completare la procedura completa in Installare il pacchetto assets-commerce. Prima di aprire un ticket di supporto, effettua le seguenti operazioni:
-
Clona l’archivio Git di Cloud Manager e copia il codice dell’archivio Commerce di AEM Assets nel progetto.
-
In tutti i file
filter.xmlepom.xmldel progetto, sostituisci tutte le occorrenze di <my-app> con il nome dell’app. -
Eseguire il commit, il push, l’esecuzione della pipeline di distribuzione e verificare che la scheda Commerce sia visualizzata nelle proprietà della risorsa.
Consulta Installare il pacchetto assets-commerce per le schermate di Cloud Manager, i passaggi della pipeline e la risoluzione dei problemi se manca la scheda Commerce.
Passaggio 2: abilitare Dynamic Media con OpenAPI
Dynamic Media con funzionalità OpenAPI deve essere abilitato nell’ambiente AEM Assets. I percorsi self-service (ad esempio Cloud Manager per i visualizzatori di prodotto) e le route di supporto Adobe sono descritti in Configura il progetto AEM Assets.
Passaggio 3: applicare i metadati di Commerce e approvare le risorse
Aggiungi metadati Commerce alle immagini del prodotto in AEM Assets. Per le definizioni dei campi, vedi Contenuto del pacchetto AEM Commerce.
La risorsa deve essere in uno stato approvato per poter attivare la sincronizzazione dati. Il salvataggio dei metadati da solo non attiva l’evento.
Passaggio 4: facoltativo — configurare un profilo di metadati Commerce
Se scegli di utilizzare i profili di metadati di AEM per semplificare l’authoring, configurali dopo che il pacchetto viene distribuito e il tuo team comprende i campi Commerce obbligatori; lo stesso pattern facoltativo di Configurare il progetto AEM Assets.
Consulta Configurare un profilo di metadati.
Limitazioni
L’integrazione di Commerce Optimizer presenta le seguenti limitazioni:
Vincoli relativi ai livelli
Leggi questa sezione prima di scegliere un nome di livello catalogo nel ticket di supporto. La scelta o la condivisione di livelli senza questo contesto è una causa frequente di casi di supporto prevenibili.
Utilizza un livello dedicato per il contenuto di AEM Assets. I payload inviati da AEM Assets popolano un catalogo Commerce Optimizer layer. I valori in tale livello sovrascrivono gli attributi del catalogo di base in cui vengono forniti i campi. Quando l’integrazione omette un campo nel payload, i valori corrispondenti in quel livello possono essere sovrascritti con valori vuoti. La condivisione di un livello con flussi di lavoro Commerce non correlati, o il riutilizzo di un livello che già memorizza dati di prodotto non AEM-Assets, può causare perdita di dati non intenzionale o sovrascritture confuse. Pianifica la scelta del livello prima di aprire il ticket di supporto e riservane il nome (ad esempio AEM-Assets predefinito) principalmente per la sincronizzazione delle immagini del prodotto basata su AEM.
Altri vincoli
- Solo immagini: l’integrazione non supporta video o altri tipi di file multimediali in questa fase.
- 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 viene creato per la mappatura prodotto-risorsa.
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.
Prima di inviare il ticket, assicurati di aver completato la configurazione di AEM Assets.
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 (vedi Vincoli relativi ai livelli). Specificare un nome personalizzato solo se intenzionale. In caso contrario, verrà utilizzato il nome predefinito
AEM-Assets. - Impostazioni locali: le impostazioni locali di origine del catalogo con cui registrare il tenant (ad esempio,
en-US). Deve corrispondere alle impostazioni internazionali utilizzate nella vista catalogo e nei dati del catalogo prodotti.
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, la regola corrispondente, le impostazioni locali e il nome del livello forniti nel ticket.
-
Sottoscrizione evento: Assets Integration Service si abbona a:
- Eventi AEM Assets (risorsa approvata, aggiornata, rimossa)
- Commerce Optimizer eventi catalogo (prodotto creato, aggiornato)
Configura la vista catalogo in modo che in vetrina e nelle API vengano visualizzati i dati immagine basati su AEM:
- Origine del catalogo (impostazioni locali) - Selezionare le stesse impostazioni locali specificate nel ticket di supporto (ad esempio
en-US). L’integrazione registra una lingua per tenant; una mancata corrispondenza impedisce la visualizzazione delle immagini sincronizzate nella vista catalogo prevista. - Livello catalogo - Assegna il livello
AEM-Assets(o il nome del livello personalizzato dal ticket) a tale vista catalogo.
Se le impostazioni locali o il livello non sono assegnati correttamente, è possibile che i dati dell’immagine non vengano visualizzati o che si comportino in modo imprevisto, anche se la sincronizzazione è riuscita a monte.
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.