실험을 위해 앱 코딩

UWP(유니버설 Windows 플랫폼) 앱의 코드를 업데이트할 준비가 되었습니다. 파트너 센터에서 먼저 프로젝트를 만들고 원격 변수를 정의한 후 업데이트할 수 있습니다.

파트너 센터에서 원격 변수 값을 받습니다.
원격 변수를 사용하여 사용자에 대한 앱 환경을 구성합니다.
사용자가 실험을 보고 원하는 작업(변환이라고도 함)을 수행한 경우를 나타내는 이벤트를 파트너 센터에 기록합니다.

이 동작을 앱에 추가하려면 Microsoft Store Services SDK에서 제공하는 API를 사용합니다.

다음 섹션에서는 실험의 변형을 가져오고 파트너 센터에 이벤트를 로깅하는 일반적인 프로세스를 설명합니다. 앱을 실험용으로 코딩한 후에는 파트너 센터 에서 실험을 정의할 수 있습니다. A/B 테스트를 사용하여 첫 번째 실험을 만들고 실행하는 절차를 단계별로 보여 주는 안내서는을 참조하십시오.

비고

Microsoft Store Services SDK의 일부 실험 API는 비동기 패턴 사용하여 파트너 센터에서 데이터를 검색합니다. 즉, 이러한 메서드 실행의 일부는 메서드가 호출된 후에 발생할 수 있으므로 작업이 완료되는 동안 앱의 UI가 응답성을 유지할 수 있습니다. 비동기 패턴을 사용하려면 이 문서의 코드 예제에서 설명한 대로 앱에서 비동기 키워드를 사용하고 API를 호출할 때 연산자를 대기해야 합니다. 규칙에 따라 비동기 메서드는 이름이 비동기로 끝납니다.

프로젝트 구성

시작하려면 개발 컴퓨터에 Microsoft Store Services SDK를 설치하고 프로젝트에 필요한 참조를 추가합니다.

Microsoft Store Services SDK설치합니다.
Visual Studio에서 프로젝트를 엽니다.
솔루션 탐색기에서 프로젝트 노드를 확장하고 참조마우스 오른쪽 단추로 클릭한 다음 참조추가를 클릭합니다.
참조 관리자에서 유니버설 Windows를 확장하고 확장을 클릭합니다.
SDK 목록에서 Microsoft Engagement Framework 옆의 확인란을 선택하고 OK를 클릭합니다.

비고

이 문서의 코드 예제는 코드 파일이 문을 사용하여 System.Threading.Tasks 및 Microsoft.Services.Store.Engagement 네임스페이스를 포함한다고 가정합니다.

실험의 변이 데이터를 가져와 보기 이벤트를 기록하라.

프로젝트에서 실험에서 수정하려는 기능에 대한 코드를 찾습니다. 변형에 대한 데이터를 검색하는 코드를 추가하고, 이 데이터를 사용하여 테스트하는 기능의 동작을 수정한 다음, 실험에 대한 보기 이벤트를 파트너 센터의 A/B 테스트 서비스에 기록합니다.

필요한 특정 코드는 앱에 따라 달라지지만 다음 예제에서는 기본 프로세스를 보여 줍니다. 전체 코드 예제는 A/B 테스트사용하여 첫 번째 실험 만들기 및 실행을 참조하세요.

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");
}

다음 단계에서는 이 프로세스의 중요한 부분을 자세히 설명합니다.

현재 변형 할당을 나타내는 StoreServicesExperimentVariation 개체를 선언하고 보기 및 변환 이벤트를 파트너 센터로 기록하는 데 사용할 StoreServicesCustomEventLogger 개체를 선언합니다.
```
private StoreServicesExperimentVariation variation;
private StoreServicesCustomEventLogger logger;
```
검색하려는 실험에 대해 프로젝트 ID로 할당된 문자열 변수를 선언합니다.

비고

파트너 센터에서 프로젝트를 생성할 때 프로젝트 ID를 얻습니다. 아래에 표시된 프로젝트 ID는 예를 들어 용도로만 사용됩니다.
```
private string projectId = "F48AC670-4472-4387-AB7D-D65B095153FB";
```
정적 GetCachedVariationAsync 메서드를 호출하여 실험에 대해 현재 캐시된 변형 할당을 가져오고 실험의 프로젝트 ID를 메서드에 전달합니다. 이 메서드는 ExperimentVariation 속성을 통해 변형 할당에 대한 액세스를 제공하는 StoreServicesExperimentVariationResult 개체를 반환합니다.
```
var result = await StoreServicesExperimentVariation.GetCachedVariationAsync(projectId);
variation = result.ExperimentVariation;
```
IsStale 속성을 확인하여 캐시된 변형 할당을 서버의 원격 변형 할당으로 새로 고쳐야 하는지 여부를 확인합니다. 새로 고쳐야 하는 경우 정적 GetRefreshedVariationAsync 메서드를 호출하여 서버에서 업데이트된 변형 할당을 확인하고 로컬 캐시된 변형을 새로 고칩니다.
```
if (result.ErrorCode != StoreServicesEngagementErrorCode.None || result.ExperimentVariation.IsStale)
{
    result = await StoreServicesExperimentVariation.GetRefreshedVariationAsync(projectId);

    if (result.ErrorCode == StoreServicesEngagementErrorCode.None)
    {
        variation = result.ExperimentVariation;
    }
}
```
StoreServicesExperimentVariation 객체의 GetBoolean, GetDouble, GetInt32, 또는 GetString 메서드를 사용하여 실험 변형 할당 값을 가져옵니다. 각 메서드에서 첫 번째 매개 변수는 검색하려는 변형의 이름입니다(파트너 센터에 입력한 변형의 이름과 동일). 두 번째 매개 변수는 파트너 센터에서 지정된 값을 검색할 수 없는 경우(예: 네트워크 연결이 없는 경우) 메서드가 반환해야 하는 기본값이며, 캐시된 버전의 변형을 사용할 수 없습니다.

