Intégration des visionneuses Dynamic Media avec Adobe Analytics et l’Experience Platform Launch

Qu’est-ce que l’intégration de Dynamic Media Viewers avec Adobe Analytics et l’Experience Platform Launch ?

La nouvelle extension Dynamic Media Viewers pour Experience Platform Launch, ainsi que la récente version de Dynamic Media Viewers 5.13, permettent aux clients de Dynamic Media, Adobe Analytics et Experience Platform Launch d’utiliser des événements et des données spécifiques pour les visionneuses Dynamic Media dans leur configuration Experience Platform 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 Extensions d’Adobe dans le Guide de l’utilisateur 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’Experience Platform Launch pour les visionneuses Dynamic Media ne fonctionne pas dans le noeud d’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’Experience Platform Launch pour les visionneuses Dynamic Media n’est pas prise en charge pour le mode de fonctionnement "contextuel", où l’URL de la visionneuse est obtenue à l’aide du bouton "URL" sur la page Détails du fichier.
• L’intégration de l’Experience Platform Launch ne peut pas être utilisée simultanément avec l’intégration des visionneuses héritées Analytics (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 cas d’utilisation Principal pour l’intégration avec l’Experience Platform Launch est celui des clients qui utilisent à la fois AEM Assets et AEM Sites. Dans de tels scénarios, vous pouvez configurer une intégration standard entre votre noeud d’auteur AEM et votre Experience Platform Launch, puis associer votre instance Sites à la propriété Experience Platform Launch. Ensuite, tout composant WCM Dynamic Media ajouté à une page Sites suit les données et les événements des visiteurs.

Voir À propos du suivi des visionneuses Dynamic Media dans AEM Sites.

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 Experience Platform Launch auprès de l’Experience Platform Launch et ajoutez-la manuellement au code de page Web.

Voir À propos du suivi des visionneuses Dynamic Media à l’aide du code intégré.

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.

En Experience Platform Launch, les concepts Éléments de données et Règles fonctionnent ensemble pour activer le suivi Adobe Analytics.

A propos des éléments de données dans l'Experience Platform Launch

Un élément de données dans l’Experience Platform 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é Experience Platform 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 que vous l’avez défini, un élément de données peut être utilisé dans d’autres emplacements de l’interface utilisateur Experience Platform 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.

A propos des règles dans l’Experience Platform Launch

Une règle dans l’Experience Platform Launch est une configuration agnostique qui définit trois zones qui constituent une règle : Événements, Conditions et Actions :

• Les événements (le cas échéant) indiquent à l’Experience Platform Launch quand déclencher une règle.
• Conditions (le cas échéant) indiquent à l'Experience Platform Launch quelles restrictions supplémentaires autoriser ou interdire lors du déclenchement d'une règle.
• Actions (alors) indiquent à l’Experience Platform 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é Experience Platform 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 l’Experience Platform Launch montre comment effectuer le suivi d’un nom de fichier au 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.

Voir Installation et configuration des extensions.

À 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 mentionné dans Cas d’utilisation pour l’intégration, il est possible de suivre les visionneuses Dynamic Media avec la nouvelle intégration Experience Platform Launch dans AEM Sites et en utilisant le code incorporé.

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 Experience Platform Launch Cloud.

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.

Voir Ajout de ressources Dynamic Media à des pages à l’aide d’Adobe Sites.

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

Les clients qui n’utilisent pas l’AEM Sites ou n’incorporent pas les visionneuses Dynamic Media dans des pages Web en dehors de AEM Sites, ou les deux, peuvent toujours utiliser l’intégration Experience Platform Launch.

Vous devez exécuter les étapes de configuration des sections Configuration d'Adobe Analytics et Configuration d'Experience Platform 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 des Experience Platform Launch à une page Web à l’aide d’un lecteur Dynamic Media.

Voir Ajouter le code incorporé de lancement pour en savoir plus sur l’utilisation du code incorporé de bibliothèque Experience Platform 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 incorporé pour la bibliothèque Experience Platform Launch en vous connectant d’abord à l’Experience Platform Launch (voir Configuration de l’Experience Platform 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 Web Install Instructions, copiez le code incorporé complet de la bibliothèque Experience Platform Launch, ainsi que les <script/> balises qui l’entourent.

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

À propos de la configuration des visionneuses Dynamic Media

L’extension Dynamic Media Viewer s’intègre automatiquement à la bibliothèque Experience Platform Launch si toutes les conditions suivantes sont remplies :

• L’objet global de la bibliothèque Experience Platform 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 Experience Platform Launch dans la visionneuse en spécifiant le 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 provenant d’une autre extension Experience Platform Launch, la valeur de l’élément de données est la valeur du lecteur 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 le événement de touche de l’extension Core Experience Platform 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 Dynamic Media Viewer est stockée dans le code de bibliothèque de l’Experience Platform Launch, même après la suppression du lecteur sur 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 l’enregistrement local ou sur le serveur ; ils sont conservés uniquement dans la bibliothèque Experience Platform 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 Dynamic Media Viewers à d’autres fins dans l’Experience Platform Launch soit possible, de tels 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.
• Experience Platform Launch : vous allez définir une propriété, une ou plusieurs règles et un ou plusieurs éléments de données pour activer le suivi de la visionneuse.

De plus, si cette solution d’intégration est utilisée avec AEM Sites, la configuration suivante doit également être effectuée :

• Adobe I/O Console - l'intégration est créée pour l'Experience Platform Launch.
• Noeud d’auteur AEM - Configuration IMS et configuration de cloud Experience Platform Launch.

Dans le cadre de la configuration, veillez à avoir accès à une société de Adobe Experience Cloud dans laquelle Adobe Analytics et l’Experience Platform 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.

Voir aussi le Guide de mise en œuvre d’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.

   Voir Rapports et suites de rapports et Création d’une suite de rapports.

   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 [props] de trafic personnalisé et [eVar] de conversion) doit être motivée par les besoins spécifiques à votre implémentation Analytics.

   Voir Présentation de props et eVar.

   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 de l’Experience Platform Launch pour l’intégration

Une fois l’Experience Platform Launch configuré, les éléments suivants seront 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 l’Experience Platform Launch pour l’intégration :

1. Début en accédant à Experience Platform Launch à partir de l'Experience Cloud page d'accueil. 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 directement l’Experience Platform Launch.

   

Création d’une propriété dans l’Experience Platform Launch

Une propriété dans l’Experience Platform Launch est une configuration nommée qui maintient tous vos paramètres ensemble. 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).

