Show Menu
SUJETS×

Intégration des visionneuses Dynamic Media à Adobe Analytics et Adobe Launch

En quoi consiste l’intégration des visionneuses Dynamic Media à Adobe Analytics et Adobe Launch ?

La nouvelle extension Visionneuses Dynamic Media pour Adobe Launch, ainsi que la version 5.13 des visionneuses Dynamic Media, permettent aux clients Dynamic Media, Adobe Analytics et Adobe Launch d’utiliser des événements et des données spécifiques aux visionneuses Dynamic Media dans leur configuration Adobe Launch.
Cette intégration signifie que vous pouvez suivre l’utilisation des visionneuses Dynamic Media sur votre site web avec Adobe Analytics. En même temps, vous pouvez utiliser les événements et les données exposés par les visiteurs avec toute autre extension Launch provenant d’Adobe ou d’un tiers.
Voir Extension Adobe dans le Guide de l’utilisateur d’Experience Platform Launch pour en savoir plus sur les extensions.
À qui s’adresse cette documentation  : administrateurs du site, développeurs sur la plate-forme AEM et les personnes chargées des opérations.

Restrictions de l’intégration

  • L’intégration d’Adobe Launch pour les visionneuses Dynamic Media ne fonctionne pas dans le nœud Auteur AEM. Vous ne pouvez pas afficher de suivi à partir d’une page WCM tant qu’elle n’est pas publiée.
  • L’intégration d’Adobe Launch pour les visionneuses Dynamic Media n’est pas prise en charge pour le mode de fonctionnement « pop-up », où l’URL de la visionneuse est obtenue à l’aide du bouton URL de la page de détails de la ressource.
  • L’intégration d’Adobe Launch ne peut pas être utilisée simultanément avec l’intégration des visionneuses Analytics héritées (au moyen du paramètre config2= ).
  • La prise en charge du suivi vidéo se limite au suivi de la lecture principale uniquement, comme décrit dans Présentation du suivi . En particulier, le suivi de la qualité de service, des publicités, des chapitres/segments et des erreurs n’est pas pris en charge.
  • La configuration de la durée de stockage n’est pas prise en charge pour les éléments de données à l’aide de l’extension Visionneuses Dynamic Media . La durée de stockage doit être définie sur Aucune .

Cas d’utilisation de l’intégration

Le principal cas d’utilisation de l’intégration à Adobe Launch est celui des clients qui utilisent à la fois AEM Assets et AEM Sites. Dans ce cas de figure, vous pouvez configurer une intégration standard entre votre nœud Auteur AEM et Adobe Launch, puis associer votre instance Sites à la propriété Adobe Launch. Ensuite, tout composant WCM Dynamic Media ajouté à une page Sites suit les données et les événements des visiteurs.
Un autre cas d’utilisation pris en charge par l’intégration est celui des clients qui utilisent AEM Assets uniquement ou Dynamic Media Classic. Dans ce cas, vous obtenez le code intégré pour votre visionneuse et vous l’ajoutez à la page du site web. Ensuite, récupérez l’URL de production de la bibliothèque d’Adobe Launch et ajoutez-la manuellement au code de la page web.

Fonctionnement du suivi des données et des événements dans l’intégration

L’intégration tire parti de deux types distincts et indépendants de suivi des visionneuses Dynamic Media : Adobe Analytics et Adobe Analytics for Audio and Video .

À propos du suivi à l’aide d’Adobe Analytics

Adobe Analytics vous permet d’effectuer le suivi des actions exécutées par l’utilisateur final lorsqu’il interagit avec les visionneuses Dynamic Media de votre site web. Adobe Analytics vous permet également d’effectuer le suivi des données propres à la visionneuse. Vous pouvez, par exemple, effectuer le suivi et enregistrer les événements de chargement des vues avec le nom de la ressource, les actions de zoom survenues, les actions de lecture vidéo, etc.
Dans Adobe Launch, les concepts d’ éléments de données et de règles fonctionnent ensemble pour activer le suivi Adobe Analytics.

À propos des éléments de données dans Adobe Launch

Un élément de données dans Adobe Launch est une propriété nommée dont la valeur est définie de manière statique ou calculée de manière dynamique en fonction de l’état d’une page web ou des données des visionneuses Dynamic Media.
Les options disponibles pour une définition d’élément de données dépendent de la liste des extensions installées dans la propriété Adobe Launch. L’extension Core est préinstallée et prête à l’emploi dans n’importe quelle configuration. Cette extension Core permet de définir un élément de données dont la valeur provient d’un cookie, de code JavaScript, d’une chaîne de requête, ainsi que de nombreuses autres sources.
Pour le suivi d’Adobe Analytics, plusieurs extensions supplémentaires doivent être installées, tel que décrit dans Installation et configuration des extensions . L’extension Visionneuses Dynamic Media permet de définir un élément de données qui est une valeur d’argument de l’événement Visionneuse dynamique. Par exemple, il est possible de faire référence au type de visionneuse ou au nom de ressource indiqué par la visionneuse lors du chargement, au niveau de zoom indiqué lorsque l’utilisateur effectue un zoom, etc.
L’extension Visionneuse Dynamic Media actualise automatiquement les valeurs de ses éléments de données.
Une fois défini, un élément de données peut être utilisé dans d’autres emplacements de l’interface utilisateur d’Adobe Launch, à l’aide du widget de sélecteur d’éléments de données. En particulier, les éléments de données définis aux fins du suivi des visionneuses Dynamic Media seront référencés par l’action Définir les variables de l’extension Adobe Analytics dans la règle (voir ci-dessous).
Voir Éléments de données dans le Guide de l’utilisateur d’Experience Platform Launch pour en savoir plus.

À propos des règles dans Adobe Launch

Une règle dans Adobe Launch est une configuration agnostique définissant trois zones qui constituent une règle : Événements , Conditions et Actions  :
  • Les événements (si) indiquent à Adobe Launch quand déclencher une règle.
  • Les conditions (si) indiquent à Adobe Launch quelles restrictions supplémentaires autoriser ou non lors du déclenchement d’une règle.
  • Les actions (alors) indiquent à Adobe Launch ce qu’il faut faire lorsqu’une règle est déclenchée.
