푸시 알림
푸시 알림은 앱이 실행 중이 아닐 때도 사용자 디바이스에 메시지를 전달하는 기능입니다. 앱은 디바이스 토큰을 Hive Axyl 서버에 등록해 발송 대상 정보를 확보하고, 운영자는 등록된 토큰을 대상으로 공지·이벤트·마케팅 메시지를 발송합니다.
이 문서는 Unity 앱 클라이언트에서 푸시 알림 기능을 구현하는 방법을 안내합니다.
제공하는 기능
푸시 알림이 제공하는 기능은 아래와 같습니다.
디바이스 토큰 등록과 관리
디바이스 토큰은 푸시 메시지를 받을 디바이스를 식별하는 값으로, FCM(Firebase Cloud Messaging) 같은 OS 푸시 서비스가 발급합니다. 앱은 OS 푸시 서비스에서 발급받은 토큰을 Hive Axyl 서버에 등록합니다. 등록한 토큰의 언어와 수신 동의는 필요할 때 변경하고, 로그아웃 등으로 더 이상 사용자 대상 알림을 받지 않아야 할 때는 사용자 연결을 해제합니다.
수신 동의
수신 동의는 정보성 알림, 광고성 알림, 야간 광고성 알림 세 가지 항목으로 나뉘며 토큰 단위로 관리합니다. 토큰을 등록할 때 세 항목의 동의 값을 함께 전달하고, 사용자가 설정을 바꾸면 수신 동의 변경으로 갱신합니다.
푸시 발송
푸시 메시지 발송은 Hive 콘솔 또는 서버 API로 수행하며, 앱 클라이언트는 발송 주체가 아닙니다. 서버 발송 API는 Hive Axyl Push 서버 API를 참고하세요.
푸시 수신 처리
앱이 실행 중일 때 도착한 메시지를 처리하는 방법과, 사용자가 알림을 탭해 앱이 실행된 경우(콜드 스타트)를 처리하는 방법은 Android는 푸시 수신 처리(Android), iOS는 푸시 수신 처리(iOS)에서 안내합니다.
구현 순서
- 푸시 모듈을 설치하고 초기화합니다.
- OS별 연동 환경을 구성합니다 — Android는 FCM, iOS는 APNs.
- OS 푸시 서비스에서 디바이스 토큰을 발급받습니다 — Android는 FCM 토큰 발급, iOS는 APNs 토큰 발급.
- 발급받은 토큰을 Hive Axyl 서버에 등록합니다. iOS는 APNs 토큰 발급에서 확인한 푸시 환경 값을 함께 사용합니다.
- 도착한 메시지를 처리합니다 — Android는 푸시 수신 처리(Android), iOS는 푸시 수신 처리(iOS).
- 사용자가 설정을 바꾸거나 로그아웃하면 토큰 설정을 변경합니다.