Dynatrace

Catégorie : Gestion de la performance des applications

Cette intégration est uniquement disponible pour les projets Web

À quoi s'attendre

Cette intégration vous aidera à évaluer comment les performances affectent l'expérience de vos clients. Vous pourrez accéder aux replays de session Contentsquare directement dans votre tableau de bord APM afin de voir exactement ce qu'un utilisateur faisait lorsqu'une erreur s'est produite et de combiner les données techniques de votre APM avec les données comportementales issues de Contentsquare pour découvrir et prioriser les problèmes ayant le plus grand impact sur l'expérience client et les revenus. Lorsque vous identifiez un problème dans un replay de session Contentsquare, vous pourrez également trouver le lien vers la session Dynatrace correspondante afin de pouvoir l'examiner plus en détail dans votre APM.

Ce que nous collectons

Variables dynamiques

Ce que nous envoyons

Replay de session

Exemple d'URL : https://app.contentsquare.com/quick-playback/index.html?pid=3771&uu=cc912cdb-ee03-a739-a659-ad2a5b1f08bb&sn=12&pvid=1&recordingType=cs&vd=dt

Mise en œuvre

Étapes de mise en œuvre

Étape 1

Veuillez vous rendre à la section Comment demander une intégration pour voir les instructions pour activer cette intégration. Vous pourrez ensuite revenir ici une fois terminé.

Pour utiliser l'intégration complète, veuillez fournir à votre CSM Contentsquare ou à l'équipe de support votre domaine de connexion Dynatrace, qui est généralement quelque chose comme : domain.live.dynatrace.com. Vous pouvez le trouver dans l'URL de l'application Web Dynatrace. Cela vous permettra de passer du replay de session Contentsquare à la session Dynatrace pertinente. Voir les instructions d'utilisation ci-dessous.

Si vous avez déjà complété l'étape ci-dessus, continuez ci-dessous.

Étape 2

Dans le portail Dynatrace, accédez à la section Application dans le menu de gauche puis cliquez sur Frontend.

Sélectionnez l'application pour laquelle vous souhaitez configurer l'intégration Contentsquare.

Une fois dans l'application, sélectionnez les trois points (…) en haut à droite et appuyez sur Modifier.

Sous les paramètres de l'application, développez le menu “Capturing” et sélectionnez les “Session and Action Properties”.

Une fois dans l'écran des Propriétés de Session et d'Action, sélectionnez “Ajouter une propriété”.

Changez la sélection de propriété en “Propriété Définie Personnalisée”.

Maintenant, selon que votre instance Dynatrace actuelle déployée sur votre site en direct prend en charge le Javascript DtrumApi, vous devez choisir l'une des 2 options ci-dessous :

Instances prenant en charge DtrumApi

Sous Type d'expression, sélectionnez JavaScript API.
Sélectionnez le type de données (chaîne) et la longueur de la chaîne définie à 200.

Entrez le Nom d'affichage de la propriété qui sera visible dans le portail.

Assurez-vous de le nommer : Contentsquare Replay et assurez-vous que la clé est contentsquarereplay et rien d'autre.

Sélectionnez “Stocker en tant que propriété de session” et “Dernière valeur”. 

Enregistrez la propriété.

Répétez les étapes ci-dessus pour créer une autre propriété et définissez cette fois l'API JavaScript sur Contentsquare SID avec une longueur de 100 et il est important de s'assurer que vous utilisez le nom exact ci-dessus afin qu'il génère une clé comme ceci : contentsquaresid

Instances NE prenant PAS en charge DtrumApi

Sous Type d'expression, sélectionnez variable JavaScript.

Sélectionnez le type de données (chaîne) et la longueur de la chaîne définie à 200.

Insérez CS_CONF.integrations_handler.replaylink comme variable

Entrez le Nom d'affichage de la propriété qui sera visible dans le portail.

Assurez-vous de le nommer : Contentsquare Replay et assurez-vous que la clé est contentsquarereplay et rien d'autre.

Sélectionner “Ignorer Do Not Track” nous permettra de capturer cette valeur des utilisateurs qui ont Do Not Track activé dans leur navigateur.

Si cela n'est pas désactivé, nous ne capturerons pas la valeur pour les navigateurs avec Do Not Track activé.

Sélectionnez “Stocker comme propriété de session” et “Dernière valeur”. 

Enregistrez la propriété.

Répétez les étapes ci-dessus pour créer une autre propriété et définissez cette fois la variable Javascript comme CS_CONF.integrations_handler.sessionID avec une longueur de 100 et nommez-la Contentsquare SID.

Il est important de s'assurer que vous utilisez le nom exact ci-dessus afin qu'il génère une clé comme ceci :

contentsquaresid

Après que les deux soient définis, vous devriez voir quelque chose comme ceci :

Si pour une raison quelconque la partie contentsquaresid est différente, veuillez informer l'équipe Contentsquare pour configurer la clé différente dans vos paramètres d'intégration de notre côté, sinon le lien vers Dynatrace depuis Contentsquare ne fonctionnera pas.

Si la balise RUM est configurée pour se mettre à jour automatiquement, la capture de propriété commencera dans quelques minutes. Si la balise est configurée en mode mise à jour manuelle, une mise à jour sera nécessaire pour définir la propriété.

Vérification du bon fonctionnement

Vous pouvez utiliser l'extension chrome pour vérifier que les résultats sont envoyés à CS

Notez qu'il ne l'enverra qu'une seule fois par session lors de la toute première vue de page, donc pour tester cela, vous devrez supprimer les cookies puis recharger.

Vérifiez à l'intérieur de la plateforme Dynatrace pour le lien de replay :

Il n'aura un lien de replay que pour les utilisateurs dont les sessions ont été collectées par le replay de session :

Dans n'importe quelle session, vous devriez voir un lien de replay CS.

Lien de Contentsquare à Dynatrace

En supposant que vous ayez déjà fourni à Contentsquare le domaine de connexion Dynatrace (et également si vous avez une clé personnalisée pour la propriété de session SID de Contentsquare dans Dynatrace comme mentionné dans les instructions ci-dessus et fourni cela également), vous pouvez alors vérifier si le lien des replays de session de Contentsquare fonctionne vers Dynatrace en allant à n'importe quelle session de replay qui a été capturée après que l'intégration a été activée et faire ce qui suit lors de la toute première vue de page de la session.

Cliquez sur les 3 points puis Afficher les variables

 

Vous verrez alors cette fenêtre contextuelle. Cliquez sur l'onglet DVAR et trouvez la clé APM_DT_Session Link qui contient un lien vers Dynatrace. Vous pouvez cliquer sur Copier la valeur et la coller dans votre navigateur pour l'ouvrir. À l'avenir, cette URL sera cliquable.

 

Cela devrait alors vous amener directement à la même session dans Dynatrace :

 

Veuillez noter que Dynatrace ne permet d'afficher et de rechercher les données de session qu'après qu'une session en direct a pris fin pour un visiteur. Cela se produit généralement 30 minutes après le début du temps d'inactivité ou après avoir quitté le site. Donc, si vous ouvrez l'un de ces liens de sessions qui sont encore actives, ils ne fonctionneront pas. Vous pourrez les ouvrir plus tard cependant. Toutes les sessions plus anciennes s'ouvriront au moment où vous accédez au lien.