DocumentazioneCommerceGuida all'integrazione di AEM Assets

Configurare l’integrazione

Last update: Thu Feb 19 2026 00:00:00 GMT+0000 (Coordinated Universal Time)

Creato per:

  • Utente

Configura l’integrazione connettendo Commerce all’istanza di AEM Assets e selezionando la strategia di corrispondenza per la sincronizzazione delle risorse.

Dopo aver identificato il progetto AEM Assets, seleziona la regola corrispondente per la sincronizzazione delle risorse tra Adobe Commerce e AEM Assets.

  • Match by product SKU—Regola predefinita che corrisponde allo SKU nei metadati della risorsa con SKU prodotto Commerce per garantire che le risorse siano associate ai prodotti corretti.

  • Custom match - Regola di corrispondenza per scenari più complessi o requisiti aziendali specifici che richiedono una logica di corrispondenza personalizzata. L’implementazione della corrispondenza personalizzata richiede lo sviluppo di codice personalizzato in Adobe Developer App Builder per definire il modo in cui le risorse vengono associate ai prodotti. Ulteriori dettagli disponibili a breve…

Per la configurazione iniziale, utilizza la regola predefinita Corrispondenza per SKU prodotto.

Requisiti

Prima di configurare l’integrazione di AEM Assets, verifica di aver completato i seguenti passaggi:

Autorizzazioni IMS e utente

Per utilizzare il Selettore risorse e fornire una configurazione più fluida in Commerce, sono necessarie le seguenti autorizzazioni:

ACCS

[Solo SaaS]{class="badge positive" title="Applicabile solo ai progetti Adobe Commerce as a Cloud Service e Adobe Commerce Optimizer (infrastruttura SaaS gestita da Adobe)."}

L’autenticazione IMS è attivata per impostazione predefinita. Aggiungi l'utente al profilo di prodotto Utenti OpenAPI di AEM Assets DM - delivery in Adobe Admin Console per concedere l'accesso al livello di consegna di AEM Assets.

Profilo prodotto Admin Console per la consegna AEM Assets {width="600" modal="regular"}

PaaS

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

  1. Abilitare Adobe IMS per Commerce seguendo le istruzioni contenute nella Guida per l'amministratore di Commerce.

  2. Apri un ticket di supporto per richiedere un ID client IMS personalizzato per il selettore risorse.

  3. Aggiungi l'utente al profilo di prodotto Utenti OpenAPI di AEM Assets DM - delivery in Adobe Admin Console per concedere l'accesso al livello di consegna di AEM Assets.

Configurare la connessione

  1. Dall’amministratore di Commerce, apri la configurazione dell’integrazione di AEM Assets.

    1. Vai a Store > Configurazione > ADOBE SERVICES > AEM Assets Integration.

      L'integrazione di AEM Assets abilita l'integrazione {width="600" modal="regular"}

INFO
L’integrazione di AEM Assets supporta solo la configurazione nell’ambito globale (predefinito). La configurazione a livello di sito web non è supportata. Quando tenti di configurare l’integrazione a livello di sito web, il sistema ignora le impostazioni a livello di sito web e utilizza invece i valori di configurazione globale.

  1. [Solo PaaS]{class="badge informative" title="Applicabile solo ai progetti Adobe Commerce on Cloud (infrastruttura PaaS gestita da Adobe)."} Inserisci Asset Selector IMS Client ID.

    Questo ID è necessario per abilitare il Selettore risorse e la funzione di compilazione automatica per i campi ID programma e ID ambiente. Per ottenere questo ID, consulta IMS e autorizzazioni utente. Per informazioni dettagliate sul selettore risorse, vedere Selezione manuale delle risorse.

  2. Selezionare l'ambiente AEM Assets Program ID e Environment ID dai menu a discesa.

    I menu a discesa si compilano automaticamente in base alla sessione IMS dell’utente. Per utilizzare questa funzione, assicurati di disporre delle autorizzazioni IMS e dell'autorizzazione utente corrette.

    Se i menu a discesa non sono disponibili, puoi immettere manualmente gli ID dall'URL di AEM Cloud Manager: https://author-p[Program ID]-e[EnvironmentID].adobeaemcloud.com/

    Modificare i valori di configurazione rimuovendo la selezione da Use system value.

  3. [Solo PaaS]{class="badge informative" title="Applicabile solo ai progetti Adobe Commerce on Cloud (infrastruttura PaaS gestita da Adobe)."} Seleziona Commerce integration per autenticare le richieste tra Commerce e il servizio di corrispondenza risorse.

  4. Impostare Synchronization enabled su Yes per consentire a Commerce di accettare gli aggiornamenti in arrivo da AEM Assets.

    Dopo aver abilitato l’integrazione, sono disponibili opzioni di configurazione aggiuntive per specificare i criteri di corrispondenza delle risorse.

  5. Selezionare una delle regole di corrispondenza risorse per la sincronizzazione risorse dal menu a discesa Asset matching rule.

  6. Aggiungi il nome del campo di metadati AEM Assets definito per gli SKU dei prodotti Commerce nel campo Match by product SKU attribute name, commerce:skus per impostazione predefinita.

  7. Selezionare Save Config per applicare gli aggiornamenti e avviare la sincronizzazione delle risorse.

    L’aggiornamento della configurazione attiva il processo di sincronizzazione iniziale, consentendo a Commerce di accettare gli aggiornamenti in arrivo da AEM Assets. Il tempo necessario per la sincronizzazione dipende dal volume delle risorse e da configurazioni specifiche. L’integrazione sfrutta i processi automatizzati per ridurre al minimo il tempo necessario per la sincronizzazione.

