Game > Gamebase > 콘솔 사용 가이드 > 푸시

앱 이용자에게 푸시 알림을 발송할 수 있습니다.

Gamebase에서는 TOAST Push 서비스를 사용해 푸시 알림을 발송합니다.

Push

[중요]

서비스 중인 게임에서 Gamebase SDK 2.6.0 이상 버전을 적용한 경우에 사용하는 메뉴입니다.

푸시를 발송한 이력과 등록된 푸시 예약 목록을 확인할 수 있습니다.

gamebase_push_01_201910

Registered List

예약 목록에서 푸시를 선택하면 푸시의 예상 발송 시간 및 등록 정보들을 확인하고, 전송 취소 버튼을 클릭하여 예약 발송건을 취소하거나 복사 버튼을 클릭하여 등록된 푸시의 등록 정보를 이용하여 푸시를 신규로 등록 할 수 있습니다.

Send History

발송 이력 목록에서 푸시를 선택하면 전송된 푸시의 상세 내역을 조회할 수 있습니다. 복사 버튼을 클릭하면 발송된 푸시의 등록 정보를 이용해 손쉽게 푸시를 등록할 수 있습니다.

gamebase_push_02_201910 gamebase_push_03_201910

Register Push

새로운 푸시를 등록하려면 등록 버튼을 클릭합니다. 콘솔에 등록한 값이 실제 단말기에서 어떻게 보여질지 오른쪽의 미리보기 UI를 통하여 확인할 수 있습니다.

gamebase_push_04_201910 gamebase_push_05_201910

(1) 발송 타입

발송 주기를 선택합니다. - 즉시 발송: 등록 즉시 푸시 메시지를 발송합니다. - 예약 발송: 예약한 시간에 푸시 메시지를 발송합니다. 사용자의 단말기 국가 시간 기준으로 푸시 메시지를 발송하고자 하는 경우 현지 시간 기준으로 발송을 선택합니다. 현지 시간 기준으로 발송을 선택하고 '2017-01-01 09:00'로 설정하면, 한국 단말기를 사용하는 사용자는 한국 시간 '2017-01-01 09:00'에, 영국 단말기를 사용하는 사용자는 영국 시간 '2017-01-01 09:00'에 푸시 메시지를 수신합니다. - 반복 발송: 동일한 푸시를 주기적으로 발송합니다. 사용자의 단말기 국가 시간 기준으로 푸시 메시지를 발송하고자 하는 경우 현지 시간 기준으로 발송을 선택합니다. 발송하고자 하는 기간을 선택한 후 해당 기간동안 발송하고자 하는 시각을 선택합니다. 그 후 선택한 발송기간동안 발송할 주기를 매일, 매주, 매월 기준으로 정보를 입력합니다. - 매일 : 매일 푸시를 발송합니다. - 매주 : 발송하고자 하는 요일을 선택하여 특정 요일에만 푸시를 발송합니다. 요일은 중복으로 선택할 수 있습니다. - 매월 : 한달을 기준으로 원하는 일자에 푸시를 발송합니다. 일자(1 ~ 31)만 입력 가능하며 한 개 또는 그 이상의 일자를 입력할 수 있습니다. 예를 들어 1일, 5일, 10일 발송을 원하는 경우 1, 5, 10을 입력하면 해당 일자에 푸시가 전송됩니다.

(2) 발송 대상

푸시 메시지를 발송할 대상을 선택합니다. - 전체 발송: 운영체제별로 선택할 수 있습니다. 선택한 운영체제를 사용하는 사용자는 모두 푸시를 수신하게 됩니다. - 특정 회원에게만 발송: 특정 회원에게만 푸시 메시지를 발송하고자 할 때 선택합니다. 입력된 사용자 ID로 푸시 토큰을 등록한 단말기에 푸시 메시지를 발송합니다. 대상 사용자가 5개의 단말기로 게임을 하는 경우 5개의 단말기로 푸시를 발송합니다. - 그룹 발송: 메시지 발송을 원하는 사용자 목록을 파일로 등록합니다. 그룹 발송은 1회 최대 10,000명까지 가능합니다. - 태그 발송: 태그를 이용하여 푸시를 발송할 수 있습니다. 푸시 - 태그 메뉴에서 등록된 태그로 발송이 가능하며 여러개의 태그 등록도 가능합니다. 태그 필터는 아래와 같은 기능을 지원합니다. - AND : 선택한 태그를 모두 만족하는 유저에게만 푸시를 발송합니다. - OR : 선택한 태그 중 하나라도 조건을 만족하는 유저에게 푸시를 발송합니다.

