MaleusMaleus

Installer le widget Maleus (projets externes uniquement)

Les projets Maleus embarquent le widget par défaut. Si vous avez connecté une codebase externe existante, copiez le snippet depuis les Réglages pour brancher le widget vous-même.

Dans l'appParamètres du projet
Sur cette page

Le widget Maleus est l'overlay de tracing qui capture les revues d'app. Savoir si vous devez l'installer dépend du type de projet.

Type de projetÉtat du widget
Projet MaleusLe widget est injecté automatiquement. Rien à installer.
Projet externeLe widget est optionnel. Copiez le snippet depuis les Réglages dans votre codebase.

Si votre projet a été créé de zéro dans Maleus, vous pouvez sauter cet article. Le widget est déjà là. Ouvrez Revues d'app pour voir ce que vos utilisateurs envoient.

Projets externes : récupérer le snippet

  1. Ouvrez le projet, puis Réglages.
  2. Dans le drill Réglages de la sidebar, choisissez SDK Maleus.
  3. L'étape 1 de la page affiche le snippet. Cliquez sur Copier.

Si le snippet contient encore <YOUR_APP_API_KEY>, c'est que le projet n'a pas encore généré de clé. Cliquez sur Générer la clé API de l'app dans la sidebar de la même page. La clé est masquée à l'écran, mais Copier place la vraie valeur dans votre presse-papiers.

Brancher le snippet dans votre codebase

Placez le snippet dans le <head> ou juste avant </body>. L'endroit exact dépend de votre stack :

  • HTML statique : n'importe où dans le <head>.
  • SPA : chargez-le avant votre router pour que les navigations soient capturées.
  • Framework rendu côté serveur : incluez-le dans votre layout racine.

Vérifier l'installation

La même page de Réglages porte une carte Étape 2 / Vérifier l'installation. Dès que votre app charge le widget au moins une fois, elle passe de En attente de la première revue à Widget détecté, avec un badge En direct. Le bouton Vérifier à nouveau force une nouvelle vérification.

Ce qui est envoyé

Quand quelqu'un interagit avec le widget, la capture contient :

  • Une capture d'écran ou un snapshot du DOM de la vue courante.
  • Les erreurs récentes observées dans la page.
  • La note ou le commentaire saisi.
  • L'identifiant de version dont le build est marqué (quand il est disponible).

Tout arrive dans Revues d'app, avec la version pré-remplie. Les revues capturées depuis un build qui ne marque pas de version apparaissent en Non rattachée.

Gardez le widget activé sur staging. C'est là que vous récolterez les retours les plus actionnables, avant de promouvoir en production.

Régénérer la clé API

Si vous avez besoin de faire tourner la clé, la sidebar de la même page de Réglages porte une action Régénérer la clé. Une modale vous prévient que la clé précédente cesse de fonctionner dès la confirmation.

Où regarder ensuite