---
url: https://developers.webzenk.kr/guide/storage.md
---
# 데이터 저장

유저별 **키-값 저장소**예요. 값은 JSON이면 무엇이든 돼요(객체·배열·숫자·문자열). 진행 상황, 설정, 인벤토리 등을 저장해요.

| 항목 | 기본 한도 |
|---|---|
| 키 이름 | 1~64자 `[A-Za-z0-9_.-]` |
| 유저당 키 개수 | 100개 |
| 값 하나 크기 | 64KB |
| 한 번에 여러 키 저장 | 20개 (전부 성공하거나 전부 실패) |

## version — 동시 저장 충돌 막기

같은 계정으로 두 기기에서 플레이하면, 한쪽이 저장한 내용을 다른 쪽이 덮어쓸 수 있어요. 그래서 저장할 때마다 **version**을 함께 보내요.

1. 새 키는 `version: 0`으로 써요.
2. 그다음부터는 **마지막으로 읽거나 쓴 version**을 보내요. 저장할 때마다 1씩 올라가요.
3. 다른 기기가 먼저 저장해서 version이 다르면 `409 VERSION_CONFLICT`가 와요. 다시 읽어서 합친 뒤 저장하세요.

SDK는 읽고 쓴 version을 기억하므로 보통은 신경 쓰지 않아도 되고, **update** 함수는 충돌이 나면 다시 읽어서 자동으로 재시도해요.

## 공개 데이터

`is_public`으로 저장한 키는 다른 유저가 읽을 수 있어요. 닉네임·프로필처럼 남에게 보여 줄 데이터에 써요.

::: warning 재화는 클라이언트 저장만 믿지 마세요
클라이언트가 저장하는 값은 조작될 수 있어요. 결제·광고 보상은 반드시 [결제 검증](./iap)·[보상형 광고](./ads) 흐름으로 지급하세요.
:::

**관련 문서** · [저장 API](/api/storage) · [Unity](/sdk/unity/features#저장) · [HTML5](/sdk/html5/features#저장)
