Exportation de fragments de contenu vers Adobe Target exporting-content-fragments-to-adobe-target

CAUTION
  • Les fragments de contenu AEM sont exportés dans l’espace de travail par défaut d’Adobe Target.
  • AEM doit être intégré à Adobe Target conformément aux instructions de la section Intégration à Adobe Target.

Vous pouvez exporter les Fragments de contenu, créés dans Adobe Experience Manager as a Cloud Service (AEM) dans Adobe Target (Target). Ceux-ci peuvent ensuite être utilisés comme offres dans les activités Target, pour tester et personnaliser les expériences en fonction des besoins.

Il existe une option pour exporter un fragment de contenu vers Adobe Target :

  • JSON : prise en charge de la diffusion de contenu découplé

Pour préparer votre instance à l’exportation de fragments de contenu AEM vers Adobe Target, vous devez :

Ensuite, vous pouvez :

Les fragments de contenu peuvent être exportés vers l’espace de travail par défaut dans Adobe Target ou vers des espaces de travail définis par l’utilisateur ou l’utilisatrice pour Adobe Target.

NOTE
Les espaces de travail Adobe Target n’existent pas dans Adobe Target lui-même. Ils sont définis et gérés dans Adobe IMS (Identity Management System), puis sélectionnés pour une utilisation dans toutes les solutions à l’aide de la console Adobe Developer.
NOTE
Les espaces de travail Adobe Target peuvent être utilisés pour permettre aux membres d’une organisation (groupe) de créer et de gérer des offres et des activités pour cette organisation uniquement ; sans donner accès à d’autres utilisateurs. Par exemple, les organisations spécifiques à un pays avec une préoccupation mondiale.

Prérequis prerequisites

L’action suivante est requise :

Ajoutez la configuration du cloud add-the-cloud-configuration

Avant d’exporter un fragment, vous devez ajouter la configuration cloud pour Adobe Target au fragment ou au dossier. Vous pouvez ainsi :

  • spécifier la ou les options de format à utiliser pour l’export ;
  • sélectionner un espace de travail Target comme destination ;
  • sélectionner un domaine d’externaliseur pour réécrire des références dans le fragment de contenu (facultatif).

Vous pouvez sélectionner les options obligatoires dans les propriétés de page du dossier et/ou du fragment concerné. La spécification est héritée, le cas échéant.

  1. Accédez à la console Ressources.

  2. Ouvrez les propriétés de page pour le dossier ou le fragment approprié.

    note note
    NOTE
    Si vous ajoutez la configuration du cloud au dossier parent du fragment de contenu, celle-ci est héritée par tous les enfants.
    Si vous ajoutez la configuration du cloud au fragment de contenu lui-même, celle-ci est héritée par toutes les variations.
  3. Sélectionnez l’onglet Services cloud.

  4. Sous Configuration du service cloud, sélectionnez Adobe Target dans la liste déroulante.

    note note
    NOTE
    Le format JSON d’une offre de fragment de contenu peut être personnalisé. Pour ce faire, définissez un composant de fragment de contenu client, puis annotez comment exporter ses propriétés dans le modèle Sling du composant.
    Affichez le composant principal : Composants principaux - Fragments de contenu
  5. Sous Adobe Target sélectionnez :

    • la configuration appropriée ;
    • l’option de format requise ;
    • un espace de travail Adobe Target ;
    • si nécessaire - domaine de l’externaliseur
    note caution
    CAUTION
    Le domaine de l’externaliseur est facultatif.
    Un externaliseur d’AEM est configuré lorsque vous souhaitez que le contenu exporté pointe vers un domaine de publication spécifique. Pour plus d’informations, consultez Configuration de l’externaliseur de liens d’AEM.
    Notez également que les domaines de l’externaliseur sont pertinents uniquement pour le contenu du fragment de contenu envoyé à Target, et non pour les métadonnées telles que Afficher le contenu de l’offre.

    Par exemple, pour un dossier :

    Dossier - Cloud Services

  6. Enregistrez et fermez.

Ajoutez la configuration héritée add-the-legacy-configuration

