- 마지막 업데이트
게임 소식 확인하기
스토브 가입
스토브 로그인
기기등록
게임진입
결제
기타설정
게임해지
스토브 탈퇴서비스 소개
이용자는 게임을 하는 동안에는 화면에 뜨는 팝업으로 새 이벤트와 공지를 확인하고, 게임을 켜지 않은 동안에는 푸시 알림으로 소식을 받아볼 수 있어요. 스토브는 이 두 가지를 모두 지원해요. 팝업과 푸시는 따로 써도 되고, 함께 활용하면 이벤트를 더 효과적으로 알릴 수 있어요.
| 기능 | 역할 | 지원 환경 | 이용자 조건 |
|---|---|---|---|
| 팝업 | 게임 내 이벤트·공지 화면을 SDK 기반 팝업으로 노출 | 모바일, PC | 로그인 후 이용 가능 |
| 푸시 알림 | 이벤트·공지 알림을 이용자 단말기로 전송 | 모바일(Android / iOS / Fire OS) | 푸시 수신 동의한 이용자 |
핵심개념
| 용어 | 설명 |
|---|---|
| 팝업 반복 설정 | 팝업 노출 주기를 일·주(월～일)·개월(1일～말일) 단위로 설정. 특정 날짜 또는 n번째 요일 기준으로 노출 주기 지정 가능 (지정한 날짜가 없는 달은 비노출 처리) |
| FCM / APNS / ADM | Android(FCM) / iOS(APNS) / Fire OS(ADM) 단말기에 푸시를 전달하는 각 플랫폼의 메시징 서비스 |
이용 시나리오
이벤트 팝업 보기
이용자가 게임에 접속하거나 특정 화면에 진입할 때 이벤트·공지 안내 팝업이 노출돼요. 노출 방식에 따라 자동·수동·뉴스·커뮤니티 팝업으로 나뉘며, 게임사가 종류와 노출 시점을 선택해 파트너스에서 등록·관리해요.
| 팝업 종류 | 노출 방식 | 모바일 | PC |
|---|---|---|---|
| 자동 팝업 | 인게임 진입 시 터치 없이 전면 팝업이 순차 노출 이벤트·광고 배너 용도로 게임 로비에서 주로 사용 |
 |
