Partager via

Créer et exécuter votre première expérience

  • Article

Lors de cette procédure pas à pas, vous allez :

  • Créez un projet d’expérimentation dans l’Espace partenaires qui définit plusieurs variables distantes qui représentent le texte et la couleur d’un bouton d’application.
  • Créez une application avec du code qui récupère les valeurs des variables distantes, utilise ces données pour modifier la couleur d’arrière-plan d’un bouton, et journalise les données d’événements de conversion et de vue vers l’Espace partenaires.
  • Créez une expérience dans le projet pour tester si la modification de la couleur d’arrière-plan du bouton d’application augmente correctement le nombre de clics de bouton.
  • Exécutez l’application pour collecter des données d’expérience.
  • Passez en revue les résultats de l’expérience dans l’Espace partenaires, choisissez une variante permettant à tous les utilisateurs de l’application et terminez l’expérience.

Pour obtenir une vue d’ensemble des tests A/B avec l’Espace partenaires, consultez Exécuter des expériences d’application avec des tests A/B.

Prérequis

Pour suivre cette procédure pas à pas, vous devez disposer d’un compte Espace partenaires et configurer votre ordinateur de développement comme décrit dans Exécuter des expériences d’application avec des tests A/B.

Créer un projet avec des variables distantes dans l’Espace partenaires

  1. Connectez-vous à l’Espace partenaires.
  2. Si vous disposez déjà d’une application dans l’Espace partenaires que vous souhaitez utiliser pour créer une expérience, sélectionnez cette application dans l’Espace partenaires. Si vous n’avez pas encore d’application dans l’Espace partenaires, créez une application en réservant un nom , puis sélectionnez cette application dans l’Espace partenaires.
  3. Dans le volet de navigation, cliquez sur Services , puis sur Expérimentation.
  4. Dans la section Projets de la page suivante, cliquez sur le bouton Nouveau projet .
  5. Dans la page Nouveau projet , entrez le nom Button Click Experiments pour votre nouveau projet.
  6. Développez la section Variables distantes, puis cliquez sur Ajouter une variable quatre fois. Vous devez maintenant avoir quatre lignes de variables vides.
  • Dans la première ligne, tapez buttonText pour le nom de la variable et tapez Bouton Gris dans la colonne Valeur par défaut.
  • Dans la deuxième ligne, tapez r pour le nom de la variable et tapez 128 dans la colonne valeur par défaut.
  • Dans la troisième ligne, tapez g pour le nom de la variable et tapez 128 dans la colonne valeur par défaut.
  • Dans la quatrième ligne, tapez b pour le nom de la variable et tapez 128 dans la colonne valeur par défaut.
  1. Cliquez sur Enregistrer et notez la valeur de l’ID de projet qui apparaît dans la section d’intégration du Kit de développement logiciel (SDK). Dans la section suivante, vous allez mettre à jour votre code d’application et référencer cette valeur dans votre code.

Coder l’expérience dans votre application

  1. Dans Visual Studio, créez un projet plateforme Windows universelle à l’aide de Visual C#. Nommez le projet SampleExperiment.

  2. Dans Explorateur de solutions, développez votre nœud de projet, cliquez avec le bouton droit sur Références, puis cliquez sur Ajouter une référence.

  3. Dans le Gestionnaire de références, développez Windows universel et cliquez sur Extensions.

  4. Dans la liste des kits SDK, cochez la case en regard de Microsoft Engagement Framework , puis cliquez sur OK.

  5. Dans Explorateur de solutions, double-cliquez sur MainPage.xaml pour ouvrir le concepteur de la page principale de l’application.

  6. Faites glisser un bouton de la boîte à outils vers la page.

  7. Double-cliquez sur le bouton du concepteur pour ouvrir le fichier de code et ajouter un gestionnaire d’événements pour l’événement Click .

  8. Remplacez l’intégralité du contenu du fichier de code par le code suivant. Affectez la projectId variable à la valeur d’ID de projet que vous avez obtenue à partir de l’Espace partenaires dans la section précédente.

    using System;