IMPORTANT
L’ajout d’une nouvelle configuration héritée est un scénario particulier qui n’est pris en charge que pour l’exportation de fragments de contenu.

Après avoir ajouté la configuration cloud pour utiliser Experience Platform Launch, pour intégrer initialement AEM à Adobe Target, vous devez également effectuer l’intégration manuelle à Adobe Target à l’aide d’une configuration héritée.

Création d’une configuration du cloud Target creating-a-target-cloud-configuration

Pour permettre à AEM d’interagir avec Adobe Target, créez une configuration de cloud Target. Pour créer la configuration, vous fournissez le code client Adobe Target et les informations d’identification de l’utilisateur.

Vous créez la configuration de cloud Target une seule fois, car vous pouvez l’associer à plusieurs campagnes AEM. Si vous disposez de plusieurs codes client Adobe Target, créez une configuration pour chaque code client.

Vous pouvez configurer la configuration de cloud pour synchroniser les segments depuis Adobe Target. Si vous activez la synchronisation, les segments sont importés de Target en arrière-plan dès que la configuration du cloud est enregistrée.

Procédez comme suit pour créer une configuration du cloud Target dans AEM :

  1. Accédez aux Services cloud hérités via le logo AEM  > Outils  > Cloud Services  > Services cloud hérités.
    Par exemple : (http://localhost:4502/libs/cq/core/content/tools/cloudservices.html)

    La page d’aperçu d’Adobe Experience Cloud s’ouvre.

  2. Dans la section Adobe Target, cliquez sur Configurer maintenant.

  3. Dans la boîte de dialogue Créer une configuration  :

    1. Donnez un titre à la configuration.
    2. Sélectionnez le modèle Configuration d’Adobe Target.
    3. Cliquez sur Créer.

Vous pouvez maintenant sélectionner la nouvelle configuration à modifier.

  1. La boîte de dialogue de modification s’ouvre.

    config-target-settings-dialog

  2. Dans la boîte de dialogue Paramètres Adobe Target, indiquez les valeurs de ces propriétés.

    • Authentification  : par défaut, il s’agit d’IMS (les informations d’identification de l’utilisateur sont obsolètes).

    • Code client  : code client du compte Target.

    • Identifiant du client  : l’identifiant du client

    • Configuration IMS  : sélectionnez la configuration requise dans la liste déroulante

    • Type d’API  : par défaut : REST (XML est obsolète)

    • Configuration d’A4T Analytics Cloud  : sélectionnez la configuration d’Analytics Cloud utilisée pour les objectifs et les mesures des activités de Target. Vous avez besoin de cette option si vous utilisez Adobe Analytics en tant que source de création de rapports lors du ciblage de contenu.

    • Utiliser le ciblage précis  : par défaut, cette case est cochée. Si cette option est sélectionnée, la configuration du service cloud attend le chargement du contexte avant de charger le contenu. Lisez la remarque suivante.

    • Synchroniser les segments à partir d’Adobe Target  : sélectionnez cette option pour télécharger les segments définis dans Target pour les utiliser dans AEM. Sélectionnez cette option lorsque la propriété Type d’API est REST, car les segments incorporés ne sont pas pris en charge et vous devez toujours utiliser les segments de Target. (Le terme AEM « segment » est l’équivalent d’« audience » dans Target.)

    • Bibliothèque cliente  : par défaut, cette valeur est définie sur AT.js (mbox.js est obsolète).

      note note
      NOTE
      Le fichier de bibliothèque cible, AT.JS, est une nouvelle bibliothèque d’implémentation pour Adobe Target qui a été conçue pour les implémentations web classiques et les applications d’une seule page.
      mbox.js est obsolète et sera supprimé ultérieurement.
      Adobe vous recommande d’utiliser AT.js comme bibliothèque cliente au lieu de mbox.js.
      AT.js offre plusieurs améliorations par rapport à la bibliothèque mbox.js :
      • Amélioration des temps de chargement des pages pour les implémentations web
      • Amélioration de la sécurité
      • Meilleures options d’implémentation pour les applications d’une seule page
      • AT.js contient les composants qui étaient inclus dans target.js. Il n’y a donc plus d’appel à target.js.
      Vous pouvez sélectionner AT.js ou mbox.js dans le menu déroulant Bibliothèque cliente.
    • Utilisation du système de gestion des balises pour diffuser la bibliothèque cliente  : sélectionnez cette option pour utiliser la bibliothèque cliente depuis Adobe Launch ou un autre système de gestion des balises (ou DTM, qui est obsolète).

    • Fichier AT.js personnalisé  : parcourez l’arborescence pour charger votre fichier AT.js personnalisé. Laissez vide pour utiliser la bibliothèque par défaut.

      note note
      NOTE
      Par défaut, lorsque vous souscrivez à l’assistant de configuration Adobe Target, le ciblage précis est activé.
      Le ciblage précis implique que cette configuration du service cloud attend le chargement du contexte avant de charger le contenu. Par conséquent, en termes de performances, un ciblage précis peut créer un délai de quelques millisecondes avant le chargement du contenu.
      Le ciblage précis est toujours activé sur l’instance de création. Toutefois, sur l’instance de publication, vous pouvez choisir de le désactiver en désactivant la coche en regard de Ciblage précis dans la configuration du service cloud (http://localhost:4502/etc/cloudservices.html). Vous pouvez également activer et désactiver le ciblage précis pour chaque composant, quel que soit votre paramètre dans la configuration du service cloud.
      Si vous avez déjà créé les composants ciblés et si vous modifiez ce paramètre, vos modifications n’affectent pas ces composants. Vous devez apporter des modifications directement à ces composants.
  3. Cliquez sur Se connecter à Adobe Target pour lancer la connexion à Target. Si la connexion est réussie, le message Connexion réussie s’affiche. Cliquez sur OK dans le message et OK dans la boîte de dialogue.

Ajout d’un framework Target adding-a-target-framework

Une fois que vous avez configuré la configuration de cloud Target, ajoutez une structure Target. La structure identifie les paramètres par défaut qui sont envoyés à Adobe Target à partir des composants ContextHub disponibles. Target utilise les paramètres pour déterminer les segments qui s’appliquent au contexte actuel.

Vous pouvez créer des structures multiples pour une même configuration Target. Les structures multiples s’avèrent utiles lorsque vous devez envoyer un jeu de paramètres différent à Target pour différentes sections de votre site web. Créez une structure pour chaque jeu de paramètres que vous avez besoin d’envoyer. Associez chaque section de votre site web à la structure appropriée. Notez qu’une page web peut utiliser uniquement une structure à la fois.

  1. Sur la page de configuration Target, cliquez sur le signe  + en regard des configurations disponibles.

  2. Dans la boîte de dialogue Créer une structure, spécifiez un titre, sélectionnez la structure Adobe Target et cliquez sur Créer.

    La page de structure s’ouvre. Le sidekick fournit des composants qui représentent les informations de ContextHub que vous pouvez mettre en correspondance.

  3. Faites glisser le composant ClientContext représentant les données que vous souhaitez utiliser pour mettre en correspondance avec la cible de dépôt. Vous pouvez également faire glisser le composant Boutique ContextHub vers la structure.

    note note
    NOTE
    Lors de la mise en correspondance, les paramètres sont transmis à un mbox via des chaînes simples. Vous ne pouvez pas mapper des tableaux à partir de ContextHub.

    Par exemple, pour utiliser les données du profil des visiteurs de votre site afin de contrôler votre campagne Target, faites glisser le composant Données du profil vers la page. Les variables de données de profil qui sont disponibles pour la mise en correspondance des paramètres Target s’affichent.

  4. Sélectionnez les variables que vous souhaitez rendre visibles pour le système Adobe Target en cochant la case Partager dans les colonnes appropriées.

    note note
    NOTE
    La synchronisation des paramètres ne fonctionne que dans un sens : d’AEM à Adobe Target.

La structure est créée. Pour répliquer le framework sur l’instance de publication, utilisez la méthode Activation du framework dans le sidekick.

Exportation d’un fragment de contenu vers Adobe Target exporting-a-content-fragment-to-adobe-target

CAUTION
Pour les contenus multimédias, comme les images, une seule référence est exportée vers Target. La ressource elle-même reste stockée dans AEM Assets et est diffusée à partir de l’instance de publication AEM.
C’est pourquoi le fragment de contenu, avec toutes les ressources associées, doit être publié avant l’exportation vers Target.

Pour exporter un fragment de contenu d’AEM vers Target (après avoir spécifié la configuration du cloud) :

  1. Accédez à votre fragment de contenu dans la console Ressources.

  2. Sélectionnez le fragment de contenu que vous souhaitez exporter vers Target.

  3. Sélectionner Exporter vers des offres Adobe Target.

    Exporter vers Adobe Target

  4. Sélectionner Exportation sans publication ou Publier selon les besoins.

    note note
    NOTE
    Les actions affichées dépendent du statut de votre fragment et des ressources associées.
    Si tout a déjà été publié et que rien n’a été modifié depuis, cette étape est ignorée.
    note note
    NOTE
    L’option Publier permet de publier imédiatement le fragment de contenu et de l’envoyer à Target.
  5. Sélectionner OK dans la boîte de dialogue de confirmation.

    Votre fragment de contenu se trouve désormais dans Target.

    note note
    NOTE
    Divers détails sur l’exportation sont visibles dans la vue Liste de la console et dans les Propriétés.
    note note
    NOTE
    Lors de l’affichage d’un fragment de contenu dans Adobe Target, la date de dernière modification affichée correspond à la date de la dernière modification du fragment dans AEM, et non à la date de la dernière exportation du fragment vers Adobe Target.
NOTE
Vous pouvez également effectuer l’exportation à partir de l’éditeur de page à l’aide de commandes comparables dans le menu Informations sur la page.

Utiliser vos fragments de contenu dans Adobe Target using-your-content-fragments-in-adobe-target

Après avoir effectué les tâches précédentes, le fragment de contenu s’affiche sur la page Offres de Target. Voir documentation spécifique de Target pour en savoir plus sur ce que vous pouvez y réaliser.

NOTE
Lors de l’affichage d’un fragment de contenu dans Adobe Target, la date de dernière modification affichée est la date de la dernière modification du fragment dans AEM, et non la date de la dernière exportation du fragment vers Adobe Target.

Supprimer un fragment de contenu déjà exporté vers Adobe Target deleting-a-content-fragment-already-exported-to-adobe-target

Comme pour l’exportation, la suppression d’un fragment de contenu d’Adobe Target peut également être sélectionnée dans la barre d’outils supérieure de la console Ressources une fois le fragment sélectionné :

Supprimer dans Adobe Target

La suppression d’un fragment de contenu qui a déjà été exporté vers Target peut entraîner des problèmes si le fragment est déjà utilisé pour une offre dans Target. La suppression du fragment rendrait l’offre inutilisable, car le fragment de contenu est fourni par AEM.

Pour éviter de telles situations :

  • Si le fragment de contenu n’est pas actuellement utilisé dans une activité, AEM permet à l’utilisateur ou à l’utilisatrice de le supprimer sans message d’avertissement.

  • Si le fragment de contenu est actuellement utilisé par une activité dans Target, un message d’erreur avertit l’utilisateur AEM des conséquences possibles de la suppression du fragment sur l’activité.

    Le message d’erreur apparu dans AEM n’empêche pas l’utilisateur ou l’utilisatrice de forcer la suppression du fragment d’expérience. Si le fragment de contenu est supprimé :

    • l’offre Target qui utilise le fragment de contenu AEM peut souffrir d’un comportement indésirable ;

      • l’offre effectue toujours le rendu, car le fragment de contenu a été transmis à Target ;
      • les références du fragment de contenu peuvent ne pas fonctionner correctement si les ressources référencées ont également été supprimées dans AEM.
    • Bien sûr, toute modification supplémentaire apportée au fragment de contenu est impossible, car le fragment de contenu n’existe plus dans AEM.

Autres ressources further-resources

Pour plus d’informations, consultez les sections suivantes :

recommendation-more-help
fbcff2a9-b6fe-4574-b04a-21e75df764ab