- 대시보드 또는 API에서 캠페인 및 트랜잭션 메시지 전송
- Journeys로 멀티채널 플로우 자동화
- 세그먼트, 필터 또는 사용자 데이터를 사용하여 사용자를 정확하게 타겟팅
- A/B 테스트로 메시지 성능 최적화
- 사용자 속성 및 동적 콘텐츠로 콘텐츠 개인화
- 스택과 연동 — HubSpot, Mixpanel, Amplitude, Zapier 등 다수
푸시 설정
푸시 알림을 보내기 전에 플랫폼 설정을 완료하고, 권한 프롬프트를 구성하고, 필요한 기능을 활성화하세요.플랫폼 설정 가이드
모바일 푸시 설정
iOS, Android, Huawei, Amazon 푸시 알림의 엔드투엔드 설정.
웹 푸시 설정
Chrome, Firefox, Safari, Edge 푸시를 활성화합니다.
모바일 SDK 설정
OneSignal SDK를 모바일 앱에 통합합니다.
웹 SDK 설정
OneSignal SDK를 웹사이트에 통합합니다.
OneSignal로 마이그레이션
Firebase, Airship, Braze 등 다른 제공업체에서 마이그레이션하는 단계.
macOS 앱 지원
macOS 앱에 맞게 OneSignal을 구성합니다.
Windows 앱 지원
Windows 데스크톱 앱에 맞게 OneSignal을 구성합니다.
watchOS 및 Wear OS 지원
Apple Watch 및 Wear OS 기기에 OneSignal을 추가합니다.
권한
잘 설계된 옵트인 경험이 푸시 대상을 극대화합니다.모바일 푸시 프롬프트
모바일 앱의 사전 권한 프롬프트 및 모범 사례를 구축합니다.
웹 푸시 프롬프트
웹 푸시의 프롬프트 타이밍과 메시지를 사용자 지정합니다.
iOS Provisional 푸시
전체 권한을 요청하기 전에 알림 센터에 무음 알림을 전달합니다.
Android 알림 카테고리
Android 사용자가 앱의 알림을 받는 방법을 사용자 지정할 수 있도록 합니다.
기능 및 고급 사용 사례
메시지 개인화
각 사용자를 위해 메시지를 개인화하는 동적 콘텐츠를 추가합니다.
다국어 메시징
각 사용자의 선호 언어로 푸시 알림을 전송합니다.
제한
대규모 대상의 알림 전달 속도를 제어합니다.
빈도 제한
사용자당 푸시 알림 수를 제한합니다.
데이터 및 백그라운드 알림
백그라운드 작업을 위한 데이터 전용 알림을 전송합니다.
VoIP 알림
통화 앱을 위한 VoIP 전용 푸시 알림을 전송합니다.
푸시 알림 전송
여러 가지 방법으로 메시지를 전송할 수 있습니다. 사용 사례에 따라 최적의 방법을 선택하세요.대시보드
대시보드 내에서 빠르게 메시지를 작성합니다.
API로 전송
REST API를 사용하여 프로그래밍 방식으로 메시지를 전송합니다.
Journeys
자동화된 멀티스텝 및 멀티채널 플로우를 구축합니다.
A/B 테스트
최대 10개의 메시지 변형을 테스트하여 성능을 최적화합니다.
대시보드에서 전송
구성 방법 선택
- 처음부터 시작하거나 AI 메시지 작성기를 사용합니다.
- 사전 구축된 템플릿을 사용합니다
전달 일정 및 최적화
타이밍이 푸시 알림 성능에 미치는 영향을 확인하세요.| 옵션 | 설명 | API 필드 |
|---|---|---|
| 즉시 전송 | 지금 모든 수신자에게 전달합니다. | — |
| 예약 | 최대 30일 전에 특정 시간에 전송합니다. | send_after |
| 옵션 | 설명 | API 필드 |
|---|---|---|
| 모두에게 동시에 | 모든 수신자가 동시에 메시지를 받습니다. 긴급 메시지에 가장 적합합니다. | — |
| 지능형 전달 | 각 사용자의 세션 활동을 기반으로 최적의 시간에 전송합니다. | delayed_option: last-active |
| 시간대별 사용자 지정 시간 | 각 사용자의 시간대에 설정된 현지 시간에 전송합니다. | delayed_option: timezone, delivery_time_of_day |
| 제한 재정의 | 제한 속도를 변경합니다. | throttle_rate_per_minute |
| 빈도 제한 재정의 | 이 메시지에 대한 빈도 제한을 비활성화합니다. | enable_frequency_cap |
디자인 속성
푸시 메시지는 사용자 대상 콘텐츠를 표시하거나 백그라운드 작업을 수행할 수 있습니다.- 표시 알림: 메시지가 필요하며 제목, 이미지, 액션 버튼 및 기타 시각적 요소를 포함할 수 있습니다.
- 백그라운드/데이터 전용 알림: 메시지를 생략하고 content_available을 포함하며 선택적으로 추가 데이터를 포함합니다.
제목
알림의 최상단 사용자 지정 가능한 텍스트입니다. 텍스트 모양은 운영 체제에서 제어합니다.- 웹 푸시 및 Huawei에 필요합니다
- 설정되지 않은 경우 웹에서 사이트 이름이 기본값입니다
- 권장 제한: 25–50자(모바일), 60–80자(웹)
- 지원: AI 메시지 작성기, 이모지, 메시지 개인화, 다국어 메시징
- API:
headings
부제목
iOS 및 macOS에서만 지원되는 보조 텍스트입니다(APNs 경유). Android 또는 웹에서는 사용할 수 없습니다.메시지
알림의 주요 콘텐츠입니다. 사용자 지정 글꼴 또는 스타일을 지원하지 않습니다. 스타일은 운영 체제에서 설정합니다.- 백그라운드 알림을 보내지 않는 한 필수입니다
- 지원: AI 메시지 작성기, 이모지, 메시지 개인화, 다국어 메시징
- 권장 제한: ~150자
- API:
contents
아이콘
Android 및 웹에서 작은 아이콘과 큰 아이콘을 사용자 지정합니다. iOS는 항상 앱 아이콘을 사용합니다.- 알림 아이콘을 참조하세요
이미지
Android, iOS 및 Windows/Android용 Chrome의 알림에 큰 이미지를 추가합니다.- 권장 크기:
1024×512px(2:1 가로 세로 비율) - 최대 크기: 1MB, 최대 너비: 2000px
- Safari(macOS/iOS) 또는 macOS 알림 센터에서는 지원되지 않습니다
- 모바일에서 보려면 이미지를 탭하거나 확장해야 합니다
- 지원되는 형식:
PNG,JPG,GIF(iOS에서만 애니메이션) - API:
ios_attachments(iOS),big_picture(Android),chrome_web_image(Chrome 웹) - 이미지 및 리치 미디어를 참조하세요
앱 이름
알림을 표시하는 앱의 이름입니다.- iOS: Xcode의 _Display Name_에서 설정합니다. 업데이트하려면 기기를 다시 시작해야 합니다
- Android/Amazon/Huawei:
AndroidManifest.xml의<application android:label="YOUR APP NAME">에서 설정합니다 - 웹: 사이트 이름 및/또는 브라우저를 표시합니다
기능 속성
액션 버튼
푸시 알림에 대화형 버튼을 추가합니다.- Android 4.1+ 및 iOS 8.0+에서 지원됩니다
- 액션 버튼을 참조하세요
실행 URL
알림을 탭할 때 사용자가 이동하는 위치를 제어합니다.- API:
url(단일 범용 URL),app_url(딥 링크, 예:your-app://screen),web_url(http/https 웹 링크) - URL, 링크 및 딥 링크를 참조하세요
배지
앱 아이콘에 점 또는 배지 번호를 표시합니다.- iOS: 빨간색 숫자 배지, 설정, 증가 또는 지울 수 있습니다. API:
ios_badgeType,ios_badgeCount - Android: 알림 카테고리가 필요합니다
- Huawei: 배지가 숫자 또는 점으로 표시됩니다. API:
huawei_badge_class,huawei_badge_set_num,huawei_badge_add_num - 웹(Chrome/Android): Android 상태 표시줄에 표시되는 아이콘; 72×72 알파 PNG여야 합니다. API:
chrome_web_badge - 배지를 참조하세요
소리
푸시가 전달될 때 소리를 재생합니다.- iOS:
sound로 설정합니다 - Android: 알림 카테고리를 통해 설정합니다
- 웹: 사용할 수 없습니다
추가 데이터
SDK 처리를 위해 페이로드에 사용자 지정 key-value 쌍을 추가합니다.- 모바일 서비스 확장 및 모바일 SDK와 웹 SDK의 클릭 리스너에서 사용됩니다
- 대시보드는 간단한 key-value 데이터만 지원합니다. 중첩된 JSON을 보내려면
data와 함께 API를 사용하세요 - 최대 총 페이로드: ~4KB;
data필드: 최대 2048바이트 - 알림 페이로드 참조를 참조하세요
Collapse ID (모바일 푸시)
동일한collapse_id를 공유하는 경우 이전 알림을 새 알림으로 교체합니다. 최대 길이: 64자. API: collapse_id
예를 들어, 날씨 앱이 세 가지 경보를 전송합니다. 사용자가 세 가지 모두 전송된 후 기기를 열면 마지막 메시지만 표시됩니다.
Web push topic (웹 푸시)
고유한web_push_topic 값을 사용하여 웹에서 이전 알림을 교체하지 않도록 합니다. 다른 주제의 알림은 독립적으로 표시됩니다. 최대 길이: 64자. API: web_push_topic
우선순위
특히 배터리 절약 모드에서 푸시의 긴급성을 설정합니다.Time to live (TTL)
기기가 오프라인인 경우 메시지를 보관하는 기간입니다. 기본값: 3일. 범위: 0 ~ 2,419,200초(28일). API:ttl
사용자가 오프라인이고 TTL이 만료되면 메시지가 삭제됩니다. 지연 전달이 되어서는 안 되는 메시지에는 ttl: 0을 설정하세요.
iOS 제한: APNs는 기기가 오프라인인 동안 가장 최근 알림만 저장합니다. 이전 알림은 삭제됩니다. 자세히 알아보기.
알림 그룹화
기기가 앱에 대한 알림을 4개 이상 받으면 Android 및 iOS가 자동으로 알림을 그룹화합니다.- iOS: API에서
thread_id를 사용하여 메시지를 함께 그룹화합니다. - Android: API에서
android_group을 사용하거나 대시보드에서 “그룹 키”를 설정합니다. 고급 사용자 지정의 경우 Android NotificationExtenderService 및 Android의 그룹 알림 가이드를 참조하세요.
푸시 알림 취소
메시지가 아직 전달되지 않은 경우 메시지를 취소할 수 있습니다. OneSignal은 대기열에 추가되지 않은 모든 구독으로 메시지 전송을 중지합니다. 이미 전달된 경우 기기에서 메시지를 제거하지 않습니다. 메시지 리포트에서 Actions > Cancel을 선택하거나 Cancel Message API를 사용합니다.기기에서 푸시 알림 제거
푸시가 전달되면 Collapse ID 또는 Web push topic을 설정한 경우에만 푸시 알림을 새 알림으로 교체할 수 있습니다. 이 중 하나도 설정하지 않으면 알림을 교체하거나 제거할 수 없습니다.Analytics
메시지 성능과 참여를 추적합니다.푸시 메시지 리포트
메시지 수준의 전달률, 열람률 및 클릭률 리포팅.
Analytics 개요
OneSignal에서 사용 가능한 모든 Analytics 옵션.
Event Streams
실시간으로 푸시 이벤트를 데이터 웨어하우스 또는 BI 도구로 스트리밍합니다.
메시지 보기 API
REST API를 통해 프로그래밍 방식으로 메시지 Analytics를 가져옵니다.
자주 묻는 질문
OneSignal 푸시는 어떤 플랫폼을 지원하나요?
OneSignal은 iOS(APNs), Android(FCM), Huawei(HMS), Amazon(ADM), 웹 브라우저(Chrome, Firefox, Safari, Edge), macOS, Windows에서 푸시를 지원합니다. 위의 플랫폼 설정 가이드를 참조하세요.사용자에게 전송하기 전에 푸시 알림을 테스트하려면 어떻게 해야 하나요?
테스트 구독을 설정하여 실제 사용자에게 영향을 주지 않고 전달, 렌더링 및 딥 링크를 확인합니다. 빠른 테스트를 위해 단일 사용자 세그먼트에 전송할 수도 있습니다.푸시 알림이 표시되지 않는 이유는 무엇인가요?
일반적인 원인으로는 플랫폼 자격 증명 누락 또는 만료, 사용자가 권한을 부여하지 않은 경우, 또는 방해 금지 모드와 같은 기기 수준 설정이 포함됩니다. 전체 문제 해결 체크리스트는 알림이 표시되지 않거나 지연됨을 참조하세요.푸시 알림의 최대 페이로드 크기는 얼마인가요?
모든 플랫폼에서 총 페이로드 크기는 약 4KB입니다.data 필드는 최대 2048바이트를 지원합니다. 이러한 제한을 초과하면 알림이 잘리거나 거부될 수 있습니다.