# 게임지원서비스 스튜디오 가이드


스튜디오 콘솔을 통해 스탯, 업적, 리더보드의 메타 데이터 설정이 가능합니다.

# 스탯 메타 데이터 설정


# 1) 스탯 메타 데이터 목록

스탯 목록 화면에서 설정된 메타 데이터 목록을 조회합니다. StatList

① 프로젝트 및 게임 ID 선택

  • 스탯 메타 데이터를 조회 또는 설정할 프로젝트 ID와 게임 ID를 선택합니다.
  • 등록된 프로젝트 ID 또는 게임 ID가 존재하지 않는 경우 조회 또는 메타 데이터 추가가 제한됩니다.

② 스탯 메타 목록

  • 해당 게임 ID 하위로 등록된 스탯 메타 데이터 목록을 확인할 수 있습니다.
  • 스탯 ID 선택 시 등록된 메타 정보의 상세 내용을 확인할 수 있고 부가 정보 수정이 가능합니다.

③ 스탯 메타 삭제

  • 등록된 스탯 메타 정보를 삭제할 수 있습니다.
  • 스탯 메타 데이터 삭제 시 해당 스탯에 적재된 유저 플레이 데이터도 함께 삭제되므로 주의가 필요합니다.

④ 스탯 데이터 초기화

  • 스탯에 적재된 유저 플레이 데이터를 초기화 합니다.
  • 스탯 메타 데이터는 유지되며, 해당 스탯에 적재된 유저 플레이 데이터만 초기화 됩니다.

⑤ 스탯 추가

  • 스탯 추가 버튼 선택 시 스탯 메타 데이터 추가 팝업이 노출됩니다.

# 2) 스탯 메타 데이터 추가

스탯 메타 등록 팝업을 통해 스탯 메타 데이터 추가가 가능합니다.

SetStatMeta

① 프로젝트 및 게임 ID 선택

  • 스탯 메타 데이터를 등록할 프로젝트 ID와 게임 ID를 선택합니다.

② 스탯 ID 입력

  • 연동에 사용할 스탯 ID를 입력합니다.
  • 영문 대문자, 숫자, 언더라인(_), 하이픈(-)으로 20자 이내로 입력 가능합니다.
  • 스탯ID는 유니크한 값으로 이미 등록된 스탯 ID는 중복 사용할 수 없습니다.

스탯 ID는 SDK 연동 시 게임 데이터를 전송하는 연동 Key로 사용됩니다.
스탯을 통해 스탯 데이터 및 업적 달성 포인트, 랭킹 포인트가 적재됩니다.

③ 업데이트 타입 선택

  • 스탯 데이터 업데이트 타입을 선택합니다.
  • 제공되는 업데이트 타입은 다음과 같습니다.
    • INCREMENT : 기존 값에 신규 값을 합산하는 방식입니다.
    • REPLACE : 기존 값을 신규 값으로 대체하는 방식입니다.
    • MAX : 기존 값 보다 신규 값이 큰 경우에만 신규 값으로 대체하는 방식입니다.
    • MIN : 기존 값 보다 신규 값이 작은 경우에만 신규 값으로 대체하는 방식입니다.

④ 부가 정보(관리명) 입력

  • 메타 정보 식별에 사용할 관리용 정보를 필요에 따라 선택 입력합니다.

# 업적 메타 데이터 설정


# 1) 업적 메타 데이터 목록

업적 목록 화면에서 설정된 메타 데이터 목록을 조회합니다. AchevementList

① 프로젝트 및 게임 ID 선택

  • 업적 메타 데이터를 조회 또는 설정할 프로젝트 ID와 게임 ID를 선택합니다.
  • 등록된 프로젝트 ID 또는 게임 ID가 존재하지 않는 경우 조회 또는 메타 데이터 추가가 제한됩니다.

② 업적 메타 목록

  • 해당 게임 ID 하위로 등록된 업적 메타 데이터 목록을 확인할 수 있습니다.
  • 업적 ID 선택 시 등록된 메타 정보의 상세 내용을 확인할 수 있고 부가 정보 수정이 가능합니다.
  • 스탯 ID 선택 시 해당 업적과 연동되는 스탯 메타 정보의 상세 내용을 확인할 수 있습니다.

