aller au contenu principal
Parcourir la documentation

Cartographie du site et mode apprentissage

Deux façons de montrer délibérément votre produit à Syncanix, en une seule passe, plutôt que d’attendre que les visiteurs atteignent chaque écran.

Le widget lit l'écran sur lequel se trouve chaque visiteur, ce qui couvre vite les parties fréquentées de votre produit et lentement — voire jamais — les recoins tranquilles. Ces deux sessions comblent cet écart : vous les lancez vous-même, elles se terminent en une fois, et ce qu'elles trouvent devient la carte de votre site et le manuel de votre agent, jamais une nouvelle chose que l'agent pourrait faire.

Laquelle utiliser

Ils lisent des choses différentes : ce sont des compléments plutôt que des alternatives — cartographiez d'abord, car cela ne demande rien de plus que l'intégration que vous avez déjà.

Une carte du site lit des pages
Elle ouvre chaque page accessible et lit son balisage : les formulaires, les routes, les liens. Elle clique aussi sur les commandes qu'elle trouve à l'intérieur de copies scellées de vos pages, si bien que rien n'atteint votre serveur. Idéale pour cartographier vite la forme de votre produit.
Le mode apprentissage lit les requêtes
Vous utilisez votre produit normalement pendant qu’une session enregistre les requêtes qu’il émet, et Syncanix en déduit la forme attendue par chacune. Idéal quand ce que fait un écran ne se lit pas sur l’écran.

Cartographier votre site

La cartographie s'exécute dans un onglet que vous avez ouvert, connecté sous votre compte. Deux conditions doivent être remplies avant qu'elle démarre, et aucune ne consiste à ajouter quoi que ce soit à votre HTML.

  1. Indiquez l'adresse, dans le tableau de bordVous saisissez l'adresse exacte où votre widget est intégré. Si elle n'est pas encore sur votre liste de sites autorisés, un bouton l'ajoute et démarre dans le même clic. La cartographie ne quitte jamais cette adresse.
  2. Appuyez sur le boutonUn clic génère un lien à usage unique qui expire au bout de cinq minutes, et ouvre votre site avec. Un bandeau apparaît en haut de cette page et rend compte de la progression. Si vous préférez l'exécuter sur une autre machine, le même bouton peut copier le lien.
  3. Suivez-la, d'où vous voulezLe tableau de bord passe à une page propre à cette exécution. Rechargez-la, ouvrez-la dans un autre navigateur, ou envoyez l'adresse à un collègue : c'est la même exécution, lue depuis le serveur, et elle survit aux trois.
<script
  type="module"
  src="https://cdn.syncanix.com/widget.js"
  data-key="pk_live_..."
></script>

Ce que fait la cartographie, dans la posture que vous choisissez :

  • Elle lit chaque page qu'elle peut atteindre en tant que vous, en suivant vos propres liens.
  • Elle clique sur les commandes qu'elle trouve à l'intérieur de copies scellées de vos pages, si bien que rien n'atteint votre serveur. C'est ainsi qu'elle apprend ce qui se cache derrière un onglet, un menu ou un panneau.
  • Avec la posture Live — que vous choisissez et qui s'affiche à l'écran pendant toute l'exécution — elle clique sur votre site réel, en votre nom.

Avant de démarrer, vous choisissez jusqu’où elle va. Sûr est sélectionné :

  • Lecture seule : elle navigue et lit, et ne presse rien.
  • Sûr, le réglage par défaut : elle clique et saisit à l’intérieur de copies scellées de vos pages, si bien que rien n’atteint votre serveur.
  • En direct : dans Avancé, derrière un avertissement que vous devez confirmer. Elle clique sur votre site réel, connectée sous votre compte, et la bannière le dit pendant toute la durée.

Ce que la cartographie ne fait jamais, où que vous la dirigiez :

  • Elle ne supprime jamais, ne paie jamais, n'envoie aucun message et ne modifie aucune permission — quelle que soit la posture choisie — et ne soumet jamais un formulaire qu'on ne lui a pas demandé de soumettre.
  • Elle ne quitte jamais l’adresse que vous avez indiquée.
  • Elle ne conserve jamais les valeurs d'une requête ni d'une réponse. Elle enregistre la forme — quels champs, de quel type — et non ce qu'ils contenaient.
  • Elle ignore toute adresse qui semble supprimer ou retirer quelque chose, plutôt que de l’ouvrir pour vérifier.

Chaque exécution a sa propre page, à une adresse où vous pouvez revenir : un rechargement, un autre navigateur ou un collègue arrivent sur la même exécution. La liste conserve le nombre de pages lues, ainsi que ce qui a été ignoré et pourquoi. Une page ignorée est signalée plutôt qu'abandonnée en silence, si bien qu'une carte partielle n'a jamais l'air complète.

Lancer une session d’apprentissage

Une session d’apprentissage enregistre ce que votre produit demande à sa propre API pendant que vous l’utilisez. Rien n’est capturé tant que vous n’en démarrez pas une, et elle s’arrête dès que vous le dites.

  1. Démarrez une session pour une adresseVous nommez l’origine exacte où tourne votre widget. Une session capture sur cette seule adresse et nulle part ailleurs, et le tableau de bord vous montre un jeton de liaison une seule fois.
  2. Utilisez votre produit comme d’habitudeConnectez-vous et faites ce que font vos clients. Plus vous parcourez votre produit, plus Syncanix peut le décrire — et vous n’exécutez pas des actions pour qu’il les copie, vous lui montrez seulement ce que votre logiciel demande.
  3. Arrêtez-la et passez en revueTerminer la session arrête la capture. Ce que Syncanix conserve est une description de la forme attendue par chaque requête — jamais les valeurs — et c'est à partir de cette description qu'est construite la carte de votre site.

Ce qu’une session d’apprentissage ne capture jamais :

  • Les champs de mot de passe, de carte bancaire et de code à usage unique, ainsi que tout ce que vous avez marqué comme sensible.
  • Les en-têtes d’autorisation et de cookies. Ils sont écartés sur l’appareil et jamais envoyés.
  • Rien du tout, sur la durée. Les données personnelles et les secrets sont retirés dans le navigateur avant que quoi que ce soit ne quitte la page, et ce qui est enregistré est effacé après sept jours.
  • Rien de ce qui se trouve dans une région exclue via la configuration de votre widget.

Une lecture qu'elle fait bel et bien : pour déterminer d'où vient la valeur d'une requête, elle la compare à ce que la page contient déjà — une balise meta, un champ caché, un cookie, un élément stocké. La comparaison a lieu dans votre navigateur, la valeur est jetée dès qu'elle est faite, et ce qui est conservé est le NOM de l'endroit d'où elle venait. Rien que seul votre serveur peut lire ne lui est visible.

Étapes suivantes