Udostępnij przez

Tworzenie i uruchamianie pierwszego eksperymentu

Korzystając z tego przewodnika, wykonasz następujące czynności:

  • Utwórz eksperymentowanie projektu w Centrum partnerskim, który definiuje kilka zmiennych zdalnych reprezentujących tekst i kolor przycisku aplikacji.
  • Utwórz aplikację z kodem, który pobiera wartości zmiennych zdalnych, używa tych danych do zmiany koloru tła przycisku, a także rejestruje dane zdarzeń wyświetlania i konwersji z powrotem do Centrum partnerskiego.
  • Utwórz eksperyment w projekcie, aby sprawdzić, czy zmiana koloru tła przycisku aplikacji pomyślnie zwiększa liczbę kliknięć przycisków.
  • Uruchom aplikację, aby zebrać dane eksperymentu.
  • Przejrzyj wyniki eksperymentu w Centrum partnerskim, wybierz odmianę, aby włączyć dla wszystkich użytkowników aplikacji i ukończyć eksperyment.

Aby zapoznać się z omówieniem testowania A/B w Centrum partnerskim, zobacz Run app experiments with A/B testing(Uruchamianie eksperymentów aplikacji za pomocą testowania A/B).

Wymagania wstępne

Aby wykonać czynności opisane w tym przewodniku, powinieneś posiadać konto w Centrum partnerskim i skonfigurować komputer deweloperski zgodnie z opisem w sekcji "Uruchamianie eksperymentów aplikacji przy użyciu testowania A/B" .

Tworzenie projektu ze zmiennymi zdalnymi w Centrum partnerskim

  1. Zaloguj się do Centrum Partnerów.
  2. Jeśli masz już aplikację w Centrum partnerskim, której chcesz użyć do utworzenia eksperymentu, wybierz tę aplikację w Centrum partnerskim. Jeśli nie masz jeszcze aplikacji w Centrum partnerskim, utwórz nową aplikację, rezerwując nazwę, a następnie wybierz tę aplikację w Centrum partnerskim.
  3. W okienku nawigacji kliknij pozycję Usługi , a następnie kliknij pozycję Eksperymentowanie.
  4. W sekcji Projects na następnej stronie kliknij przycisk Nowy projekt.
  5. Na stronie Nowy projekt wprowadź nazwę Eksperymenty z Kliknięciem Przycisku dla nowego projektu.
  6. Rozwiń sekcję Zmienne zdalne i kliknij przycisk Dodaj zmienną cztery razy. Powinny być teraz cztery puste wiersze zmiennych.
  • W pierwszym wierszu wpisz buttonText jako nazwę zmiennej i wpisz Grey Button w kolumnie wartości domyślnej.
  • W drugim wierszu wpisz r dla nazwy zmiennej i wpisz 128 w kolumnie wartości domyślnej.
  • W trzecim wierszu wpisz g dla nazwy zmiennej i wpisz 128 w kolumnie wartości domyślnej.
  • W czwartym wierszu wpisz b dla nazwy zmiennej i wpisz 128 w kolumnie wartości domyślnej.
  1. Kliknij pozycję Zapisz i zanotuj wartość identyfikatora projektu wyświetlaną w sekcji integracji zestawu SDK . W następnej sekcji zaktualizujesz kod swojej aplikacji i odwołasz się do tej wartości w kodzie.

Kodowanie eksperymentu w aplikacji

  1. W programie Visual Studio utwórz nowy projekt platformy uniwersalnej systemu Windows przy użyciu języka Visual C#. Nadaj projektowi nazwę SampleExperiment.

  2. W Eksploratorze rozwiązań rozwiń węzeł projektu, kliknij prawym przyciskiem myszy Odwołania, a następnie kliknij pozycję Dodaj odwołanie.

  3. W Menedżerze odniesień rozwiń Uniwersalny Windows i kliknij Rozszerzenia.

  4. Na liście zestawów SDK zaznacz pole wyboru obok Microsoft Engagement Framework i kliknij OK.

  5. W Eksploratorze rozwiązańkliknij dwukrotnie plik MainPage.xaml, aby otworzyć projektanta głównej strony aplikacji.

  6. Przeciągnij przycisk z przybornika na stronę.

  7. Kliknij dwukrotnie przycisk w projektancie, aby otworzyć plik kodu i dodać program obsługi zdarzeń dla zdarzenia Kliknij.

  8. Zastąp całą zawartość pliku kodu następującym kodem. Przypisz zmienną projectId do wartości identyfikatora projektu uzyskanej z Centrum partnerskiego w poprzedniej sekcji.

    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. Zapisz plik kodu i skompiluj projekt.

