Compartir a través de

Crear y ejecutar tu primer experimento

  • Artículo

En este tutorial realizará lo siguiente:

  • Cree un proyecto de experimentación en el Centro de partners que defina varias variables remotas que representan el texto y el color de un botón de aplicación.
  • Cree una aplicación con código que recupere los valores de las variables remotas, use estos datos para cambiar el color de fondo de un botón y vuelva a ver y convertir los datos de eventos en el Centro de partners.
  • Cree un experimento en el proyecto para probar si cambiar el color de fondo del botón de la aplicación aumenta correctamente el número de clics de botón.
  • Ejecute la aplicación para recopilar datos del experimento.
  • Revise los resultados del experimento en el Centro de partners, elija una variación para habilitar para todos los usuarios de la aplicación y complete el experimento.

Para obtener información general sobre las pruebas de A/B con el Centro de partners, consulte Ejecución de experimentos de aplicaciones con pruebas A/B.

Requisitos previos

Para seguir este tutorial, debe tener una cuenta del Centro de partners y debe configurar el equipo de desarrollo tal y como se describe en Ejecutar experimentos de aplicaciones con pruebas A/B.

Creación de un proyecto con variables remotas en el Centro de partners

  1. Inicie sesión en el Centro de partners.
  2. Si ya tienes una aplicación en el Centro de partners que quieres usar para crear un experimento, selecciona esa aplicación en el Centro de partners. Si aún no tiene una aplicación en el Centro de partners, cree una aplicación reservando un nombre y, a continuación, seleccione esa aplicación en el Centro de partners.
  3. En el panel de navegación, haga clic en Servicios y, a continuación, haga clic en Experimentación.
  4. En la sección Proyectos de la página siguiente, haga clic en el botón Nuevo proyecto .
  5. En la página Nuevo proyecto , escriba el nombre Botón Haga clic en Experimentos para el nuevo proyecto.
  6. Expanda la sección Variables remotas y haga clic en Agregar variable cuatro veces. Ahora debería tener cuatro filas de variables vacías.
  • En la primera fila, escriba buttonText para el nombre de la variable y escriba Botón gris en la columna Valor predeterminado.
  • En la segunda fila, escriba r para el nombre de la variable y escriba 128 en la columna Valor predeterminado.
  • En la tercera fila, escriba g para el nombre de la variable y escriba 128 en la columna Valor predeterminado.
  • En la cuarta fila, escriba b para el nombre de la variable y escriba 128 en la columna Valor predeterminado.
  1. Haga clic en Guardar y anote el valor del identificador del proyecto que aparece en la sección integración del SDK. En la sección siguiente, actualizará el código de la aplicación y hará referencia a este valor en el código.

Codificar el experimento en la aplicación

  1. En Visual Studio, cree un nuevo proyecto de Plataforma universal de Windows mediante Visual C#. Asigne al proyecto el nombre SampleExperiment.

  2. En Explorador de soluciones, expanda el nodo del proyecto, haga clic con el botón derecho en Referencias y haga clic en Agregar referencia.

  3. En el Administrador de referencias, expanda Windows universal y haga clic en Extensiones.

  4. En la lista de SDK, active la casilla situada junto a Microsoft Engagement Framework y haga clic en Aceptar.

  5. En Explorador de soluciones, haga doble clic en MainPage.xaml para abrir el diseñador de la página principal de la aplicación.

  6. Arrastre un botón del cuadro de herramientas a la página.

  7. Haga doble clic en el botón del diseñador para abrir el archivo de código y agregar un controlador de eventos para el evento Click .

  8. Reemplace todo el contenido del archivo de código por el código siguiente. Asigne la projectId variable al valor del identificador del proyecto que obtuvo del Centro de partners en la sección anterior.

    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. Guarde el archivo de código y compile el proyecto.

