--- title: 월드 데이터 매니지먼트 slug: world-sdk-guide-kr/v45zL5tOSsPxFQ1XakPSE docTags: createdAt: 2024-09-02T08:34:13.134Z --- 사용자 데이터는 월드 데이터 관리 기능을 통해 보고 변경할 수 있습니다. :::hint{type="danger"} **❗️ 주의** 월드 개발자는 기능을 사용하기 위해 자신의 API를 추가해야 합니다. API 추가 방법에 대한 다음 가이드를 참조하십시오. \[[Multiplay World DataStorage](docId:53flqHzsZjxfKksXv5h8x)] ::: ## 데이터 관리 각 월드 콘솔의 '데이터 관리' 메뉴에서 월드의 DB에 접근하고 편집할 수 있습니다. 데이터 관리에는 총 4개의 항목이 있습니다. 모든 항목은 해당 월드를 사용하는 사용자 ID를 기반으로 사용자 특정 정보를 검색합니다. - 데이터 관리: \[[World DataStorage](docId:53flqHzsZjxfKksXv5h8x)]는 저장된 사용자 정보를 보고 편집할 수 있습니다. - 인벤토리: '제품' 메뉴에서 생성된 항목/항목 패키지/통화 패키지와 관련된 사용자 정보를 보고 편집할 수 있습니다. - 잔액: '통화' 메뉴에서 생성된 통화와 관련된 사용자 정보를 보고 편집할 수 있습니다. - 제품 결제 내역 (ZEM): 월드에서 ZEM으로 각 결제 거래의 제품 결제 내역 및 영수증 ID를 확인할 수 있습니다. ![](https://api.archbee.com/api/optimize/fCt3n1oCa8rgNJ8fw9I2N-HIoMOjODKoERy8iVmB106-20240904-102410.png) :::hint{type="danger"} **❗️ 주의** 링크된 월드 데이터는 심사가 완료된 후 출시 시점부터 기록됩니다. ::: ## 데이터 저장소 \[[World DataStorage](docId:53flqHzsZjxfKksXv5h8x)]는 저장된 사용자 정보를 볼 수 있게 해줍니다. - 검색에 사용된 ZEPETO ID는 앱의 사용자 프로필에서 찾을 수 있습니다. - 검색된 데이터의 표준 시간이 표시되며, 사용자가 플레이 중일 경우 데이터는 계속 변경됩니다. 이때 날짜 옆의 새로 고침 버튼이나 새로 고침(F5)을 통해 데이터를 최신 상태로 업데이트할 수 있습니다. ![](https://api.archbee.com/api/optimize/fCt3n1oCa8rgNJ8fw9I2N-_jDN1GRCXefTxdBfeCvKE-20240904-102410.png) ![](https://api.archbee.com/api/optimize/fCt3n1oCa8rgNJ8fw9I2N-kwAzTrDVfpjmV259hi3c3-20240904-102410.png) - 각 저장소의 데이터는 키/값 형태로 저장되며, 키를 변경하여 검색할 수 있습니다. - 키 목록에서는 해당 사용자 DB에 실제로 저장된 키 값만 노출됩니다. - 키 값을 검색하고 변경할 수도 있습니다. - 오른쪽의 '편집' 버튼을 누르면 편집 상태로 전환됩니다. 편집 상태에서는 저장된 값을 자유롭게 변경할 수 있습니다. - 편집 중에는 키 값을 변경할 수 없습니다. - 편집 후에는 데이터를 저장하여 실제로 반영해야 합니다. 편집 시의 데이터가 실제 사용자 데이터와 다르면 경고 메시지가 생성됩니다. :::hint{type="danger"} **❗️ 주의** - 아래 규칙이 충족되지 않으면 데이터가 정상적으로 저장되지 않습니다. - 값이 없을 경우 - 저장할 수 없는 값을 입력할 경우 - 데이터 저장 제약 조건 - 키 길이 제한: 50자 - 키에는 알파벳, 숫자 및 밑줄(\_)만 허용됩니다. - 최대 키 수: 사용자 ID당 1000개 - 최대 값 데이터 크기: 500,000자 - 값 데이터가 실제 서버에 저장될 때 내부 식별자와 함께 직렬화된다는 점에 유의하십시오. 이를 고려하고 안전을 위해 여유를 두고 사용하십시오. - 데이터 저장 API 호출 제한 - 가져오기(분당): 200회 - 설정(분당): 200회 ::: :::hint{type="danger"} **❗️ 주의** 사용자가 실시간으로 월드를 플레이하고 있는 경우 데이터가 덮어쓰여질 위험이 있습니다. 저장 버튼을 누르기 전에 반드시 확인하십시오! ::: ## 재고 '제품' 메뉴에서 생성된 항목/항목 패키지/통화 패키지와 관련된 사용자 정보를 보고 편집할 수 있습니다. - 검색에 사용된 ZEPETO ID는 앱의 사용자 프로필에서 찾을 수 있습니다. - 검색된 데이터의 표준 시간이 표시되며, 사용자가 게임을 하고 있는 경우 데이터가 계속 변경됩니다. 이때 날짜 옆의 새로 고침 버튼이나 새로 고침(F5)을 통해 데이터를 최신 상태로 업데이트할 수 있습니다. - ID: 저장된 항목의 고유 ID 값 - 이름: 저장된 항목의 이름 - 수량: 저장된 항목의 수량 (최대 2,147,483,647) - 업데이트: 항목 정보가 업데이트된 날짜 ![](https://api.archbee.com/api/optimize/fCt3n1oCa8rgNJ8fw9I2N-Wut_sxz-RtdqNanwuzw8S-20240904-102410.png) :::hint{type="success"} **👍 **각 정보는 수정할 수 있으므로 관리자가 DB에 입력된 값을 임의로 수정할 수 있습니다. 그러나 한 번에 최대 100개의 데이터를 일괄 수정할 수 있습니다. ::: :::hint{type="info"} **📘 **다음 가이드를 참조하십시오. \[[Multiplay World DataStorage](docId:53flqHzsZjxfKksXv5h8x)] ::: 인벤토리에서 사용자 ZEPETO ID를 검색할 때, 다음과 같이 기록이 있는 사용자 데이터베이스 화면이 표시됩니다. - 데이터베이스에 저장되지 않은 새 항목을 추가하려면 추가 버튼을 누를 수 있습니다. 그러나 미리 생성된 제품만 새 제품으로 추가할 수 있습니다. - 편집 모드로 전환할 때 버튼이 나타나지 않습니다. ![](https://api.archbee.com/api/optimize/fCt3n1oCa8rgNJ8fw9I2N-YSgKi_AR9cwHy6SGN-zcP-20240904-102410.png) **로그** - 로그 메뉴에서 실시간 데이터베이스에서 수행된 모든 수정을 확인할 수 있습니다. - 한 번에 최대 90일까지 검색할 수 있습니다. - 2023년에 생성된 데이터는 볼 수 있습니다. ![](https://api.archbee.com/api/optimize/fCt3n1oCa8rgNJ8fw9I2N-5X82IN6gYzQZggWJJmvpt-20240904-102410.png) 재고에서 로그 기록 버튼을 클릭하고 오른쪽 상단의 다운로드 버튼을 클릭하여 특정 날짜의 모든 로그를 Excel 파일로 다운로드합니다. - 최대 100,000회 조회수만 다운로드할 수 있습니다. ![](https://api.archbee.com/api/optimize/fCt3n1oCa8rgNJ8fw9I2N-mWF6v6Rypibld5eZD90A7-20240904-102411.png) ## 잔액 '통화' 메뉴에서 생성된 통화와 관련된 사용자 정보를 보고 편집할 수 있습니다. - 검색에 사용된 ZEPETO ID는 앱의 사용자 프로필에서 찾을 수 있습니다. - 검색된 데이터의 표준 시간이 표시되며, 사용자가 플레이 중일 경우 데이터가 계속 변경됩니다. 이때 날짜 옆의 새로 고침 버튼이나 새로 고침(F5)을 통해 데이터를 최신 상태로 업데이트할 수 있습니다. - ID: 저장된 통화의 고유 ID 값 - 이름: 저장된 통화의 이름 - 번호: 저장된 통화의 수량(최대 2,147,483,647) - 업데이트: 통화 정보가 업데이트된 날짜 :::hint{type="success"} **👍 **각 정보는 수정할 수 있으므로 관리자가 DB에 입력된 값을 임의로 수정할 수 있습니다. 그러나 한 번에 최대 100개의 데이터를 일괄 수정할 수 있습니다. ::: ![](https://api.archbee.com/api/optimize/fCt3n1oCa8rgNJ8fw9I2N-THjTvIneAoDFSxWJksNDU-20240904-102410.png) :::hint{type="info"} **📘 **다음 가이드를 참조하십시오. \[[내 월드로 돈벌기! 아이템과 재화 설정하기](docId\:bi1uNMNWHaPlvxG21YTSO)] ::: 잔액에서 사용자 ZEPETO ID를 검색할 때, 다음과 같이 기록이 있는 사용자 데이터베이스 화면이 표시됩니다. - 데이터베이스에 저장되지 않은 새 항목을 추가하려면 추가 버튼을 누를 수 있습니다. 그러나 미리 생성된 통화만 새 항목으로 추가할 수 있습니다. - 편집 모드로 전환할 때 버튼이 나타나지 않습니다. ![](https://api.archbee.com/api/optimize/fCt3n1oCa8rgNJ8fw9I2N-f_z9lW6ouBvYTBfDDP00J-20240904-102411.png) **로그** - 실시간 데이터베이스에서 수행된 모든 편집을 로그 메뉴에서 확인할 수 있습니다. - 한 번에 최대 90일까지 검색할 수 있습니다. - 2023년에 생성된 데이터는 볼 수 있습니다. ![](https://api.archbee.com/api/optimize/fCt3n1oCa8rgNJ8fw9I2N-rN8E1S6YSSfZGe1EWDbqx-20240904-102410.png) 로그 기록 버튼을 클릭한 후, 상단 오른쪽 모서리의 다운로드 버튼을 클릭하여 지정된 날짜의 모든 로그를 Excel 파일로 다운로드할 수 있습니다. - 최대 100,000회 조회만 다운로드할 수 있습니다. ![](https://api.archbee.com/api/optimize/fCt3n1oCa8rgNJ8fw9I2N-KSQbaldj2oDZDIznjBpgo-20240904-102410.png) ## 판매 기록(ZEM) ZEM으로 거래된 상품의 결제 기록과 각 결제의 영수증 ID를 확인할 수 있습니다. - 영수증 ID는 결제가 이루어질 때만 기록됩니다. 여기 기록되지 않은 결제는 실패한 결제입니다. - 한 번에 최대 90일까지 검색할 수 있습니다. :::hint{type="success"} **👍 **제품 결제 기록을 활용하여 사용자의 제품 거래가 실제로 이루어졌는지 확인하고 관련 문의에 응답할 수 있습니다. ::: - 날짜: 로그가 남겨진 날짜 - 영수증 ID: 영수증의 ID - 제품 ID: 구매한 제품 ID - ZEM: 구매 시 결제된 제품의 ZEM ![](https://api.archbee.com/api/optimize/fCt3n1oCa8rgNJ8fw9I2N-12JuBXQ4Jttqa8VtSYUXz-20240904-102411.png) 판매 기록(ZEM)에서 오른쪽 상단의 다운로드 버튼을 클릭하여 지정된 날짜의 모든 로그를 Excel 파일로 다운로드할 수 있습니다. - 최대 100,000회 조회만 다운로드할 수 있습니다. ![](https://api.archbee.com/api/optimize/fCt3n1oCa8rgNJ8fw9I2N-egWyQYNBJDljP0D3AuuQp-20240904-102410.png)