Tworzenie eksperymentu w Centrum partnerskim

  1. Wróć do strony projektu Eksperymenty z kliknięciami przycisku w Centrum partnerskim.
  2. W sekcji Eksperymenty kliknij przycisk Nowy eksperyment .
  3. W sekcji szczegóły eksperymentu wpisz nazwę Optymalizacja Kliknięć Przycisku w polu Nazwa eksperymentu .
  4. W sekcji Wyświetl zdarzenie wpisz userViewedButton w polu Nazwa zdarzenia wyświetlania. Pamiętaj, że ta nazwa jest zgodna z ciągiem zdarzeń widoku, który został zarejestrowany w kodzie dodanym w poprzedniej sekcji.
  5. W sekcji Cele i zdarzenia konwersji wprowadź następujące wartości:
  • W polu Nazwa celu wpisz Zwiększ Liczbę Kliknięć Przycisku.
  • W polu nazwa zdarzenia konwersji wpisz nazwę userClickedButton. Pamiętaj, że ta nazwa jest zgodna z ciągiem zdarzeń konwersji, który został zarejestrowany w kodzie dodanym w poprzedniej sekcji.
  • W polu celu wybierz pozycję Maksymalizuj.
  1. W sekcji Zmienne zdalne i odmiany upewnij się, że pole wyboru Dystrybuuj równomiernie jest zaznaczone, aby odmiany zostały równomiernie dystrybuowane do aplikacji.
  2. Dodaj zmienne do eksperymentu:
    1. Kliknij kontrolkę listy rozwijanej, wybierz przyciskTekst, a następnie kliknij pozycję Dodaj zmienną. Ciąg Grey Button powinien automatycznie pojawić się w kolumnie Variation A (ta wartość pochodzi z ustawień projektu). W kolumnie Odmiana B wpisz Niebieski przycisk.
    2. Kliknij ponownie kontrolkę listy rozwijanej, wybierz pozycję r, a następnie kliknij pozycję Dodaj zmienną. Ciąg 128 powinien być automatycznie wyświetlany w kolumnie Odmiana A . W kolumnie odmiany B wpisz 1.
    3. Kliknij ponownie kontrolkę listy rozwijanej, wybierz pozycję g, a następnie kliknij pozycję Dodaj zmienną. Ciąg 128 powinien być automatycznie wyświetlany w kolumnie Odmiana A . W kolumnie odmiany B wpisz 1.
    4. Kliknij ponownie kontrolkę listy rozwijanej, wybierz pozycję b, a następnie kliknij pozycję Dodaj zmienną. Ciąg 128 powinien być automatycznie wyświetlany w kolumnie Odmiana A . W kolumnie Odmiana B wpisz wartość 255.
  3. Kliknij przycisk Zapisz , a następnie kliknij pozycję Aktywuj.

Ważne

Po aktywowaniu eksperymentu nie można już modyfikować parametrów eksperymentu, chyba że klikniesz pole wyboru Edytowalny eksperyment podczas tworzenia eksperymentu. Zazwyczaj zalecamy kodowanie eksperymentu w aplikacji przed aktywacją eksperymentu.

Uruchamianie aplikacji w celu zbierania danych eksperymentu

  1. Uruchom utworzoną wcześniej aplikację SampleExperiment .
  2. Upewnij się, że widzisz szary lub niebieski przycisk. Kliknij przycisk, a następnie zamknij aplikację.
  3. Powtórz powyższe kroki kilka razy na tym samym komputerze, aby potwierdzić, że aplikacja ma ten sam kolor przycisku.

Przejrzyj wyniki i ukończ eksperyment

Poczekaj co najmniej kilka godzin po ukończeniu poprzedniej sekcji, a następnie wykonaj następujące kroki, aby przejrzeć wyniki eksperymentu i ukończyć eksperyment.

Uwaga / Notatka

Po aktywowaniu eksperymentu Centrum partnerskie natychmiast rozpoczyna zbieranie danych z dowolnych aplikacji, które są instrumentowane w celu rejestrowania danych eksperymentu. Jednak wyświetlenie danych eksperymentu w Centrum partnerskim może potrwać kilka godzin.

  1. W Centrum partnerskim wróć do strony Experimentation (Eksperymentowanie) dla aplikacji.

  2. W sekcji Aktywne eksperymenty kliknij przycisk Optymalizuj kliknięcia, aby przejść do strony dla tego eksperymentu.

  3. Upewnij się, że wyniki wyświetlane w sekcjach Podsumowanie wyników i Szczegóły wyników są zgodne z oczekiwaniami. Aby uzyskać więcej informacji na temat tych sekcji, zobacz Zarządzanie eksperymentem w Centrum partnerskim.

    Uwaga / Notatka

    Centrum partnerskie zgłasza tylko pierwsze zdarzenie konwersji dla każdego użytkownika w okresie 24-godzinnym. Jeśli użytkownik wyzwoli wiele zdarzeń konwersji w aplikacji w ciągu 24-godzinnego okresu, zgłoszone zostaje tylko pierwsze zdarzenie konwersji. Ma to na celu zapobieżenie sytuacji, w której jeden użytkownik z wieloma zdarzeniami konwersji zaburza wyniki eksperymentu dla wybranej grupy użytkowników.

  4. Teraz możesz przystąpić do zakończenia eksperymentu. W sekcji podsumowanie wyników w kolumnie odmiany B kliknij Przełącz. Spowoduje to przełączenie wszystkich użytkowników aplikacji na niebieski przycisk.

  5. Kliknij przycisk OK, aby potwierdzić, że chcesz zakończyć eksperyment.

  6. Uruchom aplikację SampleExperiment utworzoną w poprzedniej sekcji.

  7. Upewnij się, że widzisz niebieski przycisk. Pamiętaj, że uzyskanie zaktualizowanego przypisania odmiany może potrwać do dwóch minut.

  • Last updated on