Catalog 개요

이 개요에서는 Game Manager의 Economy 섹션에 있는 Catalog V2 탭을 설명합니다. PlayFab Economy V2의 Catalog 기능을 설명하고 다양한 Item Types의 모든 필드 속성을 살펴봅니다.

​

카탈로그란?

Catalog는 플레이어가 구매하거나 플레이어에게 부여할 수 있는 아이템을 정의하는 데 사용됩니다. 많은 게임에서는 방패, 레벨 잠금 해제 또는 파워업과 같이 플레이어가 구매할 수 있는 아이템을 제공합니다. 이러한 아이템은 카탈로그에 지정되며 종종 가상 화폐나 실물 화폐로 판매됩니다. PlayFab의 Catalog는 게임의 가상 아이템을 관리할 수 있는 쉬운 방법을 제공하며 게임에서 사용할 수 있는 모든 아이템을 보관할 수 있습니다.

​

아이템 필드 참조

이 섹션에서는 Game Manager의 Economy 영역에 있는 Catalog V2 섹션의 각 필드를 설명합니다. 타이틀을 처음 만들면 카탈로그가 비어 있습니다. 아이템을 만들기 전에는 Catalog 섹션에 아이템이 표시되지 않습니다. Catalog v2 섹션에는 다음 탭이 있습니다. 이러한 각각은 Catalog 내에서 사용할 수 있는 Item Type입니다.

​

Catalog V2 아이템 필드

Catalog V2의 Items 탭에서 NEW ITEM을 선택하면 다음 페이지가 표시됩니다. New Item 페이지에는 다음 필드가 포함되어 있습니다. 명시되지 않은 경우 이러한 필드는 선택 사항입니다.

• PROPERTIES
  • Creator Entity Type: 엔터티 생성자의 유형을 알려주는 시스템 생성 필드입니다.
  • Creator Entity ID: 엔터티 생성자의 고유 ID. Game Manager에서 이 ID는 타이틀 값으로 설정됩니다.
  • Friendly ID: 코드에서 더 쉬운 참조에 사용할 수 있는 필드입니다. Friendly ID는 모든 아이템에 대해 선택 사항이며 카탈로그 내에서 고유해야 합니다.
  • Title: 일반적으로 플레이어에게 표시되는 아이템의 일반 이름을 위한 필수 필드입니다. Title의 간단한 지역화는 locale 키를 사용하여 지원됩니다. 자세한 내용은 Economy V2 Localization을 참조하세요.
  • Default Stack ID: 아이템은 각각의 양을 가진 스택으로 인벤토리에 저장될 수 있으며 StackId로 구분됩니다. 정의되지 않은 경우 인벤토리 작업은 StackId로 default 를 사용합니다. 자세한 내용은 Economy Stacks를 참조하세요.
  • Keywords: Keywords는 기본 검색 필터링에 사용할 수 있습니다. JSON 형식의 지역화된 키워드 사전입니다. 예제는 Economy V2 Localization을 참조하세요.
  • Description: JSON 형식의 지역화된 아이템 설명 사전입니다.
  • Content Type: 이 드롭다운을 사용하여 아이템 Content Type을 선택할 수 있습니다. Content Types는 Catalog Settings(Title Settings > Economy)에 정의되어 있습니다.
  • Display Properties: 사용자 지정 아이템 속성에 사용할 수 있는 JSON blob입니다.
  • Display Version: Display Properties의 버전 관리에 사용할 수 있는 필드입니다.
  • Tags: 이 필드에는 검색을 위해 카탈로그 아이템을 정리하는 데 사용할 수 있는 태그가 포함됩니다. 태그는 쉼표로 구분된 텍스트 문자열로 입력할 수 있습니다. 이러한 문자열은 Catalog Settings(Title Settings > Economy)에서 미리 정의되어 있습니다.
  • Available Tags Catalog Config에 이미 정의된 아이템 태그를 선택하기 위한 편리한 드롭다운입니다.
  • OPTIONS
    • Hidden: 현재 이 섹션에 나열된 아이템에 대해 사용 가능한 옵션은 하나입니다. 이 옵션인 Hidden 은 아이템이 검색에 노출되지 않도록 합니다.
  • Start Date: 검색에서 아이템이 사용 가능해져야 하는 시점에 대한 필수 날짜 필드입니다.
  • End Date: 검색에서 아이템을 사용할 수 없게 만드는 시점을 지정하는 날짜 필드입니다.
• PRICES
  • Add New Price: 이 섹션을 사용하여 아이템에 대한 하나 이상의 구매 가격을 지정할 수 있습니다.