③ 연동 스탯 삭제 상태 알림

  • 업적과 연동된 스탯 메타 데이터가 삭제된 경우 연동 스탯 ID에 강조 표기가 노출됩니다.
  • 이 경우, 정상 동작이 불가능하므로 해당 업적 사용 여부를 확인 후 업적을 삭제하거나, 연동 스탯 메타 데이터를 다시 설정해야 합니다.

④ 업적 메타 삭제

  • 등록된 업적 메타 정보를 삭제할 수 있습니다.
  • 업적 메타 데이터 삭제 시 적재된 업적 달성 데이터도 함께 삭제되므로 주의가 필요합니다.

⑤ 업적 데이터 초기화

  • 업적에 적재된 유저 플레이 데이터를 초기화 합니다.
  • 초기화 시 업적 메타 데이터는 유지되며, 적재된 업적 달성 데이터만 초기화 됩니다.

⑥ 업적 추가

  • 업적 추가 버튼 선택 시 업적 메타 데이터 추가 팝업이 노출됩니다.

# 2) 업적 메타 데이터 추가

업적 메타 등록 팝업을 통해 업적 메타 데이터 추가가 가능합니다.

SetAchevementMeta

① 프로젝트 및 게임 ID 선택

  • 업적 메타 데이터를 등록할 프로젝트 ID와 게임 ID를 선택합니다.

② 연동 스탯 정보 설정

  • 업적 포인트로 연동할 스탯 정보를 설정합니다.
  • 게임 플레이 데이터는 연동된 스탯을 통해 업적 포인트로 적재됩니다.
  • 기존 등록된 연동 대상 스탯이 없는 경우, 신규 스탯 생성 방식을 선택하여 일괄 등록할 수 있습니다.

③ 달성 목표 값 입력

  • 업적 달성 목표 값을 입력합니다.
  • 연동 스탯을 통해 적재된 업적 포인트가 목표 값에 도달하면 달성 처리됩니다.
  • 달성 목표 값의 입력 범위는 1 ~ 2,147,483,647 입니다.

스탯의 최대 값의 크기가 2,147,483,647 이므로, 적절한 범위로 스탯 업데이트 값과 업적 달성 목표 값을 설계해야 합니다.

④ 달성 타입 설정

  • 업적 포인트에 따른 달성 타입을 설정합니다.
  • 제공되는 설정 타입은 다음과 같습니다.
    • GTE(이상) : 업적 포인트가 달성 목표 값 이상이면 달성 처리됩니다.
    • LTE(이하) : 업적 포인트가 달성 목표 값 이하이면 달성 처리됩니다.
  • 연동 스탯의 업데이트 타입이 MAX인 경우, 기존 값보다 큰 값으로만 대체되므로 달성 타입은 GTE(이상)로 고정됩니다.
  • 연동 스탯의 업데이트 타입이 MIN인 경우, 기존 값보다 작은 값으로만 대체되므로 달성 타입은 LTE(이하)로 고정됩니다.

⑤ 부가 정보(표시 내용) 입력

  • 게임 화면에 표시할 업적 타이틀, 설명, 이미지를 필요에 따라 등록합니다.
  • 등록된 정보는 SDK 연동 후 업적 정보 조회 시 함께 제공됩니다.
    • 업적 타이틀: 업적을 대표할 타이틀 정보로 활용할 수 있습니다.
    • 업적 설명: 업적을 설명하는 용도로 활용할 수 있습니다.
    • 업적 이미지: 기본 이미지와 달성 이미지로 구성되며 달성 여부의 이미지 표현에 활용할 수 있습니다.

업적 메타 데이터 등록 완료 시 업적 ID는 '연동 스탯 ID'와 '달성 목표값'의 조합으로 자동 생성됩니다.
하나의 연동 스탯과 여러 개의 달성 목표 값 조합으로 중복되지 않는 복수의 업적 구성이 가능합니다.
생성된 업적 ID는 메타 정보 등록 완료 팝업 또는 업적 목록 화면에서 확인이 가능합니다.

# 리더보드 메타 데이터 설정


# 1) 리더보드 메타 데이터 목록

