Catégorie : Gestion des performances d'application (APM)

Cette intégration n'est disponible que pour les projets web.

À quoi s'attendre

Cette intégration vous aidera à évaluer la manière dont les performances affectent l'expérience de vos clients. Vous pourrez accéder aux replays de sessions Contentsquare directement depuis le tableau de bord de votre APM et voir ce qu'un utilisateur faisait exactement au moment où une erreur est survenue, ainsi que combiner les données techniques de votre APM avec les données comportementales identifiées par Contentsquare pour découvrir les problèmes de votre site et les prioriser selon leur impact sur l'expérience utilisateur et les revenus. Quand vous identifierez un problème dans un replay de session Contentsquare, vous pourrez trouver son lien vers la session Dynatrace correspondante et ainsi examiner l'erreur plus en profondeur dans votre APM.

Ce que nous collectons

Variables dynamiques

Ce que nous envoyons

Session Replay

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

Consultez l'article "Demander une intégration" et suivez ses instructions pour activer cette intégration. Une fois cela fait, vous pourrez poursuivre votre lecture de cet article.

Afin de pouvoir utiliser l'entièreté de l'intégration, veillez à envoyer votre domaine de connexion Dynatrace à votre CSM Contentsquare ou à notre équipe Support. Il s'agit généralement de quelques chose comme ceci : domain.live.dynatrace.com. Vous le trouverez dans l'URL de l'application web Dynatrace. Cela vous permettra de passer des replays de sessions Contentsquare aux sessions Dynatrace correspondantes. Poursuivez la lecture pour découvrir les instructions d'utilisation.

Si vous avez déjà complété les étapes décrites ci-dessus, continuez. 

Étape 2

Dans le portail Dynatrace, naviguez jusqu'à la section "Application" dans le menu de gauche et cliquez sur "Frontend".

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

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

Dans les paramètres de l'application, ouvrez le menu "Capture" et sélectionner "Propriétés des sessions et actions".

Une fois sur l'écran, cliquez sur "Ajouter une propriété".

Changez la sélection de propriété pour "Propriété définie personnalisée".

Selon que l'instance Dynatrace actuelle déployée sur votre site live supporte le Javascript DtrumApi Dynatrace, alors vous devrez choisir l'une des 2 options décrites ci-dessous :

Instances supportant DtrumApi

Dans "Expression Type", sélectionnez "API JavaScript".
Sélectionnez un type de données (chaîne) et une longueur de chaîne définie sur 200.

Saisissez le nom d'affichage de la propriété qui sera visible dans le portail.

Assurez-vous de l'appeler : Contentsquare Replay et que la key soit contentsquarereplay et rien d'autre.

Sélectionnez "Enregistrer comme propriété de session" et "Dernière value".

Enregistrez la propriété.

Répétez les étapes ci-dessus pour créer d'autre propriété et configurer l'API JavaScript, cette fois, comme Contentsquare SID avec une longueur de 100. Il est important de vous assurer que vous utilisez exactement le même nom qu'au-dessus afin que la key générée corresponde à : contentsquaresid

Instances NE supportant PAS DtrumApi

Sous "Expression Type", sélectionnez "Variable JavaScript".

Sélectionnez un type de données (chaîne) et une longueur de chaîne définie sur 200.

Saisissez CS_CONF.integrations_handler.replaylink comme variable.

Saisissez le nom d'affichage de la propriété qui sera visible dans le portail.

Assurez-vous de l'appeler : Contentsquare Replay et que la key soit contentsquarereplay et rien d'autre.

Sélectionner "Ignorer le Do Not Track" nous permettra de capturer cette value pour les utilisateurs dont le "Do Not Track" est activé sur leur navigateur.

Si laissé non activé, nous ne capturerons pas la value des navigateurs pour lesquels le "Do Not Track" est activé.

Sélectionnez "Enregistrer comme propriété de session" et "Dernière value".

Enregistrez la propriété.

Répétez les étapes ci-dessus pour créer une autre propriété et configurer la variable JavaScript afin qu'elle soit "CS_CONF.integrations_handler.sessionID" avec une longueur de 100 et nommez-la Contentsquare SID.

Il est important de vous assurer d'utiliser exactement le nom ci-dessus afin que la key générée soit bien : contentsquaresid

Une fois les deux définies, vous devriez vois ceci :

Si la partie contentsquaresid est différente pour quelques raisons que ce soit, veuillez en informer l'équipe Contentsquare pour que nous configurions la key différente dans les paramètres de votre intégration de notre côté. Autrement, le lien de Contentsquare à Dynatrace ne fonctionnera pas.

Si le tag RUM est configuré de manière à s'actualiser automatiquement, la capture de la propriété commencera en quelques minutes. Si le tag est configuré pour être mis à jour manuellement, une mise à jour sera nécessaire pour configurer la propriété.

Vérifier que ça fonctionne

Vous pouvez utiliser l'extension Chrome pour vous assurer que les résultats sont bien envoyés à Contentsquare.

Notez que cela ne sera envoyée qu'une fois par session, lors de la toute première vue de page. Vous devrez donc supprimer les cookies et recharger la page pour le tester.

Vérifiez que le lien du replay est bien disponible dans la plateforme Dynatrace :

Ces liens ne seront disponibles que pour les utilisateurs dont les sessions ont été enregistrées :

Vous devriez voir un lien de replay CS pour n'importe quelle session.

Lien de Contentsquare vers Dynatrace

En supposant que vous ayez déjà envoyé votre domaine de connexion Dynatrace à Contentsquare (et aussi que vous ayez une key personnalisée pour la propriété de session Contentsquare SID dans Dynatrace comme mentionné dans les instructions ci-dessus), vous pouvez alors vérifier si le lien de replay de session Contentsquare redirige bien vers Dynatrace en vous rendant sur tout replay de session enregistrée après activation de l'intégration et en effectuant les actions suivantes lors de la toute première vue de page de la session.

Cliquez sur les 3 points et sélectionnez l'option "Voir les variables".

 

Vous verrez alors ce pop-up. Cliquez sur l'onglet DVAR et trouvez la key APM_DT_Session Link contenant le lien vers Dynatrace. Vous pouvez cliquer sur "Copier la value" et la-coller dans votre navigateur pour l'ouvrir. Cette URL sera par la suite cliquable.

 

Cela devrait ensuite vous conduire directement vers la session correspondante dans Dynatrace :

 

Veuillez noter que Dynatrace n'autorise que que les données de sessions soient affichées et recherchées après que la session en direct se soit terminée, c'est-à-dire : généralement 30 minutes après le début du temps d'inactivité ou après la sortie du site. Ainsi, si vous ouvrez un lien de session encore active, ce dernier ne fonctionnera pas. Vous pourrez néanmoins les ouvrir plus tard. Toute autre session plus ancienne s'ouvrira dès que vous cliquerez sur le lien.