다음을 통해 공유

Microsoft Store Services SDK를 사용하여 고객과 소통

  • 아티클

Microsoft Store Services SDK는 앱에 대상 알림 보내기, 앱에서 A/B 실험 실행 등 UWP(유니버설 Windows 플랫폼) 앱에서 고객을 확보하는 데 도움이 되는 기능을 제공합니다. 이 SDK는 Visual Studio 2015 이상 버전용 확장입니다.

참고 항목

UWP 앱에서 광고를 표시하려면 Microsoft Store Services SDK 대신 Microsoft Advertising SDK를 사용합니다. Advertising 라이브러리가 Microsoft Store Services SDK에서 Microsoft Advertising SDK로 이동되었습니다. 자세한 내용은 앱에 광고 표시를 참조하세요.

Microsoft Store Services SDK가 지원하는 시나리오

Microsoft Store Services SDK는 현재 UWP 앱에 대해 다음과 같은 시나리오를 지원합니다. API에 대한 참조 설명서는 Microsoft Store Services SDK API 참조를 참조하세요.

시나리오 설명
A/B 테스트로 UWP 앱에서 실험 실행 모든 사용자에게 기능을 릴리스하기 전에 UWP(유니버설 Windows 플랫폼) 앱에서 A/B 테스트를 실행하여 일부 고객의 기능 효율성을 측정합니다. 파트너 센터에서 실험을 정의한 후 StoreServicesExperimentVariation 클래스를 사용하여 실험에 대한 변형을 가져오고, 이 데이터를 사용하여 테스트할 기능의 동작을 수정한 다음, LogForVariation 메서드를 사용하여 보기 이벤트 및 전환 이벤트를 개발자 센터로 보냅니다. 마지막으로, 파트너 센터를 사용하여 결과를 보고 실험을 관리합니다.
UWP 앱에서 피드백 허브 시작 UWP 앱의 StoreServicesFeedbackLauncher 클래스를 사용하여 문제, 제안 및 좋아요를 제출할 수 있는 피드백 허브로 Windows 10 및 Windows 11 고객을 안내합니다. 그런 다음, 파트너 센터의 피드백 보고서에서 이 피드백을 관리합니다.
파트너 센터 푸시 알림을 받도록 UWP 앱 구성 UWP 앱에서 StoreServicesEngagementManager 클래스를 사용하여 파트너 센터 대시보드를 통해 고객에게 보내는 대상 지정 푸시 알림을 받도록 앱을 등록합니다.
파트너 센터에서 사용 보고서에 대한 UWP 앱에 사용자 지정 이벤트 로깅 UWP 앱에서 StoreServicesCustomEventLogger 클래스를 사용하여 파트너 센터의 앱과 연결된 사용자 지정 이벤트를 로깅합니다. 그런 다음, 파트너 센터의 사용 보고서의 사용자 지정 이벤트 섹션에서 사용자 지정 이벤트에 대한 총 발생 횟수를 검토합니다.

필수 조건

Microsoft Store Services SDK에는 다음이 필요합니다.

  • Visual Studio 2015 이상 버전.
  • Visual Studio 버전과 함께 설치된 유니버설 Windows 앱용 Visual Studio 도구.

SDK 설치

개발용 컴퓨터에 두 가지 방법 중 하나로 Microsoft Store Services SDK를 설치할 수 있습니다.

  • MSI 설치 관리자여기에서 사용 가능한 MSI 설치 관리자를 통해 SDK를 설치할 수 있습니다.
  • NuGet 패키지 SDK를 NuGet 패키지로 설치할 수 있습니다.

Microsoft는 성능 향상 및 새로운 기능을 사용하여 새 버전의 Microsoft Store Services SDK를 주기적으로 릴리스합니다. SDK를 사용하는 기존 프로젝트가 있고 최신 버전을 사용하려는 경우 개발 컴퓨터에 최신 버전의 SDK를 다운로드하여 설치합니다.

MSI를 통해 설치

