ms-windows-store URI 사용

이 토픽에서는 ms-windows-store: URI 체계를 설명합니다. 앱은 이 URI 체계를 사용하여 Windows 10 및 Windows 11에서 LaunchUriAsync 메서드를 사용하여 스토어의 특정 페이지에 Microsoft Store 앱을 실행할 수 있습니다.

예를 들어 다음 코드를 사용하여 게임 페이지로 스토어를 열 수 있습니다.

bool result = await Windows.System.Launcher.LaunchUriAsync(new Uri("ms-windows-store://navigatetopage/?Id=Gaming"));

특정 섹션으로 스토어 열기

다음 옵션을 사용하여 특정 페이지 또는 섹션으로 스토어 앱을 실행할 수 있습니다.

URI 체계	설명	참고
ms-windows-store://home	스토어의 홈페이지를 시작합니다.
ms-windows-store://navigatetopage/?Id=[vertical]	스토어의 최상위 수직 페이지를 시작합니다.	범주에는 Home, Gaming, Entertainment, Productivity 및 LOB가 포함되지만 사용 가능한 범주는 지역에 따라 다를 수 있습니다.
ms-windows-store://downloadsandupdates	다운로드 및 업데이트 페이지를 시작합니다.	스토어 앱에 대한 2021년 10월 업데이트부터 라이브러리 페이지가 시작됩니다.
ms-windows-store://settings	스토어의 설정 페이지를 시작합니다.

특정 제품 열기

앱의 제품 ID를 사용하여 특정 제품에 대한 PDP(제품 세부 정보 페이지)로 직접 스토어를 실행할 수 있습니다. Windows 10 및 Windows 11의 스토어 앱은 여전히 PFN(패키지 제품군 이름) 및 앱 ID를 지원하지만 더 이상 사용되지 않으며 향후 지원되지 않을 수 있습니다. 이러한 값은 각 앱에 대한 제품 관리 섹션의 앱 ID 페이지에 있는 파트너 센터에서 찾을 수 있습니다.

2021년 10월 스토어 앱 업데이트부터 PDP를 표시하는 데 사용할 수 있는 두 가지 모드가 있습니다. 기본적으로 스토어 앱은 제품 세부 정보 페이지로 열립니다. 앱에 대한 필수 세부 정보와 사용자를 위한 단일 실행 단추만 표시하는 더 작은 PDP 대화 상자를 표시하는 팝업 환경으로 스토어를 시작할 수도 있습니다. 팝업 환경의 경우 대화 상자가 위의 중앙에 있어야 하는 창의 위치를 선택적으로 지정할 수 있습니다.

URI 체계	설명	참고
ms-windows-store://pdp/?ProductId=9WZDNCRFHVJL	제품에 대한 전체 PDP(제품 세부 정보 페이지)를 실행합니다.	특정 제품에 연결하는 권장 방법입니다.
ms-windows-store://pdp/?PFN= Microsoft.Office.OneNote_8wekyb3d8bbwe	제품에 대한 전체 PDP(제품 세부 정보 페이지)를 실행합니다.	PFN(패키지 제품군 이름)을 사용하는 것은 더 이상 사용되지 않습니다.
ms-windows-store://pdp/?AppId=f022389f-f3a6-417e-ad23-704fbdf57117	제품에 대한 전체 PDP(제품 세부 정보 페이지)를 실행합니다.	앱 ID 사용은 더 이상 사용되지 않습니다.
ms-windows-store://pdp/?ProductId=9WZDNCRFHVJL&mode=mini	팝업 스토어 대화 상자 환경을 시작합니다.	팝업 환경은 제품 ID만 지원합니다.

제품에 대한 평가 및 검토 환경 시작

사용자가 앱을 검토할 수 있도록 하려면 해당 PDP에 연결하고 평가 및 검토 대화 상자로 직접 실행할 수 있습니다. Store ID는 스토어 앱을 특정 제품 세부 정보 페이지로 실행하는 데 권장되는 방법입니다.

URI 체계	설명	참고
ms-windows-store://review/?ProductId=9WZDNCRFHVJL	제품에 대한 리뷰 작성 환경을 시작합니다.	StoreId를 사용하는 것이 좋습니다.
ms-windows-store://review/?PFN= Microsoft.Office.OneNote_8wekyb3d8bbwe	제품에 대한 리뷰 작성 환경을 시작합니다.	제품군 이름을 사용하는 것은 더 이상 사용되지 않습니다.
ms-windows-store://review/?AppId=f022389f-f3a6-417e-ad23-704fbdf57117	제품에 대한 리뷰 작성 환경을 시작합니다.	productid 사용은 더 이상 사용되지 않습니다.

스토어 검색

스토어 콘텐츠 검색을 위해 지원되는 여러 방법을 사용하여 검색 결과에 스토어 앱을 직접 실행할 수 있습니다.

URI 체계	설명	참고
ms-windows-store://assoc/?Tags=Photos_Rich_Media_Edit, Camera_Capture_App	한 개 이상의 태그에 연결된 제품에 대한 검색을 시작합니다.	태그는 쉼표로 구분해야 합니다.
ms-windows-store://search/?query=OneNote	지정된 쿼리에 대한 검색을 시작합니다.	쿼리에 공백을 사용할 수 있습니다.
ms-windows-store://browse/?type=Apps&cat=Health+%26+fitness	한 범주 내에서 제품에 대한 검색을 시작합니다.
ms-windows-store://publisher/?name=Microsoft Corporation	지정된 게시자에서 제품에 대한 검색을 시작합니다.	이름에 공백을 사용할 수 있습니다.
ms-windows-store://assoc/?FileExt=pdf	파일 확장자에 연결된 제품에 대한 검색을 시작합니다.
ms-windows-store://assoc/?Protocol=ms-word	프로토콜에 연결된 제품에 대한 검색을 시작합니다.