CREATE YOUR WORLD
데이터 저장소 (Data Storage)

월드 데이터 매니지먼트

18min

사용자 데이터는 월드 데이터 관리 기능을 통해 보고 변경할 수 있습니다.

❗️ 주의 월드 개발자는 기능을 사용하기 위해 자신의 API를 추가해야 합니다. API 추가 방법에 대한 다음 가이드를 참조하십시오. [Multiplay World DataStorage]



데이터 관리

월드 콘솔의 '데이터 관리' 메뉴에서 월드의 DB에 접근하고 편집할 수 있습니다.

데이터 관리에는 총 4개의 항목이 있습니다. 모든 항목은 해당 월드를 사용하는 사용자 ID를 기반으로 사용자 특정 정보를 검색합니다.

  • 데이터 관리: [World DataStorage]는 저장된 사용자 정보를 보고 편집할 수 있습니다.
  • 인벤토리: '제품' 메뉴에서 생성된 항목/항목 패키지/통화 패키지와 관련된 사용자 정보를 보고 편집할 수 있습니다.
  • 잔액: '통화' 메뉴에서 생성된 통화와 관련된 사용자 정보를 보고 편집할 수 있습니다.
  • 제품 결제 내역 (ZEM): 월드에서 ZEM으로 각 결제 거래의 제품 결제 내역 및 영수증 ID를 확인할 수 있습니다.



Document image




❗️ 주의 링크된 월드 데이터는 심사가 완료된 후 출시 시점부터 기록됩니다.



데이터 저장소

[World DataStorage]는 저장된 사용자 정보를 볼 수 있게 해줍니다.

  • 검색에 사용된 ZEPETO ID는 앱의 사용자 프로필에서 찾을 수 있습니다.
  • 검색된 데이터의 표준 시간이 표시되며, 사용자가 플레이 중일 경우 데이터는 계속 변경됩니다. 이때 날짜 옆의 새로 고침 버튼이나 새로 고침(F5)을 통해 데이터를 최신 상태로 업데이트할 수 있습니다.



Document image




Document image




  • 각 저장소의 데이터는 키/값 형태로 저장되며, 키를 변경하여 검색할 수 있습니다.
  • 키 목록에서는 해당 사용자 DB에 실제로 저장된 키 값만 노출됩니다.
  • 키 값을 검색하고 변경할 수도 있습니다.



  • 오른쪽의 '편집' 버튼을 누르면 편집 상태로 전환됩니다. 편집 상태에서는 저장된 값을 자유롭게 변경할 수 있습니다.
  • 편집 중에는 키 값을 변경할 수 없습니다.
  • 편집 후에는 데이터를 저장하여 실제로 반영해야 합니다. 편집 시의 데이터가 실제 사용자 데이터와 다르면 경고 메시지가 생성됩니다.



❗️ 주의

  • 아래 규칙이 충족되지 않으면 데이터가 정상적으로 저장되지 않습니다.
    • 값이 없을 경우
    • 저장할 수 없는 값을 입력할 경우
  • 데이터 저장 제약 조건
    • 키 길이 제한: 50자
      • 키에는 알파벳, 숫자 및 밑줄(_)만 허용됩니다.
    • 최대 키 수: 사용자 ID당 1000개
    • 최대 값 데이터 크기: 500,000자
      • 값 데이터가 실제 서버에 저장될 때 내부 식별자와 함께 직렬화된다는 점에 유의하십시오. 이를 고려하고 안전을 위해 여유를 두고 사용하십시오.
  • 데이터 저장 API 호출 제한
    • 가져오기(분당): 200회
    • 설정(분당): 200회

❗️ 주의 사용자가 실시간으로 월드를 플레이하고 있는 경우 데이터가 덮어쓰여질 위험이 있습니다. 저장 버튼을 누르기 전에 반드시 확인하십시오!



재고

'제품' 메뉴에서 생성된 항목/항목 패키지/통화 패키지와 관련된 사용자 정보를 보고 편집할 수 있습니다.

  • 검색에 사용된 ZEPETO ID는 앱의 사용자 프로필에서 찾을 수 있습니다.
  • 검색된 데이터의 표준 시간이 표시되며, 사용자가 게임을 하고 있는 경우 데이터가 계속 변경됩니다. 이때 날짜 옆의 새로 고침 버튼이나 새로 고침(F5)을 통해 데이터를 최신 상태로 업데이트할 수 있습니다.
  • ID: 저장된 항목의 고유 ID 값
  • 이름: 저장된 항목의 이름
  • 수량: 저장된 항목의 수량 (최대 2,147,483,647)
  • 업데이트: 항목 정보가 업데이트된 날짜
