Game > Gamebase > 개요

TOAST Gamebase는 게임에서 공통으로 필요한 기능들을 통합 SDK로 제공하여 손쉽고 효율적으로 게임을 개발할 수 있도록 한 서비스입니다. 게임 개발자는 게임 콘텐츠만 만드세요. 나머지는 Gamebase가 해결해 드립니다.

Gamebase에서는 인증, 결제, 푸시 등 게임에 필요한 기본 기능뿐만 아니라 게임 앱 구동에 필요한 데이터 관리, 운영을 위한 점검, 공지 등의 기능을 제공합니다. 또한, 게임 내 사용자 조회 및 이용 정지 기능 등을 손쉽게 할 수 있도록 Console을 제공합니다. 그리고, 게임 사업에서 활용할 수 있도록 게임에서 관심 있는 기본적인 지표를 실시간으로 제공합니다.

다음은 Gamebase에서 제공하는 주요 기능과 설명입니다.

Key Features

Authentication

Gamebase는 여러 IdP(identity provider)의 계정을 이용한 ID, 비밀번호 기반의 OAuth 로그인과 단말기의 UUID를 이용한 게스트 로그인을 지원합니다. Gamebase의 인증은 자체적인 회원 체계를 구축하지 않고 외부 IdP에서 제공하는 회원 정보를 이용하여 인증 서비스를 제공하는 서비스입니다. 자체적인 회원 체계가 없다라는 것은 사용자의 아이디, 비밀번호를 Gamebase 내부에 저장하지 않는 것을 의미합니다.

  • 다양한 인증 방식을 단일 인터페이스로 제공합니다. 단일 인터페이스로 API를 제공하여 보다 쉽고 빠르게 외부 IdP 추가 개발이 가능하기 때문에 개발 비용이 절감됩니다. 개발자는 복잡한 인증 절차나 법적 문제, 정책 문제 등을 고려하지 않고 쉽게 인증 기능을 구현할 수 있습니다.

  • 다양한 외부 IdP 인증을 제공합니다. 제공하는 외부 인증은 지속적으로 업데이트될 예정이며 게임에서 사용하길 원하는 인증이 있는 경우에는 고객 센터로 연락주시기 바랍니다.

다음은 Gamebase에서 지원하는 외부 인증 목록입니다.

외부 인증 제공되는 플랫폼
Facebook iOS, Android
Apple Game Center iOS
Google iOS, Android
PAYCO iOS, Android
NAVER iOS, Android
Twitter iOS, Android
LINE iOS, Android
  • 게스트 로그인을 제공합니다. 게스트 로그인을 이용하면 사용자는 아무런 입력 없이 바로 게임에 로그인하여 간편하게 게임을 시작할 수 있습니다. 게스트 로그인만으로도 Gamebase 사용자 아이디가 발급되므로 게임은 OAuth 로그인 사용자와 게스트 로그인 사용자의 구분 없이 동일하게 사용자의 게임 데이터를 관리할 수 있습니다.

  • 독립적인 회원 식별자를 제공합니다. 최초로 로그인하면 Gamebase 사용자 아이디가 자동으로 생성되며, 게임에서는 사용자를 구별하는 식별자로 사용하실 수 있습니다. 사용자 아이디는 인증 방식과 관계 없이 모든 사용자에게 발급되며 IdP에 종속적이지 않으므로 어떤한 IdP를 통해 로그인하더라도 게임 내에서 동일한 방식으로 사용자 처리가 가능합니다.

  • 로그아웃 및 게임 탈퇴 기능을 제공합니다. 로그아웃 이후 다른 인증 방식을 선택하여 다시 로그인할 수 있으며, 게임 탈퇴를 진행하면 사용자의 사용자 아이디 및 관련된 모든 정보를 Gamebase에서 삭제합니다.

  • 게임 이용자 한 명이 여러 개의 외부 IdP를 동시에 사용할 수 있도록 매핑(mapping) 기능을 제공합니다. 예를 들어 Facebook 인증을 사용하여 게임을 이용하고 있는 사용자가 Google 인증으로도 동일한 사용자 아이디를 사용할 수 있도록 매핑 기능을 제공합니다. 하나의 사용자 아이디에 Facebook과 Google 인증을 매핑하면 게임 이용자는 어떤 기기에서는 Facebook, 또 다른 기기에서는 Google로 인증하여 게임을 할 수 있습니다.

