DokumentationAEM 6.5Användarhandbok

Förbered Assets för smart taggning configure-asset-tagging-using-the-smart-content-service

Last update: Sat Jul 13 2024 00:00:00 GMT+0000 (Coordinated Universal Time)
  • Ämnen:

Skapat för:

  • Administratör

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.

NOTE
  • 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:

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:

  1. 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.

  2. Skapa en integrering i Adobe Developer Console och överför den genererade offentliga nyckeln.

  3. Konfigurera distributionen med API-nyckeln och andra autentiseringsuppgifter från Adobe Developer Console.

  4. Testa konfigurationen.

  5. 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.

  1. I användargränssnittet för Experience Manager går du till Tools > Cloud Services > Legacy Cloud Services.

  2. Klicka Configure Now under Assets Smart Tags på sidan Cloud Service.

  3. I dialogrutan Create Configuration anger du en rubrik och ett namn för konfigurationen av smarta taggar. Klicka på Create.

  4. 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 ange na, emea eller apac 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.

    Dialogrutan Experience Manager Smart Content Service för att tillhandahålla innehållstjänstens URL

    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.

  5. Klicka på Download Public Certificate for OAuth Integration och hämta den offentliga certifikatfilen AEM-SmartTags.crt.

    En representation av de inställningar som har skapats för den smarta taggningstjänsten

    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.

  1. Logga in på Experience Manager-driftsättningen som administratör. Klicka på Tools > Security > Users.

  2. Leta reda på och klicka på dam-update-service-användaren. Klicka på fliken Keystore.

  3. Ta bort den befintliga similaritysearch-nyckelbehållaren med det certifikat som upphört att gälla. Klicka på Save & Close.

    Ta bort den befintliga posten för likhetssökning i nyckelbehållaren om du vill lägga till ett säkerhetscertifikat

    Bild: Ta bort den befintliga similaritysearch-posten i nyckelbehållaren om du vill lägga till ett säkerhetscertifikat.

  4. Navigera till Tools > Cloud Services > Legacy Cloud Services. Klicka på Asset Smart Tags > Show Configuration > Available Configurations. Klicka på önskad konfiguration.

  5. Om du vill hämta ett offentligt certifikat klickar du på Download Public Certificate for OAuth Integration.

  6. 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.

  1. Öppna https://console.adobe.io i en webbläsare. Välj lämpligt konto och kontrollera att den associerade organisationsrollen är systemadministratör.

  2. Skapa ett projekt med valfritt namn. Klicka på Add API.

  3. På sidan Add an API markerar du Experience Cloud och väljer Smart Content. Klicka på Next.

  4. 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.

  5. Klicka på Next.

  6. 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.

    På fliken Overview kan du granska den information som finns för integrering.

    Bild: Information om integrering i Adobe Developer Console

Konfigurera Smart Content Service configure-smart-content-service

CAUTION
Tidigare har konfigurationer som gjorts med JWT-autentiseringsuppgifter ersatts i Adobe Developer Console. Du kan inte skapa nya JWT-referenser efter 3 juni 2024. Sådana konfigurationer kan inte längre skapas eller uppdateras, men kan migreras till OAuth-konfigurationer.
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.

  1. I Experience Manager går du till Tools > Cloud Service > Legacy Cloud Services för att öppna Cloud Services-konsolen.

  2. Öppna konfigurationen som skapats ovan under Assets Smart Tags. Klicka på Edit på tjänstinställningssidan.

  3. I dialogrutan AEM Smart Content Service använder du de förifyllda värdena för fälten Service URL och Authorization Server.

  4. 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 och OrgID.

  • 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

  1. 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"

  2. Byt namn på filen till com.adobe.granite.auth.oauth.accesstoken.provider-<randomnumber>.config.

  3. 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

  4. Spara alla ändringar i utvecklingskonsolen för innehållsdatabasen, till exempel CRXDE.

  5. Navigera till /system/console/configMgr och ersätt OSGi-konfigurationen från .<randomnumber> till -<randomnumber>.

  6. Ta bort den gamla konfigurationen för "Access Token provider name: adobe-ims-similaritysearch" i /system/console/configMgr.

  7. 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.

  1. Gå till din Experience Manager-server på https://[aem_server]:[port].

  2. Gå till Tools > Operations > Web Console för att öppna OSGi-konsolen. Klicka på Main>JMX.

  3. Klicka på com.day.cq.dam.similaritysearch.internal.impl. Den öppnas SimilaritySearch Miscellaneous Tasks.

  4. 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

  1. Gå till Tools > Workflow > Models i Experience Manager.

  2. Välj arbetsflödesmodellen DAM Update Asset på sidan Workflow Models.

  3. Klicka på Edit i verktygsfältet.

  4. 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.

    Lägg till resurssteget för smarta taggar efter steget med processminiatyrer i arbetsflödet för DAM-uppdatering av resurser

    Figur: Lägg till resurssteget för smart tagg efter steget med processminiatyrbilder i DAM Update Asset -arbetsflödet.

  5. Öppna steget i redigeringsläge. Under Advanced Settings kontrollerar du att alternativet Handler Advance är markerat.

    Konfigurera arbetsflödet för DAM-uppdatering och lägg till smart tagg

    Bild: Konfigurera arbetsflödet för DAM-uppdatering och lägg till smart tagg

  6. Välj Ignore Errors på fliken Arguments om du vill att arbetsflödet ska slutföras även om steget med automatisk taggning misslyckas.

    Konfigurera arbetsflödet för DAM-uppdatering av resurs för att lägga till smart tagg och markera hanterarframsteg

    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.

    Konfigurera arbetsflödet för DAM-uppdatering av resurs för att lägga till smart tagg och välj ignorera smart tagg

    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.

  7. 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.

NOTE
Utbildningsarbetsflödet kan endast användas på mappar.

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.

Illustrativa bilder som exempel på riktlinjer för utbildning

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.

Illustrativa bilder som exempel på riktlinjer för utbildning

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.

Illustrativa bilder som exempel på riktlinjer för utbildning

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.

Illustrativa bilder som exempel på riktlinjer för utbildning

NOTE
Möjligheten för Smart Content Service att lära sig taggar och använda dem på andra bilder beror på kvaliteten på de bilder du använder i utbildningen. För bästa resultat rekommenderar Adobe att du använder visuellt liknande bilder för att utbilda tjänsten för varje tagg.

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.

enable_smart_tags

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.

  1. I gränssnittet Experience Manager går du till Tools > Workflow > Models.

  2. Välj arbetsflödet Smart Tags Training på sidan Workflow Models och klicka sedan på Start Workflow i verktygsfältet.

  3. I dialogrutan Run Workflow bläddrar du till nyttolastmappen som innehåller de taggade resurserna för att utbilda tjänsten.

  4. 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.

    workflow_dialog

NOTE
När materialet i en mapp har behandlats för utbildning behandlas endast de ändrade resurserna i efterföljande utbildningscykler.

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.

  1. I gränssnittet Experience Manager går du till Tools > Assets > Reports.

  2. Klicka på Create på sidan Asset Reports.

  3. Välj rapporten Smart Tags Training och klicka sedan på Next i verktygsfältet.

  4. 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.

  5. På sidan Asset Reports markerar du rapporten som du skapat. Om du vill visa rapporten klickar du på View i verktygsfältet.

  6. 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.

  7. 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.

Related Articles
recommendation-more-help
19ffd973-7af2-44d0-84b5-d547b0dffee2