Codificar seu aplicativo para experimentação

Depois de criar um projeto e definir variáveis remotas no Partner Center, você estará pronto para atualizar o código em seu aplicativo UWP (Plataforma Universal do Windows) para:

• Receba valores de variável remota do Partner Center.
• Use variáveis remotas para configurar experiências de aplicativo para seus usuários.
• Registre eventos no Partner Center que indicam quando os usuários visualizaram seu experimento e executaram uma ação desejada (também chamada de conversão ).

Para adicionar esse comportamento ao seu aplicativo, você usará APIs fornecidas pelo SDK dos Serviços da Microsoft Store.

As seções a seguir descrevem o processo geral de obtenção de variações para seus eventos de experimento e registro em log no Partner Center. Depois de codificar seu aplicativo para experimentação, você pode definir um experimento no Partner Center. Para obter um passo a passo que demonstra o processo de ponta a ponta de criar e executar um experimento, consulte Criar e executar seu primeiro experimento com o teste A/B.

Configurar seu projeto

Para começar, instale o SDK da Microsoft Store Services em seu computador de desenvolvimento e adicione as referências necessárias ao seu projeto.

1. Instalar o SDK dos Serviços da Microsoft Store.
2. Abra seu projeto no Visual Studio.
3. No Gerenciador de Soluções, expanda o nó do projeto, clique com o botão direito do mouse em Referênciase clique em Adicionar Referência.
4. No Gerenciador de Referência, expanda o Windows Universal e clique em Extensões.
5. Na lista de SDKs, selecione a caixa de seleção ao lado de Microsoft Engagement Framework e clique em OK.

Obter dados de variação e registrar o evento de exibição para seu experimento

Em seu projeto, localize o código do recurso que você deseja modificar em seu experimento. Adicione um código que recupera dados para uma variação, use esses dados para modificar o comportamento do recurso que você está testando e registre o evento de exibição do experimento no serviço de teste A/B no Partner Center.

O código específico necessário dependerá do aplicativo, mas o exemplo a seguir demonstra o processo básico. Para obter um exemplo de código completo, consulte Criar e executar seu primeiro experimento de teste A/B com.

private StoreServicesExperimentVariation variation;
private StoreServicesCustomEventLogger logger;

// Assign this variable to the project ID for your experiment from Dev Center.
// The project ID shown below is for example purposes only.
private string projectId = "F48AC670-4472-4387-AB7D-D65B095153FB";

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

    // Refresh the cached variation assignment if necessary.
    if (result.ErrorCode != StoreServicesEngagementErrorCode.None || result.ExperimentVariation.IsStale)
    {
        result = await StoreServicesExperimentVariation.GetRefreshedVariationAsync(projectId);

        if (result.ErrorCode == StoreServicesEngagementErrorCode.None)
        {
            variation = result.ExperimentVariation;
        }
    }

    // Get the remote variable named "buttonText" and assign the value
    // to the button.
    var buttonText = variation.GetString("buttonText", "Grey Button");
    await button.Dispatcher.RunAsync(
        Windows.UI.Core.CoreDispatcherPriority.Normal,
        () =>
        {
            button.Content = buttonText;
        });

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

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

As etapas a seguir descrevem as partes importantes desse processo em detalhes.

1. Declare um objeto StoreServicesExperimentVariation que representa a atribuição de variação atual e um objeto StoreServicesCustomEventLogger que você usará para registrar no log eventos de exibição e conversão no Partner Center.

   private StoreServicesExperimentVariation variation;
   private StoreServicesCustomEventLogger logger;
   

2. Declare uma variável de cadeia de caracteres atribuída à ID do projeto para o experimento que você deseja recuperar.

   Observação

   Você obtém uma ID de projeto quando cria um projeto no Partner Center. A ID do projeto mostrada abaixo é apenas para fins de exemplo.

   private string projectId = "F48AC670-4472-4387-AB7D-D65B095153FB";
   

3. Obtenha a atribuição de variação armazenada em cache atual para seu experimento chamando o método GetCachedVariationAsync e passe a ID do projeto do seu experimento para o método. Esse método retorna um objeto StoreServicesExperimentVariationResult que fornece acesso à atribuição de variação por meio da propriedade ExperimentVariation.

   var result = await StoreServicesExperimentVariation.GetCachedVariationAsync(projectId);
   variation = result.ExperimentVariation;
   

