푸시 개요

​

OneSignal Push로 할 수 있는 작업

• 대시보드 또는 API에서 마케팅 캠페인 및 트랜잭션 메시지 전송
• Journey로 자동화된 푸시 및 멀티 채널 흐름 구축
• Segment, 필터 또는 사용자 데이터를 사용하여 사용자를 정확하게 타겟팅
• A/B 테스트 및 최적화 성능
• 사용자 속성 및 Dynamic Content로 메시지 개인화
• HubSpot, Mixpanel, Amplitude, Zapier 등과 같은 CRM 및 도구와 통합 자세히 보기

​

푸시 설정

1. 플랫폼별 설정 (모바일 푸시, 웹 푸시, Android, iOS 등)
2. 권한 프롬프트 구성 (사용자가 푸시 알림을 옵트인할 수 있도록 허용)
3. 기능 및 사용 사례 설정 (개인화, 다국어, 제한 등)

​

권한 프롬프트

​

기능 및 고급 사용 사례

​

Analytics

​

푸시 알림 전송

메시지 채널 선택

• 왼쪽 사이드바에서 + Create… > Push를 선택하거나 오른쪽 상단 모서리에서 New Message > New Push를 선택합니다.
• Messages > Push로 이동하여 이전에 대시보드에서 만든 메시지를 볼 수도 있습니다.

구성 방법 선택

처음부터 시작하거나 사전 구축된 Template을 사용합니다.

이름 및 레이블 설정

• 내부 추적 메타데이터를 추가합니다.
• API 동등: name

타겟팅 대상 설정

메시지를 받을 자격이 있는 사용자입니다. Segment를 포함 및 제외하여 특정 사용자를 타겟팅할 수 있습니다.

• 기본 세그먼트로 전송: 설정되지 않은 경우 기본적으로 모든 “Subscribed Users”로 설정됩니다.
• 특정 세그먼트로 전송: 명시적으로 세그먼트를 포함 및 제외합니다. 여러 세그먼트는 “OR” 관계를 가지며 중복 Subscription은 자동으로 제거됩니다.

타겟팅 방법	대시보드	API
Segment	✅	✅
필터 (API 전용)	❌	✅
Alias (API 전용)	❌	✅

​

일정 및 사용자별 전달

• 예약된 전달: 최대 30일 전에 특정 시간에 전송합니다(API: send_after)
• 지능형 전달: 사용자 행동별로 최적화합니다(API: delayed_option: last-active)
• 시간대 전달: 현지 시간에 전달합니다(API: delayed_option: timezone & delivery_time_of_day)
• 제한: 전달 속도를 제한합니다(API: throttle_rate_per_minute)
• 빈도 제한: 사용자당 메시지를 제한합니다(API: enable_frequency_cap)

​

디자인 속성

• 표시 알림: 메시지가 필요하며 제목, 이미지, 액션 버튼 및 기타 시각적 요소를 포함할 수 있습니다.
• 백그라운드/데이터 전용 알림: 메시지를 생략하고 content_available을 포함하며 선택적으로 추가 데이터를 포함합니다.

​

Title

• 웹 푸시 및 Huawei에 필요합니다
• 설정되지 않은 경우 웹에서 사이트 이름이 기본값입니다
• 권장 제한: 25–50자(모바일), 60–80자(웹)
• 지원: AI 메시지 작성기, 이모지 👍, 메시지 개인화, 다국어 메시징
• API: headings

​

Subtitle

• 권장 제한: 25–50자
• 지원: 이모지 👍, 메시지 개인화, 다국어 메시징
• API: subtitle

​

Message

• 백그라운드 알림을 보내지 않는 한 필수입니다
• 지원: AI 메시지 작성기, 이모지 👍, 메시지 개인화, 다국어 메시징
• 제한: ~150자
• API: contents

​

Icons

• 알림 아이콘을 참조하세요

​

Image

• 모든 플랫폼에 권장되는 크기: 1024×512px(2:1 가로 세로 비율)
• 최대 크기: 1MB, 최대 너비: 2000px
• Safari(macOS/iOS) 또는 macOS Notification Center에서는 지원되지 않습니다
• 모바일에서 보려면 이미지를 탭하거나 확장해야 합니다
• 지원되는 형식: PNG, JPG, GIF(iOS에서만 애니메이션)
• API 매개변수:
  • ios_attachments – iOS
  • big_picture – Android
  • chrome_web_image – Chrome 웹
• 이미지 및 리치 미디어를 참조하세요

​

App name

• iOS: Xcode의 _Display Name_에서 설정합니다. 업데이트하려면 장치를 다시 시작해야 합니다
• Android/Amazon/Huawei: AndroidManifest.xml의 <application android:label="YOUR APP NAME">에서 설정합니다
• 웹: 사이트 이름 및/또는 브라우저를 표시합니다

​

기능 속성

​

Action Buttons

• Android 4.1+ 및 iOS 8.0+에서 지원됩니다
• 액션 버튼을 참조하세요

​

Launch URL

• API 매개변수:
  • url: 단일 범용 URL
  • app_url: 딥 링크(예: your-app://screen)
  • web_url: http 또는 https 웹 링크
• URL, 링크 및 딥 링크를 참조하세요

​

Badges

• 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
  • 예시 아이콘 →
• 배지를 참조하세요

​

Sound

• iOS: sound로 설정합니다
• Android: 알림 카테고리를 통해 설정합니다
• 웹: 사용할 수 없습니다

​

Additional data

• 다음에서 사용:
  • 모바일 서비스 확장
  • 모바일 SDK 및 웹 SDK의 클릭 리스너
• 대시보드는 간단한 key-value 데이터만 지원합니다
• 중첩된 JSON을 보내려면 data와 함께 API를 사용하세요
• 페이로드 크기:
  • 최대 총 크기: ~4KB
  • data 필드: 최대 2048바이트
• OSNotification 페이로드 →

​

Collapse ID (모바일 푸시)

• 최대 길이: 64자
• API: collapse_id

알림 1. 오후 1:41에 전송 — "폭풍이 다가오고 있습니다. 우산을 챙기세요!"
알림 2. 오후 2:20에 전송 — "폭풍이 가라앉고 있습니다. 맑은 날씨가 예상됩니다."
알림 3. 오후 2:44에 전송 — "폭풍이 지나갔습니다. 햇빛을 즐기세요!"

​

Web push topic (웹 푸시)

• 최대 길이: 64자
• API: web_push_topic

알림 1. web_push_topic: "breaking-news"   → 알림 1
알림 2. web_push_topic: "breaking-news"   → 알림 2(#1 교체)
알림 3. web_push_topic: "sports"          → 알림 3(표시 유지)
알림 4. web_push_topic: "weather"         → 알림 4(표시 유지)

​

Priority

• High(권장): 즉시, 알림 기반 메시지
• Normal: 백그라운드/데이터 알림에 사용됩니다

• APNs apns-priority
• FCM priority

​

Time to live (TTL)

• 기본값: 3일
• 범위: 0 ~ 2,419,200초(28일)
• API: ttl

​

알림 그룹화

• 동일한 값으로 thread_id REST API 속성을 사용하여 메시지를 함께 그룹화합니다.

• 동일한 값으로 android_group REST API 속성을 사용하여 메시지를 함께 그룹화합니다.
• Android “Group Key”는 대시보드에서 푸시 메시지를 보낼 때도 설정할 수 있습니다.

​

푸시 알림 취소

​

장치에서 푸시 알림 제거