Förbered Assets för smart taggning configure-asset-tagging-using-the-smart-content-service
Innan du kan börja tagga dina resurser med smarta innehållstjänster måste du integrera Experience Manager Assets med Adobe Developer Console för att använda den smarta tjänsten i Adobe Sensei. När du har konfigurerat tåget med några bilder och en tagg.
- Tjänster för smart innehåll är inte längre tillgängliga för nya Experience Manager Assets-lokala kunder. Befintliga lokala kunder, som redan har den här funktionen aktiverad, kan fortsätta använda smarta innehållstjänster.
- Smarta innehållstjänster är tillgängliga för befintliga Experience Manager Assets Managed Services-kunder som redan har den här funktionen aktiverad.
- Nya Experience Manager Assets Managed Services-kunder kan följa instruktionerna i den här artikeln för att konfigurera smarta innehållstjänster.
Innan du använder tjänsten för smart innehåll bör du kontrollera följande:
-
Installera den senaste Experience Manager Service Pack.
Integrera med Adobe Developer Console integrate-adobe-io
När du integrerar med Adobe Developer Console autentiserar servern Experience Manager dina tjänstinloggningsuppgifter med Adobe Developer Console gateway innan du vidarebefordrar din begäran till Smart Content Service. För att kunna integrera behöver du ett Adobe ID-konto som har administratörsbehörighet för organisationen och som har köpts och aktiverats för din organisation.
Så här konfigurerar du tjänsten Smart Content:
-
Om du vill generera en offentlig nyckel skapar du en konfiguration för Smart Content Service i Experience Manager. Hämta ett offentligt certifikat för OAuth-integrering.
-
Skapa en integrering i Adobe Developer Console och överför den genererade offentliga nyckeln.
-
Konfigurera distributionen med API-nyckeln och andra autentiseringsuppgifter från Adobe Developer Console.
-
Du kan också aktivera automatisk taggning vid överföring av resurser.
Hämta offentligt certifikat genom att skapa konfigurationen för tjänsten Smart Content Service obtain-public-certificate
Med ett offentligt certifikat kan du autentisera din profil på Adobe Developer Console.
-
I användargränssnittet för Experience Manager går du till Tools > Cloud Services > Legacy Cloud Services.
-
Klicka Configure Now under Assets Smart Tags på sidan Cloud Service.
-
I dialogrutan Create Configuration anger du en rubrik och ett namn för konfigurationen av smarta taggar. Klicka på Create.
-
Använd följande värden i dialogrutan AEM Smart Content Service:
Service URL:
https://smartcontent.adobe.io/<region where your Experience Manager author instance is hosted>
Exempel:
https://smartcontent.adobe.io/apac
. Du kan angena
,emea
ellerapac
som de områden där din Experience Manager-författarinstans finns.note note NOTE Om den hanterade tjänsten i Experience Manager etableras före den 1 september 2022 använder du följande tjänst-URL: https://mc.adobe.io/marketingcloud/smartcontent
Authorization Server:
https://ims-na1.adobelogin.com
Lämna de andra fälten tomma (kommer senare). Klicka på OK.
Figur: Dialogrutan Smart innehållstjänst innehåller URL:er för innehållstjänsten
note note NOTE URL:en som angetts som Service URL är inte tillgänglig via webbläsaren och genererar ett 404-fel. Konfigurationen fungerar korrekt med samma värde som parametern Service URL. Den övergripande servicestatusen och underhållsschemat finns på https://status.adobe.com. -
Klicka på Download Public Certificate for OAuth Integration och hämta den offentliga certifikatfilen
AEM-SmartTags.crt
.Bild: Inställningar för tjänsten för smart taggning.
Konfigurera om när ett certifikat upphör att gälla certrenew
När ett certifikat har upphört att gälla är det inte längre tillförlitligt. Du kan inte förnya ett certifikat som har upphört att gälla. Följ de här stegen för att lägga till ett certifikat.
-
Logga in på Experience Manager-driftsättningen som administratör. Klicka på Tools > Security > Users.
-
Leta reda på och klicka på dam-update-service-användaren. Klicka på fliken Keystore.
-
Ta bort den befintliga similaritysearch-nyckelbehållaren med det certifikat som upphört att gälla. Klicka på Save & Close.
Bild: Ta bort den befintliga
similaritysearch
-posten i nyckelbehållaren om du vill lägga till ett säkerhetscertifikat. -
Navigera till Tools > Cloud Services > Legacy Cloud Services. Klicka på Asset Smart Tags > Show Configuration > Available Configurations. Klicka på önskad konfiguration.
-
Om du vill hämta ett offentligt certifikat klickar du på Download Public Certificate for OAuth Integration.
-
Gå till https://console.adobe.io och navigera till de befintliga Smart Content Services på sidan Integrations. Överför det nya certifikatet. Mer information finns i instruktionerna i Skapa Adobe Developer Console-integrering.
Integrering med Adobe Developer Console create-adobe-i-o-integration
Om du vill använda API:er för smarta innehållstjänster skapar du en integrering i Adobe Developer Console för att få API Key (som genereras i fältet CLIENT ID för Adobe Developer Console-integrering), TECHNICAL ACCOUNT ID, ORGANIZATION ID och CLIENT SECRET för Assets Smart Tagging Service Settings av molnkonfigurationen i Experience Manager.
-
Öppna https://console.adobe.io i en webbläsare. Välj lämpligt konto och kontrollera att den associerade organisationsrollen är systemadministratör.
-
Skapa ett projekt med valfritt namn. Klicka på Add API.
-
På sidan Add an API markerar du Experience Cloud och väljer Smart Content. Klicka på Next.
-
Välj Upload your public key. Ange certifikatfilen som hämtats från Experience Manager. Ett meddelande Public key(s) uploaded successfully visas. Klicka på Next.
Sidan Create a new Service Account (JWT) credential visar den offentliga nyckeln för tjänstkontot.
-
Klicka på Next.
-
Välj Smart Content Services på sidan Select product profiles. Klicka på Save configured API.
En sida visar mer information om konfigurationen. Håll den här sidan öppen för att kopiera och lägga till dessa värden i Assets Smart Tagging Service Settings av molnkonfigurationen i Experience Manager för att konfigurera smarta taggar.
Bild: Information om integrering i Adobe Developer Console
Konfigurera Smart Content Service configure-smart-content-service
Se Konfigurera IMS-integreringar för AEM
Se Steg för att konfigurera OAuth för lokala användare
Se Felsöka smarta taggar för OAuth-autentiseringsuppgifter
Om du vill konfigurera integreringen använder du värdena för fälten TECHNICAL ACCOUNT ID, ORGANIZATION ID, CLIENT SECRET och CLIENT ID från Adobe Developer Console-integreringen. Om du skapar en molnkonfiguration för smarta taggar kan API-begäranden från distributionen Experience Manager autentiseras.
-
I Experience Manager går du till Tools > Cloud Service > Legacy Cloud Services för att öppna Cloud Services-konsolen.
-
Öppna konfigurationen som skapats ovan under Assets Smart Tags. Klicka på Edit på tjänstinställningssidan.
-
I dialogrutan AEM Smart Content Service använder du de förifyllda värdena för fälten Service URL och Authorization Server.
-
Kopiera och använd följande värden som genererats i Adobe Developer Console-integrering för fälten Api Key, Technical Account ID, Organization ID och Client Secret.
table 0-row-2 1-row-2 2-row-2 3-row-2 4-row-2 Assets Smart Tagging Service Settings Integrationsfält för Adobe Developer Console Api Key CLIENT ID Technical Account ID TECHNICAL ACCOUNT ID Organization ID ORGANIZATION ID Client Secret CLIENT SECRET
Konfigurera OAuth för lokala användare config-oauth-onprem
Förutsättningar prereqs-config-oauth-onprem
Ett auktoriseringsomfång är en OAuth-sträng som innehåller följande krav:
-
Skapa en ny OAuth-integrering i Developer Console med
ClientID
,ClientSecretID
ochOrgID
. -
Lägg till följande filer på den här sökvägen
/apps/system/config in crx/de
:com.adobe.granite.auth.oauth.accesstoken.provider.<randomnumbers>.config
com.adobe.granite.auth.ims.impl.IMSAccessTokenRequestCustomizerImpl.<randomnumber>.config
Konfigurera OAuth för lokala användare steps-config-oauth-onprem
-
Lägg till eller uppdatera nedanstående egenskaper i
com.adobe.granite.auth.oauth.accesstoken.provider.<randomnumbers>.config
:-
auth.token.provider.authorization.grants="client_credentials"
-
auth.token.provider.orgId="<OrgID>"
-
auth.token.provider.default.claims=("\"iss\"\ :\ \"<OrgID>\"")
-
auth.token.provider.scope="read_pc.dma_smart_content,\ openid,\ AdobeID,\ additional_info.projectedProductContext"
auth.token.validator.type="adobe-ims-similaritysearch"
-
Uppdatera
auth.token.provider.client.id
med klient-ID:t för den nya OAuth-konfigurationen. -
Uppdatera
auth.access.token.request
till"https://ims-na1.adobelogin.com/ims/token/v3"
-
-
Byt namn på filen till
com.adobe.granite.auth.oauth.accesstoken.provider-<randomnumber>.config
. -
Utför stegen nedan i
com.adobe.granite.auth.ims.impl.IMSAccessTokenRequestCustomizerImpl.<randomnumber>.config
:- Uppdatera egenskapen auth.ims.client.secrets med klienthemligheten från den nya OAuth-integreringen.
- Byt namn på filen till
com.adobe.granite.auth.ims.impl.IMSAccessTokenRequestCustomizerImpl-<randomnumber>.config
-
Spara alla ändringar i utvecklingskonsolen för innehållsdatabasen, till exempel CRXDE.
-
Navigera till
/system/console/configMgr
och ersätt OSGi-konfigurationen från.<randomnumber>
till-<randomnumber>
. -
Ta bort den gamla konfigurationen för
"Access Token provider name: adobe-ims-similaritysearch"
i/system/console/configMgr
. -
Starta om konsolen.
Validera konfigurationen validate-the-configuration
När du har slutfört konfigurationen kan du använda en JMX MBean för att validera konfigurationen. Följ de här stegen för att validera.
-
Gå till din Experience Manager-server på
https://[aem_server]:[port]
. -
Gå till Tools > Operations > Web Console för att öppna OSGi-konsolen. Klicka på Main>JMX.
-
Klicka på
com.day.cq.dam.similaritysearch.internal.impl
. Den öppnas SimilaritySearch Miscellaneous Tasks. -
Klicka på
validateConfigs()
. I dialogrutan Validate Configurations klickar du på Invoke.
Valideringsresultaten visas i samma dialogruta.
Aktivera smart taggning i arbetsflödet DAM Update Asset (valfritt) enable-smart-tagging-in-the-update-asset-workflow-optional
-
Gå till Tools > Workflow > Models i Experience Manager.
-
Välj arbetsflödesmodellen DAM Update Asset på sidan Workflow Models.
-
Klicka på Edit i verktygsfältet.
-
Expandera sidopanelen för att visa stegen. Dra steget Smart Tag Asset som finns i avsnittet med DAM-arbetsflöden och placera det efter steget Process Thumbnails.
Figur: Lägg till resurssteget för smart tagg efter steget med processminiatyrbilder i DAM Update Asset -arbetsflödet.
-
Öppna steget i redigeringsläge. Under Advanced Settings kontrollerar du att alternativet Handler Advance är markerat.
Bild: Konfigurera arbetsflödet för DAM-uppdatering och lägg till smart tagg
-
Välj Ignore Errors på fliken Arguments om du vill att arbetsflödet ska slutföras även om steget med automatisk taggning misslyckas.
Bild: Konfigurera arbetsflödet för DAM-uppdatering av resurs för att lägga till smart tagg och välja hanterarframsteg
Om du vill tagga resurser när de överförs, oavsett om smart taggning är aktiverat för mappar eller inte, markerar du Ignore Smart Tag Flag.
Figur: Konfigurera arbetsflödet för DAM-uppdatering av resurser för att lägga till smart tagg och välj ignorera smart tagg-flagga.
-
Klicka på OK för att stänga processteget och spara sedan arbetsflödet.
Utbilda tjänsten Smart Content training-the-smart-content-service
För att Smart Content Service ska känna igen din företagsklonomi kan du köra den på en uppsättning resurser som redan innehåller taggar som är relevanta för ditt företag. För att effektivt märka upp varumärkesbilderna kräver Smart Content Service att utbildningsbilderna följer vissa riktlinjer. Efter utbildning kan tjänsten tillämpa samma taxonomi på en liknande uppsättning resurser.
Du kan utbilda tjänsten flera gånger för att förbättra dess förmåga att använda relevanta taggar. Efter varje utbildningscykel kör du ett taggningsarbetsflöde och kontrollerar om dina resurser är taggade på rätt sätt.
Du kan utbilda Smart Content Service regelbundet eller efter behov.
Riktlinjer för utbildning guidelines-for-training
För bästa resultat uppfyller bilderna i din utbildningsuppsättning följande riktlinjer:
Kvantitet och storlek: Minst 30 bilder per tagg. Minst 500 pixlar på den längre sidan.
Sammanhang: Bilder som används för en viss tagg liknar varandra visuellt.
Det är till exempel ingen bra idé att tagga alla dessa bilder som my-party
(för träning) eftersom de inte är visuellt lika.
Täckning: Använd tillräcklig variation i bilderna i kursen. Tanken är att ge några men relativt olika exempel så att Experience Manager lär sig att fokusera på rätt saker. Om du använder samma tagg på bilder som ser olika ut bör du ta med minst fem exempel av varje typ.
För taggen model-down-pose kan du t.ex. inkludera fler utbildningsbilder som liknar den markerade bilden nedan så att tjänsten kan identifiera liknande bilder mer exakt under taggningen.
Distraktion/obstruktion: Tjänsten tränar bättre på bilder som har mindre störning (framträdande bakgrunder, icke-relaterade komponenter, t.ex. objekt/personer med huvudmotivet).
För taggen casual-shoe är till exempel den andra bilden inte en bra träningskandidat.
Fullständighet: Om en bild kvalificerar sig för mer än en tagg lägger du till alla tillämpliga taggar innan du inkluderar bilden för träning. För taggar, till exempel raincoat
och model-side-view
, lägger du till båda taggarna i den kvalificerade resursen innan du inkluderar den för utbildning.
Periodisk utbildning periodic-training
Du kan aktivera tjänsten Smart Content Service för att med jämna mellanrum utbilda resurser och tillhörande taggar i en mapp. Öppna sidan Properties i resursmappen, välj Enable Smart Tags på fliken Details och spara ändringarna.
När det här alternativet har valts för en mapp kör Experience Manager ett utbildningsarbetsflöde automatiskt för att utbilda Smart Content Service i mappresurserna och deras taggar. Som standard körs utbildningsarbetsflödet varje vecka kl. 12.30 på lördagar.
On-demand-utbildning on-demand-training
Du kan utbilda tjänsten för smart innehåll när det behövs från arbetsflödeskonsolen.
-
I gränssnittet Experience Manager går du till Tools > Workflow > Models.
-
Välj arbetsflödet Smart Tags Training på sidan Workflow Models och klicka sedan på Start Workflow i verktygsfältet.
-
I dialogrutan Run Workflow bläddrar du till nyttolastmappen som innehåller de taggade resurserna för att utbilda tjänsten.
-
Ange en rubrik för arbetsflödet och lägg till en kommentar. Klicka sedan på Run. Resurserna och taggarna skickas in för utbildning.
Visa utbildningsrapporter viewing-training-reports
Om du vill kontrollera om Smart Content Service är utbildad i dina taggar i övningsresurserna kan du läsa rapporten om utbildningsarbetsflödet i rapportkonsolen.
-
I gränssnittet Experience Manager går du till Tools > Assets > Reports.
-
Klicka på Create på sidan Asset Reports.
-
Välj rapporten Smart Tags Training och klicka sedan på Next i verktygsfältet.
-
Ange en titel och beskrivning för rapporten. Under Schedule Report låter du alternativet Now vara markerat. Om du vill schemalägga rapporten till ett senare tillfälle väljer du Later och anger ett datum och en tid. Klicka sedan på Create i verktygsfältet.
-
På sidan Asset Reports markerar du rapporten som du skapat. Om du vill visa rapporten klickar du på View i verktygsfältet.
-
Granska informationen i rapporten.
Rapporten visar träningsstatusen för de taggar du har tränat. Den gröna färgen i kolumnen Training Status anger att smarta innehållstjänster har tränats för taggen. Gul färg anger att tjänsten inte är helt tränad för en viss tagg. I det här fallet lägger du till fler bilder med just den taggen och kör träningsarbetsflödet för att träna tjänsten helt för taggen.
Om du inte ser dina taggar i den här rapporten kör du utbildningsarbetsflödet igen för dessa taggar.
-
Om du vill hämta rapporten markerar du den i listan och klickar på Download i verktygsfältet. Rapporten hämtas som ett Microsoft Excel-kalkylblad.
Begränsningar limitations
-
Förbättrade smarta taggar bygger på inlärningsmodeller för bilder och taggar. Dessa modeller är inte alltid perfekta när det gäller att identifiera taggar. Den aktuella versionen av Smart Content Service har följande begränsningar:
- Oförmåga att identifiera små skillnader i bilder. Till exempel tunna eller jämna skjortor.
- Oförmåga att identifiera taggar baserat på små mönster/delar av en bild. Till exempel logotyper på T-shirts.
- Taggning stöds i de språkområden som Experience Manager stöds i.
-
Om du vill söka efter resurser med smarta taggar (vanliga eller förbättrade) använder du Assets Omnissearch (fulltextsökning). Det finns inget separat sökpredikat för smarta taggar.