Partilhar via

Crie e execute sua primeira experiência

Neste guia prático, irá:

  • Crie um projeto de experimento no Partner Center que define várias variáveis remotas que representam o texto e a cor de um botão de uma aplicação.
  • Crie um aplicativo com código que recupere os valores das variáveis remotas, use esses dados para alterar a cor do plano de fundo de um botão e registre os dados de eventos de exibição e conversão de volta para o Partner Center.
  • Crie um experimento no projeto para testar se alterar a cor do plano de fundo do botão do aplicativo aumenta com êxito o número de cliques no botão.
  • Execute o aplicativo para coletar dados do experimento.
  • Analise os resultados do experimento no Partner Center, escolha uma variação a ser habilitada para todos os usuários do aplicativo e conclua o experimento.

Para obter uma visão geral dos testes A/B com o Partner Center, consulte Executar experimentos de aplicativos com testes A/B.

Pré-requisitos

Para seguir este passo a passo, você deve ter uma conta do Partner Center e configurar seu computador de desenvolvimento conforme descrito em Executar experimentos de aplicativos com testes A/B.

Criar um projeto com variáveis remotas no Partner Center

  1. Inicie sessão no Partner Center.
  2. Se você já tiver um aplicativo no Partner Center que deseja usar para criar um experimento, selecione esse aplicativo no Partner Center. Se ainda não tiveres uma aplicação no Partner Center, cria uma nova aplicação ao reservar um nome e selecciona essa aplicação no Partner Center.
  3. No painel de navegação, clique em Serviços e, em seguida, clique em Experimentação .
  4. Na seção Projetos da próxima página, clique no botão Novo projeto.
  5. Na página Novo projeto, insira o nome Button Click Experiments para o seu novo projeto.
  6. Expanda a seção de variáveis remotas e clique em Adicionar variável quatro vezes. Agora você deve ter quatro linhas variáveis vazias.
  • Na primeira linha, digite buttonText para o nome da variável e digite Grey Button na coluna valor padrão.
  • Na segunda linha, digite r para o nome da variável e digite 128 na coluna valor padrão.
  • Na terceira linha, digite g para o nome da variável e digite 128 na coluna Valor padrão.
  • Na quarta linha, digite b para o nome da variável e digite 128 na coluna valor padrão.
  1. Clique em Guardar e anote o valor do ID do projeto que aparece na secção de integração do SDK . Na próxima seção, você atualizará o código do aplicativo e fará referência a esse valor no código.

Codifique o experimento em seu aplicativo

  1. No Visual Studio, crie um novo projeto da Plataforma Universal do Windows usando o Visual C#. Nomeie o projeto SampleExperiment.

  2. No Explorador de Soluções, expanda o nó do projeto, clique com o botão direito do mouse em Referênciase clique em Adicionar Referência.

  3. No Reference Manager, expanda Universal Windows e clique em Extensões.

  4. Na lista de SDKs, selecione a caixa ao lado de Microsoft Engagement Framework e clique em OK.

  5. No Gerenciador de Soluções , clique duas vezes em MainPage.xaml para abrir o designer da página principal do aplicativo.

  6. Arraste um Botão da Caixa de Ferramentas para a página.

  7. Clique duas vezes no botão no designer para abrir o arquivo de código e adicionar um manipulador de eventos para o evento Click.

  8. Substitua todo o conteúdo do arquivo de código pelo código a seguir. Atribua a variável ao valor ID do projeto que você obteve do Partner Center na seção 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. Salve o arquivo de código e construa o projeto.