(3) 대상 국가

푸시 메시지를 발송할 국가를 선택합니다. - 전체 국가: 모든 사용자에게 푸시 메시지를 발송합니다. - 일부 국가: 선택한 국가의 사용자에게만 푸시 메시지를 발송합니다. 추가하고자 하는 국가명을 입력하면 자동으로 완성되어 입력됩니다. 입력하고자 하는 국가가 없는 경우 고객 센터로 연락 주시기 바랍니다.

[참고]

국가 판단 기준 사용자의 USIM 국가 코드를 기준으로 판단하며 USIM이 없을 경우 단말기에 설정되어 있는 국가를 기준으로 푸시 메시지가 표시됩니다.

(4) 알림음(선택항목)

단말기에서 푸시를 수신할 때 재생되는 알림음을 설정할 수 있습니다. 알림음 추가버튼을 누르면 알림음을 설정할 수 있으며 설정을 하지 않으면 디폴트 알림음이 재생이 됩니다. 외부 URL링크 또는 앱 내 배포된 알림음 파일경로를 입력합니다.

(5) 메시지 타입

[참고]

한국의 '정보통신망법'을 준수하기 위해 제공되는 기능입니다. 푸시 발송 시 정보성 메시지가 아닌 경우에는 '(광고)'로 메시지를 시작해야 하며 메시지에 연락처와 수신 철회 방법이 포함돼 있어야 합니다.

  • 홍보성: 입력된 메시지에 '(광고)'라는 머리말이 추가됩니다. 또한 추가로 입력한 연락처와 수신 철회 방법이 함께 발송됩니다. 전체 발송과 같은 광고성 푸시의 경우 국내에서는 정보통신망법 준수를 위하여 꼭 '홍보성' 메시지로 발송하셔야 합니다.
  • 정보성: 입력된 메시지만 푸시로 발송됩니다. 한국 단말기가 아닌(USIM 국가 코드가 한국이 아닌) 사용자에게는 정보성 메시지로 전송하시면 됩니다.

[중요]

홍보성을 선택한 후 입력 메시지에 '(광고)' 문구를 입력하면 '(광고)' 문구가 중복되므로 주의하세요.

(6) 발송 메시지

사용자에게 표시할 푸시 메시지를 입력합니다.

메시지는 여러 개 언어로 등록할 수 있으며, 입력한 언어 이외의 언어를 사용하는 사용자에게는 기본 언어로 선택된 언어로 표시됩니다. 언어를 추가하려면 하단의 메시지 추가 버튼을 클릭합니다. 목록에 없는 언어를 추가하려면 고객 센터로 연락 주시기 바랍니다.

[참고]

푸시 메시지를 발송했는데 단말기에 메시지가 오지 않는 경우 대부분의 경우 사용자의 푸시 토큰을 등록하지 않은 경우입니다. 사용자의 푸시 토큰이 등록되었는지 확인해주세요. 플랫폼에서 푸시 토큰을 등록하는 방법은 다음 문서를 참고하시기 바랍니다.

(7) 메시지 글자색(Only Android)

Android의 경우에는 단말기에 노출 되는 푸시 메시지의 글자색을 지정할 수 있습니다. 제목과 내용의 색을 각각 지정할 수 있으며 글자색 선택창에서 색을 선택하거나 RGB Hex값을 직접 입력하여 색을 지정할 수 있습니다. 선택된 글자색은 오른쪽의 미리보기 화면을 통하여 확인이 가능합니다.

(8) 큰 아이콘(Only Android)

큰 아이콘 추가버튼을 누르면 푸시 수신시에 오른쪽에 표시 될 아이콘의 이미지를 설정할 수 있습니다. 큰 아이콘 이미지를 설정하고 푸시를 전송하면 Android 단말기에서만 이미지가 노출되고 iOS에서는 보여지지 않습니다. 외부를 선택하고 표시할 아이콘 이미지의 외부 URL을 입력하거나 내부를 선택하여 앱 내에 배포한 아이콘 이미지 파일 경로를 입력합니다. 외부이미지인 경우 오른쪽 미리보기에서 해당 아이콘을 미리 확인할 수 있습니다.