Sincronizzazione SLA

L’integrazione garantisce i seguenti livelli di prestazioni di sincronizzazione:

  • < 5 minutes for 99% of updates

  • < 30 minutes for 99.9% of updates

In questo modo le pagine dei prodotti visualizzano sempre le immagini più aggiornate, mantenendo accurati e accattivanti i contenuti della vetrina.

Configurare il proprietario della visualizzazione

L'impostazione Proprietario visualizzazione determina quale sistema fornisce le immagini del prodotto nell'integrazione:

  • Adobe Commerce: usa immagini in hosting in Commerce.

  • AEM Assets: usa immagini sincronizzate da AEM.

L'amministratore visualizza le immagini disponibili per il proprietario, mentre le altre immagini sono disattivate e visualizzate con l'etichetta hidden.

Per informazioni sul comportamento di visualizzazione delle immagini, vedere l'argomento Imposta dettagli immagine.

TIP
Durante una migrazione da Commerce ad AEM Assets, imposta Proprietario visualizzazione su Commerce per evitare collegamenti immagine interrotti. Dopo che tutti i prodotti sono stati sincronizzati con AEM Assets, passa al proprietario di AEM Assets per completare la transizione. Ciò garantisce la disponibilità continua delle immagini durante l'intero processo.

  1. Passa a Store > Configurazione > ADOBE SERVICES > AEM Assets Integration.

    Funzionalità proprietario visualizzazione integrazione AEM Assets {width="400" modal="regular"}

  2. Seleziona l'origine Proprietario visualizzazione per visualizzare le immagini.

  3. Fare clic su Save Config per applicare gli aggiornamenti e avviare la sincronizzazione delle risorse.

Facoltativo. Configurare l’URL del dominio personalizzato

Se il progetto AEM Assets as a Cloud Service è stato configurato con un nome di dominio personalizzato, è necessario aggiungere il nome di dominio alla configurazione dell'archivio Commerce in modo che l'integrazione AEM Assets per Commerce possa utilizzarlo.

  1. Passa a Store > Configurazione > ADOBE SERVICES > AEM Assets Integration.

    L'integrazione di AEM Assets abilita l'integrazione {width="700" modal="regular"}

  2. Aggiungi l'URL dominio personalizzato al campo Asset Custom Domain.

  3. Fare clic su Save Config per applicare gli aggiornamenti e avviare la sincronizzazione delle risorse.

Passaggio successivo

  • Configura Commerce Storefront. Per utilizzare AEM Assets con Commerce Storefront con tecnologia Edge Delivery Services, completa la configurazione della vetrina descritta nell'argomento Integrazione AEM Assets nella documentazione Adobe Commerce Storefront.

  • Imposta regole corrispondenti tra Adobe Commerce e l'integrazione AEM Assets.

  • Gestione risorse Commerce.

recommendation-more-help
a946a0ea-3a16-4ab1-9bea-af7261643345