Microsoft Store Services SDK를 사용하여 고객과 소통Engage customers with the Microsoft Store Services SDK

Microsoft Store Services SDK는 앱에 대상 알림을 보내고 앱에서 A/B 실험을 실행 하는 것과 같이 UWP (유니버설 Windows 플랫폼) 앱의 고객과 관련 된 기능을 제공 합니다.The Microsoft Store Services SDK provides features that help you engage with customers in your Universal Windows Platform (UWP) apps, such as sending targeted notifications to your apps and running A/B experiments in your apps. 이 SDK는 visual studio 2015 이상 버전의 Visual Studio에 대 한 확장입니다.This SDK is an extension for Visual Studio 2015 and later versions of Visual Studio.

참고

UWP 앱에서 광고를 표시 하려면 Microsoft Store Services SDK 대신 MICROSOFT ADVERTISING sdk 를 사용 합니다.To display ads in your UWP apps, use the Microsoft Advertising SDK instead of the Microsoft Store Services SDK. 광고 라이브러리는 Microsoft Store Services SDK에서 Microsoft Advertising SDK로 이동 되었습니다.The advertising libraries have been moved from the Microsoft Store Services SDK to the Microsoft Advertising SDK. 자세한 내용은 앱에서 광고 표시를 참조 하세요.For more information, see Display ads in your app.

Microsoft Store Services SDK에서 지 원하는 시나리오Scenarios supported by the Microsoft Store Services SDK

Microsoft Store Services SDK는 현재 UWP 앱에 대해 다음과 같은 시나리오를 지원 합니다.The Microsoft Store Services SDK currently supports the following scenarios for UWP apps. API 참조 설명서는 Microsoft Store SERVICES SDK API 참조를 참조 하세요.For API reference documentation, see Microsoft Store Services SDK API reference.

시나리오Scenario DescriptionDescription
A/B 테스트를 사용 하 여 UWP 앱에서 실험 실행Run experiments in your UWP app with A/B testing 모든 사용자에 게 기능을 출시 하기 전에 유니버설 Windows 플랫폼 (UWP) 앱에서 A/B 테스트를 실행 하 여 일부 고객의 기능 효과를 측정 합니다.Run A/B tests in your Universal Windows Platform (UWP) app to measure the effectiveness of features on some customers before you release the features to everyone. 파트너 센터에서 실험을 정의한 후에는 StoreServicesExperimentVariation 클래스를 사용 하 여 앱에서 실험의 변형을 가져오고,이 데이터를 사용 하 여 테스트 중인 기능의 동작을 수정한 다음, logforvariation 메서드를 사용 하 여 보기 이벤트 및 변환 이벤트를 파트너 센터에 보냅니다.After you define an experiment in Partner Center, use the StoreServicesExperimentVariation class to get variations for your experiment in your app, use this data to modify the behavior of the feature you are testing, and then use the LogForVariation method to send view event and conversion events to Partner Center. 마지막으로 파트너 센터를 사용 하 여 결과를 보고 실험을 관리 합니다.Finally, use Partner Center to view the results and manage the experiment.
UWP 앱에서 피드백 허브 시작Launch Feedback Hub from your UWP app UWP 앱에서 StoreServicesFeedbackLauncher 클래스를 사용 하 여 Windows 10 고객에 게 문제, 제안 및 upvotes를 제출할 수 있는 피드백 허브로 안내 합니다.Use the StoreServicesFeedbackLauncher class in your UWP app to direct your Windows 10 customers to Feedback Hub, where they can submit problems, suggestions, and upvotes. 그런 다음, 파트너 센터의 피드백 보고서에서 이 피드백을 관리합니다.Then, manage this feedback in the Feedback report in Partner Center.
파트너 센터 푸시 알림을 받도록 UWP 앱 구성Configure your UWP app to receive Partner Center push notifications UWP 앱에서 StoreServicesEngagementManager 클래스를 사용 하 여 파트너 센터를 통해 고객에 게 보내는 대상 푸시 알림을 받도록 앱을 등록 합니다.Use the StoreServicesEngagementManager class in your UWP app to register your app to receive targeted push notifications that you send to your customers using Partner Center.
파트너 센터의 사용량 보고서에 대해 UWP 앱에서 사용자 지정 이벤트 기록Log custom events in your UWP app for the Usage report in Partner Center UWP 앱에서 StoreServicesCustomEventLogger 클래스를 사용 하 여 파트너 센터에서 앱과 연결 된 사용자 지정 이벤트를 로깅합니다.Use the StoreServicesCustomEventLogger class in your UWP app to log custom events that are associated with your app in Partner Center. 그런 다음 파트너 센터의 사용량 보고서사용자 지정 이벤트 섹션에서 사용자 지정 이벤트에 대 한 총 발생 횟수를 검토 합니다.Then, review the total occurrences for your custom events in the Custom events section of the Usage report in Partner Center.

