Creación y ejecución del primer experimento

En este tutorial, hará lo siguiente:

  • Cree un proyecto de experimentación en el Centro de socios 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 registre los datos de eventos de vista y conversión en el Centro de Socios.
  • 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 Realizar experimentos con aplicaciones con pruebas A/B.

Prerrequisitos

Para seguir esta guía, debe tener una cuenta del Centro de Partners y debe configurar el equipo de desarrollo como se describe en Realizar experimentos con aplicaciones usando pruebas A/B.

Crear un proyecto con variables remotas en el Centro de Socios

  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 app en el Partner Center, crear una nueva app reservando un nombre y luego seleccione esa app en el Partner Center.
  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 Experimentos de clic de botón para tu 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 como nombre de la variable y escriba 128 en la columna Valor predeterminado.
  1. Haga clic en Guardar y anote el valor id. de proyecto de que aparece en la sección de integración del SDK de . 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 con Visual C#. Asigne al proyecto el nombre SampleExperiment.

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

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

  4. En la lista de los 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 desde la Caja 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 Click.

  8. Reemplace todo el contenido del archivo de código por el código siguiente. Asigne la variable projectId al identificador de proyecto con el valor de 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.

Crear el experimento en el Centro de socios

  1. Vuelva a la página del proyecto Experimentos de clic del 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 Ver evento, escriba userViewedButton en el campo View event name. Tenga en cuenta que este nombre coincide con la cadena de evento de visualización 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 de objetivo , escriba Aumentar los clics en el botón.
  • En el campo nombre de evento de conversión, escriba el nombreuserClickedButton . 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 remotas y variaciones, confirme que la casilla Distribuir por igual está activada para que las variaciones se distribuyan de manera equitativa en su aplicación.
  2. Agregue variables al experimento:
    1. Haga clic en el control desplegable, elija botón textoy haga clic en Agregar variable. La cadena Botón gris 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 ry haga clic en Agregar variable. La cadena 128 debería aparecer automáticamente en la columna Variación A. En la columna variante B de, escriba 1.
    3. Haga clic de nuevo en el control desplegable, elija gy haga clic en Agregar variable. La cadena 128 debería aparecer automáticamente en la columna Variación A. En la columna variante B de, escriba 1.
    4. Vuelva a hacer clic en el control desplegable, elija by 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 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 activas un experimento, el Centro de asociados empieza de inmediato a recopilar datos de las aplicaciones configuradas para registrar información 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 de experimentación para tu aplicación.

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

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

    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. Este ajuste cambia a 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.

  • Last updated on