Skip to main content
고급 섹션에서는 특정 요구 사항 또는 사용자 지정 구현이 있는 고객을 위한 특수 구성 및 알림 동작을 다룹니다.

웹 푸시 웹훅

OneSignal은 알림 이벤트를 처리하기 위한 전용 웹 푸시 웹훅을 제공합니다. 전체 구현 세부 정보는 웹 푸시 웹훅을 참조하세요. 중요: 웹 푸시 웹훅은 이벤트 웹훅과는 별도의 구현이며 상호 교환하여 사용할 수 없습니다.

Service Worker 구성

OneSignal은 기본적으로 루트 범위에서 Service Worker를 자동으로 확인합니다. 그러나 더 나은 보안과 기존 Service Worker와의 충돌을 방지하기 위해 루트가 아닌 범위를 사용하도록 통합을 사용자 지정하는 것을 강력히 권장합니다. 사용자 지정 범위 구성을 구현하려면 OneSignal Service Worker 설정 가이드를 따르세요. 루트가 아닌 범위를 사용하는 이유는 무엇인가요?
  • 기존 Service Worker와의 충돌 방지
  • OneSignal의 범위를 제한하여 보안 향상
  • 사이트의 Service Worker 아키텍처에 대한 더 나은 제어 제공

로컬 개발 및 테스트

개발 및 테스트 목적으로는 다음을 다루는 포괄적인 로컬 테스트 가이드를 참조하세요:
  • localhost 환경 설정
  • SSL 인증서 없이 알림 테스트
  • 일반적인 개발 문제 디버깅

알림 클릭 동작

OneSignal은 사용자가 알림을 클릭할 때 여러 브라우저 동작을 지원합니다. 고급 URL 처리 및 클릭 작업을 완전히 비활성화하는 옵션은 딥링크 및 URL을 참조하세요.

기본 동작

사용자가 알림을 클릭하고 사이트가 열려 있지 않은 경우 브라우저가 새 탭을 열고 알림의 URL로 이동합니다.

사이트가 이미 열려 있는 경우

사용자가 하나 이상의 브라우저 탭에서 사이트를 열어둔 경우 브라우저가 응답하는 방식을 구성할 수 있습니다: 정확한 탐색 (기본값)
  • 알림의 정확한 URL(예: example.com/product)을 열려 있는 탭과 일치시킵니다
  • 일치하는 탭에서 알림의 URL로 이동합니다
  • 특정 페이지 타겟팅에 가장 적합
원본 탐색
  • 알림의 원본(예: example.com)을 사이트의 모든 열려 있는 탭과 일치시킵니다
  • 일치하는 탭에서 알림의 URL로 이동합니다
  • 일반 사이트 탐색에 유용
정확한 포커스
  • 알림의 정확한 URL을 열려 있는 탭과 일치시킵니다
  • 페이지를 새로 고치지 않고 해당 탭에 포커스를 맞춥니다
  • 사용자의 현재 페이지 상태를 방해하고 싶지 않을 때 이상적
원본 포커스
  • 알림의 원본을 사이트의 모든 열려 있는 탭과 일치시킵니다
  • 페이지를 새로 고치지 않고 해당 탭에 포커스를 맞춥니다
  • 탐색 없이 사이트에 주의를 집중시키는 데 가장 적합

알림 지속성

기본적으로 알림은 알림 기록으로 이동하기 전에 약 5초 동안 표시되며, 운영 체제에서 자동으로 제거되기 전에 1주일 동안 유지됩니다.

지속적 알림 활성화

Chrome 및 Edge 브라우저 구독자에 대해 사용자 상호작용이 있을 때까지 알림을 화면에 지속할 수 있습니다.
모든 브라우저와 운영 체제가 지속적 알림을 지원하는 것은 아닙니다. 활성화하면 적격 사용자에게만 영향을 미치며 문자 수를 줄이고 이미지/버튼 표시에 영향을 주어 알림 모양에 영향을 줄 수 있습니다.
중요 고려 사항:
  • 현재 구독자는 이 설정을 활성화한 후 변경 사항을 보려면 사이트를 다시 방문해야 합니다
  • 지속적 알림은 과도하게 사용하면 사용자를 짜증나게 할 수 있습니다
  • 높은 중요도의 알림(예: 작업 관리 앱)에만 권장됩니다
  • 사용자는 알림 위로 마우스를 가져가 읽을 수 있도록 계속 표시할 수 있습니다

구현 방법

1

대시보드 구성

OneSignal 대시보드의 “지속성” 토글을 사용하여 이 기능을 활성화/비활성화하세요.

알림 지속성 토글

2

사용자 지정 코드 구현

웹 푸시 SDK 초기화에 persistNotification 속성을 추가하세요:
persistNotification: true,
지원되는 브라우저 및 운영 체제에 대해 지속성을 활성화하려면 OneSignal 초기화 코드에 이것을 포함하세요.

브라우저 호환성

지원되는 브라우저:
  • Chrome(완전 지원)
  • Edge(완전 지원)
지원되지 않는 브라우저:
  • Firefox(설정이 효과 없음)
  • Safari(설정이 효과 없음)

모범 사례

  • 신중하게 사용: 사용자 불만을 방지하기 위해 정말 중요한 알림에만 활성화하세요
  • 철저히 테스트: 다양한 브라우저와 기기에서 동작을 확인하세요
  • 사용자 피드백 모니터링: 알림 피로를 나타낼 수 있는 옵트아웃 비율 증가를 주시하세요
  • 컨텍스트 고려: 지속적 알림은 시간에 민감하거나 실행 가능한 콘텐츠에 가장 적합합니다
다음 단계:
  • 알림 전략을 검토하여 지속성이 적절한지 확인하세요
  • 전체 배포 전에 작은 사용자 세그먼트로 기능을 테스트하세요
  • 구현 후 참여 지표를 모니터링하세요
  • 다양한 알림 유형에 대해 다른 지속성 설정을 구현하는 것을 고려하세요