(9) 버튼

푸시 수신시의 메시지 하단에 노출되는 버튼을 최대 3개까지 설정하여 함께 보낼 수 있습니다. 4가지 형태의 버튼이 있으며 유형별로 동작 방식과 설정하는 값이 서로 다르니 아래 가이드를 참고하여 설정하시기 바랍니다. - 앱 열기 : 푸시 메시지에서 버튼을 클릭하면 해당 앱을 실행합니다. 버튼 이름만 지정 가능합니다. - URL 열기 : 푸시 메시지에서 버튼을 클릭하면 콘솔에서 입력한 URL로 이동합니다. 앱 스키마를 통한 특정 앱을 실행하거나 웹페이지를 연결할 수 있습니다. - 응답 : 푸시 메시지에서 버튼을 클릭하면 응답을 할 수 있는 창이 실행됩니다. iOS의 경우 전송버튼 이름을 함께 설정할 수 있습니다. - 닫기 : 푸시 메시지에서 버튼을 클릭하면 푸시가 닫힙니다. 버튼 이름만 지정 가능합니다.

(10) 미디어(iOS)

iOS 푸시 수신시에 동적으로 실행되는 미디어를 추가할 수 있습니다. IMAGE, GIF, VIDEO, AUDIO 항목을 설정할 수 있으며 연결하고자 하는 외부 URL 또는 내부 파일경로를 입력할 수 있습니다.

(10) 미디어(Android)

Android 푸시 수신시에 실행되는 미디어를 추가할 수 있습니다. 현재 Android에서는 IMAGE 항목만 설정할 수 있으며 연결하고자 하는 외부 URL 또는 내부 파일경로를 입력할 수 있습니다.

Push(Old)

[중요]

서비스 중인 게임에서 Gamebase SDK 2.5.3 이하 버전을 적용한 경우에 사용하는 메뉴입니다.

Gamebase를 통해 발송된 푸시의 이력과 발송 예약으로 등록된 목록을 확인할 수 있습니다.

gamebase_push_01_201812

발송 예정 내역에 있는 목록은 Push Details에서 전송을 취소할 수도 있습니다.

Registered List

예약 발송 목록에서 푸시를 선택하면 푸시의 예상 발송 시간 및 등록 정보들을 확인할 수 있습니다. 현재는 예약 발송의 취소만 가능하며 등록된 정보를 수정하는 기능은 추후 제공될 예정입니다.

Send History

발송 이력 목록에서 푸시를 선택하면 전송된 푸시의 상세 내역을 조회할 수 있습니다. 복사 버튼을 클릭하면 발송된 푸시의 등록 정보를 이용해 손쉽게 푸시를 등록할 수 있습니다. gamebase_push_02_201812

Register Push

새로운 푸시를 등록하려면 등록 버튼을 클릭합니다.

gamebase_push_03_201812

(1) 메시지 타입

[참고]

한국의 '정보통신망법'을 준수하기 위해 제공되는 기능입니다. 푸시 발송 시 정보성 메시지가 아닌 경우에는 '(광고)'로 메시지를 시작해야 하며 메시지에 연락처와 수신 철회 방법이 포함돼 있어야 합니다.

  • 홍보성: 입력된 메시지에 '(광고)'라는 머리말이 추가됩니다. 또한 추가로 입력한 연락처와 수신 철회 방법이 함께 발송됩니다. 전체 발송과 같은 광고성 푸시의 경우 국내에서는 정보통신망법 준수를 위하여 꼭 '홍보성' 메시지로 발송하셔야 합니다.
  • 정보성: 입력된 메시지만 푸시로 발송됩니다. 한국 단말기가 아닌(USIM 국가 코드가 한국이 아닌) 사용자에게는 정보성 메시지로 전송하시면 됩니다.

[중요]

홍보성을 선택한 후 입력 메시지에 '(광고)' 문구를 입력하면 '(광고)' 문구가 중복되므로 주의하세요.

(2) 발송 대상

