Préparer Assets pour le balisage intelligent

Avant de pouvoir début le balisage de vos ressources à l’aide de Smart Content Services, intégrez Experience Manager Assets à Adobe Developer Console pour tirer parti du service intelligent Adobe Sensei. Une fois configuré, le service est formé à l’aide de quelques images et d’une balise.

Avant d’utiliser Smart Content Service, 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 de service auprès de la passerelle Adobe Developer Console avant de transmettre votre demande à Smart Content Service. Pour l’intégrer, vous devez disposer d’un compte Adobe ID doté de droits d’administrateur pour l’entreprise et d’une licence Smart Content Service achetée et activée pour votre entreprise.

Pour configurer Smart Content Service, 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 vos déploiements à l’aide de la clé d’API et d’autres informations d’identification d’Adobe Developer Console.

  4. Testez la configuration.

  5. Vous pouvez éventuellement activer le balisage automatique lors du transfert des ressources.

Obtenez un certificat public en créant la configuration de Smart Content Service

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 Actifs Balises dynamiques.

  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 de Experience Manager Smart Content Service pour fournir l’URL du service de contenu

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

    REMARQUE

    L’URL fournie sous la forme URL du service n’est pas accessible par le biais du navigateur et génère une erreur 404. La configuration fonctionne correctement avec la même valeur que le paramètre URL du service. Pour connaître le statut général du service et le calendrier de maintenance, voir https://status.adobe.com.

  5. Cliquez sur Télécharger le certificat public pour l’intégration OAuth et 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.

Reconfigurer à l’expiration d’un certificat

Une fois qu’un certificat expire, 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 de similitude existante dans Keystore pour ajouter un certificat de sécurité

    Figure : Supprimez l’ similaritysearch entrée existante dans 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, consultez les instructions de Création de l'intégration de la Console développeur d'Adobes.

Créer l'intégration de la Console développeur d'Adobes

Pour utiliser les API de Smart Content Service, créez une intégration dans la Console développeur d'Adobes afin d'obtenir la clé d'API (générée dans le champ ID CLIENT de l'intégration de la Console développeur d'Adobes), ID de COMPTE TECHNIQUE, ID ORGANISATION et CLIENT SECRET pour Assets Smart Tagging Service Settings de la configuration du 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 d’ identification Créer un compte de service (JWT) 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. Conservez cette page ouverte pour copier et ajouter ces valeurs dans Paramètres du service de balisage intelligent des ressources de la configuration du cloud dans Experience Manager afin de configurer les balises actives.

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

    Figure : Détails de l'intégration dans la Console développeur d'Adobes

Configuration du service de contenu dynamique

Pour configurer l’intégration, utilisez les valeurs des champs ID DE COMPTE TECHNIQUE, ID D’ORGANISATION, SECRET CLIENT et ID CLIENT de l’intégration Adobe Developer Console. La création d’une configuration cloud Smart Tags permet l’authentification des demandes d’API à partir 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 client, copiez et utilisez les valeurs suivantes générées dans l’intégration de la Console développeur d’Adobes.

    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 valider la configuration. Pour procéder à la validation, suivez ces étapes.

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

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

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

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

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

Activez le balisage intelligent dans le workflow DAM Update Asset (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.

    Configurer le processus de mise à jour des actifs DAM et ajouter une étape de balise active

    Figure : Configurer le processus de mise à jour des actifs DAM et ajouter une étape de balise active

  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.

    Configurez le processus de mise à jour des actifs de gestion des actifs numériques pour ajouter l’étape de balise active et sélectionner l’avance du gestionnaire.

    Figure : Configurez le processus de mise à jour des actifs de gestion des actifs numériques pour ajouter l’étape de balise active 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 processus de mise à jour de la gestion des actifs numériques pour ajouter une étape de balise active et sélectionnez ignorer l’indicateur de balise active.

    Figure : Configurez le processus de mise à jour de la gestion des actifs numériques pour ajouter l’étape de balise active et sélectionnez ignorer l’indicateur de balise active.

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

Formation de 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 marquer efficacement vos images de marque, Smart Content Service exige que les images de formation soient conformes à certaines directives. 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 de formations sont conformes aux consignes 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 la formation. L'idée est de fournir quelques exemples, mais 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 actives sous l'onglet Détails, puis enregistrez les modifications.

enable_smart_tags

Une fois cette option sélectionnée pour un dossier, Experience Manager exécute automatiquement un processus de formation pour former Smart Content Service aux ressources de 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. Dans la page Modèles de flux de travail, sélectionnez le processus Formation aux balises actives, puis cliquez sur Processus de Début 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 processus 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 la formation, seules les ressources modifiées sont traitées au cours des cycles de formation suivants.

Rapports de formation de vue

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 forme de feuille de calcul Microsoft Excel.

Restrictions

  • Les balises actives améliorées reposent 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 dans lesquels 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 avec des balises actives (régulières ou améliorées), utilisez Assets Omnisearch (recherche de texte intégral). Il n’y a aucun prédicat de recherche distinct pour les balises intelligentes.

Sur cette page

Adobe Summit Banner

A virtual event April 27-28.

Expand your skills and get inspired.

Register for free
Adobe Summit Banner

A virtual event April 27-28.

Expand your skills and get inspired.

Register for free