Préparation de Assets pour le balisage intelligent

Avant de pouvoir commencer à baliser vos ressources à l’aide des services de contenu dynamique, intégrez Experience Manager Assets à Adobe Developer Console afin d’exploiter le service dynamique de 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 :

Intégration à Adobe Developer Console

Lorsque vous effectuez une intégration avec Adobe Developer Console, le serveur Experience Manager authentifie vos informations d’identification du service auprès de la passerelle Adobe Developer Console 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 :

  1. Pour générer une clé publique, créez une configuration Smart Content Service dans Experience Manager. Obtenez un certificat public pour l’intégration d’OAuth.

  2. Créez une intégration dans Adobe Developer Console et chargez la clé publique générée.

  3. Configurez votre déploiement à l’aide de la clé API et d’autres informations d’identification d’Adobe Developer Console.

  4. Testez la configuration.

  5. Si vous le souhaitez, activez le balisage automatique lors du chargement de la ressource.

Obtention d’un certificat public en créant la configuration du service de contenu dynamique

Un certificat public permet d’authentifier votre profil sur Adobe Developer Console.

  1. Dans l’interface utilisateur Experience Manager, accédez à Outils > Cloud Services > Cloud Services hérités.

  2. Dans la page Cloud Services, cliquez sur Configurer maintenant sous Ressources - Balises intelligentes.

  3. Dans la boîte de dialogue Créer une configuration, spécifiez un titre et un nom pour la configuration de balises intelligentes. Cliquez sur Créer.

  4. Dans la boîte de dialogue Service de contenu dynamique AEM, utilisez les valeurs suivantes :

    URL du service: https://mc.adobe.io/marketingcloud/smartcontent

    Serveur d’autorisation: https://ims-na1.adobelogin.com

    Laissez les autres champs vides pour l’instant (pour les remplir ultérieurement). Cliquez sur OK.

    Boîte de dialogue Service de contenu dynamique de Experience Manager pour fournir l’URL du service de contenu

    Figure : Boîte de dialogue Smart Content Service pour fournir l’URL du service de contenu

    REMARQUE

    L’URL fournie comme URL du service n’est pas accessible par navigateur et génère une erreur 404. La configuration fonctionne sur OK avec la même valeur que le paramètre URL du service . Pour connaître l’état global du service et le planning de maintenance, voir https://status.adobe.com.

  5. Cliquez sur Télécharger le certificat public pour l’intégration OAuth, puis téléchargez le fichier de certificat public AEM-SmartTags.crt.

    Représentation des paramètres créés pour le service de balisage intelligent

    Figure : Paramètres du service de balisage intelligent.

Reconfiguration à l’expiration d’un certificat

Une fois qu’un certificat a expiré, il n’est plus approuvé. Vous ne pouvez pas renouveler un certificat ayant expiré. Pour ajouter un certificat, procédez comme suit.

  1. Connectez-vous en tant qu’administrateur à votre déploiement Experience Manager. Cliquez sur Outils > Sécurité > Utilisateurs.

  2. Recherchez et cliquez sur l’utilisateur dam-update-service. Cliquez sur l’onglet KeyStore.

  3. Supprimez le fichier de stockage de clés similaritysearch existant avec le certificat arrivé à expiration. Cliquez sur Enregistrer et fermer.

    Supprimer l’entrée de recherche par analogie existante dans le Keystore pour ajouter un certificat de sécurité

    Figure : Supprimez l’ similaritysearch entrée existante dans le Keystore pour ajouter un certificat de sécurité.

  4. Accédez à Outils > Cloud Services > Ancienne version de Cloud Services. Cliquez sur Balises dynamiques de ressources > Afficher la configuration > Configurations disponibles. Cliquez sur la configuration requise.

  5. Pour télécharger un certificat public, cliquez sur Télécharger le certificat public pour l’intégration Oauth.

  6. Accédez à https://console.adobe.io et accédez aux services de contenu intelligent existants sur la page Intégrations. Téléchargez le nouveau certificat. Pour plus d’informations, voir les instructions de la section Création de l’intégration d’Adobe Developer Console.

Création de l’intégration de Developer Console Adobe