푸시 메시지를 발송할 대상을 선택합니다.

  • 전체 발송: 운영체제별로 선택할 수 있습니다. 선택한 운영체제를 사용하는 사용자는 모두 푸시를 수신하게 됩니다.

  • 특정 회원에게만 발송: 특정 회원에게만 푸시 메시지를 발송하고자 할 때 선택합니다. 입력된 사용자 ID로 푸시 토큰을 등록한 단말기에 푸시 메시지를 발송합니다.

  • 그룹 발송: 메시지 발송을 원하는 사용자 목록을 파일로 등록합니다. 그룹 발송은 1회 최대 10,000명까지 가능합니다.

(3) 발송 유형

발송 주기를 선택합니다.

  • 즉시 발송: 등록 즉시 푸시 메시지를 발송합니다.

  • 예약 발송: 예약한 시간에 푸시 메시지를 발송합니다. 사용자의 단말기 국가 시간 기준으로 푸시 메시지를 발송하고자 하는 경우 현지 시간 기준으로 발송을 선택합니다. 현지 시간 기준으로 발송을 선택하고 '2017-01-01 09:00'로 설정하면, 한국 단말기를 사용하는 사용자는 한국 시간 '2017-01-01 09:00'에, 영국 단말기를 사용하는 사용자는 영국 시간 '2017-01-01 09:00'에 푸시 메시지를 수신합니다.

추후 예약 발송에 반복 발송(매일, 매주, 매달) 기능이 추가로 제공될 예정입니다.

(4) 대상 국가

푸시 메시지를 발송할 국가를 선택합니다.

  • 전체 국가: 모든 사용자에게 푸시 메시지를 발송합니다.

  • 일부 국가: 선택한 국가의 사용자에게만 푸시 메시지를 발송합니다.

추가하고자 하는 국가명을 입력하면 자동으로 완성되어 입력됩니다. 입력하고자 하는 국가가 없는 경우 고객 센터로 연락 주시기 바랍니다.

[참고]

국가 판단 기준

사용자의 USIM 국가 코드를 기준으로 판단하며 USIM이 없을 경우 단말기에 설정되어 있는 국가를 기준으로 푸시 메시지가 표시됩니다.

(5) 발송 메시지

사용자에게 표시할 푸시 메시지를 입력합니다.

메시지는 여러 개 언어로 등록할 수 있으며, 입력한 언어 이외의 언어를 사용하는 사용자에게는 기본 언어로 선택된 언어로 표시됩니다. 언어를 추가하려면 오른쪽의 '+' 버튼을 클릭합니다. 목록에 없는 언어를 추가하려면 고객 센터로 연락 주시기 바랍니다.

[참고]

푸시 메시지를 발송했는데 단말기에 메시지가 오지 않는 경우

대부분의 경우 사용자의 푸시 토큰을 등록하지 않은 경우입니다. 사용자의 푸시 토큰이 등록되었는지 확인해주세요. >

플랫폼에서 푸시 토큰을 등록하는 방법은 다음 문서를 참고하시기 바랍니다.

Tag

유저를 특정 기준으로 묶어서 전송할 수 있는 태그 기능을 제공합니다.

gamebase_push_01_201812

TOAST Push에서 푸시 발송시 사용할 태그명을 등록할 수 있습니다.

Tag register

gamebase_push_01_201812

Tag detail

등록된 태그의 관리 및 해당 태그에 등록된 유저의 목록을 관리할 수 있습니다.

gamebase_push_01_201812

상단의 삭제/수정 버튼을 통해 태그에 대한 정보 수정 및 삭제를 진행할 수 있으며 하단의 유저ID 관리 기능을 통해 태그에 유저를 등록하거나 삭제할 수 있습니다.

유저 등록

단건 등록

gamebase_push_01_201812

파일 등록

gamebase_push_01_201812

등록버튼을 누르면 위와같이 등록 팝업이 노출되며 직접 ID를 입력하거나 파일 등록을 통해 입력 가능합니다.

파일등록을 이용해 등록하고자 할 경우 한 번에 최대 1000명까지 등록 가능합니다.

유저 삭제

gamebase_push_01_201812

삭제를 하고자 할 경우 유저목록에서 왼쪽의 체크박스를 선택한 후 삭제버튼을 누르면 태그에 등록된 유저를 삭제할 수 있습니다.

TOP