다음을 통해 공유

Apple App Store에서 구매할 수 있는 PlayFab 구독 설정

  • 아티클

참고 항목

IOS 구독 상환은 현재 비공개 미리 보기로 제공됩니다. 이 기능에 액세스하려면 PlayFab 타이틀 ID와 함께 PlayFab 모바일 구독이라는 제목의 전자 메일을 PFEconomyPreviews@microsoft.com(으)로 보내면 사용자 환경에서 이 기능을 사용하도록 설정하겠습니다.

이 자습서에서는 PlayFab 구독을 성공적으로 만들고, 플레이어가 구매할 수 있도록 Apple App Store의 게임에 추가하고 여기에 포함된 항목을 상환하는 방법을 보여줍니다.

필수 조건

  1. PlayFab 게임 관리자에 있는 타이틀.
  2. 기존에 있던 PlayFab에서 선택한 타이틀과 Apple App Store 간의 통합.
  3. App Store Connect에 액세스합니다.
  4. App Store Connect에서 이미 만든 앱입니다.
  5. App Store Connect에서 앱 내에 만든 앱 내 구매. 앱 내 구매에는 가격 책정 및 지역화가 포함되어야 합니다.
  6. 해당 Transaction Observer가 이미 앱의 일부로 있는 결제 큐.

1단계: 테스트 사용자 만들기

실제 금액을 결제하지 않고 구매를 적절히 테스트하려면 먼저 앱에 테스트 사용자를 만듭니다.

  1. App Store Connect>사용자 및 액세스로 이동합니다.

  2. 샌드박스를 선택합니다.

    샌드박스 옵션

  3. 테스트 계정 옆에 있는 더하기 기호(+) 단추를 선택합니다.

  4. 양식을 채우고 만들기를 선택합니다.

    새 테스트 사용자 양식

2단계: 게임 관리자에서 구독 만들기

참고 항목

게임 관리자에서 구독을 만들기 전에 카탈로그에서 번들에 추가하려는 항목을 이미 만들고 게시했는지 확인합니다. 이 자습서에서는 Super Awesome Sword라는 PlayFab 카탈로그 항목을 이미 만들었다고 가정합니다. 아이템을 만드는 방법에 대한 지침이 필요한 경우 이 단계를 참조하세요.

  1. 게임 관리자에서 타이틀로 이동합니다.

  2. 왼쪽 탐색 메뉴에서 참여>경제를 선택합니다.

  3. 구독을 선택합니다.

    구독 탭

  4. 새 구독을 선택합니다.

  5. 항목 및 가격 등 원하는 정보를 구독에 추가합니다. 이 자습서에서는 Super Awesome Sword 구독을 이름으로 사용합니다.

  6. 플레이어가 즉시 상환할 수 있도록 하려면 페이지 끝까지 아래로 스크롤하고 저장 및 게시를 선택합니다. 나중에 게시하려면 "임시 저장"을 선택합니다.

    저장 옵션

구독에 아이템 추가

구독 자체는 플레이어에게 항목에 대한 액세스 권한을 부여하지 않습니다. 플레이어 인벤토리에서 플레이어가 액세스할 수 있는 항목을 인식할 수 있도록 항목을 연결해야 합니다.

구독에 아이템을 추가하려면 다음 단계를 따릅니다.

  1. 편집 모드에서 아이템 섹션으로 이동합니다.
  2. 추가를 선택합니다. 모든 카탈로그 아이템을 보여 주는 창이 나타납니다.
  3. 유형별로 필터링하거나 특정 아이템을 검색할 수 있습니다.
  4. Super Awesome Sword를 찾아 옆에 있는 추가를 선택합니다.
  5. 마지막으로 아래쪽에 있는 추가 단추를 선택합니다.

그러면 구독에 아이템이 추가됩니다.

번들에 아이템 추가

3단계: 마켓플레이스 매핑 사용