Criar a experiência no Partner Center

  1. Regresse à página do projeto "Botão Clique Experiências" no Partner Center.
  2. Na secção Experimentos , clique no botão Novo Experimento .
  3. Na seção Detalhes do experimento, digite o nome Otimizar Cliques do Botão no campo nome do experimento.
  4. Na seção Visualizar evento, digite userViewedButton no campo nome do evento. Observe que esse nome corresponde à cadeia de caracteres de evento de exibição que você registrou no código adicionado na seção anterior.
  5. Na seção Metas e eventos de conversão, insira os seguintes valores:
  • No campo Nome da meta, digite Aumentar cliques no botão.
  • No campo nome do evento de conversão, digite o nome userClickedButton. Observe que esse nome corresponde à cadeia de caracteres de evento de conversão que você registrou no código adicionado na seção anterior.
  • No campo Objetivo, escolha Maximizar.
  1. Na seção variáveis remotas e variações, confirme se a caixa de seleção Distribuir igualmente está marcada para que as variações sejam distribuídas igualmente para seu aplicativo.
  2. Adicione variáveis ao seu experimento:
    1. Clique no menu suspenso, escolha o botão de texto , e clique em Adicionar variável . A string Grey Button deve aparecer automaticamente na coluna Variação A (este valor é derivado das configurações do projeto). Na coluna Variação B, digite Blue Button.
    2. Clique no menu suspenso novamente, selecione re clique em Adicionar variável. A cadeia de caracteres 128 deve aparecer automaticamente na coluna Variação A. Na coluna Variação B, digite 1.
    3. Clique no controle suspenso novamente, escolha ge clique em Adicionar variável. A cadeia de caracteres 128 deve aparecer automaticamente na coluna Variação A. Na coluna Variação B, digite 1.
    4. Clique no controle suspenso novamente, escolha be clique em Adicionar variável. A cadeia de caracteres 128 deve aparecer automaticamente na coluna Variação A. Na coluna Variação B, digite 255.
  3. Clique Guardar e, em seguida, clique em Ativar.

Importante

Depois de ativar um experimento, você não poderá mais modificar os parâmetros do experimento, a menos que tenha clicado na caixa de seleção do experimento editável quando criou o experimento. Normalmente, recomendamos que você codifique o experimento em seu aplicativo antes de ativá-lo.

Execute o aplicativo para coletar dados do experimento

  1. Execute a aplicação SampleExperiment que criou anteriormente.
  2. Confirme que vê um botão cinzento ou azul. Clique no botão e feche o aplicativo.
  3. Repita as etapas acima várias vezes no mesmo computador para confirmar se seu aplicativo mostra a mesma cor de botão.

Revise os resultados e conclua o experimento

Aguarde pelo menos várias horas após concluir a seção anterior e, em seguida, siga estas etapas para revisar os resultados do experimento e concluí-lo.

Observação

Assim que você ativar um experimento, o Partner Center começará imediatamente a coletar dados de todos os aplicativos que são instrumentados para registrar dados para seu experimento. No entanto, pode levar várias horas para que os dados do experimento apareçam no Partner Center.

  1. No Partner Center, retorne à página Experimentação da sua aplicação.

  2. Na seção Experimentos Ativos, clique em Otimizar Cliques do Botão para ir para a página deste experimento.

  3. Confirme se os resultados mostrados no de resumo de Resultados e Detalhes seções Resultados correspondem ao que você espera ver. Para obter mais detalhes sobre essas seções, consulte Gerenciar seu experimento no Partner Center.

    Observação

    O Partner Center relata apenas o primeiro evento de conversão para cada usuário em um período de 24 horas. Se um usuário acionar vários eventos de conversão em seu aplicativo dentro de um período de 24 horas, somente o primeiro evento de conversão será relatado. Isso se destina a ajudar a impedir que um único usuário com muitos eventos de conversão distorca os resultados do experimento para um grupo de amostra de usuários.

  4. Agora você está pronto para terminar o experimento. Na seção Resumo dos resultados, na coluna Variação B, clique em Alterar. Isto muda todos os utilizadores da sua aplicação para o botão azul.

  5. Clique em OK para confirmar que deseja encerrar o experimento.

  6. Execute a aplicação SampleExperiment que criaste na secção anterior.

  7. Confirme que vê um botão azul. Observe que pode levar até dois minutos para que seu aplicativo receba uma atribuição de variação atualizada.

  • Last updated on