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 sessions Contentsquare directement dans votre dashboard APM afin de voir exactement ce qu'un utilisateur faisait lorsqu'une erreur s'est produite et combiner les données techniques de votre APM avec les données comportementales mises en évidence par Contentsquare pour découvrir et prioriser les problèmes ayant le plus grand impact sur votre expérience client et votre revenu. Lors de l'identification d'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

Implémentation

Étapes d'Implémentation

Étape 1

Veuillez accéder à la section Comment demander une intégration pour voir les instructions pour autoriser cette intégration. Vous pouvez ensuite revenir ici une fois complété.

Pour utiliser l'intégration complète, veuillez fournir à votre CSM Contentsquare ou à l'équipe de support votre domaine de connexion Dynatrace, c'est généralement quelque chose comme ceci : 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 où 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 Session and Action Properties, sélectionnez “Add property”.

Changez la sélection de propriété en “Custom Defined Property”.

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

Instances prenant en charge DtrumApi

Sous Type d'expression, sélectionnez API JavaScript.
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 “Store as Session Property” et “Last Value”. 

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 “Ignore Do Not Track” nous permettra de capturer cette valeur des utilisateurs qui ont Do Not Track activé dans leur navigateur.

 

Si laissé non activé, nous ne capturerons pas la valeur pour les navigateurs avec Do Not Track activé.

 

Sélectionnez “Store as Session Property” et “Last Value”. 

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 sur 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 le tag RUM est configuré pour se mettre à jour automatiquement, la capture de propriété commencera dans quelques minutes. Si le tag est configuré en mode de mise à jour manuelle, une mise à jour sera nécessaire pour définir la propriété.

Vérifier que ça fonctionne

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

Notez que cela ne l'enverra qu'une fois par session lors de la toute première page vue, 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 sessions :

Dans toute session, vous devriez voir un lien de replay CS.

Lien de Contentsquare vers 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 sessions de Contentsquare fonctionne vers Dynatrace en accédant à toute session de replay qui a été capturée après que l'intégration a été autorisée et faire ce qui suit dans la toute première page vue 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 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 actifs, ils ne fonctionneront pas. Vous pouvez les ouvrir plus tard cependant. Toutes les sessions qui sont plus anciennes s'ouvriront au moment où vous accédez au lien.