Document image




👍 각 정보는 수정할 수 있으므로 관리자가 DB에 입력된 값을 임의로 수정할 수 있습니다. 그러나 한 번에 최대 100개의 데이터를 일괄 수정할 수 있습니다.



📘 다음 가이드를 참조하십시오. [Multiplay World DataStorage]



인벤토리에서 사용자 ZEPETO ID를 검색할 때, 다음과 같이 기록이 있는 사용자 데이터베이스 화면이 표시됩니다.

  • 데이터베이스에 저장되지 않은 새 항목을 추가하려면 추가 버튼을 누를 수 있습니다. 그러나 미리 생성된 제품만 새 제품으로 추가할 수 있습니다.
  • 편집 모드로 전환할 때 버튼이 나타나지 않습니다.
Document image


로그

  • 로그 메뉴에서 실시간 데이터베이스에서 수행된 모든 수정을 확인할 수 있습니다.
    • 한 번에 최대 90일까지 검색할 수 있습니다.
      • 2023년에 생성된 데이터는 볼 수 있습니다.



Document image




재고에서 로그 기록 버튼을 클릭하고 오른쪽 상단의 다운로드 버튼을 클릭하여 특정 날짜의 모든 로그를 Excel 파일로 다운로드합니다.

  • 최대 100,000회 조회수만 다운로드할 수 있습니다.



Document image




잔액

'통화' 메뉴에서 생성된 통화와 관련된 사용자 정보를 보고 편집할 수 있습니다.

  • 검색에 사용된 ZEPETO ID는 앱의 사용자 프로필에서 찾을 수 있습니다.
  • 검색된 데이터의 표준 시간이 표시되며, 사용자가 플레이 중일 경우 데이터가 계속 변경됩니다. 이때 날짜 옆의 새로 고침 버튼이나 새로 고침(F5)을 통해 데이터를 최신 상태로 업데이트할 수 있습니다.
  • ID: 저장된 통화의 고유 ID 값
  • 이름: 저장된 통화의 이름
  • 번호: 저장된 통화의 수량(최대 2,147,483,647)
  • 업데이트: 통화 정보가 업데이트된 날짜

👍 각 정보는 수정할 수 있으므로 관리자가 DB에 입력된 값을 임의로 수정할 수 있습니다. 그러나 한 번에 최대 100개의 데이터를 일괄 수정할 수 있습니다.



Document image




📘 다음 가이드를 참조하십시오. [내 월드로 돈벌기! 아이템과 재화 설정하기]



잔액에서 사용자 ZEPETO ID를 검색할 때, 다음과 같이 기록이 있는 사용자 데이터베이스 화면이 표시됩니다.

  • 데이터베이스에 저장되지 않은 새 항목을 추가하려면 추가 버튼을 누를 수 있습니다. 그러나 미리 생성된 통화만 새 항목으로 추가할 수 있습니다.
  • 편집 모드로 전환할 때 버튼이 나타나지 않습니다.
Document image


로그

  • 실시간 데이터베이스에서 수행된 모든 편집을 로그 메뉴에서 확인할 수 있습니다.
    • 한 번에 최대 90일까지 검색할 수 있습니다.
      • 2023년에 생성된 데이터는 볼 수 있습니다.



Document image




로그 기록 버튼을 클릭한 후, 상단 오른쪽 모서리의 다운로드 버튼을 클릭하여 지정된 날짜의 모든 로그를 Excel 파일로 다운로드할 수 있습니다.

  • 최대 100,000회 조회만 다운로드할 수 있습니다.
Document image




판매 기록(ZEM)

ZEM으로 거래된 상품의 결제 기록과 각 결제의 영수증 ID를 확인할 수 있습니다.

  • 영수증 ID는 결제가 이루어질 때만 기록됩니다. 여기 기록되지 않은 결제는 실패한 결제입니다.
  • 한 번에 최대 90일까지 검색할 수 있습니다.

👍 제품 결제 기록을 활용하여 사용자의 제품 거래가 실제로 이루어졌는지 확인하고 관련 문의에 응답할 수 있습니다.

  • 날짜: 로그가 남겨진 날짜
  • 영수증 ID: 영수증의 ID
  • 제품 ID: 구매한 제품 ID
  • ZEM: 구매 시 결제된 제품의 ZEM
Document image




판매 기록(ZEM)에서 오른쪽 상단의 다운로드 버튼을 클릭하여 지정된 날짜의 모든 로그를 Excel 파일로 다운로드할 수 있습니다.

  • 최대 100,000회 조회만 다운로드할 수 있습니다.



Document image