using Windows.UI.Xaml;
using Windows.UI.Xaml.Controls;
using Windows.UI.Xaml.Media;
using System.Threading.Tasks;
using Windows.UI;
using Windows.UI.Core;

// Namespace for A/B testing.
using Microsoft.Services.Store.Engagement;

namespace SampleExperiment
{
    public sealed partial class MainPage : Page
    {
        private StoreServicesExperimentVariation variation;
        private StoreServicesCustomEventLogger logger;

        // Assign this variable to the project ID for your experiment from Dev Center.
        private string projectId = "";

        public MainPage()
        {
            this.InitializeComponent();

            // Because this call is not awaited, execution of the current method
            // continues before the call is completed.
#pragma warning disable CS4014
            InitializeExperiment();
#pragma warning restore CS4014
        }

        private async Task InitializeExperiment()
        {
            // Get the current cached variation assignment for the experiment.
            var result = await StoreServicesExperimentVariation.GetCachedVariationAsync(projectId);
            variation = result.ExperimentVariation;

            // Check whether the cached variation assignment needs to be refreshed.
            // If so, then refresh it.
            if (result.ErrorCode != StoreServicesEngagementErrorCode.None || result.ExperimentVariation.IsStale)
            {
                result = await StoreServicesExperimentVariation.GetRefreshedVariationAsync(projectId);

                // If the call succeeds, use the new result. Otherwise, use the cached value.
                if (result.ErrorCode == StoreServicesEngagementErrorCode.None)
                {
                    variation = result.ExperimentVariation;
                }
            }

            // Get remote variables named "buttonText", "r", "g", and "b" from the variation
            // assignment. If no variation assignment is available, the variables default
            // to "Grey button" for the button text and grey RGB value for the button color.
            var buttonText = variation.GetString("buttonText", "Grey Button");
            var r = (byte)variation.GetInt32("r", 128);
            var g = (byte)variation.GetInt32("g", 128);
            var b = (byte)variation.GetInt32("b", 128);

            // Assign button text and color.
            await button.Dispatcher.RunAsync(
                CoreDispatcherPriority.Normal,
                () =>
                {
                    button.Background = new SolidColorBrush(Color.FromArgb(255, r, g, b));
                    button.Content = buttonText;
                    button.Visibility = Visibility.Visible;
                });

            // Log the view event named "userViewedButton" to Dev Center.
            if (logger == null)
            {
                logger = StoreServicesCustomEventLogger.GetDefault();
            }

            logger.LogForVariation(variation, "userViewedButton");
        }

        private void button_Click(object sender, RoutedEventArgs e)
        {
            // Log the conversion event named "userClickedButton" to Dev Center.
            if (logger == null)
            {
                logger = StoreServicesCustomEventLogger.GetDefault();
            }

            logger.LogForVariation(variation, "userClickedButton");
        }
    }
}

  9. Enregistrez le fichier de code et générez le projet.