Les options disponibles dans la section Événements, Conditions et Actions dépendent des extensions installées dans la propriété Adobe Launch. L’extension Core est préinstallée et prête à l’emploi dans n’importe quelle configuration. Cette extension fournit plusieurs options pour les événements, telles que des actions de base au niveau du navigateur, comme la modification de la cible d’action, les touches sélectionnées, les envois de formulaire, etc. Elle comprend également des options pour les conditions, telles que la valeur du cookie, le type de navigateur, etc. Pour les actions, seule l’option Code personnalisé est disponible.
Pour le suivi d’Adobe Analytics, plusieurs extensions supplémentaires doivent être installées, tel que décrit dans Installation et configuration des extensions . Plus précisément :
  • L’extension Visionneuses Dynamic Media étend la liste des événements pris en charge aux événements spécifiques aux visionneuses Dynamic Media, tels que le chargement de la visionneuse, l’échange de ressources, le zoom avant et la lecture vidéo.
  • L’extension Adobe Analytics étend la liste des actions prises en charge avec deux actions requises pour envoyer des données aux serveurs de suivi : Définir des variables et Envoyer une balise .
Pour effectuer le suivi des visionneuses Dynamic Media, vous pouvez utiliser n’importe quel type des éléments suivants :
  • Événements de l’extension Visionneuses Dynamic Media, de l’extension Core ou de toute autre extension.
  • Conditions de la définition de règle. Vous pouvez également laisser la zone Conditions vide.
Dans la section Actions, vous devez disposer d’une action Définir les variables . Cette action indique à Adobe Analytics comment renseigner les variables de suivi avec des données. Parallèlement, l’action Définir les variables n’envoie rien au serveur de suivi.
L’action Définir les variables doit être suivie d’une action Envoyer une balise . L’action Envoyer la balise envoie en fait des données au serveur de suivi Analytics. Les deux actions, Définir les variables et Envoyer une balise , proviennent de l’extension Adobe Analytics.
Voir Règles dans le Guide de l’utilisateur d’Experience Platform Launch pour en savoir plus.

Exemple de configuration

L’exemple de configuration suivant dans Adobe Launch montre comment effectuer le suivi d’un nom de ressource lors du chargement de la visionneuse.
  1. Dans l’onglet Éléments de données , définissez un élément de données AssetName qui référence le paramètre asset de l’événement LOAD à partir de l’extension Visionneuses Dynamic Media.
  2. Dans l’onglet Règles , définissez une règle TrackAssetOnLoad .
    Dans cette règle, le champ Événement utilise l’événement LOAD de l’extension Visionneuses Dynamic Media.
  3. La configuration Action comporte deux types d’actions de l’extension Adobe Analytics :
    Définissez des variables qui mappent une variable Analytics de votre choix à la valeur de l’élément de données AssetName .
    Envoyer une balise , qui envoie les informations de suivi à Adobe Analytics.
  4. La configuration de règle résultante ressemble à ce qui suit :

À propos d’Adobe Analytics for Audio and Video

Lorsqu’un compte Experience Cloud est abonné pour utiliser Adobe Analytics for Audio and Video, il suffit d’activer le suivi vidéo dans les paramètres d’extension Visionneuses Dynamic Media . Les mesures vidéo sont alors disponibles dans Adobe Analytics. Le suivi vidéo dépend de la présence de l’extension Adobe Media Analytics for Audio and Video.
À l’heure actuelle, la prise en charge du suivi vidéo se limite au suivi de la lecture principale uniquement, comme décrit dans Présentation du suivi . En particulier, le suivi de la qualité de service, des publicités, des chapitres/segments et des erreurs n’est pas pris en charge.

Utilisation de l’extension Visionneuses Dynamic Media

Comme indiqué dans Cas d’utilisation de l’intégration , il est possible d’effectuer le suivi des visionneuses Dynamic Media avec la nouvelle intégration d’Adobe Launch dans AEM Sites et à l’aide du code intégré.

Suivi des visionneuses Dynamic Media dans AEM Sites

Pour effectuer le suivi des visionneuses Dynamic Media dans AEM Sites, toutes les étapes répertoriées sous la section Configuration de tous les composants d’intégration doivent être réalisées. Plus précisément, vous devez créer la configuration IMS et la configuration du cloud Adobe Launch.
Une fois la configuration appropriée effectuée, toute visionneuse Dynamic Media que vous ajoutez à une page Sites, à l’aide d’un composant WCM pris en charge par Dynamic Media, effectue automatiquement le suivi des données vers Adobe Analytics ou Adobe Analytics for video, ou les deux.

Suivi des visionneuses Dynamic Media à l’aide du code intégré

Les clients qui n’utilisent pas AEM Sites, ou n’incorporent pas les visionneuses Dynamic Media dans des pages web en dehors d’AEM Sites, ou les deux, peuvent toujours utiliser l’intégration d’Adobe Launch.
Vous devez suivre les étapes de configuration des sections Configuration d’Adobe Analytics et Configuration d’Adobe Launch . Toutefois, les étapes de configuration liées à AEM ne sont pas nécessaires.
Une fois la configuration appropriée effectuée, vous pouvez ajouter la prise en charge d’Adobe Launch à une page web à l’aide d’une visionneuse Dynamic Media.
Voir Ajout du code intégré Launch pour en savoir plus sur l’utilisation du code intégré de la bibliothèque Adobe Launch.
Voir Incorporation de la visionneuse de vidéos ou d’images sur une page web pour en savoir plus sur l’utilisation de la fonctionnalité de code intégré d’AEM Dynamic Media.
Pour effectuer le suivi des visionneuses Dynamic Media à l’aide du code intégré
  1. Préparez une page web sur laquelle vous voulez incorporer une visionneuse Dynamic Media.
  2. Obtenez le code intégré de la bibliothèque Adobe Launch en vous connectant d’abord à Adobe Launch (voir Configuration d’Adobe Launch ).
  3. Cliquez sur Propriété , puis sur l’onglet Environnements .
  4. Sélectionnez le niveau Environnement correspondant à l’environnement de la page web. Ensuite, dans la colonne Installer , cliquez sur l’icône en forme de boîte.
  5. Dans la boîte de dialogue Instructions d’installation web , copiez le code intégré complet de la bibliothèque Adobe Launch, ainsi que les balises <script/> qui l’entourent.

