# 게임지원서비스 스튜디오 가이드
스튜디오 콘솔을 통해 스탯, 업적, 리더보드의 메타 데이터 설정이 가능합니다.
# 스탯 메타 데이터 설정
# 1) 스탯 메타 데이터 목록
스탯 목록 화면에서 설정된 메타 데이터 목록을 조회합니다.
① 프로젝트 및 게임 ID 선택
- 스탯 메타 데이터를 조회 또는 설정할 프로젝트 ID와 게임 ID를 선택합니다.
- 등록된 프로젝트 ID 또는 게임 ID가 존재하지 않는 경우 조회 또는 메타 데이터 추가가 제한됩니다.
② 스탯 메타 목록
- 해당 게임 ID 하위로 등록된 스탯 메타 데이터 목록을 확인할 수 있습니다.
- 스탯 ID 선택 시 등록된 메타 정보의 상세 내용을 확인할 수 있고 부가 정보 수정이 가능합니다.
③ 스탯 메타 삭제
- 등록된 스탯 메타 정보를 삭제할 수 있습니다.
- 스탯 메타 데이터 삭제 시 해당 스탯에 적재된 유저 플레이 데이터도 함께 삭제되므로 주의가 필요합니다.
④ 스탯 데이터 초기화
- 스탯에 적재된 유저 플레이 데이터를 초기화 합니다.
- 스탯 메타 데이터는 유지되며, 해당 스탯에 적재된 유저 플레이 데이터만 초기화 됩니다.
⑤ 스탯 추가
- 스탯 추가 버튼 선택 시 스탯 메타 데이터 추가 팝업이 노출됩니다.
# 2) 스탯 메타 데이터 추가
스탯 메타 등록 팝업을 통해 스탯 메타 데이터 추가가 가능합니다.
① 프로젝트 및 게임 ID 선택
- 스탯 메타 데이터를 등록할 프로젝트 ID와 게임 ID를 선택합니다.
② 스탯 ID 입력
- 연동에 사용할 스탯 ID를 입력합니다.
- 영문 대문자, 숫자, 언더라인(_), 하이픈(-)으로 20자 이내로 입력 가능합니다.
- 스탯ID는 유니크한 값으로 이미 등록된 스탯 ID는 중복 사용할 수 없습니다.
스탯 ID는 SDK 연동 시 게임 데이터를 전송하는 연동 Key로 사용됩니다.
스탯을 통해 스탯 데이터 및 업적 달성 포인트, 랭킹 포인트가 적재됩니다.
③ 업데이트 타입 선택
- 스탯 데이터 업데이트 타입을 선택합니다.
- 제공되는 업데이트 타입은 다음과 같습니다.
- INCREMENT : 기존 값에 신규 값을 합산하는 방식입니다.
- REPLACE : 기존 값을 신규 값으로 대체하는 방식입니다.
- MAX : 기존 값 보다 신규 값이 큰 경우에만 신규 값으로 대체하는 방식입니다.
- MIN : 기존 값 보다 신규 값이 작은 경우에만 신규 값으로 대체하는 방식입니다.
④ 부가 정보(관리명) 입력
- 메타 정보 식별에 사용할 관리용 정보를 필요에 따라 선택 입력합니다.
# 업적 메타 데이터 설정
# 1) 업적 메타 데이터 목록
업적 목록 화면에서 설정된 메타 데이터 목록을 조회합니다.
① 프로젝트 및 게임 ID 선택
- 업적 메타 데이터를 조회 또는 설정할 프로젝트 ID와 게임 ID를 선택합니다.
- 등록된 프로젝트 ID 또는 게임 ID가 존재하지 않는 경우 조회 또는 메타 데이터 추가가 제한됩니다.
② 업적 메타 목록
- 해당 게임 ID 하위로 등록된 업적 메타 데이터 목록을 확인할 수 있습니다.
- 업적 ID 선택 시 등록된 메타 정보의 상세 내용을 확인할 수 있고 부가 정보 수정이 가능합니다.
- 스탯 ID 선택 시 해당 업적과 연동되는 스탯 메타 정보의 상세 내용을 확인할 수 있습니다.
③ 연동 스탯 삭제 상태 알림
- 업적과 연동된 스탯 메타 데이터가 삭제된 경우 연동 스탯 ID에 강조 표기가 노출됩니다.
- 이 경우, 정상 동작이 불가능하므로 해당 업적 사용 여부를 확인 후 업적을 삭제하거나, 연동 스탯 메타 데이터를 다시 설정해야 합니다.
④ 업적 메타 삭제
- 등록된 업적 메타 정보를 삭제할 수 있습니다.
- 업적 메타 데이터 삭제 시 적재된 업적 달성 데이터도 함께 삭제되므로 주의가 필요합니다.
⑤ 업적 데이터 초기화
- 업적에 적재된 유저 플레이 데이터를 초기화 합니다.
- 초기화 시 업적 메타 데이터는 유지되며, 적재된 업적 달성 데이터만 초기화 됩니다.
⑥ 업적 추가
- 업적 추가 버튼 선택 시 업적 메타 데이터 추가 팝업이 노출됩니다.
# 2) 업적 메타 데이터 추가
업적 메타 등록 팝업을 통해 업적 메타 데이터 추가가 가능합니다.
① 프로젝트 및 게임 ID 선택
- 업적 메타 데이터를 등록할 프로젝트 ID와 게임 ID를 선택합니다.
② 연동 스탯 정보 설정
- 업적 포인트로 연동할 스탯 정보를 설정합니다.
- 게임 플레이 데이터는 연동된 스탯을 통해 업적 포인트로 적재됩니다.
- 기존 등록된 연동 대상 스탯이 없는 경우, 신규 스탯 생성 방식을 선택하여 일괄 등록할 수 있습니다.
③ 달성 목표 값 입력
- 업적 달성 목표 값을 입력합니다.
- 연동 스탯을 통해 적재된 업적 포인트가 목표 값에 도달하면 달성 처리됩니다.
- 달성 목표 값의 입력 범위는 1 ~ 2,147,483,647 입니다.
스탯의 최대 값의 크기가 2,147,483,647 이므로, 적절한 범위로 스탯 업데이트 값과 업적 달성 목표 값을 설계해야 합니다.
④ 달성 타입 설정
- 업적 포인트에 따른 달성 타입을 설정합니다.
- 제공되는 설정 타입은 다음과 같습니다.
- GTE(이상) : 업적 포인트가 달성 목표 값 이상이면 달성 처리됩니다.
- LTE(이하) : 업적 포인트가 달성 목표 값 이하이면 달성 처리됩니다.
- 연동 스탯의 업데이트 타입이 MAX인 경우, 기존 값보다 큰 값으로만 대체되므로 달성 타입은 GTE(이상)로 고정됩니다.
- 연동 스탯의 업데이트 타입이 MIN인 경우, 기존 값보다 작은 값으로만 대체되므로 달성 타입은 LTE(이하)로 고정됩니다.
⑤ 부가 정보(표시 내용) 입력
- 게임 화면에 표시할 업적 타이틀, 설명, 이미지를 필요에 따라 등록합니다.
- 등록된 정보는 SDK 연동 후 업적 정보 조회 시 함께 제공됩니다.
- 업적 타이틀: 업적을 대표할 타이틀 정보로 활용할 수 있습니다.
- 업적 설명: 업적을 설명하는 용도로 활용할 수 있습니다.
- 업적 이미지: 기본 이미지와 달성 이미지로 구성되며 달성 여부의 이미지 표현에 활용할 수 있습니다.
업적 메타 데이터 등록 완료 시 업적 ID는 '연동 스탯 ID'와 '달성 목표값'의 조합으로 자동 생성됩니다.
하나의 연동 스탯과 여러 개의 달성 목표 값 조합으로 중복되지 않는 복수의 업적 구성이 가능합니다.
생성된 업적 ID는 메타 정보 등록 완료 팝업 또는 업적 목록 화면에서 확인이 가능합니다.
# 리더보드 메타 데이터 설정
# 1) 리더보드 메타 데이터 목록
리더보드 목록 화면에서 설정된 메타 데이터 목록을 조회합니다.
① 프로젝트 및 게임 ID 선택
- 리더보드 메타 데이터를 조회 또는 설정할 프로젝트 ID와 게임 ID를 선택합니다.
- 등록된 프로젝트 ID 또는 게임 ID가 존재하지 않는 경우 조회 또는 메타 데이터 추가가 제한됩니다.
② 리더보드 메타 목록
- 해당 게임 ID 하위로 등록된 리더보드 메타 데이터 목록을 확인할 수 있습니다.
- 리더보드 ID 선택 시 등록된 메타 정보의 상세 내용을 확인할 수 있고 부가 정보 수정이 가능합니다.
- 스탯 ID 선택 시 해당 리더보드와 연동되는 스탯 메타 정보의 상세 내용을 확인할 수 있습니다.
③ 연동 스탯 삭제 상태 알림
- 리더보드와 연동된 스탯 메타 데이터가 삭제된 경우 연동 스탯 ID에 강조 표기가 노출됩니다.
- 이 경우, 정상 동작이 불가능하므로 해당 리더보드 사용 여부를 확인 후 리더보드를 삭제하거나, 연동 스탯 메타 데이터를 다시 설정해야 합니다.
④ 리더보드 메타 삭제
- 등록된 리더보드 메타 정보를 삭제할 수 있습니다.
- 리더보드 메타 데이터 삭제 시 적재된 랭킹 데이터가 모두 삭제되므로 주의가 필요합니다.
⑤ 리더보드 데이터 초기화
- 리더보드에 적재된 랭킹 데이터를 초기화 합니다.
- 초기화 시 리더보드 메타 데이터는 유지되며, 적재된 유저 랭킹 데이터만 초기화 됩니다.
⑥ 리더보드 추가
- 리더보드 추가 버튼 선택 시 리더보드 메타 데이터 추가 팝업이 노출됩니다.
# 2) 리더보드 메타 데이터 추가
리더보드 메타 등록 팝업을 통해 리더보드 메타 데이터 추가가 가능합니다.
① 프로젝트 및 게임 ID 선택
- 리더보드 메타 데이터를 등록할 프로젝트 ID와 게임 ID를 선택합니다.
② 연동 스탯 정보 설정
- 랭킹 포인트로 연동할 스탯 정보를 설정합니다.
- 게임 플레이 데이터는 연동된 스탯을 통해 랭킹 포인트로 적재됩니다.
- 기존 등록된 연동 대상 스탯이 없는 경우, 신규 스탯 생성 방식을 선택하여 일괄 등록할 수 있습니다.
③ 순위 정렬 타입 선택
- 랭킹 포인트에 따른 순위 정렬 타입을 설정합니다.
- 설정 타입에 따라 순위표가 구성됩니다.
- 제공되는 설정 타입은 다음과 같습니다.
- DESC : 랭킹 포인트가 높은 플레이어가 1위가 됩니다.
- ASC : 랭킹 포인트가 낮은 플레이어가 1위가 됩니다.
- 연동 스탯의 업데이트 타입이 MAX인 경우, 기존 값보다 큰 값으로만 대체되므로 정렬 타입은 DESC로 고정됩니다.
- 연동 스탯의 업데이트 타입이 MIN인 경우, 기존 값보다 작은 값으로만 대체되므로 정렬 타입은 ASC로 고정됩니다.
④ 부가 정보(관리명) 입력
- 메타 정보 식별에 사용할 관리용 정보를 필요에 따라 선택 입력합니다.
리더보드 메타 데이터 등록 완료 시 리더보드 ID는 '게임 ID'와 '연동 스탯 ID'의 조합으로 자동 생성됩니다.
리더보드 메타 데이터는 연동 스탯과 1:1의 관계로만 등록이 가능하며, 동일한 조건의 순위표 복수 생성이 제한됩니다.
생성된 리더보드 ID는 메타 정보 등록 완료 팝업 또는 리더보드 목록 화면에서 확인이 가능합니다.
← 서비스 종료 컬렉션 출시 가이드 →