Creación del experimento en el Centro de partners

  1. Vuelva a la página del proyecto Experimentos de clic en el botón en el Centro de partners.
  2. En la sección Experimentos , haga clic en el botón Nuevo experimento .
  3. En la sección Detalles del experimento, escriba el nombre Optimizar clics del botón en el campo Nombre del experimento.
  4. En la sección View event (Ver evento ), escriba userViewedButton en el campo View event name (Ver nombre de evento). Tenga en cuenta que este nombre coincide con la cadena de evento de vista que registró en el código que agregó en la sección anterior.
  5. En la sección Objetivos y eventos de conversión, escriba los siguientes valores:
  • En el campo Nombre del objetivo, escriba Aumentar clics de botón.
  • En el campo Nombre del evento de conversión, escriba el nombre userClickedButton. Tenga en cuenta que este nombre coincide con la cadena de evento de conversión que registró en el código que agregó en la sección anterior.
  • En el campo Objetivo , elija Maximizar.
  1. En la sección Variables y variaciones remotas, confirme que la casilla Distribuir por igual está activada para que las variaciones se distribuyan igual a la aplicación.
  2. Agregue variables al experimento:
    1. Haga clic en el control desplegable, elija el botónTexto y haga clic en Agregar variable. El botón gris de cadena debería aparecer automáticamente en la columna Variación A (este valor se deriva de la configuración del proyecto). En la columna Variación B , escriba Botón azul.
    2. Vuelva a hacer clic en el control desplegable, elija r y haga clic en Agregar variable. La cadena 128 debería aparecer automáticamente en la columna Variación A . En la columna Variación B , escriba 1.
    3. Vuelva a hacer clic en el control desplegable, elija g y haga clic en Agregar variable. La cadena 128 debería aparecer automáticamente en la columna Variación A . En la columna Variación B , escriba 1.
    4. Vuelva a hacer clic en el control desplegable, elija b y haga clic en Agregar variable. La cadena 128 debería aparecer automáticamente en la columna Variación A . En la columna Variación B , escriba 255.
  3. Haga clic en Guardar y, a continuación, haga clic en Activar.

Importante

Después de activar un experimento, ya no puede modificar los parámetros del experimento a menos que haga clic en la casilla Editable experiment (Experimento editable) al crear el experimento. Normalmente, se recomienda codificar el experimento en la aplicación antes de activar el experimento.

Ejecución de la aplicación para recopilar datos del experimento

  1. Ejecute la aplicación SampleExperiment que creó anteriormente.
  2. Confirme que ve un botón gris o azul. Haga clic en el botón y, a continuación, cierre la aplicación.
  3. Repita los pasos anteriores varias veces en el mismo equipo para confirmar que la aplicación muestra el mismo color de botón.

Revise los resultados y complete el experimento.

Espere al menos varias horas después de completar la sección anterior y siga estos pasos para revisar los resultados del experimento y completar el experimento.

Nota:

En cuanto se activa un experimento, el Centro de partners comienza inmediatamente a recopilar datos de las aplicaciones que se instrumentan para registrar los datos del experimento. Sin embargo, los datos del experimento pueden tardar varias horas en aparecer en el Centro de partners.

  1. En el Centro de partners, vuelva a la página Experimentación de la aplicación.

  2. En la sección Experimentos activos, haga clic en Optimizar clics del botón para ir a la página de este experimento.

  3. Confirme que los resultados que se muestran en las secciones Resumen de resultados y Detalles de resultados coinciden con lo que espera ver. Para obtener más información sobre estas secciones, consulta Administrar el experimento en el Centro de partners.

    Nota:

    El Centro de partners informa solo del primer evento de conversión para cada usuario en un período de 24 horas. Si un usuario desencadena varios eventos de conversión en la aplicación en un período de 24 horas, solo se notifica el primer evento de conversión. Esto está pensado para ayudar a evitar que un único usuario con muchos eventos de conversión quite los resultados del experimento para un grupo de usuarios de ejemplo.

  4. Ahora ya está listo para finalizar el experimento. En la sección Resumen de resultados , en la columna Variación B , haga clic en Cambiar. Esto cambia todos los usuarios de la aplicación al botón azul.

  5. Haga clic en Aceptar para confirmar que desea finalizar el experimento.

  6. Ejecute la aplicación SampleExperiment que creó en la sección anterior.

  7. Confirme que ve un botón azul. Tenga en cuenta que la aplicación puede tardar hasta dos minutos en recibir una asignación de variación actualizada.