Guide de référence de l’extension Visionneuses Dynamic Media

À propos de la configuration des visionneuses Dynamic Media

L’extension Visionneuse Dynamic Media s’intègre automatiquement à la bibliothèque Adobe Launch si toutes les conditions suivantes sont réunies :
  • L’objet global de la bibliothèque Adobe Launch ( _satellite ) est présent sur la page.
  • La fonction d’extension Visionneuses Dynamic Media _dmviewers_v001() est définie sur _satellite .
  • Le paramètre de visionneuse config2= n’est pas spécifié, ce qui signifie qu’elle n’utilise pas l’intégration Analytics héritée.
De plus, il existe une option pour désactiver explicitement l’intégration d’Adobe Launch dans la visionneuse en spécifiant un paramètre launch=0 dans la configuration de la visionneuse. La valeur par défaut de ce paramètre est 1 .

Configuration de l’extension Visionneuses Dynamic Media

La seule option de configuration de l’extension Visionneuses Dynamic Media est Activer Adobe Media Analytics for Audio and Video .
Lorsque vous cochez (ou activez) cette option et si l’extension Adobe Media Analytics for Audio and Video est installée et correctement configurée, les mesures de lecture vidéo sont envoyées à la solution Adobe Analytics for Audio and Video. La désactivation de cette option désactive le suivi vidéo.
Notez que si vous activez cette option sans avoir installé Adobe Media Analytics for Audio and Video, elle n’a aucun effet.

À propos des éléments de données dans l’extension Visionneuses Dynamic Media

Le seul type d’élément de données fourni par l’extension Visionneuses Dynamic Media est Événement de visionneuse dans la liste déroulante Type d’élément de données .
Lorsqu’il est sélectionné, l’éditeur d’éléments de données génère un formulaire avec deux champs :
  • Type de données d’événement de visionneuses DM  : liste déroulante qui identifie tous les événements de visionneuse pris en charge par l’extension Visionneuses Dynamic Media qui comportent des arguments, ainsi qu’un élément COMMON spécial. Un élément COMMON représente une liste de paramètres d’événement communs à tous les types d’événements envoyés par les visionneuses.
  • Paramètre de suivi  : argument de l’événement de visionneuse Dynamic Media sélectionné.
Pour obtenir la liste des événements pris en charge par chaque type de visionneuse, reportez-vous au Guide de référence des visionneuses Dynamic Media , accédez à la section spécifique à la visionneuse, puis cliquez sur la sous-section Prise en charge du suivi d’Adobe Analytics. À l’heure actuelle, le guide de référence des visionneuses Dynamic Media ne documente pas les arguments d’événement.
Examinons à présent le cycle de vie de l’ élément de données Visionneuses Dynamic Media. La valeur de cet élément de données est renseignée après que l’événement de visionneuse Dynamic Media correspondant a lieu sur la page. Par exemple, si l’élément de données pointe vers l’événement LOAD et son argument « asset », la valeur de cet élément de données recevra des données valides une fois que la visionneuse aura exécuté l’événement LOAD pour la première fois. Si l’élément de données pointe vers l’événement ZOOM et son argument « scale », la valeur de cet élément de données reste vide jusqu’à ce que la visionneuse envoie un événement ZOOM pour la première fois.
De même, les valeurs des éléments de données sont automatiquement mises à jour lorsque la visionneuse envoie un événement correspondant sur la page. La mise à jour de la valeur se produit même si l’événement particulier n’est pas spécifié dans la configuration de la règle. Par exemple, si l’élément de données ZoomScale est défini pour le paramètre « scale » de l’événement ZOOM, mais que la seule règle présente dans la configuration de la règle est déclenchée par l’événement LOAD , la valeur de ZoomScale est toujours mise à jour chaque fois qu’un utilisateur effectue un zoom dans la visionneuse.
Toute visionneuse Dynamic Media possède un identifiant unique sur la page web. L’élément de données effectue le suivi de la valeur elle-même et de la visionneuse qui a renseigné la valeur. En d’autres termes, s’il existe plusieurs visionneuses sur la même page, ainsi qu’un élément de données AssetName qui pointe sur l’événement LOAD et son argument « asset », l’élément de données AssetName conserve une collection de noms de ressources associés à chaque visionneuse chargée sur la page.
La valeur exacte renvoyée par l’élément de données dépend du contexte. Si l’élément de données est demandé dans une règle déclenchée par un événement de visionneuse Dynamic Media, la valeur de l’élément de données est renvoyée pour la visionneuse qui a lancé la règle. Et si l’élément de données est demandé dans une règle qui a été déclenchée par un événement d’une autre extension Adobe Launch, la valeur de l’élément de données est la valeur de la visionneuse qui a été le dernier à mettre à jour cet élément de données.
Examinez l’exemple de configuration suivant  :
  • une page web qui comporte deux visionneuses de zoom Dynamic Media ; nous les désignerons visionneuse1 et visionneuse2 .
  • L’élément de données ZoomScale pointe sur l’événement ZOOM et son argument « scale ».
  • Règle TrackPan avec ce qui suit :
    • Utilise l’événement PAN de la visionneuse Dynamic Media comme déclencheur.
    • Envoie la valeur de l’élément de données ZoomScale à Adobe Analytics.
    • Règle TrackKey avec ce qui suit :
    • Utilise l’événement de pression de touche de l’extension Core Adobe Launch comme déclencheur.
    • Envoie la valeur de l’élément de données ZoomScale à Adobe Analytics.