필수 구성 요소Prerequisites

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

  • Visual Studio 2015 이상 버전Visual Studio 2015 or a later version.
  • 사용 중인 Visual Studio 버전과 함께 설치 된 유니버설 Windows 앱에 대 한 Visual Studio Tools 합니다.Visual Studio Tools for Universal Windows Apps installed with your version of Visual Studio.

SDK 설치Install the SDK

개발 컴퓨터에 Microsoft Store Services SDK를 설치 하는 방법에는 다음 두 가지가 있습니다.There are two options for installing the Microsoft Store Services SDK on your development computer:

  • MSI 설치 관리자     여기에서 사용할 수 있는 MSI 설치 관리자를 통해 SDK를 설치할 수 있습니다.MSI installer  You can install the SDK via the MSI installer available here.
  • NuGet 패키지     SDK를 NuGet 패키지로 설치할 수 있습니다.NuGet package  You can install the SDK as a NuGet package.

Microsoft는 성능 향상 및 새로운 기능을 통해 새로운 버전의 Microsoft Store Services SDK를 정기적으로 릴리스 합니다.Microsoft periodically releases new versions of the Microsoft Store Services SDK with performance improvements and new features. SDK를 사용 하는 기존 프로젝트가 있고 최신 버전을 사용 하려는 경우 개발 컴퓨터에 최신 버전의 SDK를 다운로드 하 여 설치 합니다.If you have existing projects that use the SDK and you want to use the latest version, download and install the latest version of the SDK on your development computer.

MSI를 통해 설치Install via MSI

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

  1. Visual Studio의 모든 인스턴스를 닫습니다.Close all instances of Visual Studio.

  2. 이전에 Microsoft Store Engagement 및 수익 화 SDK, 유니버설 Ad 클라이언트 SDK 또는 Ad Mediator 확장을 설치한 경우 이제 이러한 Sdk를 제거 합니다.If you previously installed the Microsoft Store Engagement and Monetization SDK, Universal Ad Client SDK, or Ad Mediator extension, uninstall these SDKs now. 필요에 따라 명령 프롬프트 창을 열고 다음 명령을 실행 하 여 Visual Studio와 함께 설치 되었지만 컴퓨터의 설치 된 프로그램 목록에 표시 되지 않을 수 있는 이전 SDK 버전을 정리 합니다.Optionally, open a Command Prompt window and run these commands to clean out any older SDK versions that may have been installed with Visual Studio, but which may not appear in the list of installed programs on your computer:

    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를 다운로드 하 여 설치 합니다.Download and install the Microsoft Store Services SDK. 설치 하는 데 몇 분 정도 걸릴 수 있습니다.It may take a few minutes to install. 프로세스가 완료 될 때까지 대기 해야 합니다.Be sure and wait until the process has finished.

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

  5. Microsoft Store Services SDK, Microsoft Advertising SDK, 유니버설 Ad 클라이언트 SDK 또는 Microsoft Store Engagement 및 수익 화 SDK의 이전 버전에서 라이브러리를 참조 하는 기존 프로젝트가 있는 경우 Visual Studio에서 프로젝트를 열고 프로젝트를 정리 하 고 다시 빌드해야 합니다 ( 솔루션 탐색기에서 프로젝트 노드를 마우스 오른쪽 단추로 클릭 하 고 프로젝트 노드를 다시 마우스 오른쪽 단추로 클릭 한 다음 다시 빌드 를 선택).If you have an existing project that references libraries from any earlier version of the Microsoft Store Services SDK, Microsoft Advertising SDK, Universal Ad Client SDK, or Microsoft Store Engagement and Monetization SDK, we recommend that you open your project in Visual Studio and clean and rebuild your project (in Solution Explorer, right-click your project node and choose Clean, and then right-click your project node again and choose Rebuild).

그렇지 않으면 프로젝트에서 처음으로 SDK를 사용 하는 경우 프로젝트에 어셈블리 참조를 추가할준비가 된 것입니다.Otherwise, if you are using the SDK for the first time in your project, you are now ready to add the assembly reference to your project.

