다음을 통해 공유

카탈로그(레거시 Economy)

  • 아티클

Important

Economy v1 API는 유지 관리 모드에 있으며 새로운 기능은 제공되지 않으며 버그 수정만 제공됩니다. v1 API는 당분간 유지될 것입니다. PlayFab Economy의 다음 버전에 대해 자세히 알아보려면 Economy v2 개요를 참조하세요!

이 자습서는 게임 관리자의 경제성 섹션에 있는 카탈로그 탭에 대해 설명합니다. 카탈로그는 플레이어가 구입할 수 있거나 귀하가 플레이어에게 줄 수 있는 아이템을 정의하는 데 사용됩니다.

카탈로그란?

많은 게임이 플레이어에게 쉴드, 레벨 잠금 해제 또는 파워업 같은 구입 아이템을 제안합니다. 이러한 아이템은 카탈로그에서 가상 통화 또는 진짜 돈 단위로 명시됩니다. 카탈로그는 게임의 가상 항목을 쉽게 관리할 수 있는 방법을 제공하며 게임에서 사용할 수 있는 항목을 보관할 수 있습니다.

플레이어가 카탈로그에서 항목을 구입하려면 먼저 항목을 만들어야 합니다.

PlayFab의 플레이어 항목 관리(서버) 및 플레이어 항목 관리(클라이언트) API는 다음을 포함하여 항목 구입을 위한 많은 전략을 지원합니다.

  • 간단한 진짜 돈 또는 가상 통화를 사용한 아이템 구입.
  • 다른 아이템 구매에 따라 촉발된 아이템이 부여됩니다.
  • 잠궈진(잠재적으로 구입 가능한 키로) 박스 및 잠금 해제된 박스입니다.
  • 무작위 결과 표.
  • 게임 내의 이벤트에 근거하여 부여되는 구입 불가능 아이템.

참고 항목

카탈로그에서 통화 타입 RM은 센트 USD 단위인 실제 금액을 위해 유보되어 있습니다. $1.99는 RM 199으로 표시됩니다.

필드 준거

이 섹션은 게임 관리자의 경제성 영역에 있는 카탈로그 섹션의 각 필드에 대해 설명합니다.

타이틀을 처음 만들 때에는 카탈로그가 없습니다. 새 카탈로그 버튼을 선택하여 카탈로그를 만들 때까지 카탈로그 섹션에 필드가 표시되지 않습니다.

카탈로그가 만들어지면 카탈로그 섹션에 다음 탭이 표시됩니다.

  • 아이템 - 가상 통화 또는 진짜 돈 단위의 가치를 갖는 구매하거나 받을 수 있는 것. 자세한 내용은 PlayFab 항목을 참조하세요.
  • 번들 - 부여하면 플레이어의 인벤토리에 표시되는 아이템 및 가상 통화의 모음.
  • 컨테이너 - 열 때까지 플레이어의 인벤토리에 아이템으로 그대로 남아 있는 아이템 및 가상 통화의 모음.
  • 드롭 표 - 플레이어에게 보상을 주기 위해 사용할 수 있는 아이템 및 가상 통화의 모음.
  • Store - Store는 카탈로그 아이템의 하위 집합입니다. 이러한 항목은 카탈로그에 책정된 가격과 다른 가격으로 제공될 수 있습니다. 자세한 내용은 PlayFab 스토리를 참조하세요.

새 카탈로그 필드

기본 카탈로그 탭에서 새 카탈로그를 선택하면 다음 페이지가 표시됩니다.

게임 관리자 - 경제성 - 카탈로그 - 새 카탈로그

새 카탈로그 페이지(위에 표시됨)에는 다음 필드가 포함되어 있습니다:

  • 카탈로그 버전필수 필드. 이는 카탈로그 탭에 표시되는 카탈로그의 이름입니다.
  • 기본 카탈로그 만들기 해당 카탈로그가 게임의 기본 카탈로그인지 여부를 나타냅니다.

새 카탈로그 아이템 필드

카탈로그를 선택하고 새 항목을 선택하면 다음 페이지가 표시됩니다.

게임 관리자 - 경제성 - 카탈로그 - 새 카탈로그 아이템