Supposons maintenant que l’utilisateur final charge la page web avec les deux visionneuses. Dans la visionneuse1 , il effectue un zoom avant à une échelle de 50 % ; ensuite, dans la visionneuse2 , il effectue un zoom avant à une échelle de 25 %. Dans la visionneuse1 , il effectue un panoramique sur l’image et appuie sur une touche du clavier.
L’activité de l’utilisateur final génère les deux appels de suivi suivants vers Adobe Analytics :
  • Le premier appel se produit, car la règle TrackPan est déclenchée lorsque l’utilisateur effectue un panoramique dans la visionneuse1 . Cet appel envoie 50 % en tant que valeur de l’élément de données ZoomScale , car l’élément de données sait que la règle est déclenchée par la visionneuse1 et récupère la valeur d’échelle correspondante.
  • Le second appel se produit, car la règle TrackKey est déclenchée lorsque l’utilisateur appuie sur une touche du clavier. Cet appel envoie 25 % en tant que valeur de l’élément de données ZoomScale , car la règle n’a pas été déclenchée par la visionneuse. L’élément de données renvoie donc la valeur la plus récente.
L’exemple de configuration ci-dessus affecte également la durée de vie de la valeur de l’élément de données. La valeur de l’élément de données géré par la visionneuse Dynamic Media est stockée dans le code de bibliothèque Adobe Launch, même après la suppression de la visionneuse de la page web. En d’autres termes, s’il existe une règle déclenchée par une extension de visionneuse autre que Dynamic Media et faisant référence à cet élément de données, l’élément de données renvoie la dernière valeur connue, même si la visionneuse n’est plus présente sur la page web.
Dans tous les cas, les valeurs des éléments de données pilotées par les visionneuses Dynamic Media ne sont pas stockées sur le stockage local ou sur le serveur ; elles sont conservées uniquement dans la bibliothèque Adobe Launch côté client. Les valeurs de cet élément de données disparaissent lors du rechargement de la page web.
En règle générale, l’éditeur d’éléments de données prend en charge la sélection de la durée de stockage . Toutefois, les éléments de données qui utilisent l’extension Visionneuses Dynamic Media ne prennent en charge que l’option de durée de stockage Aucune . La définition d’une autre valeur est possible dans l’interface utilisateur, mais le comportement de l’élément de données n’est pas défini dans ce cas. L’extension gère elle-même la valeur de l’élément de données qui conserve la valeur de l’argument d’événement de visionneuse pendant tout le cycle de vie de la visionneuse.

À propos des règles dans l’extension Visionneuses Dynamic Media

Dans l’éditeur de règles, l’extension ajoute de nouvelles options de configuration pour l’éditeur d’événements. Elle fournit également une option pour faire référence manuellement aux paramètres d’événement dans l’éditeur d’actions sous forme d’une option abrégée au lieu d’utiliser des éléments de données préconfigurés.

À propos de l’éditeur d’événements

Dans l’éditeur d’événements, l’extension Visionneuses Dynamic Media ajoute un nouveau type d’événement appelé Événement de visionneuse .
Lorsqu’il est sélectionné, l’éditeur d’événements effectue le rendu du menu déroulant Événements de visionneuse Dynamic Media , répertoriant tous les événements disponibles pris en charge par les visionneuses Dynamic Media.

À propos de l’éditeur d’actions

L’extension Visionneuses Dynamic Media vous permet d’utiliser les paramètres d’événement des visionneuses Dynamic Media pour mapper les variables Analytics dans l’éditeur Définir les variables de l’extension Adobe Analytics.
La méthode la plus simple consiste à effectuer le processus en deux étapes :
  • Tout d’abord, définissez un ou plusieurs éléments de données, où chaque élément de données représente un paramètre d’un événement Visionneuse Dynamic Media.
  • Enfin, dans l’éditeur Définir les variables de l’extension Adobe Analytics, cliquez sur l’icône du sélecteur d’éléments de données (sous forme de trois disques empilés) pour ouvrir la boîte de dialogue Sélectionner un élément de données, puis sélectionnez un élément de données à partir de celle-ci.
Il est toutefois possible d’utiliser une autre approche et d’éviter la création d’un élément de données. Vous pouvez faire directement référence à un argument à partir d’un événement Visionneuse Dynamic Media en saisissant le nom complet de l’argument d’événement dans le champ d’entrée valeur de l’affectation de variable Analytics, entouré de signes %. Par exemple :
%event.detail.dm.LOAD.asset%
Notez qu’il existe une différence importante entre l’utilisation des éléments de données et la référence directe à l’argument d’événement. Pour l’élément de données, peu importe l’événement qui déclenche l’action Définir les variables, l’événement qui déclenche la règle peut être sans rapport avec la visionneuse dynamique (comme un clic de souris sur la page web à partir de l’extension Core). Cependant, lorsque vous utilisez une référence directe à un argument, il est important de s’assurer que l’événement qui déclenche la règle correspond à l’argument d’événement auquel il fait référence.
Par exemple, la référence à %event.detail.dm.LOAD.asset% renvoie le nom de ressource correct si la règle est déclenchée par l’événement LOAD de l’extension Visionneuse Dynamic Media. Cependant, elle renvoie une valeur vide pour tout autre événement.
Le tableau suivant répertorie les événements de visionneuse Dynamic Media et leurs arguments pris en charge :
Nom de l’événement de visionneuse Référence de l’argument
COMMON %event.detail.dm.objID%
%event.detail.dm.compClass%
%event.detail.dm.instName%
%event.detail.dm.timeStamp%
BANNER %event.detail.dm.BANNER.asset%
%event.detail.dm.BANNER.frame%
%event.detail.dm.BANNER.label%
HREF %event.detail.dm.HREF.rollover%
ITEM %event.detail.dm.ITEM.rollover%
LOAD %event.detail.dm.LOAD.applicationname%
%event.detail.dm.LOAD.asset%
%event.detail.dm.LOAD.company%
%event.detail.dm.LOAD.sdkversion%
%event.detail.dm.LOAD.viewertype%
%event.detail.dm.LOAD.viewerversion%
METADATA %event.detail.dm.METADATA.length%
%event.detail.dm.METADATA.type%
MILESTONE %event.detail.dm.MILESTONE.milestone%
PAGE %event.detail.dm.PAGE.frame%
%event.detail.dm.PAGE.label%
PAUSE %event.detail.dm.PAUSE.timestamp%
PLAY %event.detail.dm.PLAY.timestamp%
SPIN %event.detail.dm.SPIN.framenumber%
STOP %event.detail.dm.STOP.timestamp%
SWAP %event.detail.dm.SWAP.asset%
SWATCH %event.detail.dm.SWATCH.frame%
%event.detail.dm.SWATCH.label%
TARG %event.detail.dm.TARG.frame%
%event.detail.dm.TARG.label%
ZOOM %event.detail.dm.ZOOM.scale%