MSI 설치 관리자를 통해 Microsoft Store Services SDK를 설치하려면 다음을 수행합니다.

  1. Visual Studio의 모든 인스턴스를 닫습니다.

  2. 이전에 Microsoft Store Engagement, Monetization SDK, Universal Ad Client SDK, Ad Mediator 확장을 설치했다면, 지금 이러한 SDK를 제거합니다. 명령 프롬프트 창을 열고 다음 명령을 실행하여 Visual Studio와 함께 설치되었을 수 있으나 컴퓨터에 설치된 프로그램 목록에 나타나지 않을 수 있는 이전 SDK 버전을 모두 정리하는 방법도 있습니다.

    MsiExec.exe /x{5C87A4DB-31C7-465E-9356-71B485B69EC8}
MsiExec.exe /x{6AB13C21-C3EC-46E1-8009-6FD5EBEE515B}
MsiExec.exe /x{6AC81125-8485-463D-9352-3F35A2508C11}

  3. Microsoft Store Services SDK를 다운로드하여 설치합니다. 설치하는 데 몇 분 정도 걸릴 수 있습니다. 프로세스가 완료될 때까지 기다려야 합니다.

  4. Visual Studio를 다시 시작합니다.

  5. 이전 버전의 Microsoft Store Services SDK, Microsoft Advertising SDK, Universal Ad Client SDK 또는 Microsoft Store Engagement and Monetization SDK에 있는 라이브러리를 참조하는 기존 프로젝트가 있는 경우 Visual Studio에서 프로젝트를 열고 프로젝트를 정리한 후 다시 빌드합니다(솔루션 탐색기에서 프로젝트 노드를 마우스 오른쪽 단추로 클릭하고 정리를 선택한 다음, 프로젝트 노드를 다시 마우스 오른쪽 단추로 클릭하고 다시 빌드 선택).

기타 프로젝트에서 처음 SDK를 사용하는 경우에도, 이제 프로젝트에 어셈블리 참조를 추가할 수 있습니다.

NuGet을 통해 설치

NuGet을 통해 Microsoft Store Services SDK 라이브러리를 설치하려면

  1. Visual Studio의 모든 인스턴스를 닫습니다.

  2. 이전에 Microsoft Store Engagement, Monetization SDK, Universal Ad Client SDK, Ad Mediator 확장을 설치했다면, 지금 이러한 SDK를 제거합니다. 명령 프롬프트 창을 열고 다음 명령을 실행하여 Visual Studio와 함께 설치되었을 수 있으나 컴퓨터에 설치된 프로그램 목록에 나타나지 않을 수 있는 이전 SDK 버전을 모두 정리하는 방법도 있습니다.

    MsiExec.exe /x{5C87A4DB-31C7-465E-9356-71B485B69EC8}