새 카탈로그 아이템 페이지(위에 표시됨)에는 다음 필드가 포함되어 있습니다:

  • 속성

    • 아이템 ID: 이 필수 필드는 카탈로그 내의 아이템에 대한 고유 식별자입니다. 아이템 ID는 카탈로그 내에서 고유해야 하지만 아이템 ID가 같은 아이템을 포함하는 카탈로그 버전이 여러 개 있을 수 있습니다.
    • 아이템 클래스: 이 옵션 필드는 카탈로그 아이템을 관리하는 데 사용할 수 있는 식별자입니다.
    • 태그: 이 옵션 필드에는 카탈로그 아이템을 조직하는 데 사용할 수 있는 태그가 포함되어 있습니다. 필드 명칭이 암시하듯이 태그는 쉼표로 구분된 텍스트 문자열입니다.
    • 아이템 이미지 URI: 이 옵션 필드를 사용하여 아이템 이미지에 URI를 제공할 수 있습니다.

  • 옵션

    • 누적 가능: 아이템을 누적 가능으로 표시하면 인벤토리에서 이 타입의 한 아이템만 허용하고 아이템 개수를 점증시킵니다.
    • 거래 가능: 거래 API 호출을 통해 아이템을 거래할 수 있는지의 여부를 표시합니다.
    • 문자 만들기 토큰: 아이템이 캐릭터 생성에 관여하는지 여부를 나타냅니다.

  • 가격

    • 통화: 아이템 가격을 위해 사용되는 통화를 지정합니다. 진짜 돈(RM)은 PlayFab에 내장되어 있기 때문에 항상 사용할 수 있습니다.

    • 금액: 통화를 선택하면 이 필드는 필수입니다. 이는 아이템의 가격에 대한 통화 단위를 나타냅니다.

  • 플레이어에게 표시

    • 표시 명칭: 이 옵션 필드는 카탈로그 아이템에 대해 표시되는 명칭입니다. 일반적 용도 하나는 게임내 Store에서 해당 아이템을 제공하려는 경우입니다. 표시 이름은 고유할 필요가 없습니다.

    • 설명: 이 옵션 필드는 카탈로그 아이템에 대한 설명입니다. 일반적 용도 하나는 게임내 Store에서 해당 아이템을 제공하려는 경우입니다.

  • 한정판

    • 한정판: 이 항목의 공급이 제한적인지의 여부를 나타냅니다.

  • 소모품 아이템이 내구적인지 또는 소모적인지를 나타냅니다.

  • 변환: 저장 시 항목을 번들 또는 컨테이너로 변환할 수 있습니다.

  • 맞춤 데이터 이 옵션 필드를 사용하여 아이템 특성을 키값 쌍(KVP)으로 입력할 수 있습니다. 각 특성을 위한 키만 요구됩니다. KVP는 텍스트 상자에 문자열로 입력될 수 있으며, 또는 키/값 쌍으로 편집을 선택하면 다음 필드에 입력할 수 있습니다:

    • 키: 필수 필드. 특성 값에 대한 지표.
    • 값: 이 옵션 필드는 특성의 값입니다. 설정하지 않은 경우 값은 null입니다.

새 카탈로그 번들 필드

카탈로그를 선택하고 번들 탭을 열어 새 번들을 선택하면 새 카탈로그 번들 페이지가 열립니다.

이 페이지에는 새 카탈로그 아이템 페이지의 모든 필드 플러스 이 필드가 포함됩니다:

  • 번들 콘텐츠:
    • 번들에 추가 카탈로그의 모든 아이템, 통화 및 드롭 표의 목록이 표시되며, 번들에 추가할 것을 선택할 수 있습니다.

새 카탈로그 컨테이너 필드

카탈로그를 선택하고 컨테이너 탭을 열어 새 컨테이너를 선택하면 새 카탈로그 컨테이너 페이지가 열립니다.

이 페이지에는 새 카탈로그 아이템 페이지의 모든 필드 플러스 이 필드가 포함됩니다:

  • 컨테이너 콘텐츠:
    • 컨테이너에 추가 카탈로그의 모든 아이템, 통화 및 드롭 표의 목록이 표시되며, 컨테이너에 추가할 것을 선택할 수 있습니다.

새 드롭 표 필드

카탈로그를 선택하고 드롭 테이블 탭을 열어 새 드롭 테이블을 선택하면 다음 페이지가 표시됩니다.

게임 관리자 - 경제 - 카탈로그 - 새 드롭 표

