Konfigurera AEM Assets för Adobe Commerce Optimizer
[Endast SaaS]{class="badge positive" title="Gäller endast Adobe Commerce Optimizer-projekt."}
AEM Assets-integrering för Adobe Commerce Optimizer gör det möjligt för handlare att använda AEM Assets som centraliserad lösning för hantering av digitala resurser för produktbilder. Den här guiden beskriver konfigurationen som är specifik för Commerce Optimizer.
Till skillnad från Adobe Commerce (PaaS) eller Adobe Commerce as a Cloud Service (ACCS) har Commerce Optimizer inget gränssnitt för administratörskonfiguration. Om du vill aktivera integreringen skapar du en supportanmälan med dina Adobe Commerce Optimizer- och AEM Assets-uppgifter. Adobe Support konfigurerar integreringen och registrerar din klient hos Assets Integration Service.
Följande diagram är en översikt över produktsynkroniseringen mellan Adobe Commerce Optimizer och AEM Assets-integreringen.
Den här integreringen har två huvudflöden:
-
Från AEM Assets: När en resurs har godkänts, avvisats eller tagits bort flödar händelsen genom Adobe Pipeline till Assets integreringstjänst. Tjänsten matchar resurser till produkter med
match-by-SKU(metadatadriven) eller en anpassad matchning (App Builder), och skickar sedanproduct-asset-mappningarna till Commerce Optimizer, där de lagras som produktlager. -
FrånAdobe Commerce Optimizer: När en produkt uppdateras i Commerce Optimizer flödar händelsen genom Adobe Pipeline till Assets integreringstjänst. Tjänsten synkroniserar alla matchande resursmappningar tillbaka till Adobe Commerce Optimizer.
Förutsättningar
Innan du konfigurerar integreringen bör du kontrollera att du har:
- En aktiv Adobe Commerce Optimizer-instans med berättigande för produktvisuella effekter, eller en AEM Assets-licens med Dynamic Media.
- Tillgång till AEM Assets as a Cloud Service.
- Både Commerce Optimizer och AEM Assets i samma Adobe IMS-organisation.
- Dynamiska media med OpenAPI aktiverat i din AEM Assets-miljö.
Onboarding
Om du vill integrera AEM Assets-integrering med Commerce Optimizer måste du skapa en supportanmälan.
Adobe Support använder informationen i din biljett för att registrera din klient hos Assets Integration Service och konfigurera integreringen.
Inkludera följande information i din supportanmälan:
- Adobe Commerce OptimizerKlient-ID (instans-ID) hittades i din Commerce Optimizer URL eller Commerce Cloud Manager-användargränssnitt.
- AEM program-ID.
- AEM miljö-ID.
- Matchande regel: Matcha med SKU eller extern matchning (App Builder).
- Lager: Kataloglagernamnet som klienten ska registreras med. Ange ett anpassat namn om det behövs. I annat fall används
AEM-Assetssom standard. - Språk: Katalogkällans språkområde som klientorganisationen ska registreras med (till exempel
en-US).
När Adobe Support har bearbetat din biljett konfigureras integreringen och din klientorganisation registreras hos Assets integreringstjänst.
När introduktionen är klar:
-
Registrering med Assets Integration Service: Din Commerce Optimizer-klientorganisation har registrerats med Assets Integration Service via Adobe Commerce Optimizer klient-ID, AEM program-ID, AEM miljö-ID och klientorganisation.
-
Autentiseringsinställning: Autentiseringen av IMS-tjänstens token har konfigurerats mellan Commerce Optimizer och Assets Integration Service för en säker kommunikation.
-
Evenemangsprenumeration: Assets Integration Service prenumererar på:
- AEM Assets-händelser (resurs godkänd, uppdaterad, borttagen)
- Commerce Optimizer kataloghändelser (produkten har skapats, uppdaterats)
Begränsningar
Integrationen Commerce Optimizer har följande begränsningar:
- Ett lager per handlare - AEM Assets-integreringen har stöd för ett AEM-Assets-lager per handlare (en källa per innehavare). Det finns för närvarande inget stöd för att konfigurera flera lager per handlare.
- Endast bilder - Integreringen stöder inte video eller andra medietyper.
- Inga kategoribilder - Kategoribildssynkronisering är inte tillgänglig. Kategoribilder från AEM Assets för Assets Selector (infogning av användargränssnitt) stöds inte.
- Ingen skillnad mellan flera platser - Integreringen hanterar inte flera platser. En bild som är kopplad till en produkt visas på samma sätt i alla kanaler och profiler.
- Bildposition/bildordning - Bildplacering och bildordning stöds inte.
- Produkten måste finnas - Om produkten inte finns i Commerce Optimizer skapas inte lagret för produktresursmappningen.
- Lagerfält skriver över - värden i ett lager skriver över baskatalogen. Om ett fält inte skickas i lagernyttolasten kan det skrivas över med ett tomt värde. Använd ett dedikerat lager för AEM Assets-innehåll. Om du återanvänder ett befintligt lager för andra syften kan data gå förlorade.
Konfigurera din AEM Assets
Installations- och konfigurationsprocessen för Commerce Optimizer är densamma som för Adobe Commerce as a Cloud Service. Se Konfigurera AEM Assets-projektet med stöd för Commerce-metadata för de fullständiga stegen.
Kontrollera att AEM Assets är klart:
-
AEM Assets-konfiguration: Konfigurera Commerce metadataprofil. Se Konfigurera en metadataprofil.
-
Aktivera dynamiska media: Verifiera att dynamiska media med OpenAPI-funktioner är aktiverade i din AEM Assets-miljö.
Konfigurera AEM Assets
Konfigurera din AEM Assets-miljö om du vill aktivera synkronisering av produktresurser.
Steg 1: Aktivera dynamiska media med OpenAPI
Dynamiska media med OpenAPI måste vara aktiverat i din AEM Assets-miljö. Produktvisningar och nya AEM Assets-licenser gör att du kan aktivera dem via Cloud Manager. Äldre AEM Assets-licenser kräver Adobe Support för att aktiveras. Se Konfigurera AEM Assets-projektet för mer information om aktiveringssteg.
Steg 2: Valfritt. Konfigurera Commerce metadataprofil
Ställ in metadataprofilen i AEM Assets för att lagra Commerce-specifika metadata.
Mer information finns i Konfigurera en metadataprofil.
Steg 3: Använd metadata på resurser
Lägg till Commerce-metadata i produktbilderna i AEM Assets.
Se paketinnehållet i AEM Commerce för fältdefinitioner och Konfigurera en metadataprofil för konfigurationsstegen.
Resursen måste ha statusen Approved för att datasynkroniseringen ska kunna utlösas. Händelsen utlöses inte när enbart metadata sparas.
AEM-Assets till din katalogvy. Om lagret inte är tilldelat kan produktbilddata skrivas över oväntat.Synkronisering
När integreringen har konfigurerats synkroniseras product-asset mappningar automatiskt.
Mer information finns i Anpassad automatisk matchning.
Exempel på arbetsflöde för Matcha efter SKU
Ett typiskt flöde när du lägger till en befintlig resurs till en ny produkt:
-
Skapa produkten i Commerce Optimizer (via API eller dataöverföring). Produkten kan till en början finnas utan bilder.
-
Öppna den resurs du vill mappa till produkten i AEM Assets.
-
Lägg till produkt-SKU:n i commerce:skus -metadata och tilldela bildroller (till exempel
thumbnail,image). -
Godkänn tillgången för leverans. Detta utlöser händelsen som Assets integreringstjänst bearbetar.
-
Assets Integration Service skickar produktavbildningsmappningen till Commerce Optimizer. Produkten i Commerce Optimizer uppdateras med bilderna från resursen.
-
Kontrollera att bilden visas. Tillåt tid för synkroniseringen att slutföras (vanligtvis inom några minuter), kontrollera produkten i användargränssnittet för Commerce Optimizer (till exempel Datasynkronisering eller katalogvy) eller fråga butiks-API:erna (Katalogtjänst, Live Search, Storefront GraphQL API) för att bekräfta att bilden returneras.
Hantering av bildroger
När en produkt har flera resurser som använder samma bildroll (till exempel två resurser med rollen thumbnail), säkerställer integreringen att endast en resurs behåller den rollen för att undvika dubblettroller i lagret Commerce Optimizer och oväntat butiksbeteende.
Beteende: När en uppdatering skickas från AEM Assets tar den senast uppdaterade resursen emot bildrollen (till exempel thumbnail) och rollen tas bort från den tidigare resursen som hade den. Detta förhindrar att duplicerade bildroller visas i butiken.