> ## Documentation Index
> Fetch the complete documentation index at: https://devdocs.xbox.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Economy v2 스토어

> PlayFab Economy v2 스토어를 만들어 아이템 목록을 큐레이션하고, 카탈로그 가격을 재정의하고, 게임 내 프로모션, 할인 및 한정 시간 오퍼를 실행합니다.

<Info>
  Economy v2는 이제 정식으로 사용할 수 있습니다(GA). 지원 및 피드백은 [PlayFab Forum](https://community.playfab.com)을 방문하세요.
</Info>

스토어는 게임 내 Economy를 구축하고 개발하는 훌륭한 방법입니다. 스토어는 아이템 및 가격 목록을 보유하는 특수 아이템 유형이며 아이템의 기본 카탈로그 가격을 재정의할 수 있게 해줍니다. 스토어를 사용하여 게임에서 아이템을 구매할 수 있는 위치를 관리하고, 게임 내 할인 및 프로모션을 제공하는 등 다양한 작업을 수행할 수 있습니다!

## 스토어 만들기

스토어를 만들려면 먼저 게임에서 접근/구매 가능하도록 하려는 다른 게시된 Catalog Items, Currency 또는 UGC가 있는지 확인해야 합니다. [Economy v2 Quickstart](/services/playfab/economy-monetization/economy-v2/quickstart#step-3---publish-an-item-to-the-catalog)의 단계를 따를 수 있습니다.

### GameManager

1. **Economy** > **Catalog (V2)** 로 이동합니다.
2. **Stores** 탭에서 **New Store**를 선택합니다.

원하는 메타데이터를 채웁니다. 중요한 설정 중 하나는 이 스토어에서 사용할 수 있게 하려는 아이템과 어떤 가격으로 재정의할지입니다.

### API

`CreateDraftItem`을 사용하여 스토어를 만들 수 있습니다.

스토어를 만드는 `CreateDraftItem` 요청 예:

```json theme={null}
{
  "Item": {
   "Type": "store",
    "Title": {
      "NEUTRAL": "My First Store",
    },
    "StartDate": "2022-09-07T00:00:00.00000000Z",
    "ItemReferences":[
      {
        "Id":"LaserSword",
        "Amount": 1,
        "PriceOptions": {
          "Prices": [{
            "Amounts": [{
              "ItemId": "Diamond",
              "Amount": 1
            }]
          }]
        }
      },
      {
      "Id":"WeaponBundle",
      "PriceOptions": {
        "Prices": [{
          "Amounts": [{
            "ItemId": "Gold",
            "Amount": 10
            },
            {
            "ItemId": "Silver",
            "Amount": 10
          }]
        }],
      },
    }]
   },
   "Publish": true
}
```

***

위는 `LaserSword`와 `WeaponBundle`이라는 두 개의 아이템을 판매하는 스토어입니다. 두 아이템 모두 카탈로그에 정의된 기존 기본 가격이 있는 기존 카탈로그 아이템입니다. 이 스토어는 기존 가격을 재정의하며 이제 `LaserSword`는 1 `Diamond`에, `WeaponBundle`은 10 Gold와 10 Silver에 제공합니다.

이 요청은 스토어가 만들어지고 게시되었다는 응답을 반환합니다.

```json theme={null}
{
  "code": 202,
  "status": "Accepted",
  "Item": {
    "Type": "store",
    "Id": "{{StoreID}}", 
    "Title": {
      "NEUTRAL": "My First Store",
    },
    ...
}
```

이제 게시된 스토어와 연결된 `Id`를 확인하세요.

<Note>
  개념을 간소화하는 데 도움이 되도록 스토어 사용의 예를 더 잘 설명하기 위해 Item ID가 GUID에서 Item 이름으로 바뀌었습니다.
</Note>

## 스토어 사용

스토어는 플레이어가 `PurchaseInventoryItems` API를 호출할 때 사용됩니다. `PurchaseInventoryItems`를 호출할 때 선택적 속성 중 하나는 `StoreId` 매개 변수이며, 이 매개 변수를 통해 이 구매 요청에 적용할 스토어를 전달할 수 있습니다.

스토어를 사용하는 `PurchaseInventoryItems` 요청 예:

```json theme={null}
{
    "Entity": {
        "Type": "title_player_account",
        "Id": "{{PlayerID}}"
    },
    "Item": {
        "Id": "LaserSword",
    },
    "Amount": 10,
    "PriceAmounts": [
        {
            "ItemId": "Diamond",
            "Amount": 1
        }
    ],
    "StoreId": "{{StoreID}}"
}
```

구매 요청에 전달된 `{{StoreId}}`와 예상된 `PriceAmount`가 이제 스토어에 설정된 1 Diamond 비용과 일치하는 방식에 유의하세요.

## 스토어 검색

`SearchItems` API를 사용할 때 전달할 수 있는 속성 중 하나는 `Store` 매개 변수입니다. 이 매개 변수를 사용하면 스토어의 컨텍스트 내에서 검색할 수 있습니다. 특정 스토어에 아이템이 존재하는지 확인할 수 있을 뿐만 아니라 스토어 아이템/콘텐츠의 재정의된 가격을 표시하는 데도 사용할 수 있습니다. 스토어의 `AlternateId`를 사용하여 검색할 수도 있습니다.

```json theme={null}
{
  "Search": "",
  "Filter": "ContentType eq 'weapons'",
  "Store": {
    "Id": "{{StoreID}}"
  },
}
```


## Related topics

- [Economy v2의 고정 콘텐츠 컨테이너](/ko/services/playfab/economy-monetization/economy-v2/tutorials/containers-with-fixed-contents.md)
- [제작 게임 3부 - 코딩](/ko/services/playfab/economy-monetization/economy-v2/tutorials/craftingGame/crafting-game-coding.md)
- [스토어(Economy 레거시) 빠른 시작](/ko/services/playfab/economy-monetization/economy/stores/quickstart.md)
- [Economy(레거시)에서의 스토어 및 세일](/ko/services/playfab/economy-monetization/economy/tutorials/stores-and-sales.md)
- [Economy(레거시)에서의 스토어 세분화 모범 사례](/ko/services/playfab/economy-monetization/economy/tutorials/best-practices-for-store-segmentation.md)