다음 예제에서는 GetString 사용하여 buttonText 변수를 가져와서 회색 단추기본 변수 값을 지정합니다.
```
var buttonText = variation.GetString("buttonText", "Grey Button");
```
코드에서 변수 값을 사용하여 테스트하는 기능의 동작을 수정합니다. 예를 들어 다음 코드는 buttonText 값을 앱의 단추 내용에 할당합니다. 이 예제에서는 프로젝트의 다른 곳에서 이 단추를 이미 정의한 것으로 가정합니다.
```
await button.Dispatcher.RunAsync(
    Windows.UI.Core.CoreDispatcherPriority.Normal,
    () =>
    {
        button.Content = buttonText;
    });
```
마지막으로 실험에 대한 보기 이벤트 파트너 센터의 A/B 테스트 서비스에 기록합니다. logger 필드를 StoreServicesCustomEventLogger 개체로 초기화하고 LogForVariation 메서드를 호출합니다. 현재 버전 할당을 나타내는 StoreServicesExperimentVariation 객체(이 객체는 이벤트에 대한 컨텍스트를 파트너 센터에 제공함)와 실험의 뷰 이벤트 이름을 전달합니다. 파트너 센터에서 실험에 대해 입력한 보기 이벤트 이름과 일치해야 합니다. 사용자가 실험의 일부인 변형을 보기 시작하면 코드에서 보기 이벤트를 기록해야 합니다.

다음 예제에서는 userViewedButton뷰 이벤트를 기록하는 방법을 보여줍니다. 이 예제에서 실험의 목표는 사용자가 앱에서 단추를 클릭하도록 하는 것이므로 앱이 변형 데이터(이 경우 단추 텍스트)를 검색하고 단추 내용에 할당한 후 보기 이벤트가 기록됩니다.
```
if (logger == null)
{
    logger = StoreServicesCustomEventLogger.GetDefault();
}

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

변환 이벤트를 파트너 센터에 기록합니다.

다음으로, 파트너 센터의 A/B 테스트 서비스에 변환 이벤트를 기록하는 코드를 추가합니다. 사용자가 실험의 목표에 도달하면 코드에서 변환 이벤트를 기록해야 합니다. 필요한 특정 코드는 앱에 따라 달라지지만 일반적인 단계는 다음과 같습니다. 전체 코드 예제는 A/B 테스트사용하여 첫 번째 실험 만들기 및 실행을 참조하세요.

사용자가 실험 목표 중 하나에 대한 목표에 도달할 때 실행되는 코드에서 LogForVariation 메서드를 다시 호출하고 StoreServicesExperimentVariation 개체 및 실험에 대한 변환 이벤트의 이름을 전달합니다. 파트너 센터에서 실험에 대해 입력한 변환 이벤트 이름 중 하나와 일치해야 합니다.

다음은 단추에 대한 Click 이벤트 처리기에서 userClickedButton 변환 이벤트를 기록하는 예제입니다. 이 예제에서 실험의 목표는 사용자가 단추를 클릭하도록 하는 것입니다.
```
private void button_Click(object sender, RoutedEventArgs e)
{
    if (logger == null)
    {
        logger = StoreServicesCustomEventLogger.GetDefault();
    }

    logger.LogForVariation(variation, "userClickedButton");
}
```

다음 단계

앱에서 실험을 코딩한 후에는 다음 단계를 수행할 준비가 됩니다.

파트너 센터에서 실험을 정의합니다. A/B 테스트에 대한 뷰 이벤트, 변환 이벤트 및 고유한 변형을 정의하는 실험을 만듭니다.
파트너 센터에서 실험을 실행하고 관리하세요.

파트너 센터 프로젝트 만들기 및 원격 변수 정의
파트너 센터에서 실험을 정의하세요.
파트너 센터에서 실험을 관리하세요
A/B 테스트 사용하여 첫 번째 실험 만들기 및 실행
A/B 테스트로 앱 실험 실행

피드백

이 페이지가 도움이 되었나요?

Last updated on 2025-06-10

다음을 통해 공유

실험을 위해 앱 코딩

프로젝트 구성

실험의 변이 데이터를 가져와 보기 이벤트를 기록하라.

변환 이벤트를 파트너 센터에 기록합니다.

다음 단계

관련 항목

피드백

추가 리소스