Vorbereiten von Assets für Smart-Tagging configure-asset-tagging-using-the-smart-content-service
Bevor Sie mit dem Tagging Ihrer Assets per Smart Content Services beginnen können, integrieren Sie Experience Manager Assets in die Adobe Developer Console, um den Smart-Service von Adobe Sensei zu nutzen. Nach der Konfiguration trainieren Sie den Service mit einigen Bildern und einem Tag.
Bevor Sie den Smart Content Service verwenden, führen Sie Folgendes aus:
-
Installieren Sie die neueste Version des Experience Manager Service Pack.
SCS-Upgrade zur Unterstützung von OAuth für Adobe Managed Services scs-upgrade-oauth-managed-services
Neue Benutzende
Installieren Sie Service Pack 22. Um die OAuth-Integration auf Service Pack 22 zu unterstützen, müssen Sie den Hotfix für Service Pack 22 installieren.
Befolgen Sie die in diesem Artikel beschriebenen Anweisungen zum Einrichten von Smart Content Services.
Vorhandene Benutzende
Wenn Sie ein Upgrade auf Service Pack 21 durchgeführt haben, installieren Sie den Hotfix für Service Pack 21, um die OAuth-Integration zu unterstützen. Jede vorhandene Konfiguration wird automatisch gelöscht. Befolgen Sie die in diesem Artikel beschriebenen Anweisungen zum Einrichten von Smart Content Services. Wenn Sie ein Upgrade auf Service Pack 22 durchführen, müssen Sie diesen Hotfix für Service Pack 22 installieren.
Für Service Pack 20 und älter müssen Sie die Problemumgehungsschritte für SCS ausführen, damit die OAuth-Integration unterstützt wird. Siehe Fehlerbehebung für Smart-Tags hinsichtlich OAuth-Anmeldedaten.
SCS-Upgrade zur Unterstützung von OAuth für On-Premise-Benutzende scs-upgrade-oauth-on-premise
Neue Benutzende
Smart Content Services ist für neue On-Premise-Benutzende von Experience Manager Assets nicht mehr verfügbar.
Vorhandene Benutzende
Vorhandene On-Premise-Benutzende, die diese Funktion bereits aktiviert haben, können Smart Content Services weiterhin nutzen.
Wenn Sie ein Upgrade auf Service Pack 21 durchgeführt haben, installieren Sie den Hotfix für Service Pack 21, um die OAuth-Integration zu unterstützen. Jede vorhandene Konfiguration wird automatisch gelöscht. Befolgen Sie die in diesem Artikel beschriebenen Anweisungen zum Einrichten von Smart Content Services. Wenn Sie ein Upgrade auf Service Pack 22 durchführen, müssen Sie diesen Hotfix für Service Pack 22 installieren.
Für Service Pack 20 und älter müssen Sie die Problemumgehungsschritte für SCS ausführen, damit die OAuth-Integration unterstützt wird. Siehe Fehlerbehebung für Smart-Tags hinsichtlich OAuth-Anmeldedaten.
Integrieren mit der Adobe Developer Console integrate-adobe-io
Bei der Integration mit der Adobe Developer Console authentifiziert der Experience Manager-Server Ihre Service-Anmeldedaten beim Adobe Developer Console-Gateway, bevor er Ihre Anfrage an den Smart Content Service weiterleitet. Zur Integration benötigen Sie ein Adobe ID-Konto mit Administratorrechten für die für Ihr Unternehmen erworbene und aktivierte Smart Content Service-Lizenz.
Gehen Sie wie folgt vor, um den Smart Content Service zu konfigurieren:
-
Erstellen Sie eine Integration in Adobe Developer Console.
-
Erstellen Sie eine Konfiguration des technischen IMS-Kontos mithilfe des API-Schlüssels und der anderen Anmeldedaten aus der Adobe Developer Console.
Erstellen einer Integration in der Adobe Developer Console create-adobe-io-integration
Um die Smart Content Service-APIs zu verwenden, erstellen Sie eine Integration in der Adobe Developer Console, um den API-Schlüssel (der im Feld CLIENT-ID der Adobe Developer Console-Integration generiert wird), die ORGANISATIONS-ID und das CLIENT-GEHEIMNIS für die Smart Tagging Service-Einstellungen für Assets der Cloud-Konfiguration in Experience Manager zu erhalten.
-
Rufen Sie https://developer.adobe.com in einem Browser auf. Wählen Sie das entsprechende Konto aus und vergewissern Sie sich, dass die zugehörige Organisationsrolle Systemadministrator ist.
-
Erstellen Sie ein Projekt mit einem beliebigen Namen. Klicken Sie auf API hinzufügen.
-
Wählen Sie auf der Seite API hinzufügen die Option Experience Cloud und dann Smart Content aus. Klicken Sie auf Weiter.
-
Wählen Sie OAuth Server-to-Server aus. Klicken Sie auf Weiter.
Weitere Informationen zu dieser Konfiguration finden Sie in der Dokumentation zur Developer Console, abhängig von Ihren Anforderungen:-
Übersicht:
-
Erstellen von neuen OAuth-Anmeldedaten:
-
Migration von vorhandenen JWT-Anmeldedaten zu OAuth-Anmeldedaten:
-
-
Wählen Sie auf der Seite Produktprofile auswählen die Option Smart Content Services aus. Klicken Sie auf Konfigurierte API speichern.
Auf einer Seite werden weitere Informationen zur Konfiguration angezeigt. Lassen Sie diese Seite geöffnet, um diese Werte zu kopieren und in den Einstellungen des Smart Tagging Service für Assets in der Cloud-Konfiguration in Experience Manager zuzufügen, um Smart Tags zu konfigurieren.
Erstellen der Konfiguration des technischen IMS-Kontos create-ims-account-config
Sie müssen die Konfiguration des technischen IMS-Kontos mithilfe der folgenden Schritte erstellen:
-
Rufen Sie in der Experience Manager-Benutzeroberfläche Tools > Sicherheit > Adobe IMS-Konfigurationen auf.
-
Klicken Sie auf Erstellen.
-
Verwenden Sie im Dialogfeld „Konfiguration des technischen IMS-Kontos“ die folgenden Werte:
table 0-row-2 1-row-2 2-row-2 3-row-2 4-row-2 5-row-2 6-row-2 7-row-2 Feld Beschreibung Cloud-Lösung Wählen Sie aus dem Dropdown-Menü Smart-Tags aus. Titel Fügen Sie den Titel des konfigurierenden IMS-Kontos hinzu. Autorisierungs-Server Fügen Sie https://ims-na1.adobelogin.comhinzu.Client-ID Wird über die Adobe Developer Console bereitgestellt. Client-Geheimnis Wird über die Adobe Developer Console bereitgestellt. Anwendungsbereich Wird über die Adobe Developer Console bereitgestellt. Organisations-ID Wird über die Adobe Developer Console bereitgestellt. -
Wählen Sie die von Ihnen erstellte Konfiguration aus und klicken Sie auf Konsistenz prüfen.
-
Bestätigen Sie das Dialogfeld „Konsistenz prüfen“ und klicken Sie auf „Schließen“, sobald die Konfiguration im konsistenten Status ist.
Erstellen einer neuen Konfiguration configure-smart-content-service
Verwenden Sie zum Konfigurieren der Integration die Werte der Felder ID DES TECHNISCHEN KONTOS, ORGANISATIONS-ID, CLIENT-GEHEIMNIS und CLIENT-ID aus der Adobe Developer Console-Integration. Das Erstellen einer Smart-Tags-Cloud-Konfiguration ermöglicht die Authentifizierung von API-Anfragen aus der Experience Manager-Bereitstellung.
-
Navigieren Sie in Experience Manager zu Tools > Cloud Service > Smart-Tag, um die Smart-Tag-Konfigurationen zu öffnen.
-
Klicken Sie auf Erstellen, um eine neue Konfiguration zu erstellen. Klicken Sie andernfalls auf Eigenschaften, um die vorhandene Konfiguration zu aktualisieren.
-
Füllen Sie die folgenden Felder aus:
table 0-row-2 1-row-2 2-row-2 3-row-2 Feld Beschreibung Titel Fügen Sie den Titel des konfigurierenden IMS-Kontos hinzu. Verknüpfte Adobe IMS-Konfiguration Wählen Sie die Konfiguration aus dem Dropdown-Menü aus. Service-URL https://smartcontent.adobe.io/<region where your Experience Manager author instance is hosted>. Beispiel:https://smartcontent.adobe.io/apac. Sie könnenna,emeaoderapacals die Regionen angeben, in denen Ihre Experience Manager-Autoreninstanz gehostet wird.note note NOTE Wenn der Experience Manager Managed Service vor dem 1. September 2022 bereitgestellt wurde, verwenden Sie die folgende Service-URL: https://mc.adobe.io/marketingcloud/smartcontent -
Klicken Sie auf Speichern und schließen.
Überprüfen der Konfiguration validate-the-configuration
Nachdem Sie die Konfiguration abgeschlossen haben, können Sie die Konfiguration mit einem JMX MBean überprüfen. Führen Sie zum Überprüfen die folgenden Schritte aus.
-
Greifen Sie unter
https://[aem_server]:[port]auf Ihren Experience Manager-Server zu. -
Gehen Sie zu Tools > Vorgänge > Web-Konsole, um die OSGi-Konsole zu öffnen. Klicken Sie auf Main > JMX.
-
Klicken Sie auf
com.day.cq.dam.similaritysearch.internal.impl (SCS).
-
Klicken Sie auf
validateConfigs(). Klicken Sie im Dialogfeld Konfigurationen prüfen auf Aufrufen.
Das Überprüfungsergebnis wird im selben Dialogfeld angezeigt.
Aktivieren der Smart-Tagging-Funktion im Workflow DAM Update Asset (optional) enable-smart-tagging-in-the-update-asset-workflow-optional
-
Gehen Sie in Experience Manager zu Tools > Workflow > Modelle.
-
Wählen Sie auf der Seite Workflow-Modelle das Workflow-Modell DAM Update Asset aus.
-
Klicken Sie in der Symbolleiste auf Bearbeiten.
-
Erweitern Sie das Seitenbedienfeld, um die Schritte anzuzeigen. Ziehen Sie den Schritt Asset intelligent taggen, der im Abschnitt „DAM-Workflow“ verfügbar ist, und platzieren Sie ihn nach dem Schritt Prozessminiaturansichten.
-
Öffnen Sie die Eigenschaften des Schritts, um die Details zu ändern. Stellen Sie unter Erweiterte Einstellungen sicher, dass die Option Handler-Erweiterung ausgewählt ist.
-
Wählen Sie auf der Registerkarte Argumente die Option Fehler ignorieren, wenn der Workflow auch dann abgeschlossen werden soll, falls der automatische Tag-Schritt fehlschlägt.
Um Assets unabhängig davon mit Tags zu versehen, ob die Smart-Tagging-Funktion für Ordner aktiviert ist, wählen Sie Smart-Tag-Markierung ignorieren aus.
-
Klicken Sie auf das Symbol
-
Klicken Sie auf Synchronisieren, um den Workflow zu speichern.
Trainieren des Smart Content Service training-the-smart-content-service
Damit der Smart Content Service die Taxonomie Ihres Unternehmens erkennen kann, sollten Sie den Dienst auf einen Asset-Satz ausführen, der bereits für Ihr Unternehmen relevante Tags enthält. Damit Sie Ihre Markenbilder effektiv mit Tags versehen können, müssen die zum Trainieren des Smart Content Service verwendeten Bilder bestimmten Richtlinien entsprechen. Nach dem Training kann der Dienst dieselbe Taxonomie auf einen ähnlichen Satz von Assets anwenden.
Sie können den Dienst mehrmals trainieren, um die Fähigkeit zu verbessern, relevante Tags anzuwenden. Führen Sie nach jedem Trainings-Zyklus einen Tagging-Workflow aus und überprüfen Sie, ob Ihre Assets mit den richtigen Tags versehen sind.
Sie können den Smart Content Service regelmäßig oder bei Bedarf trainieren.
Richtlinien für das Training guidelines-for-training
Für optimale Ergebnisse sollten Bilder im Trainingssatz folgende Richtlinien einhalten:
Menge und Größe: Mindestens 30 Bilder pro Tag. Mindestens 500 Pixel auf der längeren Seite.
Kohärenz: Bilder, die für ein bestimmtes Tag verwendet werden, sind optisch ähnlich.
So ist es beispielsweise nicht empfehlenswert, all diese Bilder mit dem Tag my-party zu versehen (zu Trainings-Zwecken), da sie einander visuell nicht ähnlich sind.
Abdeckung: Bei den Trainings-Bildern muss eine ausreichende Vielfalt vorhanden sein. Der Grundgedanke ist, einige Beispiele bereitzustellen, die jedoch verhältnismäßig vielfältig sind, sodass Experience Manager lernt, sich auf die richtigen Dinge zu konzentrieren. Wenn Sie dasselbe Tag auf visuell unähnliche Bilder anwenden, schließen Sie mindestens fünf Beispiele für jeden Typ ein.
Beispiel: Schließen Sie für das Tag model-down-pose mehr Trainings-Bilder ein, die dem hervorgehobenen Bild unten ähnlich sind, sodass der Service ähnliche Bilder beim Hinzufügen von Tags genauer identifizieren kann.
Ablenkung/Verdeckung: Der Service kann besser mit Bildern trainieren, die weniger Ablenkungen enthalten (hervorgehobenen Hintergründe oder Elemente ohne Bezug wie Objekte/Personen neben dem Hauptsubjekt).
Beispiel: Für das Tag casual-shoe ist das zweite Bild kein guter Kandidat für das Training.
Vollständigkeit: Wenn ein Bild für mehr als ein Tag qualifiziert ist, fügen Sie alle entsprechenden Tags hinzu, bevor Sie das Bild für eine Schulung hinzufügen. Beispiel: Fügen Sie im Falle von Tags wie raincoat und model-side-view beide Tags zum entsprechenden Asset hinzu, bevor Sie dieses für Trainingszwecke verwenden.
Regelmäßiges Training periodic-training
Sie können festlegen, dass der Smart Content Service regelmäßig mit den Assets und zugewiesenen Tags in einem Ordner trainiert wird. Öffnen Sie die Seite Eigenschaften Ihres Asset-Ordners, wählen Sie Smart-Tags aktivieren in der Registerkarte Details aus und speichern Sie die Änderungen.
Wenn Sie diese Option für einen Ordner auswählt haben, führt Experience Manager automatisch einen Trainings-Workflow aus, um den Smart Content Service mit den Assets im Ordner und deren Tags zu trainieren. Standardmäßig wird der Trainings-Workflow jede Woche samstags um 00:30 Uhr ausgeführt.
Training bei Bedarf on-demand-training
Sie können den Smart Content Service bei Bedarf über die Workflow-Konsole trainieren.
-
Gehen Sie in der Experience Manager-Benutzeroberfläche zu Tools > Workflow > Modelle.
-
Wählen Sie auf der Seite Workflow-Modelle den Workflow Smart-Tags-Training aus und klicken Sie dann in der Symbolleiste auf Workflow starten.
-
Suchen Sie im Dialogfeld Workflow ausführen nach dem Payload-Ordner, der die mit Tags versehenen Assets für das Trainieren des Services enthält.
-
Geben Sie einen Titel für den Workflow an und fügen Sie einen Kommentar hinzu. Klicken Sie dann auf Ausführen. Die Assets und Tags werden für das Training übermittelt.
Anzeigen von Trainings-Berichten viewing-training-reports
Um sicherzustellen, dass der Smart Content Service auf Ihre Tags im Asset-Trainingssatz trainiert ist, überprüfen Sie den Bericht zum Trainings-Workflow über die Berichte-Konsole.
-
Gehen Sie in der Experience Manager-Benutzeroberfläche zu Tools > Assets > Berichte.
-
Klicken Sie auf der Seite Asset-Berichte auf Erstellen.
-
Wählen Sie den Bericht Smart-Tags-Training aus und klicken Sie dann in der Symbolleiste auf Weiter.
-
Geben Sie einen Titel und eine Beschreibung für den Bericht an. Lassen Sie unter Berichtplanen die Option Jetzt aktiviert. Wenn Sie den Bericht für einen späteren Zeitpunkt planen möchten, wählen Sie Später und geben Sie ein Datum und eine Uhrzeit an. Klicken Sie dann in der Symbolleiste auf Erstellen.
-
Wählen Sie auf der Seite Asset-Berichte den erstellten Bericht aus. Um den Bericht anzuzeigen, klicken Sie in der Symbolleiste auf Ansicht.
-
Prüfen Sie die Details des Berichts.
Der Bericht zeigt den Trainings-Status der von Ihnen trainierten Tags an. Grün gibt in der Spalte Trainingsstatus an, dass der Smart Content Service für das Tag trainiert wird. Gelb bedeutet, dass der Service für ein bestimmtes Tag nicht vollständig trainiert ist. Fügen Sie in diesem Fall weitere Bilder mit dem jeweiligen Tag hinzu und führen Sie den Trainings-Workflow aus, um den Service vollständig für das Tag zu trainieren.
Wenn Ihre Tags nicht in diesem Bericht angezeigt werden, führen Sie den Trainings-Workflow für diese Tags erneut aus.
-
Um den Bericht herunterzuladen, wählen Sie ihn aus der Liste aus und klicken Sie in der Symbolleiste auf Herunterladen. Der Bericht kann als Microsoft Excel-Tabellenkalkulation heruntergeladen werden.
Beschränkungen limitations
-
Optimiertes Smart-Tagging basiert auf Lernmodellen von Bildern und den zugehörigen Tags. Diese Modelle können Tags nicht immer perfekt identifizieren. Bei der aktuellen Version des Smart Content Service bestehen folgende Einschränkungen:
- Subtile Unterschiede in Bildern können nicht erkannt werden. Beispiel: T-Shirts mit schmalem oder normalem Schnitt.
- Tags können nicht anhand von winzigen Mustern oder Teilen eines Bildes identifiziert werden. Beispiel: Logos auf T-Shirts.
- Tagging wird in den Gebietsschemata unterstützt, in denen Experience Manager unterstützt wird.
-
Verwenden Sie Assets-OmniSearch (Volltextsuche), um nach Assets mit Smart-Tags (normal oder erweitert) zu suchen. Es gibt kein separates Suchprädikat für Smart-Tags.