DocumentatieAEM 6.5Handboek

Assets voorbereiden voor slimme tags configure-asset-tagging-using-the-smart-content-service

Last update: Sun Jul 14 2024 00:00:00 GMT+0000 (Coordinated Universal Time)
  • Onderwerpen:

Gemaakt voor:

  • Beheerder

Voordat u met het labelen van uw middelen begint met Smart Content Services, moet u Experience Manager Assets integreren met Adobe Developer Console om de slimme service van Adobe Sensei te gebruiken. Zodra gevormd treig de dienst gebruikend een paar beelden en een markering.

NOTE
  • Smart Content Services is niet meer beschikbaar voor nieuwe klanten van Experience Manager Assets On-Premise. Bestaande klanten op locatie, die deze mogelijkheid al hebben ingeschakeld, kunnen Smart Content Services blijven gebruiken.
  • Smart Content Services is beschikbaar voor bestaande Experience Manager Assets Managed Services-klanten die deze mogelijkheid al hebben ingeschakeld.
  • Nieuwe Experience Manager Assets Managed Services-klanten kunnen de instructies in dit artikel volgen om Smart Content Services in te stellen.

Controleer het volgende voordat u de Smart Content Service gebruikt:

Integreren met Adobe Developer Console integrate-adobe-io

Wanneer u met Adobe Developer Console integreert, verifieert de Experience Manager server uw de dienstgeloofsbrieven met de gateway van Adobe Developer Console alvorens uw verzoek aan de Slimme Dienst van de Inhoud door:sturen. Voor integratie hebt u een Adobe ID-account nodig met beheerdersrechten voor de organisatie en de licentie voor Smart Content Service die u hebt aangeschaft en ingeschakeld voor uw organisatie.

