Suivi des modifications apportées à votre produit grâce aux versions

Dans Amplitude, une version représente un changement dans votre produit. Il peut s’agir d’une mise à jour majeure comme le lancement d’une nouvelle fonctionnalité, de la mise en place d’un correctif mineur pour corriger un léger dysfonctionnement ou du lancement d’une expérience. Des marqueurs dans vos graphiques de séries chronologiques indiquent à quels moments les déploiements des versions ont eu lieu.

Amplitude crée automatiquement des versions pour tous les clients disposant de plans payants, mais vous pouvez également en créer manuellement.

Création d’une version

Versions automatisées

Amplitude cherche constamment à détecter l’apparition d’une nouvelle valeur pour la propriété d’utilisateur Version. Lorsqu’une nouvelle valeur est détectée, Amplitude crée automatiquement une version le lendemain. Il applique les heuristiques suivantes lors de la création d’une version :

• Une version doit suivre le format de gestion sémantique de version : major.minor.patch, où .patch est facultatif. Par exemple, Version = 12345 ne déclenchera pas automatiquement la création d’une version, contrairement à Version = 123.45.6.
• Les projets de développement (projets qui contiennent des noms tels que « Test », « Development », « Staging », etc.) sont exclus de la génération automatique des versions.
• Si vous envoyez des données d’événement côté serveur via l’API HTTP/Batch d’Amplitude, utilisez la propriété d’utilisateur app_version.

Aucune version automatisée ne sera créée de manière rétroactive en réponse à l’ajout de données manquantes.

Configuration d’une version automatisée

Vous pouvez configurer la détection automatique des versions dans le cadre Release Timeline, si vous êtes un administrateur ou un responsable. Il vous suffit de cliquer sur l’icône des paramètres pour accéder au menu volant Project Settings. Vous pouvez y activer ou désactiver la détection automatique des versions et l’annotation automatique.

Versions manuelles

Si votre produit n’utilise pas la gestion sémantique des versions ou si vous ne disposez pas de l’un de nos plans payants, vous pouvez créer manuellement une version depuis la vue Release Timeline ou via la fonctionnalité Microscope dans un graphique.

Pour créer manuellement une version, cliquez sur + Add a Release et renseignez la boîte de dialogue qui apparaît :

• • Name : le nom de la version. Il est visible sur les graphiques et dans la vue Release Timeline.
  • Descriptions : le changement que la version apporte au produit. Il est visible dans la vue Release Timeline.
  • Version : la propriété d’utilisateur Version qui définit le changement de produit. Amplitude utilise ce champ pour vous présenter tous les nouveaux événements introduits dans la version, via la page Release Report. Le champ Version sélectionné doit correspondre à une valeur existante dans vos données.
  • Release Date : la date à laquelle la version a été publiée.
  • End Date : la date de fin du déploiement de la version.
  • Platform(s) : la ou les  Platform(s) auxquelles cette version s’applique.
  • Visibility : indique si la version est visible sur tous les graphiques ou non.

API Releases

Les versions peuvent également être créées par programmation à l’aide de l’API Releases. Cette dernière vous permet d’intégrer la création des versions dans vos propres processus de déploiement internes.

Modification d’une version

Les versions qui ont été créées manuellement ou détectées automatiquement peuvent être modifiées pour leur ajouter un contexte et des informations supplémentaires. Pour ce faire, ouvrez la version à partir de la vue Release Timeline et cliquez sur Edit.

Par défaut, toutes les versions sont visibles dans tous les graphiques. Vous pouvez modifier la visibilité d’une version à partir de la page Release Report (cette vue) ou la vue Release Timeline.

Release Report

Depuis la vue Release Timeline, vous pouvez cliquer sur une version pour afficher la page Release Report. La page Release Report est un recueil de métadonnées et d’analyses généré par Amplitude.

Dans la section Metrics, vous pouvez voir le nombre d’utilisateurs uniques qui ont interagi avec votre version ainsi que le pourcentage de votre base d’utilisateurs actifs que ce chiffre représente. Le pourcentage d’utilisateurs actifs correspond au nombre d’utilisateurs qui ont vu votre version, divisé par le nombre d’utilisateurs sur la plateforme renseignée dans la définition de la version.

 

 

Si de nouveaux événements ont été inclus dans cette version, Amplitude les affiche dans le tableau à droite.

 

La métrique % Active vous montre le pourcentage de votre base d’utilisateurs actifs qui déclenchent les nouveaux événements détectés depuis la date de publication.

 

La section Adoption affiche une série chronologique retraçant l’adoption de votre version depuis sa date de lancement. La série chronologique est limitée à 30 jours depuis le début de la version.

 

Ajout d’éléments à une version

Vous pouvez créer un lien vers d’autres contenus Amplitude via la section Analyses. Ainsi, les autres membres de votre organisation comprennent facilement les performances des expériences que vous avez lancées et l’impact qu’elles ont eu sur vos utilisateurs.

Utilisez les versions pour communiquer à la fois des informations contextuelles et des résultats à l’ensemble de votre équipe.

Pour joindre des éléments à une version, cliquez sur + Add Item dans la section Analyses de la page Release Report.

Release Timeline

La vue Release Timeline fait office d’historique de toutes les mises à jour de produits que votre équipe a publiées. Il s’agit d’une chronologie des versions créées automatiquement par Amplitude ainsi que des versions qui ont été ajoutées manuellement par votre équipe.

 

Pour accéder à la vue Release Timeline, cliquez sur Releases dans l’interface de navigation de gauche. Utilisez le sélecteur de projet pour afficher les versions du projet de votre choix.

REMARQUE : actuellement, la fonctionnalité Release Timeline ne renseigne que les nouvelles versions publiées en temps réel. Lors de l’ajout rétroactif d’anciennes données, les versions dont elles font mention ne sont pas considérées comme nouvelles, car celles-ci ont été publiées dans le passé. Les versions apparaissant dans le système de manière rétroactive ne peuvent être ajoutées que de manière manuelle à la chronologie.