새 카탈로그 드롭 표 페이지에는 다음 필드가 포함되어 있습니다:

  • 드롭 표 ID:

    • 표 ID: 이 필수 필드는 카탈로그 내의 드롭 표에 대한 고유 식별자입니다. 표 ID 값은 카탈로그 내에서 고유해야 하지만 표 ID가 같은 드롭 표를 포함하는 카탈로그 버전이 여러 개 있을 수 있습니다.

  • 표 콘텐츠:

    • 드롭 표에 추가 카탈로그의 모든 아이템 및 드롭 표의 목록이 표시되며, 드롭 표에 추가할 것을 선택할 수 있습니다.

새 Store 필드

카탈로그를 선택하고 스토어 탭을 열어 새 스토어를 선택하면 다음 페이지가 표시됩니다.

게임 관리자 - 경제성 - 카탈로그 - 새 Store

새 Store 페이지에는 다음 필드가 포함되어 있습니다:

  • Store 명칭:
    • Store ID: 이 필수 필드는 카탈로그 내의 Store에 대한 고유 식별자입니다. Store ID 값은 카탈로그 내에서 고유해야 하지만 Store ID가 같은 Store를 포함하는 카탈로그 버전이 여러 개 있을 수 있습니다.
    • Store 명칭: 이 옵션 필드는 Store에 대해 표시되는 명칭입니다. 표시 이름은 고유할 필요가 없습니다.
    • 설명: 이 옵션 필드는 Store에 대한 설명입니다.
    • 맞춤 데이터 이 옵션 필드를 사용하여 Store 특성을 키값 쌍(KVP)으로 입력할 수 있습니다. 각 특성을 위한 키만 요구됩니다. KVP는 텍스트 상자에 JSON으로서 입력됩니다. 상자 위의 JSON 라벨을 선택하면 입력을 위한 형식이 제공됩니다.
  • Store 콘텐츠:
    • Store에 추가 카탈로그의 모든 아이템의 목록이 표시되며, Store에 추가할 것을 선택할 수 있습니다.
  • 세그먼트 재정의: 이러한 선택적 필드를 사용하면 스토어를 사용할 수 있는 플레이어 세그먼트를 설정할 수 있습니다.

참고 항목

게임에서 스토어를 만들고 사용하는 방법에 대한 자세한 설명은 스토어 빠른 시작을 참조하세요.

카탈로그 만들기 예

카탈로그를 만드는 방법:

  1. 게임 관리자를 열고 왼쪽 메뉴 바에서 경제성을 선택합니다.
  2. 카탈로그 탭을 선택합니다.
  3. 새 카탈로그 버튼을 선택합니다.
  4. 카탈로그 버전을 입력합니다(예: 내 카탈로그).
    • ID가 One인 아이템이 자동으로 추가됩니다.
  5. One을 선택하세요. (카탈로그 항목 편집 페이지에는 위에서 설명한 새 카탈로그 항목 페이지와 동일한 필드가 포함되어 있습니다).
    1. 다음과 같은 일부 속성을 편집하거나 추가하십시오:
      • 항목 ID(예: shield_level_5)
      • 표시 이름(예: Level 5 Shield).
      • 설명(예: projectile 공격에 대한 강력한 방어)
  6. 통화와 금액을 선택하여 가격을 설정, 예:
    1. 통화를 금으로 설정합니다. 자세한 내용은 통화를 참조하세요.
    2. 금액을 250으로 설정합니다.
  7. 아이템 저장을 선택합니다.
  8. 카탈로그의 항목 페이지로 돌아갑니다. 더 많은 아이템을 추가하려면 새 아이템을 선택하고 단계 5 – 7을 반복합니다.

카탈로그 업로드

JSON 파일을 업로드하여 게임 관리자에서 카탈로그를 만들려면 다음 단계를 수행하세요.

  1. 게임 관리자에서 게임을 선택합니다.
  2. 경제성을 선택합니다.
  3. 카탈로그를 선택합니다.
  4. JSON 업로드를 선택합니다.
  5. 귀하의 JSON 파일을 선택하고 파일 업로드를 선택합니다.

참고 항목

또한 관리자 API의 GetCatalogItems 및 SetCatalogItems를 사용하여 카탈로그를 JSON 파일로 저장하거나 업로드할 수 있습니다.