NuGet을 통해 설치Install via NuGet

NuGet을 통해 Microsoft Store Services SDK 라이브러리를 설치 하려면 다음을 수행 합니다.To install the Microsoft Store Services SDK libraries via NuGet:

  1. Visual Studio의 모든 인스턴스를 닫습니다.Close all instances of Visual Studio.

  2. 이전에 Microsoft Store Engagement 및 수익 화 SDK, 유니버설 Ad 클라이언트 SDK 또는 Ad Mediator 확장을 설치한 경우 이제 이러한 Sdk를 제거 합니다.If you previously installed the Microsoft Store Engagement and Monetization SDK, Universal Ad Client SDK, or Ad Mediator extension, uninstall these SDKs now. 필요에 따라 명령 프롬프트 창을 열고 다음 명령을 실행 하 여 Visual Studio와 함께 설치 되었지만 컴퓨터의 설치 된 프로그램 목록에 표시 되지 않을 수 있는 이전 SDK 버전을 정리 합니다.Optionally, open a Command Prompt window and run these commands to clean out any older SDK versions that may have been installed with Visual Studio, but which may not appear in the list of installed programs on your computer:

    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를 사용 하려는 프로젝트를 엽니다.Start Visual Studio and open the project in which you want to use the Microsoft Store Services SDK.

    참고

    프로젝트에 이미 SDK의 이전 MSI 설치에서 라이브러리 참조가 포함 된 경우 프로젝트에서 이러한 참조를 제거 합니다.If your project already includes library references from an earlier MSI installation of the SDK, remove these references from your project. 이러한 참조는 이전 단계에서 참조 하는 라이브러리가 제거 되었으므로 옆에 경고 아이콘이 있습니다.These references will have warning icons next to them because the libraries they reference were removed in the previous steps.

  4. Visual Studio에서 프로젝트NuGet 패키지 관리를 클릭 합니다.In Visual Studio, click Project and Manage NuGet Packages.

  5. 검색 상자에 microsoft 서비스를 입력 하 고 microsoft. \engagement 패키지를 설치 합니다.In the search box, type Microsoft.Services.Store.Engagement and install the Microsoft.Services.Store.Engagement package. 패키지 설치가 완료 되 면 솔루션을 저장 합니다.When the package is done installing, save your solution.

    참고

    출력 창에서 지정 된 경로가 너무 긴 것을 나타내는 설치 패키지 오류를 보고 하는 경우 기본 위치 보다 짧은 경로를 사용 하 여 대체 위치에 패키지를 추출 하도록 NuGet을 구성 해야 할 수 있습니다.If the Output window reports an Install-Package error that indicates the specified path is too long, you may need to configure NuGet to extract packages to an alternate location with a shorter path than the default location. 이렇게 하려면 repositoryPath 컴퓨터의 nuget.config 파일에 값을 추가 하 고 NuGet 패키지를 추출할 수 있는 짧은 폴더 경로에 할당 합니다.To do this, add the repositoryPath value to a nuget.config file on your computer and assign it to a short folder path where NuGet packages can be extracted. 자세한 내용은 NuGet 설명서에서 이 문서 를 참조 하세요.For more information, see this article in the NuGet documentation. 또는 더 짧은 경로를 사용 하 여 Visual Studio 프로젝트를 대체 폴더로 이동 하려고 할 수 있습니다.Alternatively, you can try moving your Visual Studio project to an alternate folder with a shorter path. 글로벌 패키지 경로가 너무 길어서 문제가 발생할 수도 있습니다.The problem could also be caused by your global packages path being too long. 이 경우 globalPackagesFolder nuget.config 파일에 값을 추가 합니다.In this case, add the globalPackagesFolder value into your nuget.config file.

  6. 프로젝트를 포함 하는 Visual Studio 솔루션을 닫은 다음 솔루션을 다시 엽니다.Close the Visual Studio solution that contains your project and then reopen the solution.

  7. 프로젝트에서 NuGet을 통해 설치 된 Microsoft Store Services SDK의 이전 버전에서 라이브러리를 이미 참조 하 고 프로젝트를 최신 버전의 SDK로 업데이트 한 경우 프로젝트를 정리 하 고 다시 빌드하는 것이 좋습니다. 솔루션 탐색기에서 프로젝트 노드를 마우스 오른쪽 단추로 클릭 하 고 정리를 선택한 다음 프로젝트 노드를 다시 마우스 오른쪽 단추로 클릭 하 고 다시 빌드를 선택 합니다.If your project already references libraries from an earlier version of the Microsoft Store Services SDK that was installed via NuGet and you have updated your project to a newer release of the SDK, we recommend that you clean and rebuild your project (in Solution Explorer, right-click your project node and choose Clean, and then right-click your project node again and choose Rebuild).