Om de Slimme Dienst van de Inhoud te vormen, volg deze top-level stappen:

  1. Om een openbare sleutel te produceren, creeer een Slimme 1} configuratie van de Dienst van de Inhoud {in Experience Manager.Verkrijg een openbaar certificaat voor OAuth-integratie.

  2. Maak een integratie in Adobe Developer Console en upload de gegenereerde openbare sleutel.

  3. vorm uw plaatsinggebruikend de API sleutel en andere geloofsbrieven van Adobe Developer Console.

  4. Test de configuratie.

  5. Naar keuze, laat auto-etiketteren op activa toe uploadt.

Verkrijg openbaar certificaat door de Slimme configuratie van de Dienst van de Inhoud te creëren obtain-public-certificate

Met een openbaar certificaat kunt u uw profiel verifiëren op Adobe Developer Console.

  1. Ga in de Experience Manager-gebruikersinterface naar Tools > Cloud Services > Legacy Cloud Services.

  2. Klik op de pagina Cloud Servicen op Configure Now onder Assets Smart Tags .

  3. Geef in het dialoogvenster Create Configuration een titel en naam op voor de configuratie van slimme tags. Klik op Create.

  4. Gebruik de volgende waarden in het dialoogvenster AEM Smart Content Service :

    Service URL: https://smartcontent.adobe.io/<region where your Experience Manager author instance is hosted>

    Bijvoorbeeld https://smartcontent.adobe.io/apac . U kunt na , emea of apac opgeven als de gebieden waar de auteur van de Experience Manager wordt gehost.

    note note
    NOTE
    Als de Experience Manager Beheerde Dienst vóór September 01, 2022 provisioned is, gebruik de volgende Dienst URL:
    https://mc.adobe.io/marketingcloud/smartcontent

    Authorization Server: https://ims-na1.adobelogin.com

    Laat de overige velden voorlopig leeg (later te verstrekken). Klik op OK.

    Experience Manager de Slimme dialoog van de Dienst van de Inhoud om de inhoudsdienst URL te verstrekken

    Cijfer: De slimme dialoog van de Dienst van de Inhoud om de inhoudsdienst URL te verstrekken

    note note
    NOTE
    De URL die als Service URL wordt opgegeven, is niet toegankelijk via de browser en genereert een fout van 404. De configuratie werkt OK met dezelfde waarde als de parameter Service URL . Voor het algemene de dienststatus en onderhoudsprogramma, zie https://status.adobe.com.

  5. Klik op Download Public Certificate for OAuth Integration en download het openbare certificaatbestand AEM-SmartTags.crt .

    een vertegenwoordiging van de montages die voor de slimme het etiketteren dienst worden gecreeerd

    Cijfer: Montages voor de slimme het etiketteren dienst.

Opnieuw configureren wanneer een certificaat verloopt certrenew

Nadat een certificaat is verlopen, wordt het niet meer vertrouwd. U kunt een verlopen certificaat niet vernieuwen. Voer de volgende stappen uit om een certificaat toe te voegen.

  1. Meld u als beheerder aan bij uw Experience Manager-implementatie. Klik op Tools > Security > Users.

  2. Zoek en klik op dam-update-service-gebruiker. Klik op Keystore tab.

  3. Verwijder het bestaande similaritysearch-sleutelarchief met het verlopen certificaat. Klik op Save & Close.

    Schrap de bestaande ingang van het gelijkheidsonderzoek in Keystore om een veiligheidscertificaat toe te voegen

    Cijfer: Schrap de bestaande similaritysearch ingang in Keystore om een veiligheidscertificaat toe te voegen.

  4. Ga naar Tools > Cloud Services > Legacy Cloud Services. Klik op Asset Smart Tags > Show Configuration > Available Configurations. Klik op de gewenste configuratie.

  5. Als u een openbaar certificaat wilt downloaden, klikt u op Download Public Certificate for OAuth Integration.

  6. Toegang https://console.adobe.ioen navigeer aan de bestaande Slimme Diensten van de Inhoud op de Integrations pagina. Upload het nieuwe certificaat. Voor meer informatie, zie de instructies in de integratie van Adobe Developer Consolecreëren.

Adobe Developer Console-integratie maken create-adobe-i-o-integration

Als u API's voor Smart Content Service wilt gebruiken, maakt u een integratie in Adobe Developer Console om API Key (gegenereerd in CLIENT ID field of Adobe Developer Console integration), TECHNICAL ACCOUNT ID , ORGANIZATION ID en CLIENT SECRET for Assets Smart Tagging Service Settings of cloud configuration in Experience Manager te verkrijgen.

  1. Open https://console.adobe.io in uw browser. Selecteer het gewenste account en verifieer dat de bijbehorende organisatierol is ingesteld op systeembeheerder.

  2. Maak een project een geef het de gewenste naam. Klik op Add API.

  3. Ga naar de pagina Add an API en selecteer achtereenvolgens Experience Cloud en Smart Content. Klik op Next.

  4. Selecteer Upload your public key. Geef het certificaatbestand op dat u hebt gedownload van Experience Manager. Er wordt een Public key(s) uploaded successfully-bericht weergegeven. Klik op Next.

    Op de pagina Create a new Service Account (JWT) credential wordt de openbare sleutel voor het serviceaccount weergegeven.

  5. Klik op Next.

  6. Selecteer op de pagina Select product profiles de optie Smart Content Services . Klik op Save configured API.

    De pagina die verschijnt biedt meer informatie over de configuratie. Zorg dat deze pagina geopend blijft en kopieer deze waarden in Assets Smart Tagging Service Settings van de cloudconfiguratie in Experience Manager om slimme tags te configureren.

    Op het tabblad Overview kunt u de informatie bekijken die is opgegeven voor de integratie.

    Cijfer: Details van integratie in Adobe Developer Console

Slimme-inhoudsservice configureren configure-smart-content-service

CAUTION
Eerder zijn configuraties die zijn gemaakt met JWT Credentials onderhevig aan afschrijving in de Adobe Developer Console. U kunt na 3 juni 2024 geen nieuwe JWT-referenties maken. Dergelijke configuraties kunnen niet meer worden gemaakt of bijgewerkt, maar kunnen worden gemigreerd naar OAuth-configuraties.
Zie de integratie van IMS van de Opstelling voor AEM
Zie Stappen om OAuth voor op-premise gebruikerste vormen
Zie het Oplossen van problemen slimme markeringen voor geloofsbrieven OAuth

Als u de integratie wilt configureren, gebruikt u de waarden van de velden TECHNICAL ACCOUNT ID , ORGANIZATION ID , CLIENT SECRET en CLIENT ID van de Adobe Developer Console-integratie. Door een cloud-configuratie met slimme tags te maken, kunnen API-aanvragen van de Experience Manager -implementatie worden geverifieerd.

  1. Navigeer in Experience Manager naar Tools > Cloud Service > Legacy Cloud Services om de Cloud Services -console te openen.

  2. Open onder Assets Smart Tags de configuratie die hierboven is gemaakt. Klik op Edit op de pagina met service-instellingen.

  3. Gebruik in het dialoogvenster AEM Smart Content Service de vooraf ingevulde waarden voor de velden Service URL en Authorization Server.

  4. Voor de gebieden Api Key, Technical Account ID, Organization ID, en Client Secret, kopieer en gebruik de volgende waarden die in worden geproduceerd de integratie van Adobe Developer Console.

    table 0-row-2 1-row-2 2-row-2 3-row-2 4-row-2
    Assets Smart Tagging Service Settings Adobe Developer Console integratievelden
    Api Key CLIENT ID
    Technical Account ID TECHNICAL ACCOUNT ID
    Organization ID ORGANIZATION ID
    Client Secret CLIENT SECRET

OAuth voor gebruikers op locatie configureren config-oauth-onprem

Vereisten prereqs-config-oauth-onprem

Een vergunningswerkingsgebied is een koord OAuth dat de volgende eerste vereisten bevat:

  • Creeer een nieuwe integratie OAuth in Developer Consolegebruikend ClientID, ClientSecretID, en OrgID.

  • Voeg de volgende bestanden toe op dit pad /apps/system/config in crx/de :

    • com.adobe.granite.auth.oauth.accesstoken.provider.<randomnumbers>.config
    • com.adobe.granite.auth.ims.impl.IMSAccessTokenRequestCustomizerImpl.<randomnumber>.config

OAuth voor gebruikers op locatie configureren steps-config-oauth-onprem

  1. Voeg de onderstaande eigenschappen toe of werk deze bij in 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"

    • Werk auth.token.provider.client.id met Cliënt identiteitskaart van de nieuwe configuratie OAuth bij.

    • auth.access.token.request bijwerken naar "https://ims-na1.adobelogin.com/ims/token/v3"

  2. Wijzig de naam van het bestand in com.adobe.granite.auth.oauth.accesstoken.provider-<randomnumber>.config .

  3. Voer de onderstaande stappen uit in com.adobe.granite.auth.ims.impl.IMSAccessTokenRequestCustomizerImpl.<randomnumber>.config :

    • Werk het bezit auth.ims.client.geheime met het Geheim van de Cliënt van de nieuwe integratie OAuth bij.
    • Naam van bestand wijzigen in com.adobe.granite.auth.ims.impl.IMSAccessTokenRequestCustomizerImpl-<randomnumber>.config

  4. Sla alle wijzigingen op in de ontwikkelingsconsole van de inhoudsopslagplaats, bijvoorbeeld CRXDE.

  5. Navigeer naar /system/console/configMgr en vervang de OSGi-configuratie van .<randomnumber> tot -<randomnumber> .

  6. Verwijder de oude configuratie voor "Access Token provider name: adobe-ims-similaritysearch" in /system/console/configMgr .

  7. Start de console opnieuw.

De configuratie valideren validate-the-configuration

Nadat u de configuratie hebt voltooid, kunt u een JMX MBean gebruiken om de configuratie te bevestigen. Voer de volgende stappen uit om te valideren.

  1. Open de Experience Manager -server op https://[aem_server]:[port] .

  2. Ga naar Tools > Operations > Web Console om de OSGi-console te openen. Klik op Main>JMX .

  3. Klik op com.day.cq.dam.similaritysearch.internal.impl. Deze wordt geopend SimilaritySearch Miscellaneous Tasks .

  4. Klik op validateConfigs(). Klik in het dialoogvenster Validate Configurations op Invoke .

De validatieresultaten worden in hetzelfde dialoogvenster weergegeven.

Slimme tags toepassen inschakelen in de DAM Update Asset -workflow (optioneel) enable-smart-tagging-in-the-update-asset-workflow-optional

  1. Ga in Experience Manager naar Tools > Workflow > Models .

  2. Selecteer op de pagina Workflow Models het DAM Update Asset-workflowmodel.

  3. Klik op Edit op de werkbalk.

  4. Vouw het zijpaneel uit om de stappen weer te geven. Sleep de stap Smart Tag Asset die beschikbaar is in de DAM-workflowsectie en plaats deze na de stap Process Thumbnails.

    De stap Asset met slimme tag toevoegen na de stap met de procesminiaturen in de DAM Update Asset-workflow

    Cijfer: Voeg slimme stap van de markeringsactiva na de stap van de procesduimnagel in het DAM Update Asset werkschema toe.

  5. Open de stap in de bewerkingsmodus. Ga naar Advanced Settings en controleer of de optie Handler Advance is ingeschakeld.

    vorm het werkschema van de Activa van de Update DAM en voeg slimme markeringsstap toe

    Figuur: Vorm het werkschema van de Activa van de Update DAM en voeg slimme markeringsstap toe

  6. Selecteer op het tabblad Arguments de optie Ignore Errors als u de workflow wilt voltooien, zelfs als de stap Automatisch labelen is mislukt.

    vorm het werkschema van de Activa van de Update DAM om slimme markeringsstap toe te voegen en manager vooruit te selecteren

    Cijfer: Vorm het werkschema van de Activa van de Update DAM om slimme markeringsstap toe te voegen en manager vooruit te selecteren

    Als u assets tijdens het uploaden wilt voorzien van een tag (ongeacht of slimme tags zijn ingeschakeld voor mappen), moet u de optie Ignore Smart Tag Flag inschakelen.

    vorm het werkschema van de Activa van de Update DAM om slimme markeringsstap toe te voegen en de uitgezochte Slimme markering van de Markering te negeren

    Cijfer: Vorm het werkschema van de Activa van de Update DAM om slimme markeringsstap toe te voegen en de uitgezochte markering van de Slimme Markering te negeren.

  7. Klik op OK om de processtap te sluiten en sla de workflow op.

De Smart Content Service trainen training-the-smart-content-service

Als u wilt dat de Smart Content Service uw bedrijfskrionomie herkent, voert u deze uit op een reeks elementen die al tags bevatten die relevant zijn voor uw bedrijf. Om uw merkbeelden effectief te etiketteren, vereist de Slimme Dienst van de Inhoud dat de trainingsbeelden aan bepaalde richtlijnen voldoen. Na de training kan de service dezelfde taxonomie toepassen op een vergelijkbare set activa.

U kunt de service meerdere keren trainen om de service beter in staat te stellen relevante tags toe te passen. Voer na elke trainingscyclus een labelworkflow uit en controleer of uw elementen correct zijn gecodeerd.

U kunt de Slimme Dienst van de Inhoud periodiek of op vereiste basis trainen.

NOTE
De trainingsworkflow wordt alleen uitgevoerd voor mappen.

Richtsnoeren voor opleiding guidelines-for-training

Voor de beste resultaten voldoen de afbeeldingen in de trainingsset aan de volgende richtlijnen:

Hoeveelheid en grootte: Minimaal 30 afbeeldingen per tag. Minimaal 500 pixels aan de langere zijde.

Samenhang: De beelden die voor een specifieke markering worden gebruikt zijn visueel gelijkaardig.

Het is bijvoorbeeld geen goed idee om al deze afbeeldingen als my-party te labelen (voor training) omdat ze er anders uitzien.

Illustratieve beelden om de richtlijnen voor opleiding te illustreren

Dekking: Gebruik voldoende verscheidenheid in de beelden in de opleiding. Het is de bedoeling om een paar maar redelijk verschillende voorbeelden te geven, zodat de Experience Manager leert zich te richten op de juiste dingen. Als u dezelfde tag toepast op visueel verschillende afbeeldingen, moet u ten minste vijf voorbeelden van elke soort opnemen.

Bijvoorbeeld, voor de markering model-onderstel, omvat meer opleidingsbeelden gelijkend op het benadrukte beeld hieronder voor de dienst om gelijkaardige beelden nauwkeuriger tijdens het etiketteren te identificeren.

Illustratieve beelden om de richtlijnen voor opleiding te illustreren

Vervorming/belemmering: De de diensttreinen beter op beelden die minder afleiding (duidelijke achtergronden, niet verwante accompanimenten, zoals voorwerpen/personen met het belangrijkste onderwerp) hebben.

Bijvoorbeeld, voor de markering casual-shoe, is het tweede beeld geen goede opleidingskandidaat.

Illustratieve beelden om de richtlijnen voor opleiding te illustreren

Volledigheid: Als een afbeelding in aanmerking komt voor meer dan één tag, voegt u alle relevante tags toe voordat u de afbeelding opneemt voor training. Voeg bijvoorbeeld voor tags, zoals raincoat en model-side-view, beide tags toe aan het in aanmerking komende element voordat u dit opneemt voor training.

Illustratieve beelden om de richtlijnen voor opleiding te illustreren

NOTE
Of de Smart Content Service uw tags kan trainen en deze op andere afbeeldingen kan toepassen, hangt af van de kwaliteit van de afbeeldingen die u voor de training gebruikt. Voor de beste resultaten raadt Adobe u aan visueel vergelijkbare afbeeldingen te gebruiken om de service voor elke tag op te leiden.

Periodieke training periodic-training

U kunt de Slimme Dienst van de Inhoud toelaten om periodiek op de activa en bijbehorende markeringen binnen een omslag te trainen. Open de pagina Properties van de elementmap, selecteer Enable Smart Tags onder het tabblad Details en sla de wijzigingen op.

enable_smart_tags

Als deze optie voor een map is geselecteerd, voert Experience Manager automatisch een trainingsworkflow uit om de Smart Content Service op te leiden voor de mappenelementen en hun tags. Standaard wordt de trainingsworkflow wekelijks om 12:30 uur uitgevoerd op zaterdag.

Opleiding op aanvraag on-demand-training

U kunt de Slimme Dienst van de Inhoud wanneer vereist van de console van het Werkschema trainen.

  1. Ga in de Experience Manager -interface naar Tools > Workflow > Models .

  2. Selecteer op de pagina Workflow Models de Smart Tags Training workflow en klik vervolgens op Start Workflow op de werkbalk.

  3. Blader in het dialoogvenster Run Workflow naar de payload-map met de gecodeerde elementen voor training voor de service.

  4. Geef een titel op voor de workflow en voeg een opmerking toe. Klik vervolgens op Run . De elementen en tags worden ter training aangeboden.

    workflow_dialog

NOTE
Nadat de middelen in een map zijn verwerkt voor training, worden alleen de gewijzigde middelen verwerkt in volgende trainingscycli.

Trainingsrapporten weergeven viewing-training-reports

Om te controleren of de Slimme Dienst van de Inhoud op uw markeringen in de trainingsreeks activa wordt getraind, herzie het rapport van de opleidingswerkstroom van de console van Rapporten.

  1. Ga in de Experience Manager -interface naar Tools > Assets > Reports .

  2. Klik op Create op de pagina Asset Reports .

  3. Selecteer het rapport Smart Tags Training en klik vervolgens op Next op de werkbalk.

  4. Geef een titel en beschrijving voor het rapport op. Laat onder Schedule Report de optie Now ingeschakeld. Als u het rapport voor later wilt plannen, selecteert u Later en geeft u een datum en tijd op. Klik vervolgens op Create op de werkbalk.

  5. Selecteer op de pagina Asset Reports het rapport dat u hebt gegenereerd. Klik op View op de werkbalk om het rapport weer te geven.

  6. Bekijk de details van het rapport.

    Het rapport geeft de trainingsstatus weer voor de tags die u hebt getraind. De groene kleur in de kolom Training Status geeft aan dat de Smart Content Service is getraind voor de tag. Een gele kleur geeft aan dat de service niet volledig is getraind voor een bepaalde tag. Voeg in dit geval meer afbeeldingen met de desbetreffende tag toe en voer de trainingsworkflow uit om de service volledig op de tag te trainen.

    Als dit rapport uw tags niet bevat, voert u de trainingsworkflow voor deze tags opnieuw uit.

  7. Als u het rapport wilt downloaden, selecteert u het in de lijst en klikt u op Download op de werkbalk. Het rapport wordt gedownload als een Microsoft Excel-spreadsheet.

Beperkingen limitations

  • Verbeterde slimme tags zijn gebaseerd op leermodellen van afbeeldingen en hun tags. Deze modellen zijn niet altijd perfect bij het identificeren van tags. De huidige versie van de Smart Content Service heeft de volgende beperkingen:

    • Kan subtiele verschillen in afbeeldingen niet herkennen. Bijvoorbeeld dunne en standaard gemonteerde hemden.
    • Kan geen tags identificeren op basis van kleine patronen/delen van een afbeelding. Bijvoorbeeld logo's op T-shirts.
    • Tags worden ondersteund in de landinstellingen waarin Experience Manager wordt ondersteund.

  • Als u wilt zoeken naar elementen met slimme tags (normaal of uitgebreid), gebruikt u Assets Omnzoekopdracht (full-text zoekopdracht). Er is geen afzonderlijke zoekvoorspelling voor slimme tags.

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