Créer l’expérience dans l’Espace partenaires

  1. Revenez à la page du projet Click Experiments bouton dans l’Espace partenaires.
  2. Dans la section Expériences , cliquez sur le bouton Nouvelle expérience .
  3. Dans la section Détails de l’expérience, tapez le nom Optimiser les clics du bouton Dans le champ Nom de l’expérience.
  4. Dans la section Afficher l’événement, tapez userViewedButton dans le champ Afficher le nom de l’événement. Notez que ce nom correspond à la chaîne d’événement d’affichage que vous avez enregistrée dans le code que vous avez ajouté dans la section précédente.
  5. Dans la section Objectifs et événements de conversion, entrez les valeurs suivantes :
  • Dans le champ Nom de l’objectif, tapez Augmenter les clics du bouton.
  • Dans le champ Nom de l’événement conversion, tapez le nom userClickedButton. Notez que ce nom correspond à la chaîne d’événement de conversion que vous avez enregistrée dans le code que vous avez ajouté dans la section précédente.
  • Dans le champ Objective , choisissez Agrandir.
  1. Dans la section Variables et variantes distantes , vérifiez que la case Distribuer de façon égale est cochée afin que les variantes soient distribuées de façon égale à votre application.
  2. Ajoutez des variables à votre expérience :
    1. Cliquez sur le contrôle déroulant, choisissez buttonText, puis cliquez sur Ajouter une variable. La chaîne Bouton Gris doit apparaître automatiquement dans la colonne Variante A (cette valeur est dérivée des paramètres du projet). Dans la colonne Variation B , tapez Bouton bleu.
    2. Cliquez à nouveau sur le contrôle déroulant, choisissez r, puis cliquez sur Ajouter une variable. La chaîne 128 doit apparaître automatiquement dans la colonne Variation A . Dans la colonne Variation B , tapez 1.
    3. Cliquez à nouveau sur le contrôle déroulant, choisissez g, puis cliquez sur Ajouter une variable. La chaîne 128 doit apparaître automatiquement dans la colonne Variation A . Dans la colonne Variation B , tapez 1.
    4. Cliquez à nouveau sur le contrôle déroulant, choisissez b, puis cliquez sur Ajouter une variable. La chaîne 128 doit apparaître automatiquement dans la colonne Variation A . Dans la colonne Variation B , tapez 255.
  3. Cliquez sur Enregistrer , puis sur Activer.

Important

Après avoir activé une expérience, vous ne pouvez plus modifier les paramètres de l’expérience, sauf si vous avez cliqué sur la case à cocher Modifier l’expérience lorsque vous avez créé l’expérience. En règle générale, nous vous recommandons de coder l’expérience dans votre application avant d’activer votre expérience.

Exécuter l’application pour collecter des données d’expérience

  1. Exécutez l’application SampleExperiment que vous avez créée précédemment.
  2. Vérifiez que vous voyez un bouton gris ou bleu. Cliquez sur le bouton, puis fermez l’application.
  3. Répétez les étapes ci-dessus plusieurs fois sur le même ordinateur pour confirmer que votre application affiche la même couleur de bouton.

Passez en revue les résultats et terminez l’expérience

Attendez au moins plusieurs heures après avoir terminé la section précédente, puis suivez ces étapes pour passer en revue les résultats de votre expérience et terminer l’expérience.

Remarque

Dès que vous activez une expérience, l’Espace partenaires commence immédiatement à collecter des données à partir de toutes les applications instrumentées pour journaliser les données de votre expérience. Toutefois, l’affichage des données d’expérience dans l’Espace partenaires peut prendre plusieurs heures.

  1. Dans l’Espace partenaires, revenez à la page Expérimentation de votre application.

  2. Dans la section Expériences actives , cliquez sur Optimiser les clics de bouton pour accéder à la page de cette expérience.

  3. Vérifiez que les résultats affichés dans les sections Résumé des résultats et Détails des résultats correspondent à ce que vous prévoyez de voir. Pour plus d’informations sur ces sections, consultez Gérer votre expérience dans l’Espace partenaires.

    Remarque

    L’Espace partenaires signale uniquement le premier événement de conversion pour chaque utilisateur sur une période de 24 heures. Si un utilisateur déclenche plusieurs événements de conversion dans votre application au cours d’une période de 24 heures, seul le premier événement de conversion est signalé. Cela permet d’empêcher un seul utilisateur avec de nombreux événements de conversion de réduire les résultats de l’expérience pour un échantillon d’utilisateurs.

  4. Vous êtes maintenant prêt à mettre fin à l’expérience. Dans la section Résumé des résultats , dans la colonne Variation B , cliquez sur Changer. Cela permet à tous les utilisateurs de votre application d’atteindre le bouton bleu.

  5. Cliquez sur OK pour confirmer que vous souhaitez mettre fin à l’expérience.

  6. Exécutez l’application SampleExperiment que vous avez créée dans la section précédente.

  7. Vérifiez qu’un bouton bleu s’affiche. Notez qu’il peut prendre jusqu’à deux minutes pour que votre application reçoive une attribution de variante mise à jour.