푸시 알림
Firebase Cloud Messaging (FCM)을 통해 앱 사용자에게 푸시 알림을 발송하세요.
Last updated: 2026-05-18
Opseer는 Firebase Cloud Messaging (FCM)과 연동하여 대시보드에서 직접 모바일 또는 웹 앱 사용자에게 푸시 알림을 발송할 수 있습니다. 토픽 메시징, CSV 토큰 타겟팅, 예약 발송을 지원합니다.
사전 준비
- Firebase 연동 완료 (서비스 계정 키)
- 앱에서 FCM 클라이언트 SDK를 구현하고 토픽 구독 또는 토큰 등록 완료
발송 방법
토픽 메시징
특정 FCM 토픽을 구독한 모든 기기에 알림을 발송합니다. 전체 사용자 또는 특정 세그먼트에 공지를 방송하는 가장 일반적인 방법입니다.
푸시 이동
프로젝트 사이드바에서 푸시를 클릭합니다.
"토픽" 발송 모드 선택
발송 모드에서 토픽을 선택합니다.
토픽 지정
all / ios / android 기본 토픽 중에서 선택하거나, "커스텀 토픽"을 선택해 앱에서 사용하는 토픽 이름을 직접 입력합니다.
메시지 작성
알림 제목과 본문을 입력합니다. 선택적으로 데이터 페이로드 (JSON 키-값 쌍)를 추가할 수 있습니다.
발송
"지금 보내기"를 클릭하여 즉시 발송합니다.
기본 토픽(all / ios / android) 외의 커스텀 토픽은 Starter / Plus / Max 플랜이 필요합니다.
예약 푸시
미래의 특정 날짜와 시간에 알림을 발송하도록 예약합니다. 제품 출시, 이벤트 알림, 시간에 민감한 공지에 유용합니다.
- 유료 플랜 필요 (Starter / Plus / Max)
- 타임존 기준으로 발송 날짜와 시간 설정
- Opseer가 예약된 푸시를 저장하고 정확한 시간에 발송
- 푸시 이력에서 예약된 푸시를 조회하고 취소 가능
예약 푸시는 매분 처리되므로, 예약 시간으로부터 최대 60초의 지연이 있을 수 있습니다.
타겟 푸시 (CSV 업로드)
CSV 파일을 업로드하여 특정 기기 토큰 집합에 알림을 발송합니다. 특정 사용자 세그먼트를 대상으로 하는 리인게이지먼트 캠페인에 적합합니다.
CSV 준비
FCM 토큰이 포함된 컬럼이 있는 CSV 파일을 생성합니다. 컬럼 헤더는 "token"이어야 합니다.
Opseer에서 업로드
푸시 페이지에서 "타겟" 발송 유형을 선택하고 CSV 파일을 업로드합니다.
작성 및 발송
알림 제목과 본문을 작성한 후 발송을 클릭합니다.
플랜별 토큰 한도 (1회 발송 / 일):
- Free — 사용 불가
- Starter ($9/월) — 1회 1,000 / 일 5,000 토큰
- Plus ($24/월) — 1회 5,000 / 일 50,000 토큰
- Max ($49/월) — 1회 50,000 / 일 1,000,000 토큰
일 한도는 발송 완료된 토큰 + 예약 중인 토큰 합산으로 계산됩니다. 예약을 등록만 하고 취소하면 자동으로 한도가 회복됩니다.
메시지 형식
각 푸시 알림은 다음으로 구성됩니다:
- 제목 — 알림 제목 (눈에 띄게 표시)
- 본문 — 알림 본문 텍스트
- 데이터 (선택) — 앱에 전달되지만 알림 자체에는 표시되지 않는 커스텀 키-값 쌍. 앱에서 이 데이터를 처리하여 특정 동작을 트리거할 수 있습니다.
권한
푸시 알림 발송에는 push:send 권한이 필요합니다. 기본적으로 Owner와 Admin 역할만 이 권한을 가집니다. Member 역할은 권한 오버라이드를 통해 명시적으로 push:send를 부여받아야 합니다.