• FILES
  • Upload: 여기서 이 아이템과 연결될 수 있는 공용 카탈로그에 저장할 콘텐츠를 업로드할 수 있습니다.
• IMAGES
  • Upload: 여기서 게임 내 카탈로그의 아이템 표시를 위한 썸네일 및 스크린샷을 포함한 다양한 이미지를 업로드할 수 있습니다.
• PLATFORMS
  • Manage: 이 아이템이 대상으로 하는 플랫폼을 지정할 수 있습니다. 플랫폼 목록은 Catalog Settings(Title Settings > Economy)에 정의되어 있습니다.

​

아이템을 Draft 또는 Publish 상태로 저장

Economy V2 카탈로그는 Draft 아이템 상태를 지원합니다. Save as Draft 하면 아이템 메타데이터는 직접 호출을 통해 사용할 수 있지만 공용 검색에는 노출되지 않습니다. 아이템을 공개할 준비가 되면 Published 상태로 설정합니다. 자세한 내용은 Item Status 페이지에서 확인할 수 있습니다.

​

아이템 생성 예제

Item을 만들려면:

1. Game Manager를 열고 왼쪽 사이드 바에서 Economy를 선택합니다.
2. Catalogs V2 탭을 선택합니다.
3. NEW ITEM 버튼을 선택합니다.
   1. 필수 아이템 필드를 채웁니다.
      • Title (JSON 예: {“NEUTRAL”:“My New Amazing Item”}).
      • Start Date (오늘 날짜 선택).
4. SAVE AND PUBLISH 버튼을 선택하면 Items 페이지로 돌아갑니다.
5. 더 많은 아이템을 추가하려면 NEW ITEM을 선택하고 3-5단계를 반복합니다.

​

Catalog V2 통화 필드

Catalog V2를 선택하고 Currency 탭을 연 다음 NEW CURRENCY를 선택하면 New Currency 페이지가 열립니다. 통화(Currency)에는 Catalog V2 Item Fields와 동일한 모든 필드가 포함됩니다.

​

Catalog V2 UGC 필드

Catalog V2를 선택하고 UGC 탭을 연 다음 NEW ITEM을 선택하면 New User Generated Content 페이지가 열립니다. User Generated Content에는 Catalog V2 Item Fields와 동일한 모든 필드 및 다음 필드가 포함됩니다.

• MODERATION STATE
  • Moderation State: 아이템을 Approved, Awaiting Moderation 또는 Rejected로 표시하는 쉬운 방법입니다. Moderation State는 게시된 아이템에서만 수정할 수 있습니다.

​

Catalog V2 번들 필드

Catalog V2를 선택하고 Bundles 탭을 연 다음 NEW BUNDLE을 선택하면 New Bundle 페이지가 열립니다. 이 페이지에는 Catalog V2 Item Fields의 모든 필드 및 다음 필드가 포함됩니다.

• ITEMS
  • Add: 번들을 사용하면 여러 아이템을 단일 아이템으로 함께 그룹화할 수 있습니다. 자주 함께 구매되는 아이템이나 한정 시간에만 사용할 수 있는 아이템 번들을 만들 수 있습니다. 자세한 내용은 Economy V2 Bundles 문서를 참조하세요.
• MARKETPLACE MAPPING
  • Marketplace, Marketplace ID: 게임 내 아이템을 하나 이상의 마켓플레이스 아이템에 연결하여 리뎀션 시나리오를 지원할 수 있습니다. 자세한 내용은 Economy V2 In-App Purchases 문서를 참조하세요.

​

Catalog V2 스토어 필드

Catalog V2를 선택하고 Stores 탭을 연 다음 NEW STORE를 선택하면 New Store 페이지가 열립니다. Stores에는 Catalog V2 Item Fields의 동일한 모든 필드 및 다음 필드가 포함됩니다.

• ITEMS
  • Add: 스토어는 카탈로그의 다른 모든 아이템 유형을 포함할 수 있습니다. 모든 카탈로그 콘텐츠는 기본 가격을 유지하거나 여기 나열된 가격으로 이 스토어에서 구매할 수 있습니다. 자세한 내용은 Economy V2 Stores 문서를 참조하세요.

새 Catalog가 플레이어에게 몰입감 있고 보람 있는 경험을 만들기 위한 강력하고 유연한 도구가 되기를 바랍니다. 자세히 알아보려면 Economy V2 Quickstart를 자세히 살펴보세요.

​

참고 항목

• PlayFab Economy V2 Items
• PlayFab Economy V2 Currencies
• PlayFab Economy V2 UGC
• PlayFab Economy V2 Bundles
• PlayFab Economy V2 Stores
• PlayFab Economy V2 Subscriptions