Partilhar via

Criar e executar seu primeiro experimento

  • Artigo

Neste passo a passo, você vai:

  • Crie um projeto de experimentação no Partner Center que defina várias variáveis remotas que representam o texto e a cor de um botão do aplicativo.
  • Crie um aplicativo com código que recupere os valores de variáveis remotas, use esses dados para alterar a cor da tela de fundo de um botão e registre dados de exibição e evento de conversão de volta para o Partner Center.
  • Crie um experimento no projeto para testar se a alteração da cor da tela 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.
  • Examine 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 do teste A/B com o Partner Center, consulte Executar experimentos de aplicativo 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 aplicativo com testes A/B.

Criar um projeto com variáveis remotas no Partner Center

  1. Entre 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 você ainda não tiver um aplicativo no Partner Center, crie um novo aplicativo reservando um nome e selecione esse aplicativo 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 Experimentos de clique no botão para seu novo projeto.
  6. Expanda a seção Variáveis remotas e clique em Adicionar variável quatro vezes. Agora você deve ter quatro linhas de variáveis vazias.
  • Na primeira linha, digite buttonText para o nome da variável e digite Botão Cinza 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 Salvar e anote o valor do ID do projeto que aparece na seçã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 em seu código.

Codificar 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 Gerenciador de Soluções, expanda o nó do projeto, clique com o botão direito do mouse em Referências e clique em Adicionar Referência.

  3. No Gerenciador de Referências, expanda Janelas Universais e clique em Extensões.

  4. Na lista de SDKs, marque a caixa de seleção 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 projectId variável ao valor da 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 o experimento no Partner Center

  1. Retorne à página do projeto Experimentos de Clique no Botão no Partner Center.
  2. Na seção Experimentos, clique no botão Novo experimento.
  3. Na seção Detalhes do experimento, digite o nome Otimizar cliques no botão no campo Nome do experimento.
  4. Na seção Exibir evento, digite userViewedButton no campo Exibir 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 controle suspenso, escolha buttonText e clique em Adicionar variável. A string Botão Cinza deve aparecer automaticamente na coluna Variação A (este valor é derivado das configurações do projeto). Na coluna Variação B, digite Botão Azul.
    2. Clique no controle suspenso novamente, escolha r e clique em Adicionar variável. A string 128 deve aparecer automaticamente na coluna Variação A . Na coluna Variação B, digite 1.
    3. Clique no controle suspenso novamente, escolha g e clique em Adicionar variável. A string 128 deve aparecer automaticamente na coluna Variação A . Na coluna Variação B, digite 1.
    4. Clique no controle suspenso novamente, escolha b e clique em Adicionar variável. A string 128 deve aparecer automaticamente na coluna Variação A . Na coluna Variação B, digite 255.
  3. Clique em Salvar 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 Experimento editável ao criar o experimento. Normalmente, recomendamos que você codifique o experimento em seu aplicativo antes de ativá-lo.

Executar o aplicativo para coletar dados do experimento

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

Revise os resultados e conclua o experimento

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

Observação

Assim que você ativa um experimento, o Partner Center começa imediatamente a coletar dados de todos os aplicativos 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 do seu aplicativo.

  2. Na seção Experimentos ativos, clique em Otimizar cliques no botão para ir para a página desse experimento.

  3. Confirme se os resultados mostrados nas seções Resumo de resultados e Detalhes dos 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 no seu aplicativo em um período de 24 horas, somente o primeiro evento de conversão será informado. O objetivo é ajudar a impedir que um único usuário com muitos eventos de conversão distorça os resultados do experimento para um grupo de amostra de usuários.

  4. Agora você está pronto para encerrar o experimento. Na seção Resumo de resultados, na coluna Variação B, clique em Alternar. Isso alterna todos os usuários do seu aplicativo para o botão azul.

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

  6. Execute o aplicativo SampleExperiment que você criou na seção anterior.

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