Configuration de tous les composants d’intégration

AVANT DE COMMENCER
Si vous ne l’avez pas déjà fait, Adobe vous conseille de consulter attentivement l’ensemble de la documentation précédant cette section afin de comprendre l’intégration complète.
Cette section décrit les étapes de configuration nécessaires pour intégrer des visionneuses Dynamic Media à Adobe Analytics et Adobe Analytics for Audio and Video. Bien que l’utilisation de l’extension Visionneuses Dynamic Media à d’autres fins dans Adobe Launch soit possible, ces scénarios ne sont pas abordés dans cette documentation.
Vous allez configurer l’intégration dans les produits Adobe suivants :
  • Adobe Analytics : vous allez configurer les variables et les rapports de suivi.
  • Adobe Launch : vous allez définir une propriété, une ou plusieurs règles, ainsi qu’un ou plusieurs éléments de données pour permettre le suivi des visionneuses.
De plus, si cette solution d’intégration est utilisée avec AEM Sites, la configuration suivante doit également être effectuée :
  • Console Adobe I/O : l’intégration est créée pour Adobe Launch.
  • Nœud Auteur AEM : configuration IMS et configuration du cloud Adobe Launch.
Dans le cadre de la configuration, assurez-vous dans Adobe Experience Cloud d’avoir accès à une société pour laquelle Adobe Analytics et Adobe Launch sont déjà activés.

Configuration d’Adobe Analytics pour l’intégration

Une fois Adobe Analytics configuré, les éléments suivants sont configurés pour l’intégration :
  • Une suite de rapports est en place et sélectionnée.
  • Les variables Analytics sont disponibles pour recevoir les données de suivi.
  • Les rapports sont disponibles pour afficher les données collectées dans Adobe Analytics.
Pour configurer Adobe Analytics en vue de l’intégration  :
  1. Commencez par accéder à Adobe Analytics à partir de la page d’accueil d’Experience Cloud. Dans la barre de menus, cliquez sur l’icône Solutions (un tableau de trois points par trois) près du coin supérieur droit de la page, puis cliquez sur Analytics .
    Vous allez maintenant sélectionner une suite de rapports.

Sélection d’une suite de rapports

  1. Près du coin supérieur droit de la page Adobe Analytics, à droite du champ Rechercher des rapports , sélectionnez la suite de rapports appropriée dans la liste déroulante. Si plusieurs suites de rapports sont disponibles et que vous ne savez pas laquelle utiliser, contactez votre administrateur Adobe Analytics qui peut vous aider à sélectionner la suite de rapports adaptée.
    Dans l’illustration ci-dessous, un utilisateur a créé une suite de rapports nommée DynamicMediaViewersExtensionDoc et l’a sélectionnée dans la liste déroulante. Le nom de la suite de rapports est fourni à titre d’illustration uniquement ; la suite de rapports que vous sélectionnerez portera un nom différent.
    Si aucune suite de rapports n’est disponible, votre administrateur Adobe Analytics ou vous-même devez en créer une avant de poursuivre la configuration.
    Dans Adobe Analytics, les suites de rapports sont gérées sous Admin > Suites de rapports .
    Vous allez maintenant configurer les variables Adobe Analytics.