Voir aussi Créer une propriété Launch.

1. Dans l’Experience Platform 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 l’Experience Platform 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.

Voir Extension Experience Cloud ID Service.

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

Voir Extension Adobe Analytics.

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

Voir Adobe Media Analytics for Audio and Video.

• (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 Dynamic Media Viewers n’est disponible que si la propriété Experience Platform Launch est créée pour le développement.

Voir Création d’une propriété dans Experience Platform Launch.

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 l’Experience Platform Launch, créez les éléments de données et les règles nécessaires au suivi des visionneuses Dynamic Media.

Voir Fonctionnement du suivi des données et des événements dans l’intégration pour une présentation du suivi avec l’Experience Platform Launch.

Voir Exemple de configuration pour un exemple de configuration dans l’Experience Platform Launch qui montre comment effectuer le suivi d’un nom de fichier au 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 de l’Experience Platform 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 l’Experience Platform Launch est effectuée à partir de l’onglet Publication sous la configuration des propriétés.

L’Experience Platform Launch peut avoir plusieurs environnements de développement, un environnement intermédiaire et un environnement de production. Par défaut, la configuration de Cloud Experience Platform Launch dans AEM pointe le noeud d’auteur AEM vers l’environnement d’étape de l’Experience Platform Launch et le noeud de publication AEM vers l’environnement de production de l’Experience Platform Launch. Cette disposition signifie qu’avec les paramètres d’AEM par défaut, il est nécessaire de publier la bibliothèque Experience Platform Launch sur l’environnement d’évaluation afin de l’utiliser dans AEM auteur, puis de la publier dans l’environnement de production afin qu’elle puisse être utilisée dans AEM publication.

Voir Environnements pour plus d'informations sur les environnements Experience Platform 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 l’Experience Platform Launch, la liste de bibliothèque 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.

   

   REMARQUE

   La prochaine fois que vous apporterez des modifications à votre configuration Experience Platform 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 l’Experience Platform 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 d’Experience Platform Launch Cloud.

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 IMS Adobe, dans la liste déroulante Solution cloud, cliquez sur Experience Platform 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.

   REMARQUE

   À 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 - <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 :

    REMARQUE

    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 Experience Platform 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 d’Experience Platform Launch Cloud pour l’intégration

1. Dans AEM auteur, près de l’angle supérieur gauche, cliquez sur l’icône Outils (marteau), puis sur Cloud Services > Configurations des Experience Platform Launch.

   

2. Sur la page Configurations des Experience Platform Launch, dans le panneau de gauche, sélectionnez un site AEM pour lequel appliquer la configuration des Experience Platform 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 Experience Platform 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é Experience Platform 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 Experience Platform Launch, renseignez le champ suivant :

   Dans le champ URI de bibliothèque, vérifiez l’emplacement de la version intermédiaire de votre bibliothèque Experience Platform Launch. AEM renseigne ce champ automatiquement.

   À titre d’illustration uniquement, cette étape utilise les bibliothèques Experience Platform Launch qui sont déployées sur le réseau de diffusion de contenu Adobe.

   REMARQUE

   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 Experience Platform Launch, si nécessaire, corrigez l’URI de production auto-renseignée de la même manière que sur la page précédente Évaluation.

9. Près du coin supérieur droit, cliquez sur Créer.

   Votre nouvelle configuration Experience Platform Launch Cloud est maintenant créée et répertoriée en regard de votre site Web.

10. Sélectionnez votre nouvelle configuration de cloud Experience Platform Launch (une coche s’affiche à gauche du titre de la configuration lorsqu’elle est sélectionnée). Dans la barre d’outils, cliquez sur Publier.

    

Actuellement, AEM auteur ne prend pas en charge l’intégration de Dynamic Media Viewers avec l’Experience Platform Launch.

Elle est toutefois prise en charge dans le nœud Publication AEM. AEM publication utilise les paramètres par défaut de la configuration de Experience Platform Launch Cloud. publication utilise l’environnement de production de l’Experience Platform Launch. Par conséquent, il est nécessaire de transmettre les mises à jour de la bibliothèque Experience Platform Launch de Développement à l’environnement de production chaque fois au cours du test.

Il est possible de contourner cette restriction en spécifiant l’URL de développement ou d’évaluation de la bibliothèque Experience Platform Launch dans la configuration Experience Platform Launch Cloud pour AEM publication ci-dessus. Ainsi, le noeud de publication AEM utilise la version de développement ou d’évaluation de la bibliothèque Experience Platform Launch.

Voir Intégrer l’Experience Platform Launch et le Experience Manager pour plus d’informations sur la configuration de la configuration de Cloud Experience Platform Launch.