Préparation de Assets pour le balisage intelligent configure-asset-tagging-using-the-smart-content-service
Avant de commencer à baliser vos ressources à l’aide des services de contenu dynamique, intégrez Experience Manager Assets à l’Adobe Developer Console pour tirer parti du service dynamique d’Adobe Sensei. Une fois configuré, entraînez le service à l’aide de quelques images et d’une balise.
Avant d’utiliser le service de contenu dynamique, vérifiez les points suivants :
-
Installez le dernier pack de services Experience Manager.
Mise à niveau SCS pour la prise en charge d’OAuth pour Adobe Managed Services scs-upgrade-oauth-managed-services
Nouveaux utilisateurs et nouvelles utilisatrices
Installez le pack de services 22. Pour prendre en charge l’intégration OAuth sur le pack de services 22, vous devez installer le correctif pour le pack de services 22.
Suivez les instructions mentionnées dans cet article pour configurer les services de contenu dynamique.
Utilisateurs et utilisatrices existants
Si vous avez effectué la mise à niveau vers le pack de services 21, installez le correctif pour le pack de services 21 pour prendre en charge l’intégration OAuth. Toute configuration existante est automatiquement supprimée. Suivez les instructions mentionnées dans cet article pour configurer les services de contenu dynamique. Si vous effectuez une mise à niveau vers le pack de services 22, vous devez installer ce correctif pour le pack de services 22.
Pour le pack de services 20 et les versions antérieures, vous devez exécuter les étapes de contournement pour que SCS prenne en charge l’intégration OAuth. Consultez la section Dépannage des balises intelligentes pour les informations d’identification OAuth.
Mise à niveau SCS pour prendre en charge Oauth pour les utilisateurs et utilisatrices On-premise scs-upgrade-oauth-on-premise
Nouveaux utilisateurs et nouvelles utilisatrices
Les services de contenu intelligent ne sont plus disponibles pour les nouveaux utilisateurs et les nouvelles utilisatrices On-Premise Experience Manager Assets.
Utilisateurs et utilisatrices existants
Les utilisateurs et utilisatrices On-Premise existants, pour qui cette fonctionnalité est déjà activée, peuvent continuer à utiliser les services de contenu intelligent.
Si vous avez effectué la mise à niveau vers le pack de services 21, installez le correctif pour le pack de services 21 pour prendre en charge l’intégration OAuth. Toute configuration existante est automatiquement supprimée. Suivez les instructions mentionnées dans cet article pour configurer les services de contenu dynamique. Si vous effectuez une mise à niveau vers le pack de services 22, vous devez installer ce correctif pour le pack de services 22.
Pour le pack de services 20 et les versions antérieures, vous devez exécuter les étapes de contournement pour que SCS prenne en charge l’intégration OAuth. Consultez la section Dépannage des balises intelligentes pour les informations d’identification OAuth.
Intégration à la console Adobe Developer integrate-adobe-io
Lors de l’intégration à la console Adobe Developer, le serveur Experience Manager authentifie vos informations d’identification de service auprès de la passerelle de la console Adobe Developer avant de transférer votre demande au service de contenu dynamique. Pour l’intégration, vous avez besoin d’un compte Adobe ID disposant de droits d’administrateur pour l’organisation et d’une licence Smart Content Service achetée et activée pour votre organisation.
Pour configurer le service de contenu dynamique, procédez comme suit :
-
Créez une intégration dans l’Adobe Developer Console.
-
Créez la configuration du compte technique Adobe IMS en utilisant la clé API et d’autres informations d’identification fournies par l’Adobe Developer Console.
Créer l’intégration de l’Adobe Developer Console create-adobe-io-integration
Pour utiliser les API de service de contenu dynamique, créez une intégration dans l’Adobe Developer Console afin d’obtenir la Clé API (générée dans le champ ID CLIENT de l’intégration dans l’Adobe Developer Console), l’ID D’ORGANISATION et le SECRET CLIENT pour les Paramètres du service de balisage intelligent des ressources de la configuration cloud dans Experience Manager.
-
Accédez à l’URL https://developer.adobe.com dans un navigateur. Sélectionnez le compte approprié et vérifiez que le rôle d’organisation associé est administrateur ou administratrice système.
-
Créez un projet portant le nom de votre choix. Cliquez sur Add API (Ajouter une API).
-
Sur la page Add API, sélectionnez Experience Cloud puis Smart Content (Contenu dynamique). Cliquez sur Next (Suivant).
-
Sélectionnez OAuth serveur à serveur. Cliquez sur Suivant.
Pour plus de détails sur la façon d’effectuer cette configuration, consultez la documentation de la Developer Console, en fonction de vos besoins :-
Vue d’ensemble :
-
Créer de nouvelles informations d’identification OAuth :
-
Migrer des informations d’identification JWT existantes vers des informations d’identification OAuth :
-
-
Dans la page Sélectionner les profils de produit, sélectionnez Services de contenu dynamique. Cliquez sur Enregistrer l’API configurée.
Une page affiche davantage d’informations sur la configuration. Laissez cette page ouverte pour copier et ajouter ces valeurs dans les Paramètres du service de balisage intelligent des ressources de la configuration cloud dans Experience Manager pour configurer des balises intelligentes.
Créer la configuration du compte technique Adobe IMS create-ims-account-config
Suivez les étapes ci-dessous pour créer la configuration du compte technique IMS :
-
Dans l’interface d’utilisation Experience Manager, accédez à Outils > Sécurité > Configurations d’Adobe IMS.
-
Cliquez sur Créer.
-
Dans la boîte de dialogue Configuration du compte technique Adobe IMS, utilisez les valeurs suivantes :
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 Champ Description Solution cloud Sélectionnez Balises intelligentes dans le menu déroulant. Titre Ajoutez le titre du compte IMS de configuration. Serveur d’autorisation Ajouter https://ims-na1.adobelogin.comID client À fournir via l’Adobe Developer Console. Secret client À fournir via l’Adobe Developer Console. Portée À fournir via l’Adobe Developer Console. ID d’organisation À fournir via l’Adobe Developer Console. -
Sélectionnez la configuration que vous avez créée et cliquez sur Contrôle de l’intégrité.
-
Confirmez la boîte de dialogue du Contrôle de l’intégrité, puis cliquez sur Fermer une fois la configuration vérifiée comme saine.
Créer une configuration configure-smart-content-service
Pour configurer l’intégration, utilisez les valeurs d’ID DE COMPTE TECHNIQUE, d’ID D’ORGANISATION, de SECRET CLIENT et d’ID CLIENT à partir de l’intégration de la console Adobe Developer. La création d’une configuration cloud de balises intelligentes permet d’authentifier les demandes d’API provenant du déploiement Experience Manager.
-
Dans Experience Manager, accédez à Outils > Cloud Service > Balise intelligente pour ouvrir les configurations de balise intelligente.
-
Cliquez sur Créer pour créer une configuration. Autrement, cliquez sur Propriétés pour mettre à jour la configuration existante.
-
Renseignez les champs suivants :
table 0-row-2 1-row-2 2-row-2 3-row-2 Champ Description Titre Ajoutez le titre du compte IMS de configuration. Configuration Adobe IMS associée Sélectionnez une configuration dans le menu déroulant. Service URL (URL du service) https://smartcontent.adobe.io/<region where your Experience Manager author instance is hosted>. Par exemple,https://smartcontent.adobe.io/apac. Vous pouvez indiquerna,emea, ouapaccomme les régions où votre instance d’auteur Experience Manager est hébergée.note note NOTE Si le service géré Experience Manager est mis en service avant le 1er septembre 2022, utilisez l’URL de service suivante : https://mc.adobe.io/marketingcloud/smartcontent -
Cliquez sur Enregistrer et fermer.
Validation de la configuration validate-the-configuration
Une fois la configuration terminée, vous pouvez utiliser un MBean JMX pour valider la configuration. Pour procéder à la validation, suivez ces étapes.
-
Accédez à votre serveur Experience Manager sur
https://[aem_server]:[port]. -
Accédez à Outils > Opérations > Console Web pour ouvrir la console OSGi. Cliquez sur Principal > JMX.
-
Cliquez sur
com.day.cq.dam.similaritysearch.internal.impl (SCS).
-
Cliquez sur
validateConfigs(). Dans la boîte de dialogue Valider les configurations, cliquez sur Invoquer.
Le résultat de la validation s’affiche dans la même boîte de dialogue.
Activation du balisage intelligent dans le workflow Ressource de mise à jour de la gestion des ressources numériques (Facultatif) enable-smart-tagging-in-the-update-asset-workflow-optional
-
Dans Experience Manager, accédez à Outils > Workflow > Modèles.
-
Sur la page Modèles de processus, sélectionnez le modèle de processus Ressources de mise à jour de gestion des actifs numériques (DAM).
-
Cliquez sur Modifier dans la barre d’outils.
-
Développez le panneau latéral pour afficher les étapes. Faites glisser l’étape Balisage intelligent de la ressource disponible dans la section Processus de DAM (gestion des actifs numériques) et placez-la après l’étape Miniatures des processus.
-
Ouvrez les propriétés de l’étape pour modifier les détails. Dans Paramètres avancés, vérifiez que l’option Avance du gestionnaire est sélectionnée.
-
Dans l’onglet Arguments, sélectionnez Ignorer les erreurs si vous souhaitez que le workflow se termine même si l’étape de balisage automatique échoue.
De plus, pour baliser les ressources lors de leur chargement, et ce, que le balisage intelligent soit activé ou non dans les dossiers, cochez la case Ignorer l’indicateur de balise intelligente.
-
Cliquez sur Terminé
-
Cliquez sur Synchroniser pour enregistrer le workflow.
Entraînement du service de contenu dynamique training-the-smart-content-service
Pour que le service de contenu dynamique reconnaisse votre taxonomie métier, exécutez-la sur une série de ressources qui incluent déjà des balises correspondant à votre entreprise. Pour baliser efficacement vos images de marque, le service de contenu dynamique requiert que les images d’entraînement respectent certaines instructions. Après l’entraînement, le service peut appliquer la même taxonomie à un ensemble de ressources similaire.
Vous pouvez entraîner le service plusieurs fois afin d’améliorer sa capacité à appliquer des balises pertinentes. Après chaque cycle d’entraînement, exécutez un workflow de balisage et vérifiez si vos ressources sont correctement balisées.
Vous pouvez entraîner le service de contenu intelligent périodiquement ou selon les besoins.
Instructions d’entraînement guidelines-for-training
Pour un résultat optimal, les images de votre corpus d’entraînement respectent les instructions suivantes :
Quantité et taille : minimum 30 images par balise. Minimum 500 pixels sur le côté le plus long.
Cohérence : les images utilisées pour une balise spécifique sont visuellement similaires.
Par exemple, il est déconseillé d’incorporer une balise my-party pour toutes ces images (en situation d’entraînement), car elles ne sont pas similaires visuellement.
Couverture : les images d’entraînement doivent être suffisamment variées. L’idée est de fournir quelques exemples raisonnablement différents pour apprendre à Experience Manager à se concentrer sur les bons éléments. Si vous appliquez la même balise sur des images visuellement différentes, incluez au moins cinq exemples de chaque type.
Par exemple, pour la balise mannequin-pose-tête-baissée, incluez davantage d’images d’entraînement similaires à l’image mise en évidence ci-dessous pour que le service reconnaisse les images similaires avec plus de précision lors du balisage.
Distraction/obstruction : l’entraînement du service donne de meilleurs résultats sur les images qui ont moins de distractions (telles que des arrière-plans importants ou des objets/personnes sans lien avec le sujet principal).
Par exemple, pour la balise chaussure-décontractée, la seconde image n’est pas un bon candidat pour l’entraînement.
Complétude : si une image est admissible pour plusieurs balises, ajoutez toutes les balises applicables avant d’inclure l’image à des fins de formation. Par exemple, pour les balises telles que raincoat et model-side-view, ajoutez les deux balises sur la ressource éligible avant de l’inclure pour la formation.
Entraînement périodique periodic-training
Vous pouvez activer le service de contenu dynamique afin qu’il s’entraîne périodiquement sur les ressources et les balises associées au sein d’un dossier. Ouvrez la page de Propriétés de votre dossier de ressources, sélectionnez Activer les balises intelligentes sous l’onglet Détails et enregistrez les modifications.
Lorsque cette option est sélectionnée pour un dossier, Experience Manager exécute automatiquement un workflow d’entraînement afin d’entraîner le service de contenu dynamique sur les ressources du dossier et leurs balises. Par défaut, le workflow d’entraînement s’exécute toutes les semaines à 00 h 30 le samedi.
Entraînement à la demande on-demand-training
Vous pouvez entraîner le service de contenu dynamique lorsque cela s’avère nécessaire à partir de la console de workflow.
-
Dans l’interface d’Experience Manager, accédez à Outils > Workflow > Modèles.
-
Dans la page Modèles de workflow, sélectionnez le workflow Entraînement des balises intelligentes, puis cliquez sur Démarrer le workflow dans la barre d’outils.
-
Dans la boîte de dialogue Exécuter le workflow, localisez le dossier de payload qui comprend les ressources balisées pour entraîner le service.
-
Indiquez le titre du workflow et ajoutez un commentaire. Cliquez ensuite sur Exécuter. Les ressources et les balises sont soumises à l’entraînement.
Affichage des rapports de formation viewing-training-reports
Pour vérifier que le service de contenu dynamique est entraîné sur vos balises dans la série de ressources d’entraînement, examinez le rapport de workflow d’entraînement dans la console Rapports.
-
Dans l’interface Experience Manager, accédez à Outils > Ressources > Rapports.
-
Dans la page Rapports de ressources, cliquez sur Créer.
-
Sélectionnez le rapport Entraînement des balises intelligentes, puis cliquez sur Suivant dans la barre d’outils.
-
Indiquez un titre et une description pour le rapport. Sous Planifier le rapport, laissez l’option Maintenant sélectionnée. Si vous souhaitez planifier le rapport pour une date ultérieure, sélectionnez Plus tard et spécifiez une date et une heure. Ensuite, cliquez sur Créer dans la barre d’outils.
-
Dans la page Rapports de ressources, sélectionnez le rapport que vous avez généré. Pour afficher le rapport, cliquez sur Afficher dans la barre d’outils.
-
Passez en revue les détails du rapport.
Le rapport affiche le statut d’identification des balises que vous avez entraînées. La couleur verte de la colonne État de l’entraînement indique que le service de contenu dynamique est entraîné pour la balise. La couleur jaune indique que le service n’est pas complètement entraîné pour une balise particulière. Dans ce cas, ajoutez d’autres images avec la balise particulière et exécutez le workflow d’entraînement pour l’entraînement complet du service sur la balise.
Si vous ne voyez pas vos balises dans ce rapport, lancez à nouveau le workflow d’entraînement pour ces balises.
-
Pour télécharger le rapport, sélectionnez-le dans la liste, puis cliquez sur Télécharger dans la barre d’outils. Le rapport est téléchargé sous la forme d’une feuille de calcul Microsoft Excel.
Limites limitations
-
Le balisage intelligent amélioré est basé sur des modèles d’apprentissage d’images et de leurs balises. Ces modèles ne sont pas toujours parfaits pour identifier les balises. La version actuelle du service de contenu dynamique présente les limites suivantes :
- Impossibilité d’identifier des différences subtiles dans les images. Par exemple, des chemises coupe droite ou ajustée.
- Impossibilité d’identifier des balises basées sur des motifs ou des éléments minuscules d’une image. Par exemple, des logos sur des t-shirts.
- Le balisage est pris en charge dans les paramètres régionaux gérés par Experience Manager.
-
Pour rechercher des ressources à l’aide de balises intelligentes (standard ou améliorées), utilisez la recherche de texte intégral d’Assets. Il n’y a aucun prédicat de recherche distinct pour les balises intelligentes.