그렇지 않으면 프로젝트에서 처음으로 SDK를 사용 하는 경우 프로젝트에 어셈블리 참조를 추가할준비가 된 것입니다.Otherwise, if you are using the SDK for the first time in your project, you are now ready to add the assembly reference to your project.

프로젝트에 어셈블리 참조 추가Add the assembly reference to your project

MSI 설치 관리자 또는 NuGet을 통해 Microsoft Store Services SDK를 설치한 후에는 다음 지침에 따라 UWP 프로젝트에서 SDK 어셈블리를 참조 합니다.After you install the Microsoft Store Services SDK via the MSI installer or NuGet, follow these instructions to reference the SDK assembly in your UWP project.

  1. Visual Studio에서 프로젝트를 엽니다.Open your project in Visual Studio.

    참고

    프로젝트가 모든 CPU를 대상으로 하는 JavaScript 앱 인 경우 아키텍처 관련 빌드 출력 (예: x86)을 사용 하도록 프로젝트를 업데이트 합니다.If your project is a JavaScript app that targets Any CPU, update your project to use an architecture-specific build output (for example, x86).

  2. 솔루션 탐색기에서 참조 를 마우스 오른쪽 단추로 클릭 하 고 참조 추가 ...를 선택 합니다.In Solution Explorer, right click References and select Add Reference…

  3. 참조 관리자에서 유니버설 Windows를 확장 하 고 확장을 클릭 한 다음 Microsoft Engagement 프레임 워크옆의 확인란을 선택 합니다.In Reference Manager, expand Universal Windows, click Extensions, and then select the check box next to Microsoft Engagement Framework. 이를 통해 Microsoft 서비스 의 api를 사용할 수 있습니다.This enables you to use the APIs in the Microsoft.Services.Store.Engagement namespace.

  4. 확인을 클릭합니다.Click OK.

참고

NuGet을 통해 SDK 라이브러리를 설치한 경우 프로젝트에는 Microsoft. Store.If you installed the SDK libraries via NuGet, your project will contain a Microsoft.Services.Store.Engagement reference. Microsoft. Store Engagement 참조는 NuGet 패키지를 나타내며,이 패키지의 라이브러리는 무시 해도 됩니다.The Microsoft.Services.Store.Engagement reference represents the NuGet package (rather than the libraries in it), and you can ignore it.

SDK의 프레임 워크 패키지 이해Understanding framework packages in the SDK

Microsoft Store Services SDK의 Microsoft.Services.Store.Engagement.dll 라이브러리는 프레임 워크 패키지로구성 됩니다.The Microsoft.Services.Store.Engagement.dll library in the Microsoft Store Services SDK is configured as a framework package. 이 라이브러리는 Microsoft 의 api를 포함 합니다.This library contains the APIs in the Microsoft.Services.Store.Engagement namespace.

이 라이브러리는 프레임 워크 패키지 이므로 사용자가이 라이브러리를 사용 하는 앱 버전을 설치한 후 수정 및 성능 향상으로 라이브러리의 새 버전을 게시할 때마다 Windows 업데이트를 통해 장치에서이 라이브러리가 자동으로 업데이트 됩니다.Because this library is a framework package, this means that after a user installs a version of your app that uses this library, this library is automatically updated on their device through Windows Update whenever we publish a new version of the library with fixes and performance improvements. 이렇게 하면 고객이 항상 사용 가능한 최신 버전의 라이브러리를 장치에 설치 하도록 할 수 있습니다.This helps to ensure that your customers always have the latest available version of the library installed on their devices.

이 라이브러리에서 새 Api 또는 기능을 도입 하는 새 버전의 SDK를 출시 하는 경우 해당 기능을 사용 하려면 최신 버전의 SDK를 설치 해야 합니다.If we release a new version of the SDK that introduces new APIs or features in this library, you will need to install the latest version of the SDK to use those features. 이 시나리오에서는 업데이트 된 앱을 스토어에도 게시 해야 합니다.In this scenario, you would also need to publish your updated app to the Store.