리더보드 목록 화면에서 설정된 메타 데이터 목록을 조회합니다. LeaderboardList

① 프로젝트 및 게임 ID 선택

  • 리더보드 메타 데이터를 조회 또는 설정할 프로젝트 ID와 게임 ID를 선택합니다.
  • 등록된 프로젝트 ID 또는 게임 ID가 존재하지 않는 경우 조회 또는 메타 데이터 추가가 제한됩니다.

② 리더보드 메타 목록

  • 해당 게임 ID 하위로 등록된 리더보드 메타 데이터 목록을 확인할 수 있습니다.
  • 리더보드 ID 선택 시 등록된 메타 정보의 상세 내용을 확인할 수 있고 부가 정보 수정이 가능합니다.
  • 스탯 ID 선택 시 해당 리더보드와 연동되는 스탯 메타 정보의 상세 내용을 확인할 수 있습니다.

③ 연동 스탯 삭제 상태 알림

  • 리더보드와 연동된 스탯 메타 데이터가 삭제된 경우 연동 스탯 ID에 강조 표기가 노출됩니다.
  • 이 경우, 정상 동작이 불가능하므로 해당 리더보드 사용 여부를 확인 후 리더보드를 삭제하거나, 연동 스탯 메타 데이터를 다시 설정해야 합니다.

④ 리더보드 메타 삭제

  • 등록된 리더보드 메타 정보를 삭제할 수 있습니다.
  • 리더보드 메타 데이터 삭제 시 적재된 랭킹 데이터가 모두 삭제되므로 주의가 필요합니다.

⑤ 리더보드 데이터 초기화

  • 리더보드에 적재된 랭킹 데이터를 초기화 합니다.
  • 초기화 시 리더보드 메타 데이터는 유지되며, 적재된 유저 랭킹 데이터만 초기화 됩니다.

⑥ 리더보드 추가

  • 리더보드 추가 버튼 선택 시 리더보드 메타 데이터 추가 팝업이 노출됩니다.

# 2) 리더보드 메타 데이터 추가

리더보드 메타 등록 팝업을 통해 리더보드 메타 데이터 추가가 가능합니다.

SetLeaderboardMeta

① 프로젝트 및 게임 ID 선택

  • 리더보드 메타 데이터를 등록할 프로젝트 ID와 게임 ID를 선택합니다.

② 연동 스탯 정보 설정

  • 랭킹 포인트로 연동할 스탯 정보를 설정합니다.
  • 게임 플레이 데이터는 연동된 스탯을 통해 랭킹 포인트로 적재됩니다.
  • 기존 등록된 연동 대상 스탯이 없는 경우, 신규 스탯 생성 방식을 선택하여 일괄 등록할 수 있습니다.

③ 순위 정렬 타입 선택

  • 랭킹 포인트에 따른 순위 정렬 타입을 설정합니다.
  • 설정 타입에 따라 순위표가 구성됩니다.
  • 제공되는 설정 타입은 다음과 같습니다.
    • DESC : 랭킹 포인트가 높은 플레이어가 1위가 됩니다.
    • ASC : 랭킹 포인트가 낮은 플레이어가 1위가 됩니다.
  • 연동 스탯의 업데이트 타입이 MAX인 경우, 기존 값보다 큰 값으로만 대체되므로 정렬 타입은 DESC로 고정됩니다.
  • 연동 스탯의 업데이트 타입이 MIN인 경우, 기존 값보다 작은 값으로만 대체되므로 정렬 타입은 ASC로 고정됩니다.

④ 부가 정보(관리명) 입력

  • 메타 정보 식별에 사용할 관리용 정보를 필요에 따라 선택 입력합니다.

리더보드 메타 데이터 등록 완료 시 리더보드 ID는 '게임 ID'와 '연동 스탯 ID'의 조합으로 자동 생성됩니다.
리더보드 메타 데이터는 연동 스탯과 1:1의 관계로만 등록이 가능하며, 동일한 조건의 순위표 복수 생성이 제한됩니다.
생성된 리더보드 ID는 메타 정보 등록 완료 팝업 또는 리더보드 목록 화면에서 확인이 가능합니다.

Last Updated: 2023. 7. 15. 오후 3:21:26