회원 - TOAST Document

Game > Gamebase > 콘솔 사용 가이드 > 회원

게임에 로그인한 회원 정보를 조회합니다.

Search Member

User ID/IdP ID를 입력하면 회원정보를 검색할 수 있습니다. 사용자 아이디(User ID)는 최초로 로그인할 때 Gamebase에서 자동으로 발급하는 사용자 식별자입니다. 전달 시 혼란을 줄이고자 같은 발음의 문자를 배제하여 "ABCDFGHJKLMNPQRSTWXYZ1346789" 문자만을 사용하고 있습니다. IdP ID는 Id Provider에서 제공하는 아이디 정보로써 로그인 시 입력하는 정보가 아닌 Id Provider내의 고유 식별자를 의미합니다. 따라서 IdP ID 항목으로 검색하고자 할 경우 검색정보 입력에 주의가 필요합니다.

검색된 사용자의 상세 정보를 위쪽에 표시하고 로그인, 매핑, 결제, 이용 정지, 플레이 시간 등의 이력은 아래쪽에 탭 형태로 표시됩니다.

Detail Information

image alt

User

유저 ID: Gamebase 사용자 아이디
국가코드(USIM): 사용자 단말기의 USIM 국가 코드로 수집에 실패하면 'ZZ'로 표기됩니다. 단말기에 설정된 국가 코드를 확인하고 싶다면 하단의 로그인 이력에서 확인하세요.
마지막 로그인 시간: 사용자가 가장 마지막에 로그인한 시간
등록일: 사용자가 최초로 로그인한 시간
계정 상태
정상: 정상 사용자.
이용정지: 어뷰징 등으로 이용 정지(ban)된 사용자. 우측 상단의 계정 상태 변경 메뉴를 통해 이용정지를 해제할 수 있습니다.
탈퇴: 탈퇴한 사용자.
푸시 토큰: 유저의 푸시 토큰 정보 조회.

Identity Provider

Gamebase에서는 여러 개의 외부 IdP를 연동할 수 있습니다. 즉, 사용자가 하나의 사용자 아이디에 Facebook, Google 두 개의 IdP를 등록하여 로그인할 수 있습니다. SDK에서 Login using a specific IdP나 'Add Mapping API를 호출하는 경우에 IdP가 등록됩니다.

IdP: 외부 IdP(게스트, Facebook, PAYCO, Google 등)
Idp ID: 외부 IdP에서 제공하는 아이디(Facebook no, PAYCO 아이디 등)
등록일: 사용자가 최초로 해당 IdP를 등록한 시간

계정 상태 변경

image alt 조회한 유저의 계정 상태를 변경할 수 있는 기능입니다. 상태별 변경할 수 있는 경우는 아래와 같습니다. - 정상: 이용정지, 탈퇴상태로 변경이 가능합니다. 탈퇴시에는 해당 계정정보를 되돌릴 수 없으므로 처리 전 확인 및 주의가 필요합니다. - 이용 정지: 이용정지 해제를 진행할 수 있습니다. - 탈퇴: 해당 버튼이 노출되지 않습니다.

매핑 추가

조회한 유저의 Id Provider 정보를 추가할 수 있는 기능입니다. 연결하고자하는 IdP를 가지고 있는 유저의 정보가 정상일 경우에만 매핑 추가 작업이 가능합니다. 제공 유저의 IdP 설정란에서 연결하고자 하는 Id Provider 정보를 1번 버튼을 통해 오른쪽화면에 추가한 후, 아래 매핑 추가 버튼을 통해 매핑 추가 작업을 진행합니다. 잘못 추가했다면 매핑 추가 버튼을 누르기 전에는 2번 버튼을 통해 언제든지 다른 Id provider로 교체 가능합니다. 제공 받는 유저가 GUEST정보만 가지고 있을 경우에는 새로운 Id Provider정보가 추가되면서 기존의 Guest정보는 유실되므로 작업 진행 시 주의가 필요합니다. 제공 유저의 Id Provider 정보가 한개일 경우 해당작업을 진행하면 제공 유저 정보는 유실상태로 변경되어 더이상 사용할 수 없으므로 작업 진행 전 확인이 필요합니다.

제공 전 예시

image alt

제공 후 예시

image alt

매핑 해제

다중 매핑이 이루어진 계정의 경우 요청에 따라 Id Provider 정보 연동을 해제할 수 있습니다. 각각의 계정은 최소 1개의 연결정보가 존재해야 하므로 2개 이상의 연결정보가 존재할 때만 버튼이 활성화 됩니다. 버튼을 누르면 아래와 같이 연결된 Id Provider 정보와 함께 매핑 해제 버튼이 노출됩니다. 해제 버튼을 누를 경우 아래와 같이 최종 확인창과 함께 Id Provider 정보를 확인합니다. 확인버튼을 누르시면 매핑 해제가 진행됩니다. image alt

image alt

조회한 사용자의 로그인 내역을 조회합니다. 최초 조회 시에는 최근 1일로 조회하며 조회를 원하는 날짜를 다시 입력하여 조회할 수도 있습니다. 단, 최근 3개월(90일) 동안의 이력만 제공합니다. SDK에서 로그인 관련 API를 호출할 때 이력이 추가됩니다.

Login Date: 사용자가 앱에 로그인 한 시간
Login Type: 사용자 로그인 시 사용한 인증 유형(IdP Login/Guest 등). 괄호안의 정보는 실제 사용 된 IdProvider 정보.
OS / Ver: 사용자 로그인 시 사용한 OS(IOS/Android/WebGL 등) 및 해당 OS의 버전 정보
Device model: 사용자가 앱 로그인 시 사용한 기기 모델명
Device Key: 사용자 로그인 시 사용한 기기가 가지고 있는 고유 식별값(Android:Android id, iOS:IDFV)
Device Country Code: 사용자 로그인 시 기기에 설정된 국가 코드
USIM Country Code: 사용자 로그인 시 USIM카드에 설정된 국가 코드
Telecom: 사용자 로그인 시 이용한 통신사 정보
Network: 사용자 로그인 시 사용한 네트워크 유형(Wi-Fi/3G/LTE 등)
Language Code: 사용자 로그인 시 단말기에 설정 된 언어 코드 정보
Store Code: 사용자가 앱을 다운로드한 스토어 정보
Client Version: 앱 다운로드 당시의 클라이언트 버전 정보
Gamebase SDK Version: 앱에 사용된 Gamebase SDK의 버전 정보
etc: 기타 로그인 시 사용된 위 항목 외 정보