Reference

Launching

서비스되고 있는 게임 앱은 처음 시작할 때 여러 정보가 필요합니다. Gamebase는 게임 앱 실행 초기에 운영에 필요한 데이터를 게임 앱에 제공하며, 이를 Launching이라고 부릅니다. 론칭 정보는 Gamebase Console에서 실시간으로 설정할 수 있으며, SDK 초기화나 론칭 상태 변경 시에 게임에서 확인할 수 있습니다.

Gamebase에서 제공되는 론칭 정보는 다음과 같습니다.

  • 앱 상태 정보
    • 게임 클라이언트 업데이트 필요 여부, 다운로드 URL
    • 점검 정보
  • 긴급 공지 정보
  • 인증 정보
  • 게임 인앱 URL 목록

Reference

For Global

Gamebase는 기본적으로 게임의 글로벌 오픈을 지원하고 있으며 글로벌 환경에서의 게임 운영을 지원하기 위하여 다음과 같은 기능들을 제공합니다.

  • 게임 이용자에게 표시되는 메시지는 모두 다국어 처리가 가능합니다.
    • 게임 이용자에게 표시되는 메시지를 Console에서 입력할 때 다국어로 입력받아 이용자의 기기 언어 설정에 맞게 언어를 표시합니다. Console에서 한국어, 영어, 일본어를 입력하면 한국어 기기를 사용하는 이용자에게는 한국어 메시지가 표시됩니다.
  • 국가 필터링 기능을 제공합니다.
    • 운영 중에 특정 국가의 게임 이용자에게만 긴급 공지 메시지나 푸시 메시지를 보내고 싶은 경우, 국가를 지정하여 메시지를 표시할 수 있습니다.
  • 운영자의 현지 표준 시간대(local timezone)를 선택하여 손쉽게 시간 입력이 가능합니다.
    • 베트남에서 게임을 운영하는 경우, 베트남 표준 시간대(timezone)를 선택하여 베트남 시간 기준으로 입력할 수 있으므로, 한국 시간으로 변경하는 수고를 줄일 수 있습니다.

Standard Index(BI)

  • Gamebase Console에서 기본적인 운영 지표를 실시간으로 제공합니다.
    • CCU(concurrent connected users): 실시간 동시 접속자 수
    • MCU(maximum concurrent users): 하루 동안의 최대 동시 접속자 수(실시간과 일자별 조회 제공)
    • DAU(daily active users): 하루 동안 게임을 사용한 순수 이용자 수(실시간과 일자별 조회 제공)
    • NRU(newly registered uesrs): 하루 동안의 신규 사용자 수(실시간과 일자별 조회 제공)
    • 점유율 차트: 게임 이용자의 운영체제별, 국가별, 게임 클라이언트 버전별 점유율을 파이 차트로 제공
    • 동시 접속(동접) 변화 그래프: 하루 동안의 동접 변화량을 그래프로 제공하고 점검과 푸시 메시지 전송에 따른 그래프 변경도 한눈에 확인 가능
  • 권한 있는 여러 프로젝트의 지표를 한눈에 확인할 수 있도록 그룹 지표를 제공합니다.
  • 설치 URL 통계를 제공하여 일자별, 브라우저(Internet Explorer, Chrome등)별, 플랫폼(Windows, Android 등)별 설치 URL 호출 수 및 점유율을 제공합니다.
  • 게임의 매출 통계를 확인할 수 있는 판매 현황 화면을 제공합니다.
    • 월별, 일자별, 스토어별 매출 합계를 제공
    • 원하는 통화(KRW, USD 등)로 변경하여 확인 가능

Reference

