Vytvoření a spuštění prvního experimentu

Tento návod vám ukáže, jak:

• Vytvořte v Centru pro partnery projekt experimentování, který definuje několik vzdálených proměnných, jež představují text a barvu tlačítka aplikace.
• Vytvořte aplikaci s kódem, který načítá hodnoty vzdálených proměnných, používá tato data k úpravě barvy pozadí tlačítka a protokoluje data o zobrazení a konverzích událostí zpět do Partnerského centra.
• Vytvořte v projektu experiment, který otestuje, jestli změna barvy pozadí tlačítka aplikace úspěšně zvýší počet kliknutí na tlačítko.
• Spuštěním aplikace shromážděte data experimentu.
• Zkontrolujte výsledky experimentu v Partnerském centru, zvolte variantu, která se povolí všem uživatelům aplikace, a dokončete experiment.

"Přehled testování A/B v centru pro partnery naleznete v části Provádění experimentů s aplikacemi pomocí testování A/B."

Požadavky

Pokud chcete postupovat podle tohoto názorného postupu, musíte mít účet Partnerského centra a musíte nakonfigurovat vývojový počítač, jak je popsáno v tématu Spuštění experimentů s testováním A/B.

Vytvoření projektu se vzdálenými proměnnými v Partnerském centru

1. Přihlaste se k Partnerskému centru.
2. Pokud už máte aplikaci v Partnerském centru, kterou chcete použít k vytvoření experimentu, vyberte tuto aplikaci v Partnerském centru. Pokud ještě nemáte aplikaci v Partnerském centru, vytvořte novou aplikaci rezervováním názvu a poté vyberte tuto aplikaci v Partnerském centru.
3. V navigačním podokně klepněte na položku Služby a potom klepněte na tlačítko Experimentování.
4. V části Projekty na další stránce klikněte na tlačítko Nový projekt .
5. Na stránce Nový projekt zadejte název Experimenty s kliknutím na tlačítko pro váš nový projekt.
6. Rozbalte oddíl Vzdálené proměnné a klikněte na Přidat proměnnou čtyřikrát. Teď byste měli mít čtyři prázdné řádky proměnných.

• Do prvního řádku zadejte buttonText pro názvu proměnné a do sloupce Výchozí hodnota zadejte Grey Button.
• Do druhého řádku zadejte r pro název proměnné a do sloupce Výchozí hodnota zadejte 128.
• Do třetího řádku napište g jako proměnné název a do sloupce Výchozí hodnota napište 128.
• Ve čtvrtém řádku zadejte b pro název proměnné a ve sloupci Výchozí hodnota zadejte 128.

7. Klikněte na Uložit a poznamenejte si hodnotu ID projektu , která se zobrazí v části integrace sady SDK . V další části aktualizujete kód aplikace a na tuto hodnotu v kódu odkazujete.

Kódování experimentu v aplikaci

1. V sadě Visual Studio vytvořte nový projekt univerzální platformy Windows pomocí jazyka Visual C#. Pojmenujte projekt SampleExperiment.

2. V Průzkumníku řešení rozbalte uzel projektu, klikněte pravým tlačítkem na Odkazya klikněte na Přidat odkaz.

3. Ve Správci odkazů rozbalte položku Univerzální systém Windows a klepněte na tlačítko Rozšíření.

4. V seznamu SDK zaškrtněte políčko vedle Microsoft Engagement Framework a klikněte na OK.

5. V Průzkumníku řešenídvojitým kliknutím na MainPage.xaml otevřete návrhář pro hlavní stránku v aplikaci.

6. Přetáhněte tlačítko ze sady nástrojů na stránku.

7. Dvojklikem na tlačítko v návrhovém prostředí otevřete soubor s kódem a přidejte obslužnou rutinu pro událost Click.

8. Celý obsah souboru kódu nahraďte následujícím kódem. Přiřaďte proměnnou projectId k hodnotě ID projektu , kterou jste získali z Partner Center v předchozí části.

   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. Uložte soubor kódu a sestavte projekt.

Vytvoření experimentu v Partnerském centru

1. Vraťte se na stránku projektu experimenty s kliknutím na tlačítko v partnerském centru.
2. V části Experimenty klikněte na tlačítko Nový experiment .
3. V části Podrobnosti o experimentu zadejte název Optimalizace kliknutí na tlačítko do pole Název experimentu.
4. V části Zobrazit událost zadejte userViewedButton do pole Název události Zobrazení . Všimněte si, že tento název odpovídá řetězci události zobrazení, který jste zaprotokolovali v kódu, který jste přidali v předchozí části.
5. V části Cíle a události převodu zadejte následující hodnoty:

• Do pole Název cíle zadejte Zvýšení Kliknutí na Tlačítko.
• Do pole Název události převodu zadejte název userClickedButton. Všimněte si, že toto jméno odpovídá řetězci události převodu, který jste zaznamenali v kódu, který jste přidali v předchozí části.
• V poli Objective zvolte Maximalizovat.

6. V části Vzdálené proměnné a varianty ověřte, že je zaškrtnuté políčko Distribuovat rovnoměrně, aby se varianty rovnoměrně distribuovaly do vaší aplikace.
7. Přidejte do experimentu proměnné:
   1. Klikněte na rozevírací pole, zvolte buttonTexta poté klikněte na Přidat proměnnou. Řetězec Šedé tlačítko by se měl automaticky objevit ve sloupci Varianta A (tato hodnota je odvozena z nastavení projektu). Do sloupce Variant B zadejte modré tlačítko.
   2. Znovu klikněte na ovládací prvek rozevíracího seznamu, zvolte r a klikněte na Přidat proměnnou. Řetězec 128 by se měl automaticky objevit ve sloupci Varianta A . Do sloupce Varianta B zadejte 1.
   3. Znovu klikněte na ovládací prvek rozevíracího seznamu, zvolte g a klikněte na Přidat proměnnou. Řetězec 128 by se měl automaticky objevit ve sloupci Varianta A . Do sloupce Varianta B zadejte 1.
   4. Znovu klikněte na rozevírací ovládací prvek, zvolte b a klikněte na Přidat proměnnou. Řetězec 128 by se měl automaticky objevit ve sloupci Varianta A . Do sloupce Varianta B zadejte 255.
8. Klepněte na tlačítko Uložit a potom klepněte na tlačítko Aktivovat.

Důležité

Po aktivaci experimentu už nemůžete parametry experimentu upravovat, pokud jste při vytváření experimentu nezaškrtli políčko Upravitelný experiment . Před aktivací experimentu obvykle doporučujeme zakódovat experiment v aplikaci.

Spuštěním aplikace shromážděte data experimentu.

1. Spusťte aplikaci SampleExperiment , kterou jste vytvořili dříve.
2. Potvrďte, že se zobrazuje šedé nebo modré tlačítko. Klikněte na tlačítko a zavřete aplikaci.
3. Opakujte výše uvedené kroky několikrát na stejném počítači, abyste potvrdili, že aplikace zobrazuje stejnou barvu tlačítka.

Kontrola výsledků a dokončení experimentu

Počkejte aspoň několik hodin po dokončení předchozí části a pak podle těchto kroků zkontrolujte výsledky experimentu a experiment dokončete.

Poznámka:

Jakmile experiment aktivujete, Partnerské centrum okamžitě začne shromažďovat data ze všech aplikací, které jsou instrumentované k protokolování dat pro váš experiment. Zobrazení dat experimentu v Partnerském centru ale může trvat několik hodin.

1. V Partnerském centru se vraťte na stránku Experimentování vaší aplikace.

2. V části Aktivní experimenty klikněte na Optimalizovat kliknutí na tlačítko, abyste přešli na stránku tohoto experimentu.

3. Ověřte, že výsledky zobrazené v sekcích Souhrn výsledků a Podrobnosti o výsledcích odpovídají tomu, co očekáváte vidět. Další podrobnosti o těchto částech najdete v tématu Správa experimentu v Partnerském centru.

   Poznámka:

   Partnerské centrum hlásí pouze první událost převodu pro každého uživatele v 24hodinovém časovém období. Pokud uživatel v aplikaci aktivuje více událostí převodu během 24hodinového období, zobrazí se pouze první událost převodu. Cílem je zabránit tomu, aby jeden uživatel s mnoha událostmi převodu zkresloval výsledky experimentu pro vzorek uživatelů.

4. Teď jste připraveni experiment ukončit. V části Souhrn výsledků ve sloupci Varianta B klikněte na Přepnout. Tím se přepnou všichni uživatelé vaší aplikace na modré tlačítko.

5. Kliknutím na OK potvrďte, že chcete experiment ukončit.

6. Spusťte aplikaci SampleExperiment , kterou jste vytvořili v předchozí části.

7. Potvrďte, že se zobrazí modré tlačítko. Upozorňujeme, že přijetí aktualizovaného přiřazení variant může trvat až dvě minuty.

Související témata

• Vytvoření projektu a definování vzdálených proměnných v Partnerském centru
• Naprogramujte svou aplikaci pro experimenty
• Definování experimentu v Partnerském centru
• Správa experimentu v Partnerském centru
• Spouštění aplikačních experimentů s A/B testováním