> For the complete documentation index, see [llms.txt](/llms.txt)

# GS2-SerialKey 마스터 데이터 레퍼런스

마스터 데이터 포맷과 임포트할 각종 모델의 레퍼런스




## 마스터 데이터 포맷


**JSON**
```json
{
  "version": "2022-09-13",
  "campaignModels": [
    {
      "name": "[string]캠페인 모델 이름",
      "metadata": "[string?]메타데이터",
      "enableCampaignCode": "[bool]캠페인 코드에 의한 교환을 허용할지 여부"
    }
  ]
}
```


|  | 타입 | 활성화 조건 | 필수 | 기본값 | 값 제한 | 설명 |
| --- | --- | --- | --- | --- | --- | --- |
| version | string | | ✓ | 2022-09-13 | | 마스터 데이터 포맷 버전 |
| campaignModels | [List&lt;CampaignModel&gt;](#campaignmodel) |  |  |  |  ~ 1000 items | 캠페인 모델<br>캠페인 모델은 캠페인을 정의하고 시리얼 코드와 연결하여 관리하는 데 사용됩니다. |

## 모델

### CampaignModel

캠페인 모델<br>

캠페인 모델은 캠페인을 정의하고 시리얼 코드와 연결하여 관리하는 데 사용됩니다.

|  | 타입 | 활성화 조건 | 필수 | 기본값 | 값 제한 | 설명 |
| --- | --- | --- | --- | --- | --- | --- |
| campaignId | string |  | ※ |  |  ~ 1024자 | 캠페인 모델 GRN<br>※ 서버가 자동으로 설정 |
| name | string |  | ✓ |  |  ~ 128자 | 캠페인 모델 이름 |
| metadata | string |  |  |  |  ~ 2048자 | 메타데이터<br>메타데이터에는 임의의 값을 설정할 수 있습니다.<br>이 값들은 GS2의 동작에는 영향을 주지 않으므로, 게임 내에서 사용하는 정보를 저장하는 용도로 사용할 수 있습니다. |
| enableCampaignCode | bool |  |  | false |  | 캠페인 코드에 의한 교환을 허용할지 여부<br>활성화하면 개별 시리얼 코드가 아닌 공통 캠페인 코드(캠페인 이름)를 사용하여 보상을 교환할 수 있게 됩니다. 이를 통해 하나의 코드를 여러 사용자가 사용할 수 있습니다. |

---