GDK 상거래 시스템
GDK 내에서 사용할 수 있는 상거래 관련 기능 및 서비스를 통해 여러 수익 창출 모델과 이러한 상거래 옵션에 대한 백엔드 서비스의 심층 통합 기능을 사용할 수 있습니다. 이 문서는 GDK 문서의 상거래 섹션에서 보다 심층적으로 다루는 이러한 시스템 및 옵션에 대한 개요를 제공합니다.
클라이언트 측 기능
GDK를 사용하면 게임에서 소모성 제품, 내구성 제품(다운로드 가능한 콘텐츠), 구독, 번들 및 평가판과 같은 다양한 유형의 게임 내 추가 기능 및 제품 유형을 구현할 수 있습니다. XStore API 세트는 클라이언트 측에서 이러한 제품을 쿼리, 광고 및 관리하는 데 필요한 기능을 제공합니다. 완전히 작동하는 게임 내 스토어의 예는 GDK 게임 내 스토어 샘플을 참조하세요.
기본 섹션 아래의 다음 문서에서는 이러한 API 및 시나리오를 다룹니다.
기본 스토어 운영 - 판매 가능한 품목과 사용자가 소유한 품목을 쿼리합니다.
패키지 없이 내구성 제품를 사용하는 방법 - 별도의 다운로드 패키지가 없는 내구성 제품을 사용합니다.
다운로드 가능한 콘텐츠(DLC) 관리 및 라이선스 부여 - 다운로드 패키지와 함께 기존 내구성 제품을 사용합니다.
소모성 제품 기반 에코시스템 - 게임 내에서 소모성 제품 기반 수익 창출 모델을 설정하고 구성합니다.
게임에 대한 평가판 구현 - 게임에 내장된 평가판을 구현합니다.
번들 및 시즌 패스 - 번들 및 시즌 패스를 사용하여 제품으로 고객에게 가치와 참여를 제공합니다.
게임을 위한 제품 공유 모델 - Xbox 콘솔과 Windows PC 모두에서 GDK 게임에 대한 라이선스 모델과 사용자 간의 공유가 적용되는 방식입니다.
서버 측 기능
클라이언트 측 API를 지원하고 서비스 간 호출을 허용하는 Microsoft Store 서비스는 다음 서비스로 분할됩니다.
컬렉션 - 사용자가 소유하거나 사용 권한이 있는 제품에 대한 정보를 제공하고 소모성 제품을 처리합니다. 또한 승인된 파트너의 Game Pass 구독 상태를 감지하는 데 사용할 수 있습니다.
환불 - 파트너 서비스에서 이미 처리된 소모성 제품에 대해 사용자에게 지급된 환불을 감지하고 관리할 수 있습니다.
구매 - 파트너 서비스가 사용자 계정에 무료 항목을 추가할 수 있도록 합니다.
되풀이 - 사용자의 구독에 대한 자세한 정보를 제공하고 파트너 서비스가 사용자를 대신하여 해당 구독을 관리할 수 있도록 합니다.
Microsoft Store 서비스로 인증
Microsoft Store Services로 서비스를 인증하는 방법에 대한 자세한 내용은 서비스 간 인증을 위한 사용자 Store ID 요청을 참조하세요.
참고 항목
XSTS 토큰 인증에 익숙하다면 Collections 서비스에서 XSTS 토큰을 지원합니다. 그러나 다른 Microsoft Store Services는 그렇지 않습니다. 다른 서비스에서 제공되는 중요한 기능 때문에 이제 파트너가 서버 간 인증 흐름을 Microsoft Entra ID 및 UserStoreId 흐름으로 전환하는 것이 좋습니다.
인증 흐름을 간소화하고 Microsoft Store Services를 호출하려면 GitHub에서 Microsoft.StoreServices 프로젝트 및 샘플을 검토하세요. Microsoft.StoreServices 라이브러리는 인증 키 관리를 돕고 제품 관리를 위해 Microsoft Store 서비스를 호출하는 래퍼 API를 제공합니다. 샘플 프로젝트는 서비스에서 Microsoft.StoreServices 라이브러리를 사용하는 방법, 소모성 제품 관리를 위한 예제 논리, 환불된 구매 조정, 만료된 자격 증명 갱신 등을 강조합니다. PC에서 또는 Azure를 통해 샘플 서비스를 설정하기 위한 단계별 구성 가이드가 샘플에 포함되어 있습니다.
XDK를 사용한 개발자를 위한 주요 정보
XDK의 상거래 시스템에 익숙하다면 다음은 동등한 GDK 서비스의 명칭을 안내하는 데 도움이 될 것입니다.
인벤토리 서비스 - XDK의 인벤토리 서비스 기능(쿼리 소유권, 소모성 제품 처리 등)은 이제 컬렉션 서비스에서 처리됩니다. 여기에는 소유권 및 소모성 제품 수량을 검증하기 위한 모든 서버 간 시나리오가 포함됩니다. 인벤토리에 사용되는 XSTS 토큰은 컬렉션 호출에 사용할 수 있지만 Microsoft Store Services의 확장된 기능을 사용하려면 파트너가 Microsoft Entra ID 및 사용자 Store ID 토큰 인증 흐름으로 이동하는 것이 좋습니다.
예: https://collections.mp.microsoft.com/v8.0/collections/b2bLicensePreview인벤토리 클라이언트 API - 항목의 소유권 쿼리와 관련된 모든 클라이언트 측 기능은 이제 XStore API를 통해 처리됩니다.
예: XStoreQueryEntitledProductsAsync는 현재 사용자가 그 순간에 사용할 수 있는 항목을 반환합니다.카탈로그 찾아보기 API - 게임 내 구매를 위해 사용 가능한 제품 쿼리와 관련된 모든 클라이언트 측 기능은 이제 XSstore API를 통해 처리됩니다. 귀하의 타이틀 내에서 판매할 수 있는 제품을 쿼리하기 위한 서버 간 옵션은 없습니다.
예: XStoreQueryAssociatedProductsAsync는 게임 내 스토어의 일부로 판매할 수 있는 제품을 반환합니다.평가판 및 라이선스 - 평가판 라이선스와 관련된 모든 클라이언트 측 기능은 이제 XStore API의 일부입니다. 예: XStoreQueryGameLicenseAsync는 평가판 라이선스 정보를 포함하여 현재 게임의 라이선스 정보를 반환합니다. 자체 서비스에서 클라이언트 측 라이선스를 확인하는 기능은 라이선스 토큰을 사용하여 서비스 라이선스 확인을 참조하세요.