Using the other TOAST Service

  • 게임에서 필요한 TOAST 서비스를 보다 쉽게 연동할 수 있도록 돕습니다.
  • Gamebase 사용자 아이디로 각 서비스의 API를 사용할 수 있도록 Gamebase에서 래핑(wrapping)하여 API를 제공합니다. 따라서, 사용자는 별도 서비스의 API를 직접 호출할 필요가 없습니다.
  • Notification > Push : 푸시 메세지를 발송해 주는 통합 푸시 서비스
  • Mobile Service > IAP : 통합 인앱 결제 서비스
  • Game > Leaderboard : 실시간 대용량 랭킹 서비스
  • Security > AppGuard : 실시간으로 애플리케이션의 코드 조작을 방지하는 서비스

Terms

다음은 Gamebase 서비스 용어를 정리한 것입니다.

용어 설명
게임유저 ID Gamebase 내부의 사용자 식별자
디바이스 키 디바이스 식별자(iOS:IDFV, Android:Android ID)
UUID Guest 생성 시 사용되는 단말 식별자로, 앱 삭제 전까지 유지
IdP Identify Provider로 인증 제공자. Facebook, Google, Apple Game Center, PAYCO 등
IdP 토큰 IdP SDK로부터 인증 후 받은 액세스 토큰(access token)
IdP 로그인 외부 IdP 로그인(Facebook, Google 등)


Service Architecture

다음은 Gamebase 서비스 구조도와 간단한 설명입니다. 논리 구성도

컴포넌트명 설명
Gamebase SDK - 클라이언트 개발을 위한 SDK
Gamebase Server - 내부/외부 모듈 간의 매시업 API(mashup API)를 제공하고 내부 로직을 처리
- 클라이언트 초기 실행 시 데이터 제공
- 사용자 구분 키 발급과 관리, 매핑 관리
- 게임별 동시 접속 지표 수집 및 관리
Console - 웹 Console

Platform Guide

Client Developer's Guide

Server Developer's Guide

Operator's Guide


Funtional Guide

Feature Description Client Server Console
Login 게스트, 3rd Party 인증 지원
- 지원되는 IdP: Facebook, Google, Apple Game Center, PAYCO
[Android] [iOS] [Unity] [토큰 검증]
[회원 조회]
[App] > 인증 정보 설정
[Member] > 회원 조회
- 기본 정보, 로그인 이력, 플레이 시간, 결제 이력 등
Logout 로그아웃 [Android] [iOS] [Unity]
Withdraw 게임 탈퇴
- 게임 이용자의 사용자 ID, 매핑 정보 등 모든 정보 삭제
[Android] [iOS] [Unity]
Mapping 하나의 사용자 ID에 여러 개의 IdP를 연동하는 기능 [Android] [iOS] [Unity]
Purchase(IAP) (TOAST 서비스 연동)
인앱 결제
- 지원되는 스토어: Google, App Store
[Android] [iOS] [Unity] [Wrapping API] [Purchase]
- 아이템 등록
- 결제 정보 조회
Push (TOAST 서비스 연동)
푸시 메시지 전송 및 결과 확인
[Android] [iOS] [Unity] [Push]
- 실시간, 예약 푸시 발송
Leaderboard (TOAST 서비스 연동)
실시간 대용량 랭킹 조회 및 등록
[Wrapping API]
Webview SDK에서 기본적인 WebView UI를 제공
시스템 팝업, 토스트(toast) UI 제공
[Android] [iOS] [Unity]
[Operator] Maintenance (운영) 점검 기능 [점검 여부 확인] [Maintenance]
- 점검 등록, 점검 해제
[Operator] Notice (운영) 긴급 공지 기능
- 게임 이용자가 앱을 실행할 때 팝업 형태로 공지 확인 가능
[Notice]
-공지 등록
[Operator] Ban (운영) 게임 이용자의 이용 정지 등록 및 해제
- 게임 이용자의 이용 정지 등록 및 해제
[Android] [iOS] [Unity]
-이용 정지 게임 이용자 정보 확인
[Ban]
-이용 정지 등록 및 해제