OneSignal 서비스 대표 이미지
OS · MOBILE PUSH

OneSignal
앱 푸시 연동 안내.

모바일 앱 푸시와 사용자 세그먼트 관리를 제공하는 외부 푸시 플랫폼 연동 안내입니다.

HTTPS · Push API 스마트폰 앱 미연동 · 앱 설정 전
OS · MOBILE PUSH ROUTE PREVIEW
YOU 사용자 기기 Client
NET HTTPS · Push API 연결 중계
WEB 스마트폰 앱 앱 토큰 · 서버 발송
모바일 앱의 푸시 권한·기기 토큰과 서버 발송 API를 제공자별로 구성합니다. PACKET FLOW
앱·푸시 미연동

OneSignal 앱 연동 안내

모바일 앱 푸시와 사용자 세그먼트 관리를 제공하는 외부 푸시 플랫폼 연동 안내입니다.

앱 사용 방법

대시보드에서 앱 프로젝트를 만들고 Android·iOS SDK를 자체 앱에 추가합니다. SDK에서 구독 상태와 사용자 식별자를 연결하고, 먼저 테스트 기기로 발송을 확인한 뒤 서버 API를 통해 권한이 있는 알림만 보냅니다. OneSignal 대시보드는 운영 설정용이며 별도 소비자 앱은 아닙니다.

실제 발송에는 모바일 앱의 SDK 설정, 기기 토큰 등록, 서버 자격 증명과 발송 API 구현이 필요합니다.

IMPLEMENTATION GUIDE

OneSignal 구현 순서

04 IMPLEMENTATION STEPS

모바일 앱 푸시와 사용자 세그먼트 관리를 제공하는 외부 푸시 플랫폼 연동 안내입니다. 이 메뉴는 스마트폰 앱과 서버 사이의 알림 전달 연동을 안내하며, 웹 포털에 모바일 앱이나 발송 기능을 설치하지 않습니다.

시작 전 준비사항

  • OneSignal 앱·플랫폼별 프로젝트 설정
  • iOS APNs 및 Android FCM 자격 증명 구성
  • 앱 SDK 초기화·사용자 구독과 서버 API 연동

구현 및 검증 순서

  1. 앱과 제공자 프로젝트 등록

    공식 콘솔에 iOS·Android 앱을 각각 등록하고 bundle ID/package name, 앱 서명과 개발·운영 환경을 맞춥니다.

  2. 클라이언트 토큰 연동

    앱에서 알림 권한을 요청하고 기기별 푸시 토큰을 서버에 등록합니다. 토큰 갱신, 로그아웃, 앱 삭제와 수신 거부 시 정리 흐름을 구현합니다.

  3. 서버 발송 API 구성

    서버 비밀 설정에 인증 정보를 보관하고 로그인·권한을 확인하는 발송 API를 만듭니다. 대상 사용자와 메시지를 검증하고 키·토큰·개인정보를 로그에 남기지 않습니다.

  4. 단말·수신 상태 검증

    실제 iOS·Android 기기에서 포그라운드·백그라운드·종료 상태를 시험하고 중복 발송, 만료 토큰, 수신 거부와 실패 재시도를 점검합니다.

운영 전 확인 목록

  • 앱별 개발·운영 환경과 bundle ID/package name이 일치하는가
  • 기기 토큰 갱신·철회와 사용자 수신 동의를 처리하는가
  • 발송 자격 증명이 서버에만 있고 실제 기기에서 수신을 검증했는가

REST API 키는 앱에 내장하지 말고 서버에만 보관하세요. 구독·사용자 식별 및 수신 거부 정책을 검토하고 요금·데이터 처리 조건을 확인하세요.