MsiExec.exe /x{6AB13C21-C3EC-46E1-8009-6FD5EBEE515B}
MsiExec.exe /x{6AC81125-8485-463D-9352-3F35A2508C11}

  3. Visual Studio를 시작하고 Microsoft Store Services SDK를 사용하려는 프로젝트를 엽니다.

    참고 항목

    프로젝트에 이 SDK의 이전 MSI 설치에 포함된 라이브러리 참조가 이미 들어 있으면 프로젝트에서 이러한 참조를 제거합니다. 참조하는 라이브러리가 이전 단계에서 제거되었으므로 이러한 참조 옆에 경고 아이콘이 있습니다.

  4. Visual Studio에서 프로젝트 및 NuGet 패키지 관리를 클릭합니다.

  5. 검색 상자에 Microsoft.Services.Store.Engagement를 입력하고 Microsoft.Services.Store.Engagement 패키지를 설치합니다. 패키지 설치가 완료되면 솔루션을 저장합니다.

    참고 항목

    출력 창이 지정된 경로가 너무 길다는 것을 나타내는 Install-Package 오류를 보고하는 경우, 기본 위치보다 경로가 더 짧은 다른 위치로 패키지를 추출하도록 NuGet을 구성해야 할 수 있습니다. 이렇게 하려면 repositoryPath 값을 컴퓨터의 nuget.config 파일에 추가하고 NuGet 패키지를 추출할 수 있는 짧은 폴더 경로에 할당합니다. 자세한 내용은 NuGet 설명서에서 이 항목을 참조하세요. 또는 Visual Studio 프로젝트를 경로가 짧은 대체 폴더로 이동할 수 있습니다. 전역 패키지 경로가 너무 길어 문제가 발생할 수도 있습니다. 이 경우 nuget.config 파일에 globalPackagesFolder 값을 추가합니다.

  6. 프로젝트가 포함된 Visual Studio 솔루션을 닫고, 솔루션을 다시 엽니다.

  7. 프로젝트가 NuGet을 통해 설치된 이전 버전의 Microsoft Store Services SDK의 라이브러리를 이미 참조하고 프로젝트를 최신 버전의 SDK로 업데이트한 경우 프로젝트를 정리하고 다시 빌드하는 것이 좋습니다(솔루션 탐색기에서 프로젝트 노드를 마우스 오른쪽 단추로 클릭하고 정리를 선택한 다음, 프로젝트 노드를 다시 마우스 오른쪽 단추로 클릭하고 다시 빌드를 선택).

기타 프로젝트에서 처음 SDK를 사용하는 경우에도, 이제 프로젝트에 어셈블리 참조를 추가할 수 있습니다.

프로젝트에 어셈블리 참조 추가

MSI 설치 관리자 또는 NuGet을 통해 Microsoft Store Services SDK를 설치한 후에는 다음 지침에 따라 UWP 프로젝트에서 해당 SDK 어셈블리를 참조합니다.

  1. Visual Studio에서 새 프로젝트를 엽니다.

    참고 항목

    프로젝트의 대상이 모든 CPU인 JavaScript 앱인 경우 아키텍처별 빌드 출력(예: x86)을 사용하도록 프로젝트를 업데이트합니다.

  2. 솔루션 탐색기에서 참조를 마우스 오른쪽 단추로 클릭하고, 참조 추가...를 선택합니다.

  3. 참조 관리자에서 유니버설 Windows를 확장하고, 확장을 클릭한 후 Microsoft Engagement Framework 옆에 있는 확인란을 선택합니다. 그러면 Microsoft.Services.Store.Engagement 네임스페이스에 API를 사용할 수 있습니다.

  4. 확인을 클릭합니다.

참고 항목

NuGet을 통해 SDK 라이브러리를 설치한 경우 프로젝트에 Microsoft.Services.Store.Engagement 참조가 포함됩니다. Microsoft.Services.Store.Engagement 참조는 NuGet 패키지(포함된 라이브러리가 아님)를 나타내며 이는 무시해도 됩니다.

SDK의 프레임워크 패키지 이해

Microsoft Store Services SDK의 Microsoft.Services.Store.Engagement.dll 라이브러리는 프레임워크 패키지로 구성됩니다. 이 라이브러리에는 Microsoft.Services.Store.Engagement 네임스페이스의 API가 포함되어 있습니다.

이 라이브러리는 프레임워크 패키지입니다. 다시 말해서 사용자가 이 라이브러리를 사용하는 앱 버전을 설치하면 수정 및 성능 향상이 포함된 새 버전의 라이브러리가 게시될 때마다 Windows 업데이트를 통해 사용자 디바이스의 라이브러리가 자동으로 업데이트됩니다. 따라서 고객의 디바이스에 항상 사용 가능한 최신 버전의 라이브러리가 설치됩니다.

이 라이브러리에 새로운 API 또는 기능을 도입하는 새 버전의 SDK를 릴리스하는 경우 이러한 기능을 사용하려면 최신 버전의 SDK를 설치해야 합니다. 이 시나리오에서는 업데이트된 앱을 스토어에 게시해야 합니다.