메인 콘텐츠로 건너뛰기

개요

사일런트 알림을 사용하면 가시적인 메시지를 표시하거나 소리를 재생하지 않고도 앱을 깨우고 백그라운드 작업(예: 동기화 또는 데이터 새로 고침)을 수행할 수 있습니다. iOS에서는 이를 백그라운드 알림이라고 하며, Android에서는 데이터 알림이라고 합니다. 이들을 통칭하여 사일런트 푸시라고 하며, 일반 가시 알림과는 다르게 동작합니다. 이 가이드에서는 지원되는 플랫폼에서 OneSignal을 사용하여 사일런트 알림을 구성하고 전송하는 방법을 설명합니다.

제한 사항

사일런트 알림은 일반 푸시 메시지와 다르게 동작하며 여러 플랫폼별 제한 사항이 있습니다.
  • 앱이 사일런트 푸시를 받을 수 없는 경우:
    • iOS: 앱 전환기에서 스와이프하여 삭제할 때와 같이 사용자가 앱을 닫은 경우. (Apple 지원 참조).
    • Android: 기기 설정을 통해 앱이 강제 종료되었거나 스와이프하여 삭제할 때 일부 제조업체에 의해 자동으로 종료된 경우. (자세한 내용).
  • 전달이 보장되지 않음:
    • Apple과 Google 모두 사일런트 알림을 최선의 노력으로 처리합니다. iOS는 저전력 모드, 백그라운드 앱 새로 고침 꺼짐 또는 사용자가 앱을 닫은 경우 전달을 지연하거나 삭제할 수 있습니다. Android는 Doze 또는 OEM 절전 규칙에 따라 전달을 제한하거나 일괄 처리할 수 있습니다.
    • 따라서 사일런트 알림은 중요한 업데이트에 사용해서는 안 됩니다.
  • 구독된 사용자만: OneSignal SDK는 구독된 구독에만 데이터 알림을 보냅니다. 구독하지 않은 사용자에게 도달하려면 이 해결 방법을 따르세요.
  • 크로스 플랫폼 SDK에 대한 제한된 지원:

OneSignal에서 사일런트 알림 전송

OneSignal에서 사일런트 알림을 전송하려면 다음 단계를 따르세요:
1

가시적인 콘텐츠 생략

메시지에서 가시적인 텍스트나 제목을 제거합니다. 여기에는 다음이 포함됩니다:
  • API: Create notification API 요청의 contents, headings, subtitle.
  • Dashboard: Message, Title, Subtitle
2

content_available 설정

  • API: content_availabletrue로 설정.
  • Dashboard: “Send to Apple iOS”에서 Content available을 선택. 이것은 모든 플랫폼에 적용되며 메시지가 전송되지 않음을 시스템에 알립니다.
3

알림에 데이터 추가

  • API: data 매개변수 사용.
  • Dashboard: Additional Data 필드 사용.

플랫폼별 설정

iOS 백그라운드 알림 설정

백그라운드 알림을 처리하려면 iOS 앱에서 Xcode의 Background Modes > Remote Notifications 기능을 활성화해야 합니다. 이는 모바일 SDK 설정을 따랐다면 일반적으로 포함됩니다. Apple 문서:
사용자가 앱을 닫은 경우(앱 전환기에서 스와이프하여 삭제) iOS는 알림을 전달하지 않습니다.이러한 경우 가시적인 contents 메시지를 포함하고 UNNotificationServiceExtension.didReceive에서 데이터를 처리하세요.

Android 데이터 알림 설정

알림 서비스 확장을 사용하여 Android에서 데이터 알림을 처리합니다. 이를 통해:
  • 앱이 강제 종료되지 않은 경우 알림 처리
  • 알림 표시 또는 억제 방법 사용자 지정

VoIP 알림 전송

VoIP 알림은 지원되지만 표준 OneSignal SDK 외부에서 추가 구성이 필요합니다. OneSignal은 VoIP 토큰을 자동으로 등록하지 않습니다. 설정 지침은 VoIP 알림 설정 가이드를 참조하세요.

FAQ

사일런트 알림을 사용하여 제거 또는 구독 취소를 감지할 수 있나요?

기술적으로는 가능하지만 신뢰할 수 없습니다. 위의 제한 사항 섹션에서 설명한 것처럼 사일런트 알림의 전달은 보장되지 않습니다. 대신:
  • 한 달에 한 번 이상 모든 사용자에게 가시적인 알림(콘텐츠 포함)을 보내세요.
  • 선택적으로 사일런트 알림을 보완 확인으로 보내세요.
구독 상태 변경 처리에 대한 자세한 내용은 구독 가이드를 참조하세요.

확인된 전달이 사일런트 알림과 작동하나요?

확인된 전달은 사일런트 알림과 작동하지 않습니다.