4. Verifique a propriedade IsStale para determinar se a atribuição de variação armazenada em cache precisa ser atualizada com uma atribuição de variação remota do servidor. Se precisar ser atualizado, chame o método estático GetRefreshedVariationAsync para verificar se há uma atribuição de variação atualizada do servidor e atualizar a variação em cache local.

   if (result.ErrorCode != StoreServicesEngagementErrorCode.None || result.ExperimentVariation.IsStale)
   {
       result = await StoreServicesExperimentVariation.GetRefreshedVariationAsync(projectId);
   
       if (result.ErrorCode == StoreServicesEngagementErrorCode.None)
       {
           variation = result.ExperimentVariation;
       }
   }
   

5. Use os métodos GetBoolean, GetDouble, GetInt32ou GetString do objeto StoreServicesExperimentVariation para obter os valores da atribuição de variação. Em cada método, o primeiro parâmetro é o nome da variação que você deseja recuperar (esse é o mesmo nome de uma variação que você insere no Partner Center). O segundo parâmetro é o valor padrão que o método deve retornar se não for capaz de recuperar o valor especificado do Partner Center (por exemplo, se não houver conectividade de rede) e uma versão armazenada em cache da variação não estiver disponível.

   O exemplo a seguir usa GetString para obter uma variável chamada buttonText e especifica um valor de variável padrão de botão cinza.

   var buttonText = variation.GetString("buttonText", "Grey Button");
   

6. Em seu código, use os valores de variável para modificar o comportamento do recurso que você está testando. Por exemplo, o código a seguir atribui o valor buttonText ao conteúdo de um botão em seu aplicativo. Este exemplo pressupõe que você já tenha definido esse botão em outro lugar em seu projeto.

   await button.Dispatcher.RunAsync(
       Windows.UI.Core.CoreDispatcherPriority.Normal,
       () =>
       {
           button.Content = buttonText;
       });
   

7. Por fim, registre o evento de visualização do seu experimento para o serviço de teste A/B no Partner Center. Inicialize o campo logger em um objeto StoreServicesCustomEventLogger e chame o método LogForVariation. Passe o objeto StoreServicesExperimentVariation que representa a atribuição de variação atual (este objeto fornece contexto sobre o evento para o Partner Center) e o nome do evento de exibição do experimento. Isso deve corresponder ao nome do evento de exibição que você insere para seu experimento no Partner Center. Seu código deve registrar o evento de exibição quando o usuário começar a exibir uma variação que faz parte do experimento.

   O exemplo a seguir mostra como registrar um evento de exibição chamado userViewedButton. Neste exemplo, o objetivo do experimento é fazer com que o usuário clique em um botão no aplicativo, de modo que o evento de exibição seja registrado depois que o aplicativo tiver recuperado os dados de variação (nesse caso, o texto do botão) e atribuído ao conteúdo do botão.

   if (logger == null)
   {
       logger = StoreServicesCustomEventLogger.GetDefault();
   }
   
   logger.LogForVariation(variation, "userViewedButton");
   

Registrar eventos de conversão no Partner Center

Em seguida, adicione código para registrar os eventos de conversão no serviço de teste A/B no Partner Center. Seu código deve registrar um evento de conversão quando o usuário atingir um objetivo para o experimento. O código específico necessário dependerá do seu aplicativo, mas aqui estão as etapas gerais. Para obter um exemplo de código completo, consulte Criar e executar seu primeiro experimento de teste A/B com.

1. No código executado quando o usuário atingir um objetivo para uma das metas do experimento, chame o método LogForVariation novamente e passe o objeto StoreServicesExperimentVariation e o nome de um evento de conversão para seu experimento. Isso deve corresponder a um dos nomes de evento de conversão que você insere para seu experimento no Partner Center.

   O exemplo a seguir registra um evento de conversão chamado userClickedButton do manipulador de eventos Clique para um botão. Neste exemplo, o objetivo do experimento é fazer com que o usuário clique no botão.

   private void button_Click(object sender, RoutedEventArgs e)
   {
       if (logger == null)
       {
           logger = StoreServicesCustomEventLogger.GetDefault();
       }
   
       logger.LogForVariation(variation, "userClickedButton");
   }
   

Próximas etapas

Depois de codificar o experimento em seu aplicativo, você estará pronto para as seguintes etapas:

1. Definir seu experimento no Partner Center. Crie um experimento que defina os eventos de exibição, os eventos de conversão e as variações exclusivas para o teste A/B.
2. executar e gerenciar seu experimento no Partner Center.

Tópicos relacionados

• Criar um projeto e definir variáveis remotas no Partner Center
• Definir seu experimento no Partner Center
• Gerenciar seu experimento no Partner Center
• Crie e execute seu primeiro experimento com teste A/B
• Executar experimentos de aplicativo com testes A/B