푸시 알림이 가장 높은 참여를 유도하는 이유
- 대시보드 또는 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개의 메시지 변형을 테스트하여 성능을 최적화합니다.
대시보드에서 전송
메시지 채널 선택
만들기… 를 선택한 후 메시지 채널을 선택합니다. 메시지 또는 템플릿으로 이동하여 이전 메시지를 볼 수도 있습니다.
OneSignal 대시보드에서 새 메시지를 만듭니다.
구성 방법 선택
- 처음부터 시작하거나 AI 메시지 작성기를 사용합니다.
- 사전 구축된 템플릿을 사용합니다
이름 및 레이블 설정
추적 및 보고를 위한 내부 메타데이터를 추가합니다. API 동등:
name대상 선택
메시지를 받을 사용자를 선택합니다. 세그먼트를 포함 및 제외하여 특정 그룹을 타겟팅할 수 있습니다. 세그먼트가 설정되지 않은 경우 기본적으로 모든 “구독된 사용자”로 설정됩니다.
대시보드의 이름, 레이블 및 대상 세그먼트 선택.
전달 일정 및 최적화
타이밍이 푸시 알림 성능에 미치는 영향을 확인하세요.타이밍이 전부입니다: 액션을 유도하는 푸시 알림을 보내는 방법
사용자별 전달 시간:
대상의 각 사용자가 메시지를 수신할 시간을 설정합니다.
전달 재정의:
이 메시지에 한해 앱 수준의 전달 기본값을 재정의합니다.
지능형 전달 또는 시간대별 사용자 지정 시간을 사용하면 대상의 모든 레코드가 메시지를 받을 수 있도록 전달이 24시간에 걸쳐 진행됩니다. 현지 시간 오전 9시 메시지가 전송될 때 수신자가 이미 오전 10시라면 다음 날 오전 9시에 메시지를 받습니다.
디자인 속성
푸시 메시지는 사용자 대상 콘텐츠를 표시하거나 백그라운드 작업을 수행할 수 있습니다.- 표시 알림: 메시지가 필요하며 제목, 이미지, 액션 버튼 및 기타 시각적 요소를 포함할 수 있습니다.
- 백그라운드/데이터 전용 알림:
headings와contents를 생략하고, iOS와 Android 모두에서content_available을true로 설정하며, 선택적으로 추가 데이터를 포함합니다.
웹 및 모바일 푸시 알림의 구조
제목
알림의 최상단 사용자 지정 가능한 텍스트입니다. 텍스트 모양은 운영 체제에서 제어합니다.- 웹 푸시 및 Huawei에 필요합니다
- 설정되지 않은 경우 웹에서 사이트 이름이 기본값입니다
- 권장 제한: 25–50자(모바일), 60–80자(웹)
- 지원: AI 메시지 작성기, 이모지, 메시지 개인화, 다국어 메시징
- API:
headings
푸시 플랫폼(Android, iOS, Huawei, Amazon)은 제목이나 메시지를 고정된 글자 수에서 자르지 않습니다. 텍스트가 잘리는 위치는 기기, 화면 방향 및 사용자의 시스템 텍스트 크기(접근성 모드)에 따라 달라집니다. Android에서는 런처와 제조사에 따라서도 다릅니다.OneSignal과 전달 서비스(APNs, FCM 등)는 알림을 전송할 뿐 기기가 알림을 렌더링하는 방식은 제어하지 않으므로, 어떤 API나 페이로드 옵션으로도 잘림을 재정의할 수 없습니다. 동일한 텍스트가 한 기기에서는 전부 표시되고 다른 기기에서는 잘릴 수 있습니다.
부제목
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 - 웹(Android의 Chrome): Android 기기의 Chrome 웹 알림에 표시되는 단색 상태 표시줄 아이콘입니다. 앱 아이콘 배지가 아닙니다. 권장: 정사각형 PNG,
96×96(최소72×72). API:chrome_web_badge. 알림 아이콘을 참조하세요 - 배지를 참조하세요
소리
푸시가 전달될 때 소리를 재생합니다.- iOS:
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
우선순위
특히 배터리 절약 모드에서 푸시의 긴급성을 설정합니다.- High(
10, 기본값이며 권장): 즉시 표시되는 알림 기반 메시지. - Normal(
5): 백그라운드 및 데이터 전용 알림에 권장됩니다. - API:
priority - 플랫폼 문서: APNs 우선순위, FCM 우선순위
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 알림 서비스 확장 및 Android의 그룹 알림 가이드를 참조하세요.
Android에서 그룹화된 알림.
Huawei 메시지 유형 (Huawei)
OneSignal이 Huawei(HMS) 기기에 푸시를 전달하는 방식을 제어합니다. API:huawei_msg_type
data: OneSignal SDK가 클라이언트 측에서 알림을 렌더링하여 전체 기능 세트(큰 이미지, 액션 버튼)와 확인된 전달을 사용할 수 있습니다. 앱이 강제 종료된 경우 표시되지 않습니다.message(기본값): HMS Core가 서버 측에서 렌더링합니다. 제목과 본문만 표시되지만 앱이 강제 종료되어도 표시됩니다.huawei_msg_type및 데이터 및 백그라운드 알림을 참조하세요.
huawei_msg_type=data는 HMS 전송 유형이며 무음 알림이 아닙니다. 표시 가능한 콘텐츠가 있는 data 유형 푸시는 여전히 전체 알림을 표시합니다.푸시 알림 취소
메시지가 아직 전달되지 않은 경우 메시지를 취소할 수 있습니다. 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바이트를 지원합니다. 이러한 제한을 초과하면 알림이 잘리거나 거부될 수 있습니다.
이는 화면에 표시되는 제목/본문 잘림과는 다릅니다. 페이로드 크기는 전달 전에 APNs/FCM이 적용하는 엄격한 제한입니다. 제목과 본문의 표시 잘림은 전달 후 기기에서 발생하며 운영 체제 렌더링에 따라 달라집니다. 위의 제목을 참조하세요.