플레이어가 앱에서 구독을 구매하는 경우 게임 관리자에서 구독을 올바르게 구매하고 할당받도록 하려면 마켓플레이스 매핑을 구성해야 합니다. 이 작업은 게임 관리자에서 구독을 만드는 동안 또는 만든 후 편집 모드에서 구독으로 돌아가서 수행할 수 있습니다.

  1. 편집 모드에서 구독으로 이동합니다.
  2. 마켓플레이스 매핑 섹션까지 아래로 스크롤합니다.
  3. 마켓플레이스 드롭다운에서 원하는 마켓플레이스를 선택합니다. 이 자습서에서는 AppleAppStore입니다.
  4. 마켓플레이스 ID로 App Store Connect의 제품 ID와 동일한 ID를 사용해야 합니다. 이 자습서에서는 pf.commerce.ios.sas1을 사용했습니다.
  5. 완료하려면 해당 행의 오른쪽에 있는 +를 선택하고 변경 사항을 저장합니다.

마켓플레이스 매핑

4단계: 구매

팁

이 주제에 대한 자세한 내용은 앱 내 구매를 참조하세요.

앱 내 구매를 구성하는 방법에 대한 개요는 Apple 개발자 문서를 참조하세요.

이제 App Store Connect에서 IAP를 생성하고, 게임 관리자의 항목으로 구독을 구성하고, 구독의 마켓플레이스 매핑을 설정했습니다. 앱에서의 구독 구매로 넘어가겠습니다.

앱에서 IAP 아이템을 노출하고 구매할 수 있게 되면 1단계에서 만든 테스트 사용자를 사용하여 앱에서 IAP를 구매할 수 있습니다. 이 작업이 완료되면 Apple의 API는 구매의 유효성을 검사하고 플레이어에게 구독에 대한 액세스를 보장하기 위해 PlayFab의 상환 API와 함께 사용해야 하는 영수증을 반환해야 합니다.

5단계: 앱 내 구매 항목 상환

Apple의 API에서 영수증을 받으면 PlayFab의 RedeemAppleAppStoreInventoryItems API 호출을 사용하여 IAP를 성공적으로 상환해야 합니다. 이 경우 인증된 플레이어에게 Super Awesome Sword 구독 을 부여한 다음, Super Awesome Sword 카탈로그 항목에 대한 액세스 권한을 부여해야 합니다.

두 ID가 일치하는지 확인

상환 호출 전에 게임 관리자에서 마켓플레이스 매핑을 위해 사용한 대체 ID가 App Store Connect의 제품 ID와 일치하는지 확인해야 합니다.

다음 스크린샷은 게임 관리자의 번들 내에서 가져온 것입니다. 마켓플레이스 ID가 여기서 말하는 AlternateId이며, 기본적으로 번들을 식별하는 또 다른 방법입니다.

마켓플레이스 매핑

App Store Connect에서 내 앱으로 이동하여 원하는 앱을 선택한 다음 왼쪽 탐색 메뉴에서 기능>앱 내 구매로 이동하고 마지막으로 IAP를 선택하면 IAP 메타데이터에서 제품 ID가 표시됩니다.

App Store Connect 제품 ID

플레이어 인증

아이템을 상환하려면 RedeemAppleAppStoreInventoryItems를 사용합니다. 하지만 그 전에 아이템을 상환하려는 플레이어가 앱에서 제대로 인증되는지 확인해야 합니다. 이를 위해 LoginWithApple를 사용합니다.

LoginWithApple 호출이 성공하면 PlayFab의 API는 X-EntityToken 키와 함께 RedeemAppleAppStoreInventoryItems 헤더의 일부로 사용해야 하는 EntityToken을 반환합니다. API 플랫폼을 사용하여 테스트하는 경우 다음과 같습니다.

API 플랫폼 헤더 키

상환 호출

플레이어가 인증되고, 두 ID가 일치하는지 확인되며, 플레이어의 앱 구매 영수증도 확인되면 상환을 호출할 준비가 되었습니다. 이를 위해 RedeemAppleAppStoreInventoryItems API 호출을 사용합니다.

{
    "Receipt": "{Your receipt}"
}

상환 호출에는 단일 값만 있으며, 이는 IAP를 성공적으로 구매한 후 Apple에서 반환한 영수증입니다.

성공적인 응답에는 타임스탬프 및 MarketplaceTransactionId와 같은 데이터와 함께 제공되는 200 status code가 있습니다.

성공적인 상환 호출이 실행된 후에는 인증된 플레이어의 인벤토리에서 Super Awesome Sword를 볼 수 있습니다.

참고 항목