Pour utiliser les API de service de contenu dynamique, créez une intégration dans Adobe Developer Console afin d’obtenir la clé API (générée dans le champ ID CLIENT de l’intégration d’Adobe Developer Console), ID DE COMPTE TECHNIQUE, ID ORGANIZATION et SECRET CLIENT pour Paramètres du service de balisage intelligent des ressources de la configuration cloud dans Experience Manager.

  1. Accédez à l’URL https://console.adobe.io dans un navigateur. Sélectionnez le compte approprié et vérifiez que le rôle d’organisation associé est administrateur système.

  2. Créez un projet portant le nom de votre choix. Cliquez sur Add API (Ajouter une API).

  3. Sur la page Add API, sélectionnez Experience Cloud puis Smart Content (Contenu dynamique). Cliquez sur Next (Suivant).

  4. Sélectionnez Upload your public key (Charger votre clé publique). Fournissez le fichier de certificat téléchargé depuis Experience Manager. Le message Public key(s) uploaded successfully (La ou les clés publiques ont été chargées) s’affiche. Cliquez sur Next (Suivant).

    La page Create a new Service Account (JWT) credentialpage affiche la clé publique du compte de service.

  5. Cliquez sur Next (Suivant).

  6. Dans la page Select product profiles (Sélectionner les profils de produits), sélectionnez Smart Content Services (Services de contenu dynamique). Cliquez sur Save configured API (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 Paramètres du service de balisage intelligent des ressources de la configuration cloud dans Experience Manager pour configurer les balises intelligentes.

    Dans l’onglet Overview (Aperçu), vous pouvez consulter les informations fournies pour l’intégration.

    Figure : Détails de l’intégration dans Adobe Developer Console

Configuration du service de contenu dynamique

Pour configurer l’intégration, utilisez les valeurs ID DE COMPTE TECHNIQUE, ID D’ORGANISATION, SECRET CLIENT et les champs ID CLIENT de l’intégration Adobe Developer Console. La création d’une configuration cloud de balises intelligentes permet d’authentifier les demandes d’API provenant du déploiement Experience Manager.

  1. Dans Experience Manager, accédez à Outils > Cloud Service > Cloud Services hérités pour ouvrir la console Cloud Services.

  2. Sous Ressources – Balises intelligentes, ouvrez la configuration créée ci-dessus. Sur la page de paramètres du service, cliquez sur Modifier.

  3. Dans la boîte de dialogue Service de contenu dynamique AEM, utilisez les valeurs préremplies pour les champs URL de service et Serveur d’autorisation.

  4. Pour les champs Clé d’API, ID de compte technique, ID d’organisation et Secret du client, copiez et utilisez les valeurs suivantes générées dans l’ intégration d’Adobe Developer Console.

    Paramètres du service de balisage intelligent des ressources Adobe Developer Console champs d'intégration
    Clé API ID CLIENT
    Identifiant de compte technique ID DE COMPTE TECHNIQUE
    Identifiant d'organisation ID D’ORGANISATION
    Secret client SECRET CLIENT

Validation de la configuration

Une fois la configuration terminée, vous pouvez utiliser un MBean JMX pour la valider. Pour procéder à la validation, suivez ces étapes.

  1. Accédez à votre serveur Experience Manager à l’adresse https://[aem_server]:[port].

  2. Accédez à Outils > Opérations > Console web pour ouvrir la console OSGi. Cliquez sur Principal > JMX.

  3. Cliquez sur com.day.cq.dam.similaritysearch.internal.impl. Il ouvre Tâches diverses SimilaritySearch.

  4. Cliquez sur validateConfigs(). Dans la boîte de dialogue Valider les configurations, cliquez sur Invoquer.

Les résultats de la validation s’affichent dans la même boîte de dialogue.

Activez le balisage intelligent dans le workflow Ressource de mise à jour de gestion des actifs numériques (facultatif)

  1. Dans Experience Manager, accédez à Outils > Workflow > Modèles.

  2. Sur la page Modèles de processus, sélectionnez le modèle de processus Ressources de mise à jour de gestion des actifs numériques.

  3. Cliquez sur Modifier dans la barre d’outils.

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

    Ajout de l’étape Balisage intelligent de la ressource après l’étape Miniatures des processus dans le processus Ressources de mise à jour de gestion des actifs numériques

    Figure : Ajout de l’étape Balisage intelligent de la ressource après l’étape Miniatures des processus dans le processus Ressources de mise à jour de gestion des actifs numériques.

  5. Ouvrez l’étape en mode édition. Dans Paramètres avancés, vérifiez que l’option Avance du gestionnaire est sélectionnée.

    Configuration du workflow Ressources de mise à jour de gestion des actifs numériques et ajout de l’étape Balisage intelligent

    Figure : Configuration du workflow Ressources de mise à jour de gestion des actifs numériques et ajout de l’étape Balisage intelligent

  6. Dans l’onglet Arguments, sélectionnez Ignorer les erreurs si vous souhaitez que le processus se termine même si l’étape de balisage automatique échoue.

    Configuration du workflow Ressources de mise à jour de gestion des actifs numériques pour ajouter l’étape Balisage intelligent et sélectionner l’avance du gestionnaire

    Figure : Configuration du workflow Ressources de mise à jour de gestion des actifs numériques pour ajouter l’étape Balisage intelligent et sélectionner l’avance du gestionnaire

    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.

    Configurez le workflow Ressources de mise à jour de gestion des actifs numériques pour ajouter une étape de balise intelligente et sélectionnez Ignorer l’indicateur de balise intelligente .

    Figure : Configurez le workflow Ressources de mise à jour de gestion des actifs numériques pour ajouter l’étape Balisage intelligent et sélectionnez Ignorer l’indicateur Balisage intelligent .

  7. Cliquez sur OK pour fermer l’étape du processus, puis enregistrez ce dernier.

Entraînement du service de contenu dynamique

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 exige que les images d’entraînement respectent certaines instructions. Après l’entraînement, le service peut appliquer la même taxonomie sur un ensemble de ressources similaire.

Vous pouvez entraîner plusieurs fois le service afin d’améliorer sa capacité à appliquer les balises appropriées. Après chaque cycle d’entraînement, exécutez un workflow de balisage et vérifiez que vos ressources sont correctement balisées.

Vous pouvez entraîner le service de contenu dynamique périodiquement ou en fonction des besoins.

REMARQUE

Le workflow d’entraînement s’exécute sur les dossiers uniquement.

Instructions d’entraînement

Pour de meilleurs résultats, les images de votre jeu d’entraînement sont conformes aux directives 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.

Images d’illustration donnant un exemple d’instructions d’entraînement

Couverture : Utilisez une variété suffisante d’images dans l’entraînement. L'idée est de fournir quelques exemples raisonnablement variés pour que le Experience Manager apprenne à se concentrer sur les bonnes choses. 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.

Images d’illustration donnant un exemple d’instructions d’entraînement

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.

Images d’illustration donnant un exemple d’instructions d’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.

Images d’illustration donnant un exemple d’instructions d’entraînement

REMARQUE

La capacité du service de contenu dynamique à s’entraîner à partir de vos balises et à les appliquer à d’autres images dépend de la qualité des images que vous utilisez pour l’entraînement. Pour obtenir des résultats optimaux, Adobe recommande d’utiliser des images visuellement similaires afin d’entraîner le service pour chaque balise.

Entraînement périodique

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 Propriétés de votre dossier de ressources, sélectionnez Activer les balises intelligentes sous l’onglet Détails et enregistrez les modifications.

enable_smart_tags

Une fois cette option 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 sur une base hebdomadaire à 0 h 30 le samedi.

Entraînement à la demande

Vous pouvez entraîner le service de contenu dynamique chaque fois que cela est nécessaire à partir de la console Processus.

  1. Dans l’interface Experience Manager, accédez à Outils > Workflow > Modèles.

  2. Sur la page Modèles de processus , sélectionnez le workflow Entraînement des balises intelligentes , puis cliquez sur Démarrer le processus dans la barre d’outils.

  3. Dans la boîte de dialogue Exécuter le processus, localisez le dossier de charge utile qui comprend les ressources balisées pour entraîner le service.

  4. Indiquez un titre pour le workflow et ajoutez un commentaire. Cliquez ensuite sur Exécuter. Les ressources et les balises sont soumises à l’entraînement.

    workflow_dialog

REMARQUE

Une fois que les ressources d’un dossier sont traitées pour formation, seules les ressources modifiées sont traitées au cours des cycles de formation suivants.

Afficher les rapports de formation

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.

  1. Dans l’interface Experience Manager, accédez à Outils > Ressources > Rapports.

  2. Dans la page Rapports de ressources, cliquez sur Créer.

  3. Sélectionnez le rapport Entraînement des balises intelligentes, puis cliquez sur Suivant dans la barre d’outils.

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

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

  6. Passez en revue les détails du rapport.

    Le rapport affiche l’état 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.

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

Restrictions

  • Les balises intelligentes améliorées sont basées sur les modèles d’apprentissage des 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/é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 où Experience Manager est pris en charge. Pour obtenir la liste des langues, voir Notes de mise à jour du service de contenu dynamique.
  • 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.

Sur cette page