|
| 수동 팝업 | 특정 UI 터치 또는 화면 진입 시 호출 지정 위치(location 1～5)에 노출, 시점은 게임사가 제어 |
|
|
| 뉴스 팝업 | 지정된 UI 클릭 시 호출 공지·이벤트 배너를 한 화면에 모아 노출, 클릭 시 랜딩 URL·커뮤니티로 연결 |
|
|
| 커뮤니티 웹뷰 | 뉴스 팝업 또는 지정 UI 클릭 시 호출 스토브 커뮤니티 홈을 로그인 유지 상태로 노출 (SDK 인터페이스 필수) |
|
|
이건 꼭 알아 두세요
커뮤니티 웹뷰를 일반 URL로 호출하면 로그인이 풀려요. 로그인 상태 유지를 위해 SDK 커뮤니티 인터페이스 사용이 필수예요.
PC 팝업의 "N일 동안 보지 않기"는 로컬 기반으로 동작해요. 동일 계정이라도 다른 PC에서 접속하면 팝업이 다시 노출돼요.
| 항목 | 모바일 (스토브 Mobile SDK) | PC (PCSDK View SDK) |
|---|---|---|
| 팝업 UI 제공 방식 | SDK 내장 WebView로 팝업 UI 직접 제공 | v3.1.0부터 WebView UI 직접 제공 |
| 초기화 조건 | 이용자 로그인 완료 후 팝업 호출 가능 | Base SDK 초기화 완료 후 View SDK 초기화 순서 필수 |
| 팝업 관리 | 파트너스에서 이벤트 화면별 설정 | 파트너스에서 이벤트 화면별 설정 (모든 게임 유형 지원) |
이건 꼭 알아 두세요
PC SDK 팝업 API를 호출하면 기존 팝업 창이 모두 닫힌 후 새 창이 열려요. Base SDK 초기화 전에는 View SDK 기능이 동작하지 않아요.
푸시 알림 받기
이용자는 게임을 실행하지 않은 상태에서도 새 이벤트·공지 소식을 푸시 알림으로 받아볼 수 있어요. 알림을 받을지는 이용자가 직접 선택하며, 게임 내 설정에서 언제든 켜고 끌 수 있어요.
이용자는 수신 동의를 한 경우에만 푸시 알림을 받아요. 동의 시점과 기본 수신 설정은 서비스 국가에 따라 달라요.
| 대상 | 동의 시점 | 수신 설정 |
|---|---|---|
| 대한민국(KR) | 회원 가입 시 약관 동의 단계 | 광고성·야간 푸시 수신 동의(선택) 항목 제공 광고성 동의 시에만 야간 푸시 동의 가능, 게임 내 설정에서 ON/OFF 변경 |
| 글로벌(KR 외) | 가입 시 별도 동의 절차 없음 | 주간·야간 모두 기본 ON 게임 내 설정에서 ON/OFF 변경, 단 야간 푸시 설정 UI는 인게임에 미노출 |
게임사가 푸시를 발송하기 위한 연동 정보예요. 지원 메시징 서비스와 발송 방식을 확인하세요.
| 서비스 | 대상 단말 | 비고 |
|---|---|---|
| FCM | Android | Firebase Cloud Messaging HTTP v1 사용 |
| APNS | iOS | 토큰 인증(TOKEN) 방식 사용 |
| ADM | Fire OS (Amazon) | Amazon Device Messaging |
| 발송 방식 | 설명 |
|---|---|
| 파트너스 발송 | 파트너스에서 즉시·예약·반복(일/주/월) 발송. 로컬타임 발송 지원, 운영팀이 직접 제어 |
| 서버 개별 발송 | 게임 서버에서 특정 회원에게 개별 푸시 발송 API 호출 (API Access Token 필요) |
| 서버 그룹 발송 | 게임 서버에서 특정 게임 또는 마켓 이용자 전체에게 그룹 발송 API 호출 |
이건 꼭 알아 두세요
ㆍ한국에서는 광고성 푸시에 동의한 이용자에게 마지막 동의일로부터 2년마다 재동의 안내를 보내야 해요(「정보통신망법」 제50조). 이 안내는 스토브가 자동으로 발송해요.
ㆍ여러 월드로 운영되는 게임은, 이용자가 마지막으로 접속한 월드 기준으로만 푸시가 전송돼요.
ㆍ푸시는 로그인된 모든 기기에서 받아요. 단, 한 기기에서 여러 계정을 사용한 경우에는 가장 최근에 접속한 계정 기준으로만 발송돼요.
ㆍ로그아웃(원격 로그아웃 포함)하거나 스토브 탈퇴를 신청하면, 해당 기기로는 푸시가 발송되지 않아요.
ㆍ게임을 해지하면, 해지가 완료된 시점부터 해당 게임의 푸시가 더 이상 발송되지 않아요.
연동개요
전체 적용 흐름
| 단계 | 담당 · 활동 | 상세 내용 |
|---|---|---|
| 1단계 | 게임사 기획팀 이벤트 방식 결정 |
팝업 종류·푸시 발송 방식을 결정해 퍼블리싱 기술 담당자에게 전달 |
| 2단계 | 게임사 기획팀 · 퍼블리싱 담당자 파트너스 설정 |
ㆍ파트너스에서 팝업 내용 등록 ㆍ마켓별 푸시 인증 키 등록 (FCM·APNS·ADM) |
| 3단계 | 게임사 개발팀 클라이언트 연동 |
ㆍSDK 팝업 호출 구현 (종류별 호출 위치·시점 설정) ㆍ게임 내 푸시 수신 ON/OFF 설정 화면 구현 (KR은 야간 푸시 포함) |
| 4단계 | 게임사 개발팀 서버 연동 |
서버 API 발송 사용 시 개별·그룹 발송 API 연동 |
| 5단계 | 게임사 QA팀 검증 및 배포 |
체크리스트로 필수·권장 항목 점검 후 Sandbox(샌드박스) → Live 순서로 검증·배포 |
시작 전 결정 항목
팝업·푸시 연동을 시작하기 전, 아래 항목을 게임팀 내부에서 먼저 결정해 주세요.
| 결정 항목 | 선택지 및 내용 | 결정 후 처리 |
|---|---|---|
| ① 사용할 팝업 종류 | 자동/수동 팝업, 뉴스 팝업, 커뮤니티 팝업 중 선택 | 종류 확정 후 파트너스에서 팝업 내용 등록 PC게임은 등록 시 플랫폼 필드에서 'PC게임' 선택 |
| ② 푸시 발송 방식 | 파트너스 발송 : 운영팀이 즉시·예약·반복 발송 (개발 불필요) 서버 API 발송 : 게임 서버에서 이용자·그룹에 직접 발송 두 방식 혼용 가능 |
서버 API 발송 사용 시 퍼블리싱 기술 담당자를 통해 API Access Token 발급 신청 |
| ③ 한국 서비스 여부 확인 | 한국 서비스 시 광고성·야간 푸시 관련 추가 준수 사항 적용 ※ 세부 사항은 역할 분담·체크리스트 참고 |
글로벌 전용 게임이면 야간 푸시 설정 UI를 게임 내에 노출하지 않도록 개발팀에 전달 |
역할 분담
팝업·푸시 연동에서 스토브가 처리하는 영역과 게임사가 직접 구현하는 영역이에요.
스토브 플랫폼이 제공하는 것
게임사가 구현해야 하는 것환경 구분 안내
연동 테스트는 반드시 Sandbox(샌드박스) 환경에서 먼저 진행한 뒤, 검증이 완료된 후 Live 환경에 적용해요.
| 구분 | Sandbox (샌드박스) | Live (운영) |
|---|---|---|
| API Host | https://api.gate8.com | https://api.onstove.com |
| 용도 | 개발·QA 테스트 전용. 실 이용자에게 영향을 주지 않아요. | 실제 서비스 환경. QA 완료 후 배포해요. |
체크리스트
| 구분 | 역할 | 점검항목 |
|---|---|---|
| 필수 | 게임 클라이언트 | SDK 초기화 순서 확인
|
| 필수 | 게임 클라이언트 | 팝업 종류별 정상 노출 확인
|
| 필수 | 게임 클라이언트 | 마켓별 푸시 인증 키 발급 및 파트너스 등록 확인
|
| 필수 | 게임 클라이언트 | 푸시 수신 설정 ON/OFF 제어 구현 확인
|
| 필수 | 게임 클라이언트 | 글로벌 이용자 야간 푸시 UI 미제공 확인
|
| 권장 | 게임 서버 | 서버 직접 발송 API 연동 확인 (서버 발송 사용 시)
|