Configuration des variables Adobe Analytics

  1. Vous allez maintenant désigner une ou plusieurs variables Adobe Analytics à utiliser pour effectuer le suivi du comportement des visionneuses Dynamic Media sur la page web.
    Il est possible d’utiliser n’importe quel type de variable pris en charge par Adobe Analytics. La décision concernant le type de variable (tel que # de trafic personnalisé et # de conversion) doit être motivée par les besoins spécifiques à votre implémentation Analytics.
    Aux fins de cette documentation, seule une variable de trafic personnalisé (props) sera utilisée, car elle sera disponible dans un rapport Analytics quelques minutes après qu’une action a eu lieu sur une page web.
    Pour activer une nouvelle variable de trafic personnalisé, dans Adobe Analytics, sur la barre d’outils, cliquez sur Admin > Suites de rapports .
  2. Sur la page Gestionnaire de Report Suites , sélectionnez le rapport approprié, puis sur la barre d’outils, cliquez sur Modifier les paramètres > Trafic > Variables de trafic .
  3. Dans ce cas, sélectionnez la variable inutilisée, attribuez-lui un nom explicite ( ressource de visionneuse (prop 30) ) et redéfinissez la zone de liste modifiable sur « Activé » dans la colonne Activé.
    La capture d’écran suivante est un exemple de variable de trafic personnalisé ( prop30 ) pour le suivi d’un nom de ressource utilisé par la visionneuse :
  4. Au bas de la liste des variables, cliquez sur Enregistrer .

Configuration d’un rapport

  1. En règle générale, la configuration d’un rapport dans Adobe Analytics dépend des besoins spécifiques au projet. La configuration détaillée des rapports dépasse donc le cadre de cette intégration.
    Il suffit toutefois de savoir que les rapports de trafic personnalisé sont automatiquement disponibles dans Adobe Analytics après avoir configuré les variables Trafic personnalisé dans Configuration des variables Adobe Analytics .
    Par exemple, le rapport pour la variable Ressource de visionneuse (prop 30) est disponible dans le menu Rapports sous Trafic personnalisé > Trafic personnalisé 21-30 > Ressource de visionneuse (prop 30) .
    La consultation de ce rapport juste après la création de Ressource de visionneuse (prop 30) ne montre aucune donnée ; c’est ce qui est attendu à ce stade de l’intégration.

Configuration d’Adobe Launch pour l’intégration

Une fois Adobe Launch configuré, les éléments suivants sont configurés pour l’intégration :
  • Création d’une propriété pour conserver toutes vos configurations ensemble.
  • Installation et configuration des extensions. Le code client de toutes les extensions installées dans la propriété est compilé dans une bibliothèque. Cette bibliothèque sera utilisée ultérieurement par la page web.
  • Configuration des éléments de données et des règles. Cette configuration définit les données à capturer à partir des visionneuses Dynamic Media, le moment où déclencher la logique de suivi, ainsi que l’endroit où envoyer les données de la visionneuse dans Adobe Analytics.
  • Publication de la bibliothèque.
Pour configurer Adobe Launch en vue de l’intégration  :
  1. Commencez par accéder à Adobe Launch à partir de la page d’accueil d’Experience Cloud. Dans la barre de menus, cliquez sur l’icône Solutions (un tableau de trois points par trois) près du coin supérieur droit de la page, puis cliquez sur Launch .
    Vous pouvez également ouvrir Adobe Launch directement .

Création d’une propriété dans Adobe Launch

Une propriété dans Adobe Launch est une configuration nommée qui conserve l’ensemble de vos paramètres. Une bibliothèque des paramètres de configuration est générée et publiée à différents niveaux d’environnement (développement, évaluation et production).
  1. Dans Adobe Launch, cliquez sur Nouvelle propriété .
  2. Dans la boîte de dialogue Créer une propriété , dans le champ Nom , saisissez un nom descriptif, tel que le titre de votre site web. Par exemple, DynamicMediaViewersProp.
  3. Dans le champ Domaines , saisissez le domaine de votre site web.
  4. Dans la liste déroulante Options avancées , activez Configurer pour le développement d’extensions (ne peut pas être modifié plus tard) au cas où l’extension que vous souhaitez utiliser (dans ce cas, Visionneuses Dynamic Media ) n’est pas encore disponible.
  5. Cliquez sur Enregistrer .
    Cliquez sur la propriété que vous venez de créer, puis passez à Installation et configuration des extensions .

Installation et configuration des extensions

Toutes les extensions disponibles dans Adobe Launch sont répertoriées sous Extensions > Catalogue .
Pour installer une extension, cliquez sur Installer . Si nécessaire, réalisez une configuration d’extension ponctuelle, puis cliquez sur Enregistrer .
Le cas échéant, les extensions suivantes doivent être installées et configurées :
  • (Obligatoire) Extension Experience Cloud ID Service
Aucune configuration supplémentaire n’est nécessaire, acceptez les valeurs proposées. Lorsque vous avez terminé, veillez à cliquer sur Enregistrer .
  • (Obligatoire) Extension Adobe Analytics
Pour configurer cette extension, vous devez d’abord connaître l’identifiant de suite de rapports figurant dans Adobe Analytics, sous Admin > Suite de rapports , sous l’en-tête de colonne Identifiant de suite de rapports .
(À des fins de démonstration uniquement, l’identifiant de suite de rapports DynamicMediaViewersExtensionDoc sera utilisé dans les captures d’écran suivantes. Cet identifiant a été créé et utilisé dans Sélection d’une suite de rapports précédemment.)
Sur la page Installer l’extension, saisissez l’identifiant de suite de rapports dans le champ Suites de rapports de développement , le champ Suites de rapports d’évaluation et le champ Suites de rapport de production .
Configurez l’élément suivant uniquement si vous prévoyez d’utiliser le suivi vidéo :
Sur la page Installer l’extension , développez Général , puis spécifiez le serveur de suivi. Le serveur de suivi suit le modèle <trackingNamespace>.sc.omtrdc.net , où <trackingNamespace> représente les informations obtenues dans l’e-mail de mise en service.
Cliquez sur Enregistrer .
  • (Facultatif ; obligatoire uniquement si le suivi vidéo est nécessaire) Adobe Media Analytics for Audio and Video
Renseignez le champ Serveur de suivi. Le serveur de suivi pour l’extension Adobe Media Analytics for Audio and Video est différent du serveur de suivi utilisé pour Adobe Analytics. Il suit le modèle <trackingNamespace>.hb.omtrdc.net , où <trackingNamespace> représente les informations provenant de l’e-mail de mise en service.
Tous les autres champs sont facultatifs.
  • (Obligatoire) Extension Visionneuses Dynamic Media
Sélectionnez Activer Adobe Analytics for Video pour activer le suivi Video Heartbeat.
Notez qu’au moment de la rédaction de cet article, l’extension Visionneuses Dynamic Media n’est disponible que si la propriété Adobe Launch est créée pour le développement.
Une fois les extensions installées et configurées, au minimum, les cinq extensions suivantes (quatre si vous n’effectuez pas le suivi vidéo) seront répertoriées dans la zone Extensions > Installées.

Configuration des éléments de données et des règles

Dans Adobe Launch, créez les éléments de données et les règles nécessaires au suivi des visionneuses Dynamic Media.
Voir Exemple de configuration pour un exemple de configuration dans Adobe Launch qui montre comment effectuer le suivi d’un nom de ressource au moment du chargement de la visionneuse.
Voir Configuration de l’extension Visionneuses Dynamic Media pour en savoir plus sur les fonctionnalités de l’extension.

Publication d’une bibliothèque

Pour apporter des modifications à la configuration d’Adobe Launch (y compris la configuration de la propriété, des extensions, des règles et des éléments de données), vous devez publier ces modifications. La publication dans Adobe Launch est effectuée à partir de l’onglet Publication sous la configuration des propriétés.
Adobe Launch peut comporter plusieurs environnements de développement, un environnement d’évaluation et un environnement de production. Par défaut, la configuration du cloud Adobe Launch dans AEM pointe le nœud Auteur AEM vers l’environnement d’évaluation d’Adobe Launch et le nœud Publication AEM vers l’environnement de production d’Adobe Launch. Cela signifie qu’avec les paramètres par défaut d’AEM, il est nécessaire de publier la bibliothèque Adobe Launch dans l’environnement d’évaluation afin de l’utiliser dans l’auteur AEM, puis de la publier dans l’environnement de production afin qu’elle puisse être utilisée dans la publication AEM.
Voir Environnements pour plus d’informations sur les environnements Adobe Launch.
La publication d’une bibliothèque implique les deux étapes suivantes :
  • Ajout et création d’une bibliothèque en incluant toutes les modifications nécessaires (nouvelles et mises à jour) dans la bibliothèque.
  • Déplacement de la bibliothèque vers les différents niveaux d’environnement (du développement à l’évaluation et à la production)

Ajout et création d’une bibliothèque

  1. La première fois que vous ouvrez l’onglet Publication dans Adobe Launch, la liste des bibliothèques est vide.
    Dans la colonne de gauche, cliquez sur Ajouter une nouvelle bibliothèque .
  2. Sur la page Créer une bibliothèque, dans le champ Nom , saisissez un nom descriptif pour la nouvelle bibliothèque. Par exemple :
    DynamicMediaViewersLib
    Dans la liste déroulante Environnement, sélectionnez le niveau Environment. Au départ, seul le niveau Développement est disponible pour la sélection. Près du coin inférieur gauche de la page, cliquez sur Ajouter toutes les ressources modifiées .
  3. Dans le coin supérieur droit de la page, cliquez sur Enregistrer et créer pour développement .
    En quelques minutes, la bibliothèque est créée et prête à être utilisée.
    La prochaine fois que vous apporterez des modifications à votre configuration Adobe Launch, accédez à l’onglet Publication sous la configuration Propriété , puis cliquez sur votre bibliothèque créée précédemment.
    Dans l’écran de publication de la bibliothèque, cliquez sur Ajouter toutes les ressources modifiées , puis sur Enregistrer et créer pour développement .

Déplacement d’une bibliothèque à travers les niveaux d’environnement

  1. Une fois une bibliothèque ajoutée, elle se trouve initialement dans l’environnement de développement. Pour la déplacer au niveau de l’environnement d’évaluation (qui correspond à la colonne Envoyé), dans le menu déroulant de la bibliothèque, cliquez sur Envoyer pour approbation .
  2. Dans la boîte de dialogue de confirmation, cliquez sur Envoyer .
    Une fois la bibliothèque déplacée vers la colonne Envoyé, dans le menu déroulant de la bibliothèque, cliquez sur Créer pour l’évaluation .
  3. Suivez un processus similaire pour déplacer la bibliothèque de l’environnement d’évaluation vers l’environnement de production (colonne Publié).
    Tout d’abord, dans le menu déroulant, cliquez sur Approuver pour publication .
  4. Dans le menu déroulant, cliquez sur Créer et publier en production .
    Voir Publication pour plus d’informations sur le processus de publication dans Adobe Launch.

Configuration d’Adobe Experience Manager pour l’intégration

Conditions préalables :
  • AEM exécute les instances d’auteur et de publication.
  • Le nœud Auteur AEM est configuré dans Dynamic Media.
  • Les composants WCM Dynamic Media sont activés dans AEM Sites.
La configuration d’AEM comprend les deux étapes principales suivantes :
  • Configuration d’AEM IMS
  • Configuration du cloud Adobe Launch

Configuration d’AEM IMS

  1. Dans l’auteur AEM, cliquez sur l’icône Outils (en forme de marteau), puis sur Sécurité > Configurations d’Adobe IMS .
  2. Sur la page Configuration d’Adobe IMC, près du coin supérieur gauche, cliquez sur Créer .
  3. Sur la page Configuration du compte technique Adobe IMS , dans la liste déroulante Solution cloud , cliquez sur Adobe Launch .
  4. Activez Créer un certificat , puis, dans le champ de texte, entrez une valeur pertinente pour votre certificat. Par exemple, AdobeLaunchIMSCert . Cliquez sur Créer un certificat .
    Le message d’informations suivant s’affiche :
    Afin de récupérer un jeton d’accès valide, la nouvelle clé publique du certificat doit être ajoutée au compte technique sur Adobe I/O.
    Cliquez sur OK pour fermer la boîte de dialogue Infos.
  5. Cliquez sur Télécharger la clé publique pour télécharger un fichier de clé publique ( *.crt ) sur votre système local.
    À ce stade, laissez ouverte la page Configuration du compte technique Adobe IMS  ; ne fermez pas la page et ne cliquez pas sur Suivant. Vous y reviendrez plus tard.
  6. Dans un nouvel onglet du navigateur, accédez à la Console Adobe I/O .
  7. Sur la page Intégrations de la console Adobe I/O , près du coin supérieur droit, cliquez sur Nouvelle intégration .
  8. Dans la boîte de dialogue Créer une intégration Créer une intégration, vérifiez que le bouton radio Accès à une API est sélectionné, puis cliquez sur Continuer .
  9. Sur la deuxième page Créer une intégration , activez le bouton radio API Experience Platform Launch API . Dans le coin inférieur droit de la page, cliquez sur Continuer .
  10. Sur la troisième page Créer une intégration , procédez comme suit :
    • Dans le champ Nom , saisissez un nom explicite. Par exemple, DynamicMediaViewersIO .
    • Dans le champ Description , saisissez la description de l’intégration.
    • Dans la zone Certificats de clé publique , chargez votre fichier de clé publique ( *.crt ) que vous avez précédemment téléchargé au cours de ces étapes.
    • Sous l’en-tête Sélectionner un rôle pour l’API Experience Platform Launch , sélectionnez Admin .
    • Sous l’en-tête Sélectionner un ou plusieurs profils de produit pour l’API Experience Platform Launch , sélectionnez le profil de produit appelé Launch - &lt;nom_de_votre_société> .
  11. Cliquez sur Créer une intégration .
  12. Sur la page Intégration créée , cliquez sur Continuer vers les informations concernant l’intégration .
  13. Une page Informations concernant l’intégration s’affiche, comme suit :
    Laissez ouverte cette page Informations concernant l’intégration . Vous aurez besoin de plusieurs informations figurant dans les onglets Aperçu et JWT dans un instant.
    Page Informations concernant l’intégration
  14. Revenez à la page Configuration du compte technique Adobe IMS que vous avez laissée ouverte précédemment. Dans le coin supérieur droit de la page, cliquez sur Suivant pour ouvrir la page Compte dans la fenêtre Configuration du compte technique Adobe IMS .
    (Si vous avez accidentellement fermé la page, revenez à l’auteur AEM, puis cliquez sur Outils > Sécurité > Configurations d’Adobe IMS . Cliquez sur Créer . Dans la liste déroulante Solution cloud , sélectionnez Adobe Launch . Dans la liste déroulante Certificat , sélectionnez le nom du certificat créé précédemment.
    Configuration du compte technique Adobe IMS – page Certificat
  15. La page Compte comporte cinq champs qui vous obligeront à renseigner les informations de la page Informations concernant l’intégration de l’étape précédente.
    Configuration du compte technique Adobe IMS – page Compte
  16. Sur la page Compte , renseignez les champs suivants :
    • Titre  : entrez un titre de compte descriptif.
    • Serveur d’autorisation  : revenez à la page Informations concernant l’intégration que vous avez ouverte précédemment. Cliquez sur l’onglet JWT . Copiez le nom du serveur (sans le chemin d’accès), comme indiqué ci-dessous.
(l’exemple de nom de serveur est fourni à titre d’illustration uniquement) Revenez à la page Compte , puis collez le nom dans le champ correspondant. Par exemple, https://ims-na1.adobelogin.com/ (l’exemple de nom de serveur est fourni à titre d’illustration uniquement)
Page Informations concernant l’intégration – onglet JWT
  1. Clé API  : revenez à la page Informations concernant l’intégration. Cliquez sur l’onglet Aperçu , puis sur Copier à droite du champ Clé API (ID client) .
    Revenez à la page Compte , puis collez la clé dans le champ correspondant.
    Page Informations concernant l’intégration
  2. Secret client  : revenez à la page Informations concernant l’intégration. Dans l’onglet Aperçu , cliquez sur Récupérer le secret client . À droite du champ Secret client , cliquez sur Copier .
    Revenez à la page Compte , puis collez la clé dans le champ correspondant.
  3. Charge utile  : revenez à la page Informations concernant l’intégration. Dans l’onglet JWT , dans le champ Charge utile JWT, copiez le code d’objet JSON entier.
    Revenez à la page Compte , puis collez le code dans le champ correspondant.
    Page Informations concernant l’intégration – onglet JWT
    La page Compte, avec tous les champs remplis, se présente comme suit :
  4. Dans le coin supérieur droit de la page Compte , cliquez sur Créer .
    Avec AEM IMS configuré, vous disposez désormais d’un nouveau compte IMSAccount répertorié sous Configurations d’Adobe IMS .

Configuration du cloud Adobe Launch pour l’intégration

  1. Dans l’auteur AEM, près du coin supérieur gauche, cliquez sur l’icône Outils (en forme de marteau), puis sur Cloud Services > Configurations d’Adobe Launch .
  2. Sur la page Configurations d’Adobe Launch , dans le panneau de gauche, sélectionnez un AEM Site auquel appliquer la configuration d’Adobe Launch.
    À titre d’illustration uniquement, le site We.Retail est sélectionné dans la capture d’écran ci-dessous.
  3. Dans le coin supérieur gauche de la page, cliquez sur Créer .
  4. Sur la page Général (1/3 pages) de la fenêtre Créer une configuration Adobe Launch , renseignez les champs suivants :
    • Titre  : entrez un titre de configuration descriptif. Par exemple, We.Retail Launch cloud configuration .
    • Configuration Adobe IMS associée  : sélectionnez la configuration IMS que vous avez créée précédemment dans Configuration d’AEM IMS .
    • Société  : dans la liste déroulante Société , sélectionnez votre société Experience Cloud. La liste est renseignée automatiquement.
    • Propriété  : dans la liste déroulante Propriété, sélectionnez la propriété Adobe Launch que vous avez créée précédemment. La liste est renseignée automatiquement. Après avoir rempli tous les champs, la page Général se présente comme suit :
  5. Près du coin supérieur gauche, cliquez sur Suivant .
  6. Sur la page Évaluation (2/3 pages) de la fenêtre Créer une configuration Adobe Launch , renseignez les champs suivants :
    Dans le champ URI bibliothèque , vérifiez l’emplacement de la version d’évaluation de votre bibliothèque Adobe Launch. AEM renseigne ce champ automatiquement.
    À titre d’illustration uniquement, cette étape utilise les bibliothèques Adobe Launch déployées sur le réseau de diffusion de contenu Adobe.
    Vérifiez que l’URI (Uniform Resource Identifier) de bibliothèque auto-renseigné n’est pas mal formé. Si nécessaire, corrigez-le de sorte qu’il soit relatif au protocole. C’est-à-dire qu’il commence par une double barre oblique.
    Par exemple : //assets.adobetm.com/launch-xxxx .
    Votre page Évaluation doit ressembler à ce qui suit. Notez que les options Archiver et Charger la bibliothèque de manière asynchrone ne sont pas définies :
  7. Près du coin supérieur droit, cliquez sur Suivant .
  8. Sur la page Production (3/3 pages) de la fenêtre Créer une configuration Adobe Launch , si nécessaire, corrigez l’URI de production auto-renseigné de la même manière que sur la page Évaluation précédente.
  9. Près du coin supérieur droit, cliquez sur Créer .
    Votre nouvelle configuration du cloud Adobe Launch est maintenant créée et répertoriée en regard de votre site web.
  10. Sélectionnez votre nouvelle configuration du cloud Adobe Launch (une coche apparaît à gauche du titre de la configuration lorsqu’elle est sélectionnée). Dans la barre d’outils, cliquez sur Publier .
À l’heure actuelle, l’auteur AEM ne prend pas en charge l’intégration des visionneuses Dynamic Media avec Adobe Launch.
Elle est toutefois prise en charge dans le nœud Publication AEM. Avec les paramètres par défaut de la configuration du cloud Adobe Launch, la publication AEM utilise l’environnement de production d’Adobe Launch. Par conséquent, il est nécessaire de transmettre les mises à jour de la bibliothèque Adobe Launch de l’environnement de développement vers celui de production chaque fois pendant le test.
Il est possible de contourner cette limitation en spécifiant l’URL de développement ou d’évaluation de la bibliothèque Adobe Launch dans la configuration du cloud Adobe Launch pour la publication AEM ci-dessus. Ce faisant, le nœud Publication AEM utilise la version de développement ou d’évaluation de la bibliothèque Adobe Launch.
Voir Intégration d’AEM à Adobe Launch via Adobe I/O pour plus d’informations sur la configuration du cloud Adobe Launch.