전략적 타이밍, 인앱 소프트 프롬프트, iOS 임시 알림으로 iOS, Android, Huawei에서 푸시 알림 옵트인율을 높이세요.
푸시 권한 프롬프트는 앱이 푸시 알림을 보낼 수 있는지 사용자에게 묻는 운영 체제 대화 상자입니다. 사용자의 응답에 따라 배너로 나타나고, 잠금 화면에 표시되고, 소리를 재생하는 알림을 전달할 수 있는지가 결정됩니다.
시스템 권한 프롬프트를 표시하는 iOS 및 Android 기기.
프롬프트를 하나의 전략으로 다루세요. 시스템 프롬프트는 표시 횟수가 제한되어 있습니다. iOS에서는 한 번, Android(Google과 Huawei)에서는 두 번만 표시할 수 있습니다. 사용자가 모든 시도를 거부하면 시스템 설정에서 수동으로 알림을 다시 활성화해야 합니다. 타이밍이 잘못된 프롬프트는 구독자를 영구히 잃게 만들 수 있으며, 도달 가능한 오디언스는 실행하는 모든 푸시 캠페인의 ROI를 좌우하는 가장 큰 요소입니다.Apple과 Google 모두 권한을 요청하기 전에 알림의 가치를 설명할 것을 권장합니다. 컨텍스트가 없으면 사용자는 거부할 가능성이 더 높으며, iOS에서는 한 번 거부된 프롬프트를 다시 표시할 수 없습니다.이 가이드는 모바일 앱 푸시를 다룹니다. 웹 푸시에 대해서는 웹 푸시 권한 프롬프트를 참조하세요.
푸시 옵트인율은 시스템 프롬프트 자체의 문구보다 언제, 어떻게 요청하는지에 훨씬 더 크게 좌우됩니다. 프롬프트를 전략으로 다루는 앱은 첫 실행 시점에 프롬프트를 표시하는 앱을 지속적으로 능가합니다. 아래 원칙들은 그 구성 요소이며, 이어지는 예시 전략은 이러한 요소를 어떻게 구체적인 플레이북으로 결합하는지 보여줍니다.
가치 있는 순간 이후에 요청하세요. 사용자가 알림받을 만한 가치가 있는 무언가를 방금 경험했을 때까지 기다리세요. 온보딩 완료, 항목 저장, 토픽 팔로우, 주문 완료, 첫 세션 종료 같은 시점입니다. 사용자가 앱이 무엇을 하는지 이해하기도 전에 첫 실행에서 프롬프트를 표시하는 것이 낮은 옵트인율의 가장 큰 원인입니다.
iOS에서는 임시 알림으로 시작하세요.임시 알림은 어떤 프롬프트도 없이 알림 센터로 조용히 전달되므로, 사용자는 가상의 설명이 아닌 실제 콘텐츠를 기반으로 유지 여부를 결정합니다. iOS에서 종종 가장 높은 전환율을 보이는 경로이므로 기본 시작점으로 삼아야 합니다.
인앱 소프트 프롬프트로 가치를 설명하세요. 소프트 프롬프트는 어떤 종류의 알림을 보낼 것이며 왜 중요한지 사용자에게 알려주는 OneSignal 인앱 메시지입니다. 소프트 프롬프트를 닫아도 시스템 프롬프트 시도 횟수가 소진되지 않으므로, 아직 준비되지 않았던 사용자에게 다시 요청할 수 있습니다.
시스템 프롬프트가 아니라 소프트 프롬프트를 거부한 사용자에게 다시 요청하세요. 소프트 프롬프트가 일정 주기(예: 2주마다)로 다시 표시되도록 구성하세요. 아직 준비되지 않았던 사용자는 시스템 프롬프트 제한을 소진하지 않고도 다시 한 번 기회를 얻습니다.
문구와 타이밍을 반복 개선하세요. 소프트 프롬프트를 배포하고, 메시지 리포트에서 전환율을 확인한 다음, 트리거, 문구, 빈도를 조정하세요. 타이밍과 문구의 작은 변경만으로도 옵트인율이 수십 퍼센트포인트 움직이는 경우가 흔합니다.
이 예시는 iOS에서 즉각적인 도달을 위한 임시 알림과, 가치 있는 순간에 표시되는 소프트 프롬프트를 결합하여 완전한 옵트인으로 전환합니다. 시작점으로 삼되 알림 유형과 가치 있는 순간을 앱에 맞게 조정하세요. Android 및 Huawei 앱의 경우 1단계는 건너뛰고 2단계부터 시작하세요.1단계: iOS에서 조용한 도달
OneSignal 대시보드의 Settings > Apple iOS > Advanced Configuration > Enable iOS 12 direct to history에서 임시 승인을 활성화하세요.
사용자의 첫 주 동안 2~3개의 고품질 알림을 전송하세요. 개인화된 추천, 속보 알림, 주간 다이제스트처럼 구독의 가치를 보여주는 콘텐츠를 선택하세요. 사용자는 프롬프트 없이 알림 센터에서 이를 조용히 받게 됩니다.
2단계: 가치 있는 순간에 전환
Messages > In-App에서 사용자가 이미 경험한 가치를 언급하는 소프트 프롬프트를 만드세요. 헤드라인 예시: “잠금 화면에서 속보 알림을 받아보세요.”
오디언스를 Show to all users로 설정하세요. Push Permission Prompt 클릭 액션이 자동으로 미구독 사용자에게만 필터링합니다.
신호가 강한 이벤트에서 메시지를 트리거하세요. 임시 알림 열기 또는 반응, 토픽 팔로우, 장바구니에 항목 추가, 5분간의 세션 시간 등입니다.
CTA 버튼에 Push Permission Prompt 클릭 액션을 추가하세요.
일정을 Multiple times로 설정하고, 사용자당 최대 표시 횟수를 20, 표시 사이 간격을 2 weeks로 설정하세요(약 10개월 동안 재프롬프트).
3단계: 측정과 반복
1~2주 후, 메시지 리포트에서 프롬프트에서 옵트인까지의 전환율을 확인하세요.
SDK 리스너로 전체 퍼널을 계측하세요. 소프트 프롬프트 클릭, 닫기, 시스템 프롬프트 결과를 추적하고 그 이벤트를 분석 도구로 전달하세요.
수치를 기반으로 한 번에 하나의 변수(트리거 이벤트, 헤드라인, CTA 문구, 표시 사이 간격)만 조정하세요.
사용자가 임시 알림을 열거나 반응한 직후에 소프트 프롬프트를 트리거하세요. 이미 알림에서 가치를 경험했기 때문에 시스템 프롬프트에서 “Allow” 비율이 크게 상승합니다.
OneSignal 대시보드에서 활성화합니다. 사용자는 어떤 프롬프트도 없이 알림 센터에서 조용한 알림을 받고, Keep을 탭하여 전체 구독자로 전환합니다.
iOS 온보딩과 낮은 마찰의 도달. 소프트 프롬프트와 결합하여 조용한 구독자를 전체 푸시 구독자로 전환하세요.
세 가지 모두 결합할 수 있습니다. iOS에서 자주 사용되는 고성능 패턴은 즉각적인 조용한 도달을 위해 임시 알림을 활성화하고, 가치 있는 순간에 소프트 프롬프트를 표시하며, 원할 때 옵트인하려는 사용자를 위해 기본 설정 센터에서 프로그래밍 방식 프롬프트를 노출하는 것입니다.
사용자가 이미 시스템 권한 프롬프트를 최대 횟수만큼 거부했다면(iOS는 한 번, Android는 두 번), 클릭 액션은 대신 사용자를 앱의 알림 설정으로 이동시킵니다. 이는 SDK에서 requestPermission(fallbackToSettings: true)를 호출하는 것과 동일합니다.
Push Permission Prompt 클릭 액션이 있는 인앱 메시지는 이미 알림을 허용한 사용자에게는 표시되지 않습니다.
5
트리거 선택
오디언스는 메시지를 볼 자격이 있는 대상을 제어합니다. 트리거는 메시지가 표시되는 시점을 제어합니다. 사용자가 알림받을 만한 가치가 있는 무언가를 방금 경험한 가치 있는 순간에 프롬프트를 트리거하는 것을 목표로 하세요.
메시지가 표시되는 시기를 제어하는 트리거 옵션.
트리거 옵션(전환율이 낮은 것부터 높은 것 순으로 대략적으로 정렬):
앱 열기 시. 간단하지만 최적인 경우는 드뭅니다. 앱의 가치가 몇 초 안에 명확한 경우에만 사용하세요.
설정된 세션 시간 후. 좋은 기본값. 사용자가 앱을 탐색한 후에 요청하도록 기다립니다.
특정 사용자 이벤트 시. 전환에 가장 좋습니다. 온보딩 완료, 항목 저장, 토픽 팔로우, 첫 구매 완료 같은 신호가 강한 액션 이후에 트리거하세요.
프로그래밍 방식, 인앱 메시지 트리거 SDK 메서드를 사용. 여러 신호를 결합한 후에 프롬프트하는 등 타이밍과 컨텍스트를 완전히 제어합니다.
예를 들어, 사용자가 앱에서 최소 5분을 보낼 때까지 기다리려면:
5분의 세션 시간 후 메시지를 표시하도록 구성된 트리거.
6
일정과 빈도
메시지가 표시되는 빈도를 제어하세요.
Only once. 처음에 준비되지 않았던 사용자를 전환할 가능성이 낮습니다.
Every time conditions are met. 너무 공격적이며 사용자를 불편하게 할 수 있습니다.
Multiple times (권장). 사용자당 최대 표시 횟수와 표시 사이 간격을 설정하세요. 예를 들어, 20회 표시와 2 weeks 간격은 미구독 사용자에게 약 10개월 동안 공격적인 주기로 재프롬프트합니다. 참여도가 낮거나 유틸리티성 앱에서 2주 간격이 부담스럽게 느껴진다면 간격을 (예: 30 days 또는 60 days처럼) 늘리세요.
이미 거부한 사용자가 아무 일도 일어나지 않는 대신 앱의 알림 설정으로 리디렉션되도록 하려면 requestPermission()에 fallbackToSettings: true를 전달하세요.
optOut()을 통해 SDK 수준에서 구독이 옵트아웃된 경우(구독 레코드에 notification_types: -2로 표시됨), requestPermission() 단독으로는 구독 상태가 변경되지 않습니다. 대신 optIn()을 사용하세요. 권한을 요청함과 동시에 옵트아웃 상태를 해제합니다.
임시 푸시 알림은 iOS 12에서 도입되었습니다. 권한 프롬프트를 표시하지 않고도 알림 센터로 알림을 전달할 수 있습니다. 사용자는 앱의 실제 콘텐츠를 확인한 후 그 경험을 바탕으로 알림을 유지할지, 무음으로 할지, 끌지 결정합니다.전략으로서 효과적인 이유:
실패할 시스템 프롬프트가 없습니다. 사전 옵트인 결정 없이도 첫 세션부터 사용자에게 도달하기 시작할 수 있습니다.
사용자는 가상의 설명이 아닌 실제 가치를 기반으로 결정합니다.
나중에 소프트 프롬프트를 표시하여 임시 사용자를 배너, 소리, 잠금 화면 알림이 포함된 전체 푸시 구독자로 전환할 수 있습니다.
트레이드오프. 임시 알림은 가시성이 낮습니다. 알림 센터로만 조용히 전달되며, 사용자가 전체 권한으로 업그레이드하기 전까지는 배너, 소리, 잠금 화면 알림이 없습니다.
사용자에게 알림을 유지할지 끌지 묻는 임시 알림.
임시 승인을 활성화하려면 OneSignal 대시보드의 Settings > Apple iOS > Advanced Configuration으로 이동하여 Enable iOS 12 direct to history를 체크하세요. 사용자가 임시 알림과 상호작용하는 방식과 이를 표준 프롬프트와 결합하는 방법을 포함한 전체 안내는 iOS 임시 푸시 알림을 참조하세요.
임시 알림과 가치 있는 순간에 표시되는 소프트 프롬프트를 결합하는 구체적인 플레이북은 예시 온보딩 옵트인 전략을 참조하세요.
iOS에서는 시스템 권한 프롬프트를 거부하면 앱의 푸시 알림이 영구적으로 비활성화됩니다. 프롬프트를 다시 표시할 수 없습니다. Android에서는 사용자에게 한 번 더 기회가 주어집니다(총 두 번). 모든 시도가 소진된 후에는 사용자가 기기의 설정 > 알림에서 수동으로 알림을 다시 활성화해야 합니다. Push Permission Prompt 클릭 액션과 requestPermission(fallbackToSettings: true)는 모두 사용자를 알림 설정으로 직접 이동시켜 이를 처리합니다.
아니요. iOS와 Android의 시스템 권한 프롬프트는 운영 체제가 제어하며 커스터마이즈할 수 없습니다. 커스터마이즈할 수 있는 것은 그 앞에 표시되는 인앱 메시지, 즉 소프트 프롬프트뿐입니다. 소프트 프롬프트로 알림의 가치를 설명하고, 기대치를 설정하며, 시스템 프롬프트에서 “Allow”를 선택할 가능성을 높이세요.
시스템 권한 프롬프트가 소진된 후에는(iOS에서 한 번, Android에서 두 번) 다시 표시할 수 없습니다. 대신 requestPermission(fallbackToSettings: true) SDK 메서드나 인앱 메시지의 Push Permission Prompt 클릭 액션을 사용하세요. 두 방법 모두 앱의 알림 설정을 열어 사용자가 수동으로 알림을 활성화할 수 있게 합니다. 알림이 왜 가치 있는지 설명하는 인앱 메시지와 함께 사용하세요.
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"OneSignal Documentation","description":"OneSignal is a platform for sending push notifications, emails, in-app messages, and SMS campaigns via a single API, Journey Builder, and a dashboard.","colors":{"primary":"#3A3DB3","light":"#E54B4D","dark":"#3A3DB3"},"logo":{"light":"https://mintcdn.com/onesignal/yJcueeDCO7UpHnnY/logo/OneSignal-Logo.svg?fit=max\u0026auto=format\u0026n=yJcueeDCO7UpHnnY\u0026q=85\u0026s=1fcfb6fef6d820fd9d99c74850711107","dark":"https://mintcdn.com/onesignal/s4WC_KzLxf8ornqq/logo/OneSignal-Logo-White.svg?fit=max\u0026auto=format\u0026n=s4WC_KzLxf8ornqq\u0026q=85\u0026s=2573a53b5aea961e18c82b3af8f31925"},"favicon":"https://mintcdn.com/onesignal/SGduBFHpiRdg5l6h/favicon.ico?fit=max\u0026auto=format\u0026n=SGduBFHpiRdg5l6h\u0026q=85\u0026s=c0a99fadc0553c658a83741c5611cef4","api":{"examples":{"languages":["curl","typescript","python","php","go","ruby","java","csharp","rust"],"autogenerate":true}},"navbar":{"links":[{"href":"mailto:support@onesignal.com","label":"Support"}],"primary":{"type":"button","label":"Dashboard","href":"https://dashboard.onesignal.com"}},"footer":{"socials":{"github":"https://github.com/OneSignal","linkedin":"https://linkedin.com/company/onesignal","youtube":"https://www.youtube.com/@onesignalofficial/playlists"}},"seo":{"metatags":{"apple-mobile-web-app-title":"OneSignal Docs"}},"fonts":{"family":"Nunito Sans"},"styling":{"eyebrows":"breadcrumbs","latex":true},"integrations":{"ga4":{"measurementId":"G-2DGWL0VYP5"},"posthog":{"apiKey":"phc_vZpvE0f5eyzcOt30FHer34yddVmNdo9kmlMVRBzLMtn","apiHost":"https://eu.i.posthog.com","sessionRecording":true}},"contextual":{"options":["copy","view","chatgpt","claude"],"display":"header"},"navigation":{"languages":[{"language":"en","href":"docs/en/home"},{"language":"cn","href":"docs/cn/home"},{"language":"ko","href":"docs/ko/home"},{"language":"ja","href":"docs/ja/home"},{"language":"tr","href":"docs/tr/home"},{"language":"pt-BR","href":"docs/pt-BR/home"},{"language":"es","href":"docs/es/home"},{"language":"fr","href":"docs/fr/home"}]}},"deployment":{"deploymentMetadataValue":{"subdomain":"onesignal","hasAudioNarration":false,"actualSubdomain":"onesignal","customDomains":["documentation.onesignal.com"],"gitSource":{"type":"github","owner":"onesignal","repo":"mintlify-docs","deployBranch":"main","contentDirectory":"","isPrivate":true,"mountPath":"","label":""},"feedback":{"thumbs":true},"entitlements":{"AI_CHAT":{"status":"ENABLED"},"WEB_MCP":{"status":"ENABLED"},"NARRATION":{"status":"ENABLED"}},"buildId":"6aee76d2161a823262d5e93f","clientVersion":"0.0.4094","searchFilterCounts":[{"language":"en","tag":"User Guides","count":203},{"language":"es","tag":"Guías del Usuario","count":178},{"language":"fr","tag":"Guides utilisateur","count":178},{"language":"ja","tag":"ユーザーガイド","count":178},{"language":"ko","tag":"사용자 가이드","count":178},{"language":"pt-BR","tag":"Guia do Usuário","count":178},{"language":"tr","tag":"Kullanıcı Kılavuzları","count":178},{"language":"cn","tag":"用户指南","count":176},{"language":"en","tag":"Message channels","count":90},{"language":"es","tag":"Canales de mensajería","count":84},{"language":"fr","tag":"Canaux de messagerie","count":84},{"language":"ja","tag":"メッセージングチャネル","count":84},{"language":"ko","tag":"메시지 채널","count":84},{"language":"pt-BR","tag":"Canais de mensagem","count":84},{"language":"tr","tag":"Mesaj kanalları","count":84},{"language":"cn","tag":"消息渠道","count":83},{"language":"default","tag":"API Reference","count":68},{"language":"default","tag":"API reference","count":64},{"language":"en","tag":"Analytics \u0026 Integrations","count":53},{"language":"es","tag":"Analítica \u0026 Integraciones","count":52},{"language":"fr","tag":"Analyses et intégrations","count":52},{"language":"ja","tag":"分析 \u0026 統合","count":52},{"language":"ko","tag":"분석 \u0026 통합","count":52},{"language":"pt-BR","tag":"Análises \u0026 Integrações","count":52},{"language":"tr","tag":"Analitik ve Entegrasyonlar","count":52},{"language":"cn","tag":"分析和集成","count":51},{"language":"cn","tag":"开发者指南","count":48},{"language":"es","tag":"Guías del desarrollador","count":48},{"language":"fr","tag":"Guides développeur","count":48},{"language":"ja","tag":"開発者ガイド","count":48},{"language":"ko","tag":"개발자 가이드","count":48},{"language":"tr","tag":"Geliştirici Kılavuzları","count":48},{"language":"en","tag":"Developer Guides","count":47},{"language":"pt-BR","tag":"Guia de desenvolvedor","count":47},{"language":"en","tag":"Integrations","count":37},{"language":"es","tag":"Integraciones","count":37},{"language":"fr","tag":"Intégrations","count":37},{"language":"ja","tag":"統合","count":37},{"language":"ko","tag":"통합","count":37},{"language":"pt-BR","tag":"Integrações","count":37},{"language":"tr","tag":"Entegrasyonlar","count":37},{"language":"cn","tag":"集成","count":36},{"language":"en","tag":"Tutorials","count":35},{"language":"cn","tag":"推送通知","count":31},{"language":"cn","tag":"OneSignal 作为目的地","count":31},{"language":"en","tag":"Push","count":31},{"language":"en","tag":"OneSignal as destination","count":31},{"language":"es","tag":"Push notificaciones","count":31},{"language":"es","tag":"OneSignal como destino","count":31},{"language":"fr","tag":"Push","count":31},{"language":"fr","tag":"OneSignal comme destination","count":31},{"language":"ja","tag":"プッシュ通知","count":31},{"language":"ja","tag":"OneSignal as 宛先","count":31},{"language":"ko","tag":"푸시","count":31},{"language":"ko","tag":"OneSignal을 데이터 목적지로 사용","count":31},{"language":"pt-BR","tag":"Push notificações","count":31},{"language":"pt-BR","tag":"OneSignal como destino","count":31},{"language":"tr","tag":"Anlık bildirimler","count":31},{"language":"tr","tag":"OneSignal hedef","count":31},{"language":"en","tag":"Mobile SDKs","count":26},{"language":"cn","tag":"移动SDK","count":25},{"language":"es","tag":"SDKs móviles","count":25},{"language":"fr","tag":"SDK mobiles","count":25},{"language":"ja","tag":"モバイルSDK","count":25},{"language":"ko","tag":"모바일 SDKs","count":25},{"language":"pt-BR","tag":"SDKs móveis","count":25},{"language":"tr","tag":"Mobil SDK'lar","count":25},{"language":"cn","tag":"教程","count":24},{"language":"es","tag":"Tutoriales","count":24},{"language":"fr","tag":"Tutoriels","count":24},{"language":"ja","tag":"チュートリアル","count":24},{"language":"ko","tag":"튜토리얼","count":24},{"language":"pt-BR","tag":"Tutoriais","count":24},{"language":"tr","tag":"Eğitimler","count":24},{"language":"en","tag":"Mobile SDK setup","count":19},{"language":"cn","tag":"移动SDK设置","count":18},{"language":"es","tag":"Configuración del SDK móvil","count":18},{"language":"fr","tag":"Configuration SDK mobile","count":18},{"language":"ja","tag":"モバイルSDKセットアップ","count":18},{"language":"ko","tag":"모바일 SDK 설정","count":18},{"language":"pt-BR","tag":"Configuração do SDK móvel","count":18},{"language":"tr","tag":"Mobil SDK kurulumu","count":18},{"language":"default","tag":"Messages","count":9},{"language":"default","tag":"Users","count":9},{"language":"default","tag":"Organization","count":9},{"language":"default","tag":"Journeys","count":8},{"language":"default","tag":"Deprecated","count":6},{"language":"default","tag":"Templates","count":6},{"language":"default","tag":"Subscriptions","count":6},{"language":"default","tag":"Segments","count":5}]},"assistantConfig":{"enableStarterQuestions":false,"deflection":{"enabled":true,"email":"support@onesignal.com","showHelpButton":true}},"basePath":"","hasChatPermissions":true,"hasWebMcpPermissions":true,"toggles":[{"name":"kill-isr","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-mintlify-slack","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-integrations-settings","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"rbac-expansion","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-pr-grouping","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-prefix","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"analytics-v7","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"user-flows-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"no-publish-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-onboarding","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"llms-txt-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving-live","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"stripTemperatureMiddleware","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"support-platform-pylon-zendesk","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"instant-rollback","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications-server","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-fable","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fixed-ai-action-pricing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automation-resolve-merge-conflict","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"scoped-publishing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"mintql","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"page-level-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-version-history-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-page-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"full-page-search","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workspace-projects","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"assistant-v5","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fork-pr-previews","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"revalidation-jwt","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-sso-scim","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"hobby-abuse-scan","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"dashboard-inbox","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-signup","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-dual-write","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-enabled","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"approve-review-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-metadata","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"sso-setup-deadline-banner","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-serve","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"live-agents","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"comment-mode","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"googleFontsInlined":true},"customCss":[],"page":{"pagePath":"docs/ko/prompt-for-push-permissions","slug":"/docs/ko/prompt-for-push-permissions","pageMetadata":{"title":"푸시 권한 요청","description":"전략적 타이밍, 인앱 소프트 프롬프트, iOS 임시 알림으로 iOS, Android, Huawei에서 푸시 알림 옵트인율을 높이세요.","keywords":["푸시 옵트인","푸시 구독자 늘리기","소프트 프롬프트","임시 알림","옵트인율","권한"],"href":"/docs/ko/prompt-for-push-permissions"},"description":{"compiledSource":"\"use strict\";\nconst {jsx: _jsx} = arguments[0];\nconst {useMDXComponents: _provideComponents} = arguments[0];\nfunction _createMdxContent(props) {\n const _components = {\n p: \"p\",\n ..._provideComponents(),\n ...props.components\n };\n return _jsx(_components.p, {\n children: \"전략적 타이밍, 인앱 소프트 프롬프트, iOS 임시 알림으로 iOS, Android, Huawei에서 푸시 알림 옵트인율을 높이세요.\"\n });\n}\nfunction MDXContent(props = {}) {\n const {wrapper: MDXLayout} = {\n ..._provideComponents(),\n ...props.components\n };\n return MDXLayout ? _jsx(MDXLayout, {\n ...props,\n children: _jsx(_createMdxContent, {\n ...props\n })\n }) : _createMdxContent(props);\n}\nreturn {\n default: MDXContent\n};\n","frontmatter":{},"scope":{}},"pageType":"default","mdx":{"mdxSource":{"compiledSource":"\"use strict\";const{Fragment:_Fragment,jsx:_jsx,jsxs:_jsxs}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){const _components={a:`a`,code:`code`,em:`em`,hr:`hr`,li:`li`,ol:`ol`,p:`p`,strong:`strong`,tbody:`tbody`,td:`td`,th:`th`,thead:`thead`,tr:`tr`,ul:`ul`,..._provideComponents(),...props.components},{Card,Columns,Frame,Heading,Info,Note,OptimizedImage,Step,Steps,Table,Tip}=_components;if(!Card)_missingMdxReference(`Card`,true);if(!Columns)_missingMdxReference(`Columns`,true);if(!Frame)_missingMdxReference(`Frame`,true);if(!Heading)_missingMdxReference(`Heading`,true);if(!Info)_missingMdxReference(`Info`,true);if(!Note)_missingMdxReference(`Note`,true);if(!OptimizedImage)_missingMdxReference(`OptimizedImage`,true);if(!Step)_missingMdxReference(`Step`,true);if(!Steps)_missingMdxReference(`Steps`,true);if(!Table)_missingMdxReference(`Table`,true);if(!Tip)_missingMdxReference(`Tip`,true);return _jsxs(_Fragment,{children:[_jsx(_components.p,{children:`푸시 권한 프롬프트는 앱이 푸시 알림을 보낼 수 있는지 사용자에게 묻는 운영 체제 대화 상자입니다. 사용자의 응답에 따라 배너로 나타나고, 잠금 화면에 표시되고, 소리를 재생하는 알림을 전달할 수 있는지가 결정됩니다.`}),`\n`,_jsx(Frame,{caption:`시스템 권한 프롬프트를 표시하는 iOS 및 Android 기기.`,children:_jsx(OptimizedImage,{src:`https://mintcdn.com/onesignal/jBdBk5XvQR5eKOks/images/docs/7ace2bd5abf90a044c363ec9acb227467b62a7f49fdf0dd2922280dc188f4973-a90c2cc443f5fe9e7c80368c680a16cf1ca6203f7b28a0a6eec212add8510f80-Untitled_design_11.png?fit=max\u0026auto=format\u0026n=jBdBk5XvQR5eKOks\u0026q=85\u0026s=381c6c0ecf9c24cda0e9153fc582e319`,alt:`나란히 표시된 iOS와 Android의 시스템 권한 프롬프트`,\"data-og-width\":`1920`,width:`1920`,\"data-og-height\":`1080`,height:`1080`,\"data-path\":`images/docs/7ace2bd5abf90a044c363ec9acb227467b62a7f49fdf0dd2922280dc188f4973-a90c2cc443f5fe9e7c80368c680a16cf1ca6203f7b28a0a6eec212add8510f80-Untitled_design_11.png`,\"data-optimize\":`true`,\"data-opv\":`3`,srcset:`https://mintcdn.com/onesignal/jBdBk5XvQR5eKOks/images/docs/7ace2bd5abf90a044c363ec9acb227467b62a7f49fdf0dd2922280dc188f4973-a90c2cc443f5fe9e7c80368c680a16cf1ca6203f7b28a0a6eec212add8510f80-Untitled_design_11.png?w=280\u0026fit=max\u0026auto=format\u0026n=jBdBk5XvQR5eKOks\u0026q=85\u0026s=813395f81edfb45a145bc5db6d7db29c 280w, https://mintcdn.com/onesignal/jBdBk5XvQR5eKOks/images/docs/7ace2bd5abf90a044c363ec9acb227467b62a7f49fdf0dd2922280dc188f4973-a90c2cc443f5fe9e7c80368c680a16cf1ca6203f7b28a0a6eec212add8510f80-Untitled_design_11.png?w=560\u0026fit=max\u0026auto=format\u0026n=jBdBk5XvQR5eKOks\u0026q=85\u0026s=c9123138f4cd434e0399e0f43b75d7df 560w, https://mintcdn.com/onesignal/jBdBk5XvQR5eKOks/images/docs/7ace2bd5abf90a044c363ec9acb227467b62a7f49fdf0dd2922280dc188f4973-a90c2cc443f5fe9e7c80368c680a16cf1ca6203f7b28a0a6eec212add8510f80-Untitled_design_11.png?w=840\u0026fit=max\u0026auto=format\u0026n=jBdBk5XvQR5eKOks\u0026q=85\u0026s=b45a1cb11acd00c6f85cdb1ccec5fac1 840w, https://mintcdn.com/onesignal/jBdBk5XvQR5eKOks/images/docs/7ace2bd5abf90a044c363ec9acb227467b62a7f49fdf0dd2922280dc188f4973-a90c2cc443f5fe9e7c80368c680a16cf1ca6203f7b28a0a6eec212add8510f80-Untitled_design_11.png?w=1100\u0026fit=max\u0026auto=format\u0026n=jBdBk5XvQR5eKOks\u0026q=85\u0026s=47d2a574fcd2633ca9b899b32e4894b5 1100w, https://mintcdn.com/onesignal/jBdBk5XvQR5eKOks/images/docs/7ace2bd5abf90a044c363ec9acb227467b62a7f49fdf0dd2922280dc188f4973-a90c2cc443f5fe9e7c80368c680a16cf1ca6203f7b28a0a6eec212add8510f80-Untitled_design_11.png?w=1650\u0026fit=max\u0026auto=format\u0026n=jBdBk5XvQR5eKOks\u0026q=85\u0026s=98f01fd1b7789555861c59187644cb80 1650w, https://mintcdn.com/onesignal/jBdBk5XvQR5eKOks/images/docs/7ace2bd5abf90a044c363ec9acb227467b62a7f49fdf0dd2922280dc188f4973-a90c2cc443f5fe9e7c80368c680a16cf1ca6203f7b28a0a6eec212add8510f80-Untitled_design_11.png?w=2500\u0026fit=max\u0026auto=format\u0026n=jBdBk5XvQR5eKOks\u0026q=85\u0026s=2e20c4df93ca357205cabce580def9d0 2500w`})}),`\n`,_jsxs(_components.p,{children:[`프롬프트를 하나의 전략으로 다루세요. 시스템 프롬프트는 표시 횟수가 제한되어 있습니다. `,_jsx(_components.strong,{children:`iOS에서는 한 번`}),`, `,_jsx(_components.strong,{children:`Android(Google과 Huawei)에서는 두 번`}),`만 표시할 수 있습니다. 사용자가 모든 시도를 거부하면 시스템 설정에서 수동으로 알림을 다시 활성화해야 합니다. 타이밍이 잘못된 프롬프트는 구독자를 영구히 잃게 만들 수 있으며, 도달 가능한 오디언스는 실행하는 모든 푸시 캠페인의 ROI를 좌우하는 가장 큰 요소입니다.`]}),`\n`,_jsxs(_components.p,{children:[_jsx(_components.a,{href:`https://developer.apple.com/design/human-interface-guidelines/managing-notifications`,children:`Apple`}),`과 `,_jsx(_components.a,{href:`https://developer.android.com/training/permissions/requesting`,children:`Google`}),` 모두 권한을 요청하기 전에 알림의 가치를 설명할 것을 권장합니다. 컨텍스트가 없으면 사용자는 거부할 가능성이 더 높으며, iOS에서는 한 번 거부된 프롬프트를 다시 표시할 수 없습니다.`]}),`\n`,_jsxs(_components.p,{children:[`이 가이드는 모바일 앱 푸시를 다룹니다. 웹 푸시에 대해서는 `,_jsx(_components.a,{href:`/docs/ko/permission-requests`,children:`웹 푸시 권한 프롬프트`}),`를 참조하세요.`]}),`\n`,_jsx(Heading,{level:`2`,id:`높은-옵트인율을-위한-전략`,children:`높은 옵트인율을 위한 전략`}),`\n`,_jsxs(_components.p,{children:[`푸시 옵트인율은 시스템 프롬프트 자체의 문구보다 `,_jsx(_components.em,{children:`언제`}),`, `,_jsx(_components.em,{children:`어떻게`}),` 요청하는지에 훨씬 더 크게 좌우됩니다. 프롬프트를 전략으로 다루는 앱은 첫 실행 시점에 프롬프트를 표시하는 앱을 지속적으로 능가합니다. 아래 원칙들은 그 구성 요소이며, 이어지는 `,_jsx(_components.a,{href:`#example-onboarding-opt-in-strategy`,children:`예시 전략`}),`은 이러한 요소를 어떻게 구체적인 플레이북으로 결합하는지 보여줍니다.`]}),`\n`,_jsx(Heading,{level:`3`,id:`원칙`,children:`원칙`}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`가치 있는 순간 이후에 요청하세요.`}),` 사용자가 알림받을 만한 가치가 있는 무언가를 방금 경험했을 때까지 기다리세요. 온보딩 완료, 항목 저장, 토픽 팔로우, 주문 완료, 첫 세션 종료 같은 시점입니다. 사용자가 앱이 무엇을 하는지 이해하기도 전에 첫 실행에서 프롬프트를 표시하는 것이 낮은 옵트인율의 가장 큰 원인입니다.`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`iOS에서는 임시 알림으로 시작하세요.`}),` `,_jsx(_components.a,{href:`#use-ios-provisional-notifications`,children:`임시 알림`}),`은 어떤 프롬프트도 없이 알림 센터로 조용히 전달되므로, 사용자는 가상의 설명이 아닌 실제 콘텐츠를 기반으로 유지 여부를 결정합니다. iOS에서 종종 가장 높은 전환율을 보이는 경로이므로 기본 시작점으로 삼아야 합니다.`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`인앱 소프트 프롬프트로 가치를 설명하세요.`}),` 소프트 프롬프트는 어떤 종류의 알림을 보낼 것이며 왜 중요한지 사용자에게 알려주는 OneSignal 인앱 메시지입니다. 소프트 프롬프트를 닫아도 시스템 프롬프트 시도 횟수가 소진되지 않으므로, 아직 준비되지 않았던 사용자에게 다시 요청할 수 있습니다.`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`시스템 프롬프트가 아니라 소프트 프롬프트를 거부한 사용자에게 다시 요청하세요.`}),` 소프트 프롬프트가 일정 주기(예: 2주마다)로 다시 표시되도록 구성하세요. 아직 준비되지 않았던 사용자는 시스템 프롬프트 제한을 소진하지 않고도 다시 한 번 기회를 얻습니다.`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`문구와 타이밍을 반복 개선하세요.`}),` 소프트 프롬프트를 배포하고, 메시지 리포트에서 전환율을 확인한 다음, 트리거, 문구, 빈도를 조정하세요. 타이밍과 문구의 작은 변경만으로도 옵트인율이 수십 퍼센트포인트 움직이는 경우가 흔합니다.`]}),`\n`]}),`\n`,_jsx(Heading,{level:`3`,id:`예시-온보딩-옵트인-전략`,children:`예시: 온보딩 옵트인 전략`}),`\n`,_jsx(_components.p,{children:`이 예시는 iOS에서 즉각적인 도달을 위한 임시 알림과, 가치 있는 순간에 표시되는 소프트 프롬프트를 결합하여 완전한 옵트인으로 전환합니다. 시작점으로 삼되 알림 유형과 가치 있는 순간을 앱에 맞게 조정하세요. Android 및 Huawei 앱의 경우 1단계는 건너뛰고 2단계부터 시작하세요.`}),`\n`,_jsx(_components.p,{children:_jsx(_components.strong,{children:`1단계: iOS에서 조용한 도달`})}),`\n`,_jsxs(_components.ol,{children:[`\n`,_jsxs(_components.li,{children:[`OneSignal 대시보드의 `,_jsx(_components.strong,{children:`Settings > Apple iOS > Advanced Configuration > Enable iOS 12 direct to history`}),`에서 임시 승인을 활성화하세요.`]}),`\n`,_jsx(_components.li,{children:`사용자의 첫 주 동안 2~3개의 고품질 알림을 전송하세요. 개인화된 추천, 속보 알림, 주간 다이제스트처럼 구독의 가치를 보여주는 콘텐츠를 선택하세요. 사용자는 프롬프트 없이 알림 센터에서 이를 조용히 받게 됩니다.`}),`\n`]}),`\n`,_jsx(_components.p,{children:_jsx(_components.strong,{children:`2단계: 가치 있는 순간에 전환`})}),`\n`,_jsxs(_components.ol,{children:[`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Messages > In-App`}),`에서 사용자가 이미 경험한 가치를 언급하는 소프트 프롬프트를 만드세요. 헤드라인 예시: “잠금 화면에서 속보 알림을 받아보세요.”`]}),`\n`,_jsxs(_components.li,{children:[`오디언스를 `,_jsx(_components.strong,{children:`Show to all users`}),`로 설정하세요. `,_jsx(_components.strong,{children:`Push Permission Prompt`}),` 클릭 액션이 자동으로 미구독 사용자에게만 필터링합니다.`]}),`\n`,_jsx(_components.li,{children:`신호가 강한 이벤트에서 메시지를 트리거하세요. 임시 알림 열기 또는 반응, 토픽 팔로우, 장바구니에 항목 추가, 5분간의 세션 시간 등입니다.`}),`\n`,_jsxs(_components.li,{children:[`CTA 버튼에 `,_jsx(_components.strong,{children:`Push Permission Prompt`}),` 클릭 액션을 추가하세요.`]}),`\n`,_jsxs(_components.li,{children:[`일정을 `,_jsx(_components.strong,{children:`Multiple times`}),`로 설정하고, 사용자당 최대 표시 횟수를 `,_jsx(_components.code,{children:`20`}),`, 표시 사이 간격을 `,_jsx(_components.code,{children:`2 weeks`}),`로 설정하세요(약 10개월 동안 재프롬프트).`]}),`\n`]}),`\n`,_jsx(_components.p,{children:_jsx(_components.strong,{children:`3단계: 측정과 반복`})}),`\n`,_jsxs(_components.ol,{children:[`\n`,_jsx(_components.li,{children:`1~2주 후, 메시지 리포트에서 프롬프트에서 옵트인까지의 전환율을 확인하세요.`}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.a,{href:`#track-push-permissions-and-prompt-results`,children:`SDK 리스너`}),`로 전체 퍼널을 계측하세요. 소프트 프롬프트 클릭, 닫기, 시스템 프롬프트 결과를 추적하고 그 이벤트를 분석 도구로 전달하세요.`]}),`\n`,_jsx(_components.li,{children:`수치를 기반으로 한 번에 하나의 변수(트리거 이벤트, 헤드라인, CTA 문구, 표시 사이 간격)만 조정하세요.`}),`\n`]}),`\n`,_jsx(Tip,{children:_jsx(_components.p,{children:`사용자가 임시 알림을 열거나 반응한 직후에 소프트 프롬프트를 트리거하세요. 이미 알림에서 가치를 경험했기 때문에 시스템 프롬프트에서 “Allow” 비율이 크게 상승합니다.`})}),`\n`,_jsx(_components.hr,{}),`\n`,_jsx(Heading,{level:`2`,id:`접근-방식-선택`,children:`접근 방식 선택`}),`\n`,_jsx(_components.p,{children:`OneSignal로 푸시 구독자 기반을 늘리는 방법은 세 가지가 있습니다. 대부분의 iOS 앱은 임시 알림과 인앱 소프트 프롬프트를 결합해야 하며, 대부분의 Android 앱은 소프트 프롬프트부터 시작해야 합니다.`}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`접근 방식`}),_jsx(_components.th,{children:`플랫폼`}),_jsx(_components.th,{children:`작동 방식`}),_jsx(_components.th,{children:`사용 시점`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`인앱 소프트 프롬프트 (권장)`})}),_jsx(_components.td,{children:`iOS, Android, Huawei`}),_jsxs(_components.td,{children:[_jsx(_components.strong,{children:`Push Permission Prompt`}),` 클릭 액션이 포함된 OneSignal 인앱 메시지를 구성합니다. 버튼을 탭하면 시스템 프롬프트가 표시됩니다. 인앱 메시지를 닫아도 시도 횟수가 소진되지 않으므로 나중에 다시 요청할 수 있습니다.`]}),_jsx(_components.td,{children:`기본 선택. 코드 릴리스 없이 프롬프트를 디자인, 예약, 타겟팅, 재표시할 수 있습니다.`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`프로그래밍 방식 프롬프트`})}),_jsx(_components.td,{children:`iOS, Android, Huawei`}),_jsxs(_components.td,{children:[`앱 코드에서 `,_jsx(_components.a,{href:`/docs/ko/mobile-sdk-reference#requestpermission-fallbacktosettings-push`,children:_jsx(_components.code,{children:`requestPermission()`})}),` 또는 `,_jsx(_components.a,{href:`/docs/ko/mobile-sdk-reference#optout-optin-optedin`,children:_jsx(_components.code,{children:`optIn()`})}),`을 호출합니다. 시스템 프롬프트가 즉시 나타납니다.`]}),_jsx(_components.td,{children:`앱이 트리거를 제어하는 사용자 지정 흐름. 기본 설정 센터, 프로필 화면, 프롬프트가 정당화되는 인앱 이벤트 등입니다.`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:_jsx(_components.a,{href:`#use-ios-provisional-notifications`,children:`임시 알림`})})}),_jsx(_components.td,{children:`iOS`}),_jsxs(_components.td,{children:[`OneSignal 대시보드에서 활성화합니다. 사용자는 어떤 프롬프트도 없이 알림 센터에서 조용한 알림을 받고, `,_jsx(_components.strong,{children:`Keep`}),`을 탭하여 전체 구독자로 전환합니다.`]}),_jsx(_components.td,{children:`iOS 온보딩과 낮은 마찰의 도달. 소프트 프롬프트와 결합하여 조용한 구독자를 전체 푸시 구독자로 전환하세요.`})]})]})]}),`\n`,_jsx(_components.p,{children:`세 가지 모두 결합할 수 있습니다. iOS에서 자주 사용되는 고성능 패턴은 즉각적인 조용한 도달을 위해 임시 알림을 활성화하고, 가치 있는 순간에 소프트 프롬프트를 표시하며, 원할 때 옵트인하려는 사용자를 위해 기본 설정 센터에서 프로그래밍 방식 프롬프트를 노출하는 것입니다.`}),`\n`,_jsx(Frame,{caption:`시스템 권한 프롬프트로 이어지는 인앱 소프트 프롬프트.`,children:_jsx(OptimizedImage,{src:`https://mintcdn.com/onesignal/RWtLFPeffHrC81wI/images/docs/a6d382ca2711ba0e9f013bebe5c420d129fbfbc5ef0b2fbd9cb4bef78c7e9480-mobile-push-optimize-reach.webp?fit=max\u0026auto=format\u0026n=RWtLFPeffHrC81wI\u0026q=85\u0026s=bfbc66b313bd85f944476e8363f1d093`,alt:`시스템 푸시 권한 프롬프트로 이어지는 인앱 메시지`,\"data-og-width\":`1600`,width:`1600`,\"data-og-height\":`1058`,height:`1058`,\"data-path\":`images/docs/a6d382ca2711ba0e9f013bebe5c420d129fbfbc5ef0b2fbd9cb4bef78c7e9480-mobile-push-optimize-reach.webp`,\"data-optimize\":`true`,\"data-opv\":`3`,srcset:`https://mintcdn.com/onesignal/RWtLFPeffHrC81wI/images/docs/a6d382ca2711ba0e9f013bebe5c420d129fbfbc5ef0b2fbd9cb4bef78c7e9480-mobile-push-optimize-reach.webp?w=280\u0026fit=max\u0026auto=format\u0026n=RWtLFPeffHrC81wI\u0026q=85\u0026s=440bd2bf2c8195e29d476db422e71632 280w, https://mintcdn.com/onesignal/RWtLFPeffHrC81wI/images/docs/a6d382ca2711ba0e9f013bebe5c420d129fbfbc5ef0b2fbd9cb4bef78c7e9480-mobile-push-optimize-reach.webp?w=560\u0026fit=max\u0026auto=format\u0026n=RWtLFPeffHrC81wI\u0026q=85\u0026s=3105bc27dc5b8135e476408784819f39 560w, https://mintcdn.com/onesignal/RWtLFPeffHrC81wI/images/docs/a6d382ca2711ba0e9f013bebe5c420d129fbfbc5ef0b2fbd9cb4bef78c7e9480-mobile-push-optimize-reach.webp?w=840\u0026fit=max\u0026auto=format\u0026n=RWtLFPeffHrC81wI\u0026q=85\u0026s=d17690599089d63dc30408aeb93b4b7e 840w, https://mintcdn.com/onesignal/RWtLFPeffHrC81wI/images/docs/a6d382ca2711ba0e9f013bebe5c420d129fbfbc5ef0b2fbd9cb4bef78c7e9480-mobile-push-optimize-reach.webp?w=1100\u0026fit=max\u0026auto=format\u0026n=RWtLFPeffHrC81wI\u0026q=85\u0026s=47998a6d28ca50e28c6764c62dfb9989 1100w, https://mintcdn.com/onesignal/RWtLFPeffHrC81wI/images/docs/a6d382ca2711ba0e9f013bebe5c420d129fbfbc5ef0b2fbd9cb4bef78c7e9480-mobile-push-optimize-reach.webp?w=1650\u0026fit=max\u0026auto=format\u0026n=RWtLFPeffHrC81wI\u0026q=85\u0026s=d2badfe90cbe41f3754bc80fb62e0850 1650w, https://mintcdn.com/onesignal/RWtLFPeffHrC81wI/images/docs/a6d382ca2711ba0e9f013bebe5c420d129fbfbc5ef0b2fbd9cb4bef78c7e9480-mobile-push-optimize-reach.webp?w=2500\u0026fit=max\u0026auto=format\u0026n=RWtLFPeffHrC81wI\u0026q=85\u0026s=83f4e350cbcc13ef901cfc48f4cb5464 2500w`})}),`\n`,_jsx(_components.hr,{}),`\n`,_jsx(Heading,{level:`2`,id:`사전-요구-사항`,children:`사전 요구 사항`}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[_jsx(_components.a,{href:`https://dashboard.onesignal.com`,children:`OneSignal 계정`}),`.`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.a,{href:`/docs/ko/mobile-sdk-setup`,children:`OneSignal SDK가 설치되고`}),` `,_jsx(_components.code,{children:`OneSignalInAppMessages`}),` 패키지가 활성화된 모바일 앱.`]}),`\n`]}),`\n`,_jsx(_components.hr,{}),`\n`,_jsx(Heading,{level:`2`,id:`인앱-푸시-권한-프롬프트-설정`,children:`인앱 푸시 권한 프롬프트 설정`}),`\n`,_jsxs(Steps,{children:[_jsxs(Step,{title:`자동 권한 프롬프트 제거`,children:[_jsx(_components.p,{children:`시작하기 전에 앱이 이미 시스템 권한 프롬프트를 자동으로 트리거하고 있지 않은지 확인하세요.`}),_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[`앱 시작 시 호출되는 `,_jsx(_components.code,{children:`requestPermission()`}),` 또는 `,_jsx(_components.code,{children:`optIn()`}),` 호출을 모두 제거하세요.`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.code,{children:`requestAuthorizationWithOptions`}),`에 대한 네이티브 iOS 호출과 푸시 토큰을 직접 생성하는 모든 코드를 제거하세요.`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.code,{children:`requestPermissions`}),`에 대한 Android 호출과 푸시 토큰을 직접 생성하는 모든 코드를 제거하세요.`]}),`\n`]})]}),_jsxs(Step,{title:`인앱 메시지 생성 또는 편집`,children:[_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`Messages > In-App`}),`으로 이동한 다음 다음 중 하나를 수행하세요.`]}),_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[`기본 `,_jsx(_components.strong,{children:`Push Permission Prompt`}),` 템플릿을 편집하거나,`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`New Message`}),`를 클릭하여 직접 만드세요.`]}),`\n`]}),_jsx(Frame,{caption:`기본 Push Permission Prompt 템플릿을 편집하거나 직접 만드세요.`,children:_jsx(OptimizedImage,{src:`https://mintcdn.com/onesignal/l4Z9oMlZl9nJOS_T/images/push/prompt-for-push-set-up-an-in-app-push-permission-prompt.jpg?fit=max\u0026auto=format\u0026n=l4Z9oMlZl9nJOS_T\u0026q=85\u0026s=80dd758e2587507b2052b2e20df0409e`,alt:`Push Permission Prompt 템플릿이 표시된 OneSignal 인앱 메시지 목록`,\"data-og-width\":`2616`,width:`2616`,\"data-og-height\":`1356`,height:`1356`,\"data-path\":`images/push/prompt-for-push-set-up-an-in-app-push-permission-prompt.jpg`,\"data-optimize\":`true`,\"data-opv\":`3`,srcset:`https://mintcdn.com/onesignal/l4Z9oMlZl9nJOS_T/images/push/prompt-for-push-set-up-an-in-app-push-permission-prompt.jpg?w=280\u0026fit=max\u0026auto=format\u0026n=l4Z9oMlZl9nJOS_T\u0026q=85\u0026s=5cfc814fb88bcc69c59d4843bcdd09f5 280w, https://mintcdn.com/onesignal/l4Z9oMlZl9nJOS_T/images/push/prompt-for-push-set-up-an-in-app-push-permission-prompt.jpg?w=560\u0026fit=max\u0026auto=format\u0026n=l4Z9oMlZl9nJOS_T\u0026q=85\u0026s=86556b08d55d6e3f75d9a5e260728e4f 560w, https://mintcdn.com/onesignal/l4Z9oMlZl9nJOS_T/images/push/prompt-for-push-set-up-an-in-app-push-permission-prompt.jpg?w=840\u0026fit=max\u0026auto=format\u0026n=l4Z9oMlZl9nJOS_T\u0026q=85\u0026s=7adf400ed0946df30b0509b5ed750a9d 840w, https://mintcdn.com/onesignal/l4Z9oMlZl9nJOS_T/images/push/prompt-for-push-set-up-an-in-app-push-permission-prompt.jpg?w=1100\u0026fit=max\u0026auto=format\u0026n=l4Z9oMlZl9nJOS_T\u0026q=85\u0026s=8d2617de7c8f192bf363fd9a2c800162 1100w, https://mintcdn.com/onesignal/l4Z9oMlZl9nJOS_T/images/push/prompt-for-push-set-up-an-in-app-push-permission-prompt.jpg?w=1650\u0026fit=max\u0026auto=format\u0026n=l4Z9oMlZl9nJOS_T\u0026q=85\u0026s=2b4a0e838c65da87eabe77c6a91df66f 1650w, https://mintcdn.com/onesignal/l4Z9oMlZl9nJOS_T/images/push/prompt-for-push-set-up-an-in-app-push-permission-prompt.jpg?w=2500\u0026fit=max\u0026auto=format\u0026n=l4Z9oMlZl9nJOS_T\u0026q=85\u0026s=eb036f5d07e412de4caf4709e502518c 2500w`})}),_jsxs(_components.p,{children:[`오디언스를 `,_jsx(_components.strong,{children:`Show to all users`}),`로 설정하세요. OneSignal은 `,_jsx(_components.strong,{children:`Push Permission Prompt`}),` 클릭 액션에 따라 아직 푸시를 구독하지 않은 사용자에게만 이 메시지를 자동으로 필터링합니다.`]}),_jsx(Frame,{caption:`오디언스를 'Show to all users'로 설정하세요. Push Permission Prompt 클릭 액션이 자동으로 미구독 사용자에게 필터링합니다.`,children:_jsx(OptimizedImage,{src:`https://mintcdn.com/onesignal/l4Z9oMlZl9nJOS_T/images/push/prompt-for-push-set-up-an-in-app-push-permission-prompt-show-to-all-users.jpg?fit=max\u0026auto=format\u0026n=l4Z9oMlZl9nJOS_T\u0026q=85\u0026s=e9b2b23e4e7663ee7799fd4a92dbe473`,alt:`모든 사용자에게 표시하도록 구성된 오디언스 설정`,\"data-og-width\":`1766`,width:`1766`,\"data-og-height\":`678`,height:`678`,\"data-path\":`images/push/prompt-for-push-set-up-an-in-app-push-permission-prompt-show-to-all-users.jpg`,\"data-optimize\":`true`,\"data-opv\":`3`,srcset:`https://mintcdn.com/onesignal/l4Z9oMlZl9nJOS_T/images/push/prompt-for-push-set-up-an-in-app-push-permission-prompt-show-to-all-users.jpg?w=280\u0026fit=max\u0026auto=format\u0026n=l4Z9oMlZl9nJOS_T\u0026q=85\u0026s=c11d77d71104cd915e994efd3e3e213f 280w, https://mintcdn.com/onesignal/l4Z9oMlZl9nJOS_T/images/push/prompt-for-push-set-up-an-in-app-push-permission-prompt-show-to-all-users.jpg?w=560\u0026fit=max\u0026auto=format\u0026n=l4Z9oMlZl9nJOS_T\u0026q=85\u0026s=c24c673407ede9782dd901b79bd2cab0 560w, https://mintcdn.com/onesignal/l4Z9oMlZl9nJOS_T/images/push/prompt-for-push-set-up-an-in-app-push-permission-prompt-show-to-all-users.jpg?w=840\u0026fit=max\u0026auto=format\u0026n=l4Z9oMlZl9nJOS_T\u0026q=85\u0026s=3563dfdb84066ec9ecbf27b19667d2c8 840w, https://mintcdn.com/onesignal/l4Z9oMlZl9nJOS_T/images/push/prompt-for-push-set-up-an-in-app-push-permission-prompt-show-to-all-users.jpg?w=1100\u0026fit=max\u0026auto=format\u0026n=l4Z9oMlZl9nJOS_T\u0026q=85\u0026s=cb4ab085c2910e1a5cf1a237e53c7239 1100w, https://mintcdn.com/onesignal/l4Z9oMlZl9nJOS_T/images/push/prompt-for-push-set-up-an-in-app-push-permission-prompt-show-to-all-users.jpg?w=1650\u0026fit=max\u0026auto=format\u0026n=l4Z9oMlZl9nJOS_T\u0026q=85\u0026s=71784d7c4d1669efb51ce6e1dcd9e026 1650w, https://mintcdn.com/onesignal/l4Z9oMlZl9nJOS_T/images/push/prompt-for-push-set-up-an-in-app-push-permission-prompt-show-to-all-users.jpg?w=2500\u0026fit=max\u0026auto=format\u0026n=l4Z9oMlZl9nJOS_T\u0026q=85\u0026s=9523295c6a8f01c9159531898833d88e 2500w`})})]}),_jsxs(Step,{title:`메시지 디자인 사용자 지정`,children:[_jsx(_components.p,{children:`앱에 맞게 모양, 느낌, 문구를 개인화하세요. 어떤 종류의 알림을 받게 될지, 왜 가치가 있는지 사용자에게 알려주세요.`}),_jsxs(_components.p,{children:[`자세한 내용은 `,_jsx(_components.a,{href:`/docs/ko/design-your-in-app-message`,children:`드래그 앤 드롭으로 인앱 메시지 디자인하기`}),` 또는 `,_jsx(_components.a,{href:`/docs/ko/design-your-in-app-message-with-html`,children:`HTML로 인앱 메시지 디자인하기`}),`를 참조하세요.`]}),_jsx(Frame,{caption:`푸시 옵트인 메시지를 만들기 위한 인앱 메시지 블록 편집기.`,children:_jsx(OptimizedImage,{src:`https://mintcdn.com/onesignal/l4Z9oMlZl9nJOS_T/images/push/push-customize-the-message-design.jpg?fit=max\u0026auto=format\u0026n=l4Z9oMlZl9nJOS_T\u0026q=85\u0026s=df030196ba721eedfd4c1ad5af0fa3cd`,alt:`푸시 옵트인 프롬프트가 있는 인앱 메시지 블록 편집기`,\"data-og-width\":`2604`,width:`2604`,\"data-og-height\":`1770`,height:`1770`,\"data-path\":`images/push/push-customize-the-message-design.jpg`,\"data-optimize\":`true`,\"data-opv\":`3`,srcset:`https://mintcdn.com/onesignal/l4Z9oMlZl9nJOS_T/images/push/push-customize-the-message-design.jpg?w=280\u0026fit=max\u0026auto=format\u0026n=l4Z9oMlZl9nJOS_T\u0026q=85\u0026s=3157c1b5e8d45ea5673dfa4c52da3417 280w, https://mintcdn.com/onesignal/l4Z9oMlZl9nJOS_T/images/push/push-customize-the-message-design.jpg?w=560\u0026fit=max\u0026auto=format\u0026n=l4Z9oMlZl9nJOS_T\u0026q=85\u0026s=318971d03d9bdf10a3c56ba15b0cfcfd 560w, https://mintcdn.com/onesignal/l4Z9oMlZl9nJOS_T/images/push/push-customize-the-message-design.jpg?w=840\u0026fit=max\u0026auto=format\u0026n=l4Z9oMlZl9nJOS_T\u0026q=85\u0026s=54eb68d973fc901210879a2d96af5fbf 840w, https://mintcdn.com/onesignal/l4Z9oMlZl9nJOS_T/images/push/push-customize-the-message-design.jpg?w=1100\u0026fit=max\u0026auto=format\u0026n=l4Z9oMlZl9nJOS_T\u0026q=85\u0026s=4317b2598a49e5e18ee01168222a68be 1100w, https://mintcdn.com/onesignal/l4Z9oMlZl9nJOS_T/images/push/push-customize-the-message-design.jpg?w=1650\u0026fit=max\u0026auto=format\u0026n=l4Z9oMlZl9nJOS_T\u0026q=85\u0026s=19ba8d47cbf0e7cc850a523c3d4d3a0e 1650w, https://mintcdn.com/onesignal/l4Z9oMlZl9nJOS_T/images/push/push-customize-the-message-design.jpg?w=2500\u0026fit=max\u0026auto=format\u0026n=l4Z9oMlZl9nJOS_T\u0026q=85\u0026s=8048a3724281105d38e306621e110971 2500w`})})]}),_jsxs(Step,{title:`Push Permission Prompt 클릭 액션 추가`,children:[_jsxs(_components.p,{children:[`메시지의 버튼이나 이미지에 `,_jsx(_components.strong,{children:`Push Permission Prompt`}),` 클릭 액션을 추가하세요. 탭하면 시스템 권한 프롬프트가 나타납니다.`]}),_jsx(Frame,{caption:`버튼에 Push Permission Prompt 클릭 액션 추가.`,children:_jsx(OptimizedImage,{src:`https://mintcdn.com/onesignal/l4Z9oMlZl9nJOS_T/images/push/push-add-the-push-permission-prompt-click-action.jpg?fit=max\u0026auto=format\u0026n=l4Z9oMlZl9nJOS_T\u0026q=85\u0026s=8ed4971452754851f4ff064121bcb900`,alt:`Push Permission Prompt이 선택된 클릭 액션 드롭다운`,\"data-og-width\":`2604`,width:`2604`,\"data-og-height\":`1770`,height:`1770`,\"data-path\":`images/push/push-add-the-push-permission-prompt-click-action.jpg`,\"data-optimize\":`true`,\"data-opv\":`3`,srcset:`https://mintcdn.com/onesignal/l4Z9oMlZl9nJOS_T/images/push/push-add-the-push-permission-prompt-click-action.jpg?w=280\u0026fit=max\u0026auto=format\u0026n=l4Z9oMlZl9nJOS_T\u0026q=85\u0026s=75a5795c1b0bffadb668a2d9211194fa 280w, https://mintcdn.com/onesignal/l4Z9oMlZl9nJOS_T/images/push/push-add-the-push-permission-prompt-click-action.jpg?w=560\u0026fit=max\u0026auto=format\u0026n=l4Z9oMlZl9nJOS_T\u0026q=85\u0026s=b8b01023508e65b726822aebce43d8e8 560w, https://mintcdn.com/onesignal/l4Z9oMlZl9nJOS_T/images/push/push-add-the-push-permission-prompt-click-action.jpg?w=840\u0026fit=max\u0026auto=format\u0026n=l4Z9oMlZl9nJOS_T\u0026q=85\u0026s=98b8395910459aa045cbf7098bcaf89a 840w, https://mintcdn.com/onesignal/l4Z9oMlZl9nJOS_T/images/push/push-add-the-push-permission-prompt-click-action.jpg?w=1100\u0026fit=max\u0026auto=format\u0026n=l4Z9oMlZl9nJOS_T\u0026q=85\u0026s=5421a9fb4a67649e4b99b5755ad80a01 1100w, https://mintcdn.com/onesignal/l4Z9oMlZl9nJOS_T/images/push/push-add-the-push-permission-prompt-click-action.jpg?w=1650\u0026fit=max\u0026auto=format\u0026n=l4Z9oMlZl9nJOS_T\u0026q=85\u0026s=6088b2700591d6564f14902bb1ebb981 1650w, https://mintcdn.com/onesignal/l4Z9oMlZl9nJOS_T/images/push/push-add-the-push-permission-prompt-click-action.jpg?w=2500\u0026fit=max\u0026auto=format\u0026n=l4Z9oMlZl9nJOS_T\u0026q=85\u0026s=54ff0d5156021501eaa19bf0b601e04e 2500w`})}),_jsx(Frame,{caption:`iOS에서 클릭 액션에 의해 트리거된 시스템 권한 프롬프트.`,children:_jsx(OptimizedImage,{src:`https://mintcdn.com/onesignal/Z6xkXGfmy814If53/images/docs/e18f7f87a5efaaa5284cf19be8de863c3833379d37b095aef9d015835a694485-prompt-2.webp?fit=max\u0026auto=format\u0026n=Z6xkXGfmy814If53\u0026q=85\u0026s=a484b1c75320beefb83bde20c443f789`,alt:`iOS 네이티브 푸시 알림 권한 프롬프트`,\"data-og-width\":`1560`,width:`1560`,\"data-og-height\":`804`,height:`804`,\"data-path\":`images/docs/e18f7f87a5efaaa5284cf19be8de863c3833379d37b095aef9d015835a694485-prompt-2.webp`,\"data-optimize\":`true`,\"data-opv\":`3`,srcset:`https://mintcdn.com/onesignal/Z6xkXGfmy814If53/images/docs/e18f7f87a5efaaa5284cf19be8de863c3833379d37b095aef9d015835a694485-prompt-2.webp?w=280\u0026fit=max\u0026auto=format\u0026n=Z6xkXGfmy814If53\u0026q=85\u0026s=630ed5ae9afbe1bf6441bafd31d2265a 280w, https://mintcdn.com/onesignal/Z6xkXGfmy814If53/images/docs/e18f7f87a5efaaa5284cf19be8de863c3833379d37b095aef9d015835a694485-prompt-2.webp?w=560\u0026fit=max\u0026auto=format\u0026n=Z6xkXGfmy814If53\u0026q=85\u0026s=b254334c06fc82da85938866c75b9afb 560w, https://mintcdn.com/onesignal/Z6xkXGfmy814If53/images/docs/e18f7f87a5efaaa5284cf19be8de863c3833379d37b095aef9d015835a694485-prompt-2.webp?w=840\u0026fit=max\u0026auto=format\u0026n=Z6xkXGfmy814If53\u0026q=85\u0026s=48d5ec824fe12deca21998aec99397f2 840w, https://mintcdn.com/onesignal/Z6xkXGfmy814If53/images/docs/e18f7f87a5efaaa5284cf19be8de863c3833379d37b095aef9d015835a694485-prompt-2.webp?w=1100\u0026fit=max\u0026auto=format\u0026n=Z6xkXGfmy814If53\u0026q=85\u0026s=14f917b9c861098e4fe1a2579bc36fa5 1100w, https://mintcdn.com/onesignal/Z6xkXGfmy814If53/images/docs/e18f7f87a5efaaa5284cf19be8de863c3833379d37b095aef9d015835a694485-prompt-2.webp?w=1650\u0026fit=max\u0026auto=format\u0026n=Z6xkXGfmy814If53\u0026q=85\u0026s=dae1bb465d8f7790fe002c1925988cc0 1650w, https://mintcdn.com/onesignal/Z6xkXGfmy814If53/images/docs/e18f7f87a5efaaa5284cf19be8de863c3833379d37b095aef9d015835a694485-prompt-2.webp?w=2500\u0026fit=max\u0026auto=format\u0026n=Z6xkXGfmy814If53\u0026q=85\u0026s=ce9958e2cefc84b5820b86ddc00e41d6 2500w`})}),_jsxs(_components.p,{children:[`사용자가 이미 시스템 권한 프롬프트를 최대 횟수만큼 거부했다면(iOS는 한 번, Android는 두 번), 클릭 액션은 대신 사용자를 앱의 알림 설정으로 이동시킵니다. 이는 SDK에서 `,_jsx(_components.code,{children:`requestPermission(fallbackToSettings: true)`}),`를 호출하는 것과 동일합니다.`]}),_jsx(Info,{children:_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`Push Permission Prompt`}),` 클릭 액션이 있는 인앱 메시지는 이미 알림을 허용한 사용자에게는 표시되지 않습니다.`]})})]}),_jsxs(Step,{title:`트리거 선택`,children:[_jsxs(_components.p,{children:[`오디언스는 메시지를 볼 자격이 있는 `,_jsx(_components.em,{children:`대상`}),`을 제어합니다. 트리거는 메시지가 표시되는 `,_jsx(_components.em,{children:`시점`}),`을 제어합니다. 사용자가 알림받을 만한 가치가 있는 무언가를 방금 경험한 `,_jsx(_components.strong,{children:`가치 있는 순간`}),`에 프롬프트를 트리거하는 것을 목표로 하세요.`]}),_jsx(Frame,{caption:`메시지가 표시되는 시기를 제어하는 트리거 옵션.`,children:_jsx(OptimizedImage,{src:`https://mintcdn.com/onesignal/jFWn5xzleD8du3j6/images/docs/52f0d8bef7cac18c1d791ec229d2bd86e995a8e01401c7559e2476fcfecddc6d-Screenshot_2024-10-29_at_2.18.33_PM.png?fit=max\u0026auto=format\u0026n=jFWn5xzleD8du3j6\u0026q=85\u0026s=1b55a4815213ddf3f77db8041e143aa2`,alt:`인앱 메시지 트리거 구성 패널`,\"data-og-width\":`1792`,width:`1792`,\"data-og-height\":`514`,height:`514`,\"data-path\":`images/docs/52f0d8bef7cac18c1d791ec229d2bd86e995a8e01401c7559e2476fcfecddc6d-Screenshot_2024-10-29_at_2.18.33_PM.png`,\"data-optimize\":`true`,\"data-opv\":`3`,srcset:`https://mintcdn.com/onesignal/jFWn5xzleD8du3j6/images/docs/52f0d8bef7cac18c1d791ec229d2bd86e995a8e01401c7559e2476fcfecddc6d-Screenshot_2024-10-29_at_2.18.33_PM.png?w=280\u0026fit=max\u0026auto=format\u0026n=jFWn5xzleD8du3j6\u0026q=85\u0026s=0c1d0726e6a918b33fcac3e054c147c7 280w, https://mintcdn.com/onesignal/jFWn5xzleD8du3j6/images/docs/52f0d8bef7cac18c1d791ec229d2bd86e995a8e01401c7559e2476fcfecddc6d-Screenshot_2024-10-29_at_2.18.33_PM.png?w=560\u0026fit=max\u0026auto=format\u0026n=jFWn5xzleD8du3j6\u0026q=85\u0026s=dfc1c7974abbb03f25a18a851bd5757a 560w, https://mintcdn.com/onesignal/jFWn5xzleD8du3j6/images/docs/52f0d8bef7cac18c1d791ec229d2bd86e995a8e01401c7559e2476fcfecddc6d-Screenshot_2024-10-29_at_2.18.33_PM.png?w=840\u0026fit=max\u0026auto=format\u0026n=jFWn5xzleD8du3j6\u0026q=85\u0026s=b5e7a12a1b0f0843dfd44bea5afd7ffa 840w, https://mintcdn.com/onesignal/jFWn5xzleD8du3j6/images/docs/52f0d8bef7cac18c1d791ec229d2bd86e995a8e01401c7559e2476fcfecddc6d-Screenshot_2024-10-29_at_2.18.33_PM.png?w=1100\u0026fit=max\u0026auto=format\u0026n=jFWn5xzleD8du3j6\u0026q=85\u0026s=d95d44db5311300066c7b3effc99020b 1100w, https://mintcdn.com/onesignal/jFWn5xzleD8du3j6/images/docs/52f0d8bef7cac18c1d791ec229d2bd86e995a8e01401c7559e2476fcfecddc6d-Screenshot_2024-10-29_at_2.18.33_PM.png?w=1650\u0026fit=max\u0026auto=format\u0026n=jFWn5xzleD8du3j6\u0026q=85\u0026s=6f1b59e0e75866ca85b38f405853e85f 1650w, https://mintcdn.com/onesignal/jFWn5xzleD8du3j6/images/docs/52f0d8bef7cac18c1d791ec229d2bd86e995a8e01401c7559e2476fcfecddc6d-Screenshot_2024-10-29_at_2.18.33_PM.png?w=2500\u0026fit=max\u0026auto=format\u0026n=jFWn5xzleD8du3j6\u0026q=85\u0026s=d5a2b364c0590a53a0b2a983d9ea0105 2500w`})}),_jsx(_components.p,{children:`트리거 옵션(전환율이 낮은 것부터 높은 것 순으로 대략적으로 정렬):`}),_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`앱 열기 시.`}),` 간단하지만 최적인 경우는 드뭅니다. 앱의 가치가 몇 초 안에 명확한 경우에만 사용하세요.`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`설정된 세션 시간 후.`}),` 좋은 기본값. 사용자가 앱을 탐색한 후에 요청하도록 기다립니다.`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`특정 사용자 이벤트 시.`}),` 전환에 가장 좋습니다. 온보딩 완료, 항목 저장, 토픽 팔로우, 첫 구매 완료 같은 신호가 강한 액션 이후에 트리거하세요.`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`프로그래밍 방식`}),`, `,_jsx(_components.a,{href:`/docs/ko/mobile-sdk-reference#addtrigger-addtriggers`,children:`인앱 메시지 트리거 SDK 메서드`}),`를 사용. 여러 신호를 결합한 후에 프롬프트하는 등 타이밍과 컨텍스트를 완전히 제어합니다.`]}),`\n`]}),_jsx(_components.p,{children:`예를 들어, 사용자가 앱에서 최소 5분을 보낼 때까지 기다리려면:`}),_jsx(Frame,{caption:`5분의 세션 시간 후 메시지를 표시하도록 구성된 트리거.`,children:_jsx(OptimizedImage,{src:`https://mintcdn.com/onesignal/0qspEXXeJ8zJbkJ-/images/docs/81f8cca652667ae5920dbc8b73cca1b297d9e5f35d5ed4dc23d05640a4c838ae-Screenshot_2024-10-29_at_2.25.25_PM.png?fit=max\u0026auto=format\u0026n=0qspEXXeJ8zJbkJ-\u0026q=85\u0026s=311ed96b93b789bb652cc365b5708d7a`,alt:`5분으로 설정된 세션 시간 트리거`,\"data-og-width\":`1792`,width:`1792`,\"data-og-height\":`624`,height:`624`,\"data-path\":`images/docs/81f8cca652667ae5920dbc8b73cca1b297d9e5f35d5ed4dc23d05640a4c838ae-Screenshot_2024-10-29_at_2.25.25_PM.png`,\"data-optimize\":`true`,\"data-opv\":`3`,srcset:`https://mintcdn.com/onesignal/0qspEXXeJ8zJbkJ-/images/docs/81f8cca652667ae5920dbc8b73cca1b297d9e5f35d5ed4dc23d05640a4c838ae-Screenshot_2024-10-29_at_2.25.25_PM.png?w=280\u0026fit=max\u0026auto=format\u0026n=0qspEXXeJ8zJbkJ-\u0026q=85\u0026s=5cd17b8a2b7c895e2fa6a182304be64b 280w, https://mintcdn.com/onesignal/0qspEXXeJ8zJbkJ-/images/docs/81f8cca652667ae5920dbc8b73cca1b297d9e5f35d5ed4dc23d05640a4c838ae-Screenshot_2024-10-29_at_2.25.25_PM.png?w=560\u0026fit=max\u0026auto=format\u0026n=0qspEXXeJ8zJbkJ-\u0026q=85\u0026s=320a2a40cf1cdca3e303f5fb8d98d2e4 560w, https://mintcdn.com/onesignal/0qspEXXeJ8zJbkJ-/images/docs/81f8cca652667ae5920dbc8b73cca1b297d9e5f35d5ed4dc23d05640a4c838ae-Screenshot_2024-10-29_at_2.25.25_PM.png?w=840\u0026fit=max\u0026auto=format\u0026n=0qspEXXeJ8zJbkJ-\u0026q=85\u0026s=d5b349b3d4dceff435b5145f71c5634b 840w, https://mintcdn.com/onesignal/0qspEXXeJ8zJbkJ-/images/docs/81f8cca652667ae5920dbc8b73cca1b297d9e5f35d5ed4dc23d05640a4c838ae-Screenshot_2024-10-29_at_2.25.25_PM.png?w=1100\u0026fit=max\u0026auto=format\u0026n=0qspEXXeJ8zJbkJ-\u0026q=85\u0026s=24a2ae0ff4592c69006da918ad40c70f 1100w, https://mintcdn.com/onesignal/0qspEXXeJ8zJbkJ-/images/docs/81f8cca652667ae5920dbc8b73cca1b297d9e5f35d5ed4dc23d05640a4c838ae-Screenshot_2024-10-29_at_2.25.25_PM.png?w=1650\u0026fit=max\u0026auto=format\u0026n=0qspEXXeJ8zJbkJ-\u0026q=85\u0026s=ada3a4e55bd285cb8c484cb2fb6696a1 1650w, https://mintcdn.com/onesignal/0qspEXXeJ8zJbkJ-/images/docs/81f8cca652667ae5920dbc8b73cca1b297d9e5f35d5ed4dc23d05640a4c838ae-Screenshot_2024-10-29_at_2.25.25_PM.png?w=2500\u0026fit=max\u0026auto=format\u0026n=0qspEXXeJ8zJbkJ-\u0026q=85\u0026s=ce4767e80f6b8eb06b6d5ef29df9c848 2500w`})})]}),_jsxs(Step,{title:`일정과 빈도`,children:[_jsx(_components.p,{children:`메시지가 표시되는 빈도를 제어하세요.`}),_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Only once.`}),` 처음에 준비되지 않았던 사용자를 전환할 가능성이 낮습니다.`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Every time conditions are met.`}),` 너무 공격적이며 사용자를 불편하게 할 수 있습니다.`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Multiple times (권장).`}),` 사용자당 최대 표시 횟수와 표시 사이 간격을 설정하세요. 예를 들어, `,_jsx(_components.code,{children:`20`}),`회 표시와 `,_jsx(_components.code,{children:`2 weeks`}),` 간격은 미구독 사용자에게 약 10개월 동안 공격적인 주기로 재프롬프트합니다. 참여도가 낮거나 유틸리티성 앱에서 2주 간격이 부담스럽게 느껴진다면 간격을 (예: `,_jsx(_components.code,{children:`30 days`}),` 또는 `,_jsx(_components.code,{children:`60 days`}),`처럼) 늘리세요.`]}),`\n`]}),_jsx(Frame,{caption:`인앱 메시지의 일정 및 빈도 설정.`,children:_jsx(OptimizedImage,{src:`https://mintcdn.com/onesignal/Xl2NHJvxakrK4JbL/images/docs/eb61a38c8908fbeba60833eecc357d720e747c37abacffdfe246dbd7758bbaf4-Screenshot_2024-10-29_at_2.28.20_PM.png?fit=max\u0026auto=format\u0026n=Xl2NHJvxakrK4JbL\u0026q=85\u0026s=7a49b641bdeb959dde6edad5ef7de9dc`,alt:`최대 표시 횟수와 표시 사이 간격을 보여주는 일정 구성`,\"data-og-width\":`1792`,width:`1792`,\"data-og-height\":`910`,height:`910`,\"data-path\":`images/docs/eb61a38c8908fbeba60833eecc357d720e747c37abacffdfe246dbd7758bbaf4-Screenshot_2024-10-29_at_2.28.20_PM.png`,\"data-optimize\":`true`,\"data-opv\":`3`,srcset:`https://mintcdn.com/onesignal/Xl2NHJvxakrK4JbL/images/docs/eb61a38c8908fbeba60833eecc357d720e747c37abacffdfe246dbd7758bbaf4-Screenshot_2024-10-29_at_2.28.20_PM.png?w=280\u0026fit=max\u0026auto=format\u0026n=Xl2NHJvxakrK4JbL\u0026q=85\u0026s=0ea6a8a31cc0f1afbdfeca45d7deb9f8 280w, https://mintcdn.com/onesignal/Xl2NHJvxakrK4JbL/images/docs/eb61a38c8908fbeba60833eecc357d720e747c37abacffdfe246dbd7758bbaf4-Screenshot_2024-10-29_at_2.28.20_PM.png?w=560\u0026fit=max\u0026auto=format\u0026n=Xl2NHJvxakrK4JbL\u0026q=85\u0026s=48dec4ab617d2ca48cc21ea476763cbd 560w, https://mintcdn.com/onesignal/Xl2NHJvxakrK4JbL/images/docs/eb61a38c8908fbeba60833eecc357d720e747c37abacffdfe246dbd7758bbaf4-Screenshot_2024-10-29_at_2.28.20_PM.png?w=840\u0026fit=max\u0026auto=format\u0026n=Xl2NHJvxakrK4JbL\u0026q=85\u0026s=6b7b0ee008a09ca720c0d7ce5713d70e 840w, https://mintcdn.com/onesignal/Xl2NHJvxakrK4JbL/images/docs/eb61a38c8908fbeba60833eecc357d720e747c37abacffdfe246dbd7758bbaf4-Screenshot_2024-10-29_at_2.28.20_PM.png?w=1100\u0026fit=max\u0026auto=format\u0026n=Xl2NHJvxakrK4JbL\u0026q=85\u0026s=2110522a632882c613855caef8cc55a3 1100w, https://mintcdn.com/onesignal/Xl2NHJvxakrK4JbL/images/docs/eb61a38c8908fbeba60833eecc357d720e747c37abacffdfe246dbd7758bbaf4-Screenshot_2024-10-29_at_2.28.20_PM.png?w=1650\u0026fit=max\u0026auto=format\u0026n=Xl2NHJvxakrK4JbL\u0026q=85\u0026s=334823315bd6b0a0dfc90e7be62cd2ae 1650w, https://mintcdn.com/onesignal/Xl2NHJvxakrK4JbL/images/docs/eb61a38c8908fbeba60833eecc357d720e747c37abacffdfe246dbd7758bbaf4-Screenshot_2024-10-29_at_2.28.20_PM.png?w=2500\u0026fit=max\u0026auto=format\u0026n=Xl2NHJvxakrK4JbL\u0026q=85\u0026s=764cf035135d0decc10e7a63d573938f 2500w`})})]})]}),`\n`,_jsx(_components.hr,{}),`\n`,_jsx(Heading,{level:`2`,id:`프로그래밍-방식으로-권한-프롬프트-표시`,children:`프로그래밍 방식으로 권한 프롬프트 표시`}),`\n`,_jsxs(_components.p,{children:[_jsx(_components.a,{href:`/docs/ko/mobile-sdk-reference#requestpermission-fallbacktosettings-push`,children:_jsx(_components.code,{children:`requestPermission()`})}),` 또는 `,_jsx(_components.a,{href:`/docs/ko/mobile-sdk-reference#optout-optin-optedin`,children:_jsx(_components.code,{children:`optIn()`})}),` SDK 메서드를 사용해 시스템 권한 프롬프트를 수동으로 트리거할 수 있습니다. 다음과 같은 사용자 지정 흐름에 유용합니다.`]}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[_jsx(_components.a,{href:`/docs/ko/preference-center`,children:`기본 설정 센터`}),`.`]}),`\n`,_jsx(_components.li,{children:`사용자 프로필 화면.`}),`\n`,_jsx(_components.li,{children:`특정 인앱 이벤트.`}),`\n`]}),`\n`,_jsxs(_components.p,{children:[`이미 거부한 사용자가 아무 일도 일어나지 않는 대신 앱의 알림 설정으로 리디렉션되도록 하려면 `,_jsx(_components.code,{children:`requestPermission()`}),`에 `,_jsx(_components.code,{children:`fallbackToSettings: true`}),`를 전달하세요.`]}),`\n`,_jsx(Note,{children:_jsxs(_components.p,{children:[_jsx(_components.code,{children:`optOut()`}),`을 통해 SDK 수준에서 구독이 옵트아웃된 경우(구독 레코드에 `,_jsx(_components.code,{children:`notification_types: -2`}),`로 표시됨), `,_jsx(_components.code,{children:`requestPermission()`}),` 단독으로는 구독 상태가 변경되지 않습니다. 대신 `,_jsx(_components.code,{children:`optIn()`}),`을 사용하세요. 권한을 요청함과 `,_jsx(_components.strong,{children:`동시에`}),` 옵트아웃 상태를 해제합니다.`]})}),`\n`,_jsx(_components.hr,{}),`\n`,_jsx(Heading,{level:`2`,id:`ios-임시-알림-사용`,children:`iOS 임시 알림 사용`}),`\n`,_jsx(_components.p,{children:`임시 푸시 알림은 iOS 12에서 도입되었습니다. 권한 프롬프트를 표시하지 않고도 알림 센터로 알림을 전달할 수 있습니다. 사용자는 앱의 실제 콘텐츠를 확인한 후 그 경험을 바탕으로 알림을 유지할지, 무음으로 할지, 끌지 결정합니다.`}),`\n`,_jsx(_components.p,{children:_jsx(_components.strong,{children:`전략으로서 효과적인 이유:`})}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsx(_components.li,{children:`실패할 시스템 프롬프트가 없습니다. 사전 옵트인 결정 없이도 첫 세션부터 사용자에게 도달하기 시작할 수 있습니다.`}),`\n`,_jsx(_components.li,{children:`사용자는 가상의 설명이 아닌 실제 가치를 기반으로 결정합니다.`}),`\n`,_jsx(_components.li,{children:`나중에 소프트 프롬프트를 표시하여 임시 사용자를 배너, 소리, 잠금 화면 알림이 포함된 전체 푸시 구독자로 전환할 수 있습니다.`}),`\n`]}),`\n`,_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`트레이드오프.`}),` 임시 알림은 가시성이 낮습니다. 알림 센터로만 조용히 전달되며, 사용자가 전체 권한으로 업그레이드하기 전까지는 배너, 소리, 잠금 화면 알림이 없습니다.`]}),`\n`,_jsx(Frame,{caption:`사용자에게 알림을 유지할지 끌지 묻는 임시 알림.`,children:_jsx(OptimizedImage,{src:`https://mintcdn.com/onesignal/l4Z9oMlZl9nJOS_T/images/push/ios-provisional-push-notifications.jpg?fit=max\u0026auto=format\u0026n=l4Z9oMlZl9nJOS_T\u0026q=85\u0026s=7c07a624b367b7c4cbf0572a7464311c`,alt:`Keep 및 Turn Off 옵션이 있는 iOS 임시 푸시 알림`,\"data-og-width\":`1062`,width:`1062`,\"data-og-height\":`585`,height:`585`,\"data-path\":`images/push/ios-provisional-push-notifications.jpg`,\"data-optimize\":`true`,\"data-opv\":`3`,srcset:`https://mintcdn.com/onesignal/l4Z9oMlZl9nJOS_T/images/push/ios-provisional-push-notifications.jpg?w=280\u0026fit=max\u0026auto=format\u0026n=l4Z9oMlZl9nJOS_T\u0026q=85\u0026s=d7ec8860cb295ca1eb9cfc515e4257be 280w, https://mintcdn.com/onesignal/l4Z9oMlZl9nJOS_T/images/push/ios-provisional-push-notifications.jpg?w=560\u0026fit=max\u0026auto=format\u0026n=l4Z9oMlZl9nJOS_T\u0026q=85\u0026s=96ecdcf6439d0c01482507192c4e5ed6 560w, https://mintcdn.com/onesignal/l4Z9oMlZl9nJOS_T/images/push/ios-provisional-push-notifications.jpg?w=840\u0026fit=max\u0026auto=format\u0026n=l4Z9oMlZl9nJOS_T\u0026q=85\u0026s=6f03bf3f084e8decf67b52ac73ce7301 840w, https://mintcdn.com/onesignal/l4Z9oMlZl9nJOS_T/images/push/ios-provisional-push-notifications.jpg?w=1100\u0026fit=max\u0026auto=format\u0026n=l4Z9oMlZl9nJOS_T\u0026q=85\u0026s=fe4629c29aa4c5b119a377f5d871e145 1100w, https://mintcdn.com/onesignal/l4Z9oMlZl9nJOS_T/images/push/ios-provisional-push-notifications.jpg?w=1650\u0026fit=max\u0026auto=format\u0026n=l4Z9oMlZl9nJOS_T\u0026q=85\u0026s=bb22e641535333a1953f7c34143afb0f 1650w, https://mintcdn.com/onesignal/l4Z9oMlZl9nJOS_T/images/push/ios-provisional-push-notifications.jpg?w=2500\u0026fit=max\u0026auto=format\u0026n=l4Z9oMlZl9nJOS_T\u0026q=85\u0026s=f7a0b7c4c80309a62a701a737b45a8eb 2500w`})}),`\n`,_jsxs(_components.p,{children:[`임시 승인을 활성화하려면 OneSignal 대시보드의 `,_jsx(_components.strong,{children:`Settings > Apple iOS > Advanced Configuration`}),`으로 이동하여 `,_jsx(_components.strong,{children:`Enable iOS 12 direct to history`}),`를 체크하세요. 사용자가 임시 알림과 상호작용하는 방식과 이를 표준 프롬프트와 결합하는 방법을 포함한 전체 안내는 `,_jsx(_components.a,{href:`/docs/ko/ios-provisional-push-notifications`,children:`iOS 임시 푸시 알림`}),`을 참조하세요.`]}),`\n`,_jsx(Tip,{children:_jsxs(_components.p,{children:[`임시 알림과 가치 있는 순간에 표시되는 소프트 프롬프트를 결합하는 구체적인 플레이북은 `,_jsx(_components.a,{href:`#example-onboarding-opt-in-strategy`,children:`예시 온보딩 옵트인 전략`}),`을 참조하세요.`]})}),`\n`,_jsx(_components.hr,{}),`\n`,_jsx(Heading,{level:`2`,id:`푸시-권한-및-프롬프트-결과-추적`,children:`푸시 권한 및 프롬프트 결과 추적`}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[_jsx(_components.a,{href:`/docs/ko/mobile-sdk-reference#addclicklistener-in-app`,children:`인앱 메시지 클릭 리스너`}),`로 사용자가 소프트 프롬프트에서 어떤 버튼을 탭했는지 추적하세요.`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.a,{href:`/docs/ko/mobile-sdk-reference#addlifecyclelistener`,children:`인앱 메시지 수명 주기 리스너`}),`로 노출과 닫기(사용자가 소프트 프롬프트를 봤지만 탭하지 않은 경우)를 추적하세요.`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.a,{href:`/docs/ko/mobile-sdk-reference#addpermissionobserver-push`,children:`푸시 권한 옵저버`}),`로 시스템 권한 프롬프트 자체의 결과를 추적하세요.`]}),`\n`]}),`\n`,_jsx(Info,{children:_jsx(_components.p,{children:`이러한 SDK 이벤트를 원하는 백엔드나 분석 도구로 전달할 수 있습니다.`})}),`\n`,_jsx(_components.hr,{}),`\n`,_jsx(Heading,{level:`2`,id:`faq`,children:`FAQ`}),`\n`,_jsx(Heading,{level:`3`,id:`사용자가-시스템-권한-프롬프트를-거부하면-어떻게-되나요`,children:`사용자가 시스템 권한 프롬프트를 거부하면 어떻게 되나요?`}),`\n`,_jsxs(_components.p,{children:[`iOS에서는 시스템 권한 프롬프트를 거부하면 앱의 푸시 알림이 영구적으로 비활성화됩니다. 프롬프트를 다시 표시할 수 없습니다. Android에서는 사용자에게 한 번 더 기회가 주어집니다(총 두 번). 모든 시도가 소진된 후에는 사용자가 기기의 `,_jsx(_components.strong,{children:`설정 > 알림`}),`에서 수동으로 알림을 다시 활성화해야 합니다. `,_jsx(_components.strong,{children:`Push Permission Prompt`}),` 클릭 액션과 `,_jsx(_components.a,{href:`/docs/ko/mobile-sdk-reference#requestpermission-fallbacktosettings-push`,children:_jsx(_components.code,{children:`requestPermission(fallbackToSettings: true)`})}),`는 모두 사용자를 알림 설정으로 직접 이동시켜 이를 처리합니다.`]}),`\n`,_jsx(Heading,{level:`3`,id:`네이티브-시스템-권한-프롬프트를-커스터마이즈할-수-있나요`,children:`네이티브 시스템 권한 프롬프트를 커스터마이즈할 수 있나요?`}),`\n`,_jsx(_components.p,{children:`아니요. iOS와 Android의 시스템 권한 프롬프트는 운영 체제가 제어하며 커스터마이즈할 수 없습니다. 커스터마이즈할 수 있는 것은 그 앞에 표시되는 인앱 메시지, 즉 소프트 프롬프트뿐입니다. 소프트 프롬프트로 알림의 가치를 설명하고, 기대치를 설정하며, 시스템 프롬프트에서 “Allow”를 선택할 가능성을 높이세요.`}),`\n`,_jsx(Heading,{level:`3`,id:`임시-알림을-받은-사용자에게도-프롬프트를-표시할-수-있나요`,children:`임시 알림을 받은 사용자에게도 프롬프트를 표시할 수 있나요?`}),`\n`,_jsxs(_components.p,{children:[`네, 그리고 그렇게 해야 합니다. 임시 알림 사용자는 이미 앱의 실제 알림을 경험했기 때문에 소프트 프롬프트의 최적 후보입니다. 권장 패턴은 `,_jsx(_components.a,{href:`#use-ios-provisional-notifications`,children:`iOS 임시 알림 사용`}),`을 참조하세요. 사용자가 임시 알림을 열거나 반응한 직후에 소프트 프롬프트 타이밍을 잡으세요.`]}),`\n`,_jsx(Heading,{level:`3`,id:`이전에-푸시를-거부한-사용자에게-다시-프롬프트하려면-어떻게-해야-하나요`,children:`이전에 푸시를 거부한 사용자에게 다시 프롬프트하려면 어떻게 해야 하나요?`}),`\n`,_jsxs(_components.p,{children:[`시스템 권한 프롬프트가 소진된 후에는(iOS에서 한 번, Android에서 두 번) 다시 표시할 수 없습니다. 대신 `,_jsx(_components.a,{href:`/docs/ko/mobile-sdk-reference#requestpermission-fallbacktosettings-push`,children:_jsx(_components.code,{children:`requestPermission(fallbackToSettings: true)`})}),` SDK 메서드나 인앱 메시지의 `,_jsx(_components.strong,{children:`Push Permission Prompt`}),` 클릭 액션을 사용하세요. 두 방법 모두 앱의 알림 설정을 열어 사용자가 수동으로 알림을 활성화할 수 있게 합니다. 알림이 왜 가치 있는지 설명하는 인앱 메시지와 함께 사용하세요.`]}),`\n`,_jsx(Heading,{level:`3`,id:`모든-android-버전에서-시스템-권한-프롬프트가-필요한가요`,children:`모든 Android 버전에서 시스템 권한 프롬프트가 필요한가요?`}),`\n`,_jsx(_components.p,{children:`아니요. Android 13(API 레벨 33) 이상에서만 필요합니다. Android 13은 런타임 알림 권한을 도입하여 푸시 알림에 대한 명시적인 사용자 동의를 요구합니다.`}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`출시:`}),` 2022년 8월(Pixel 기기).`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`대상 SDK 요구 사항:`}),` 2023년 8월 31일부터 Google Play의 모든 신규 앱과 업데이트는 API 레벨 33 이상을 대상으로 해야 합니다.`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`출처:`}),` `,_jsx(_components.a,{href:`https://developer.android.com/develop/ui/views/notifications/notification-permission`,children:`알림 권한에 대한 Google의 개발자 가이드`}),`.`]}),`\n`]}),`\n`,_jsx(_components.p,{children:`Android 12 이하에서는 앱 설치 시 알림 권한이 자동으로 부여됩니다.`}),`\n`,_jsx(_components.hr,{}),`\n`,_jsxs(Columns,{cols:2,children:[_jsx(Card,{title:`iOS 임시 푸시 알림`,icon:`apple`,href:`/docs/ko/ios-provisional-push-notifications`,children:_jsx(_components.p,{children:`iOS 12+에서 사전 권한 프롬프트 없이 알림 센터로 알림을 보냅니다.`})}),_jsx(Card,{title:`모바일 SDK 참조`,icon:`code`,href:`/docs/ko/mobile-sdk-reference#requestpermission-fallbacktosettings-push`,children:_jsxs(_components.p,{children:[_jsx(_components.code,{children:`requestPermission`}),`, `,_jsx(_components.code,{children:`optIn`}),`, 권한 옵저버, 인앱 클릭 리스너 API.`]})}),_jsx(Card,{title:`웹 푸시 권한 프롬프트`,icon:`globe`,href:`/docs/ko/permission-requests`,children:_jsx(_components.p,{children:`소프트 프롬프트, 슬라이드다운, 네이티브 웹 푸시 권한 요청을 구성합니다.`})}),_jsx(Card,{title:`인앱 메시지 설정`,icon:`message`,href:`/docs/ko/in-app-messages-setup`,children:_jsx(_components.p,{children:`소프트 프롬프트를 실행할 수 있도록 앱에서 인앱 메시징을 활성화합니다.`})})]})]})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{default:MDXContent};function _missingMdxReference(id,component){throw new Error(`Expected `+(component?`component`:`object`)+\" `\"+id+\"` to be defined: you likely forgot to import, pass, or provide it.\")}","frontmatter":{},"scope":{"config":{},"pageMetadata":{"title":"푸시 권한 요청","description":"전략적 타이밍, 인앱 소프트 프롬프트, iOS 임시 알림으로 iOS, Android, Huawei에서 푸시 알림 옵트인율을 높이세요.","keywords":["푸시 옵트인","푸시 구독자 늘리기","소프트 프롬프트","임시 알림","옵트인율","권한"],"href":"/docs/ko/prompt-for-push-permissions"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[{"title":"높은 옵트인율을 위한 전략","slug":"높은-옵트인율을-위한-전략","depth":2,"children":[{"title":"원칙","slug":"원칙","depth":3,"children":[]},{"title":"예시: 온보딩 옵트인 전략","slug":"예시-온보딩-옵트인-전략","depth":3,"children":[]}]},{"title":"접근 방식 선택","slug":"접근-방식-선택","depth":2,"children":[]},{"title":"사전 요구 사항","slug":"사전-요구-사항","depth":2,"children":[]},{"title":"인앱 푸시 권한 프롬프트 설정","slug":"인앱-푸시-권한-프롬프트-설정","depth":2,"children":[]},{"title":"프로그래밍 방식으로 권한 프롬프트 표시","slug":"프로그래밍-방식으로-권한-프롬프트-표시","depth":2,"children":[]},{"title":"iOS 임시 알림 사용","slug":"ios-임시-알림-사용","depth":2,"children":[]},{"title":"푸시 권한 및 프롬프트 결과 추적","slug":"푸시-권한-및-프롬프트-결과-추적","depth":2,"children":[]},{"title":"FAQ","slug":"faq","depth":2,"children":[{"title":"사용자가 시스템 권한 프롬프트를 거부하면 어떻게 되나요?","slug":"사용자가-시스템-권한-프롬프트를-거부하면-어떻게-되나요","depth":3,"children":[]},{"title":"네이티브 시스템 권한 프롬프트를 커스터마이즈할 수 있나요?","slug":"네이티브-시스템-권한-프롬프트를-커스터마이즈할-수-있나요","depth":3,"children":[]},{"title":"임시 알림을 받은 사용자에게도 프롬프트를 표시할 수 있나요?","slug":"임시-알림을-받은-사용자에게도-프롬프트를-표시할-수-있나요","depth":3,"children":[]},{"title":"이전에 푸시를 거부한 사용자에게 다시 프롬프트하려면 어떻게 해야 하나요?","slug":"이전에-푸시를-거부한-사용자에게-다시-프롬프트하려면-어떻게-해야-하나요","depth":3,"children":[]},{"title":"모든 Android 버전에서 시스템 권한 프롬프트가 필요한가요?","slug":"모든-android-버전에서-시스템-권한-프롬프트가-필요한가요","depth":3,"children":[]}]}],"codeExamples":{}},"jsLinks":["/_mintlify/custom/onesignal/e069c1b9f3157e14/hotjar-koala.js","/_mintlify/custom/onesignal/3e5d03885ab32f49/intercom.js","/_mintlify/custom/onesignal/dbb7af4794d1b586/munchkin-marketo.js"],"subdomain":"onesignal","siteName":"OneSignal Documentation","title":"푸시 권한 요청 - OneSignal Documentation","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{"en":{"href":"/docs/en/prompt-for-push-permissions","matchLevel":1},"cn":{"href":"/docs/cn/prompt-for-push-permissions","matchLevel":1},"ko":{"href":"/docs/ko/prompt-for-push-permissions","matchLevel":0},"ja":{"href":"/docs/ja/prompt-for-push-permissions","matchLevel":1},"tr":{"href":"/docs/tr/prompt-for-push-permissions","matchLevel":1},"pt-BR":{"href":"/docs/pt-BR/prompt-for-push-permissions","matchLevel":1},"es":{"href":"/docs/es/prompt-for-push-permissions","matchLevel":1},"fr":{"href":"/docs/fr/prompt-for-push-permissions","matchLevel":1}}},"lastModified":"2026-07-07T02:20:09.185Z","originalFileLocation":"docs/ko/prompt-for-push-permissions.mdx","locale":"ko"},"headHtml":"\u003cscript data-mint-head>(function(){var d=document.documentElement,p=null;if(!p){try{p=localStorage.getItem(\"isDarkMode\")}catch(e){}if(p==='true')p='dark';else if(p==='false')p='light';if(p!=='light'\u0026\u0026p!=='dark'\u0026\u0026p!=='system')p=\"system\"}var r=p==='system'?(matchMedia(\"(prefers-color-scheme: dark)\").matches?'dark':'light'):p;d.classList.remove(r==='dark'?'light':'dark');d.classList.add(r);d.setAttribute(\"data-theme-preference\",p)})();\u003c/script>\u003cmeta data-mint-head name=\"description\" content=\"전략적 타이밍, 인앱 소프트 프롬프트, iOS 임시 알림으로 iOS, Android, Huawei에서 푸시 알림 옵트인율을 높이세요.\">\u003cmeta data-mint-head name=\"application-name\" content=\"OneSignal Documentation\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/onesignal/eCiRydtW5fLfLRWp/_generated/favicon/android-chrome-192x192.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"apple-touch-icon\" type=\"image/png\" sizes=\"180x180\" href=\"/mintlify-assets/_mintlify/favicons/onesignal/eCiRydtW5fLfLRWp/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/onesignal/eCiRydtW5fLfLRWp/_generated/favicon/favicon-16x16.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/onesignal/eCiRydtW5fLfLRWp/_generated/favicon/favicon-32x32.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/onesignal/eCiRydtW5fLfLRWp/_generated/favicon/favicon.ico\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/onesignal/eCiRydtW5fLfLRWp/_generated/favicon-dark/android-chrome-192x192.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/onesignal/eCiRydtW5fLfLRWp/_generated/favicon-dark/favicon-16x16.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/onesignal/eCiRydtW5fLfLRWp/_generated/favicon-dark/favicon-32x32.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/onesignal/eCiRydtW5fLfLRWp/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"푸시 권한 요청 - OneSignal Documentation\">\u003cmeta data-mint-head property=\"og:description\" content=\"전략적 타이밍, 인앱 소프트 프롬프트, iOS 임시 알림으로 iOS, Android, Huawei에서 푸시 알림 옵트인율을 높이세요.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"OneSignal Documentation\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://documentation.onesignal.com/docs/ko/prompt-for-push-permissions\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://onesignal.mintlify.site/_mintlify/api/og/v2?division=%EB%AA%A8%EB%B0%94%EC%9D%BC+%ED%91%B8%EC%8B%9C\u0026amp;title=%ED%91%B8%EC%8B%9C+%EA%B6%8C%ED%95%9C+%EC%9A%94%EC%B2%AD\u0026amp;description=%EC%A0%84%EB%9E%B5%EC%A0%81+%ED%83%80%EC%9D%B4%EB%B0%8D%2C+%EC%9D%B8%EC%95%B1+%EC%86%8C%ED%94%84%ED%8A%B8+%ED%94%84%EB%A1%AC%ED%94%84%ED%8A%B8%2C+iOS+%EC%9E%84%EC%8B%9C+%EC%95%8C%EB%A6%BC%EC%9C%BC%EB%A1%9C+iOS%2C+Android%2C+Huawei%EC%97%90%EC%84%9C+%ED%91%B8%EC%8B%9C+%EC%95%8C%EB%A6%BC+%EC%98%B5%ED%8A%B8%EC%9D%B8%EC%9C%A8%EC%9D%84+%EB%86%92%EC%9D%B4%EC%84%B8%EC%9A%94.\u0026amp;theme=12e705baa88dc8cc6d7a9877\u0026amp;signature=c813ea342026ab95329211040cf3e59e49b59f4ae0457bfc288fc84a812448da\">\u003cmeta data-mint-head property=\"og:image:width\" content=\"1200\">\u003cmeta data-mint-head property=\"og:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"twitter:card\" content=\"summary_large_image\">\u003cmeta data-mint-head name=\"twitter:title\" content=\"푸시 권한 요청 - OneSignal Documentation\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"전략적 타이밍, 인앱 소프트 프롬프트, iOS 임시 알림으로 iOS, Android, Huawei에서 푸시 알림 옵트인율을 높이세요.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://onesignal.mintlify.site/_mintlify/api/og/v2?division=%EB%AA%A8%EB%B0%94%EC%9D%BC+%ED%91%B8%EC%8B%9C\u0026amp;title=%ED%91%B8%EC%8B%9C+%EA%B6%8C%ED%95%9C+%EC%9A%94%EC%B2%AD\u0026amp;description=%EC%A0%84%EB%9E%B5%EC%A0%81+%ED%83%80%EC%9D%B4%EB%B0%8D%2C+%EC%9D%B8%EC%95%B1+%EC%86%8C%ED%94%84%ED%8A%B8+%ED%94%84%EB%A1%AC%ED%94%84%ED%8A%B8%2C+iOS+%EC%9E%84%EC%8B%9C+%EC%95%8C%EB%A6%BC%EC%9C%BC%EB%A1%9C+iOS%2C+Android%2C+Huawei%EC%97%90%EC%84%9C+%ED%91%B8%EC%8B%9C+%EC%95%8C%EB%A6%BC+%EC%98%B5%ED%8A%B8%EC%9D%B8%EC%9C%A8%EC%9D%84+%EB%86%92%EC%9D%B4%EC%84%B8%EC%9A%94.\u0026amp;theme=12e705baa88dc8cc6d7a9877\u0026amp;signature=c813ea342026ab95329211040cf3e59e49b59f4ae0457bfc288fc84a812448da\">\u003cmeta data-mint-head name=\"twitter:image:width\" content=\"1200\">\u003cmeta data-mint-head name=\"twitter:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"msapplication-config\" content=\"/mintlify-assets/_mintlify/favicons/onesignal/eCiRydtW5fLfLRWp/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"OneSignal Docs\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#3A3DB3\">\u003clink data-mint-head rel=\"canonical\" href=\"https://documentation.onesignal.com/docs/ko/prompt-for-push-permissions\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/docs/ko/prompt-for-push-permissions.md\">\u003clink data-mint-head rel=\"alternate\" hreflang=\"ko\" href=\"https://documentation.onesignal.com/docs/ko/prompt-for-push-permissions\">\u003clink data-mint-head rel=\"alternate\" hreflang=\"en\" href=\"https://documentation.onesignal.com/docs/en/prompt-for-push-permissions\">\u003clink data-mint-head rel=\"alternate\" hreflang=\"zh\" href=\"https://documentation.onesignal.com/docs/cn/prompt-for-push-permissions\">\u003clink data-mint-head rel=\"alternate\" hreflang=\"ja\" href=\"https://documentation.onesignal.com/docs/ja/prompt-for-push-permissions\">\u003clink data-mint-head rel=\"alternate\" hreflang=\"tr\" href=\"https://documentation.onesignal.com/docs/tr/prompt-for-push-permissions\">\u003clink data-mint-head rel=\"alternate\" hreflang=\"pt-BR\" href=\"https://documentation.onesignal.com/docs/pt-BR/prompt-for-push-permissions\">\u003clink data-mint-head rel=\"alternate\" hreflang=\"es\" href=\"https://documentation.onesignal.com/docs/es/prompt-for-push-permissions\">\u003clink data-mint-head rel=\"alternate\" hreflang=\"fr\" href=\"https://documentation.onesignal.com/docs/fr/prompt-for-push-permissions\">\u003clink data-mint-head rel=\"alternate\" hreflang=\"x-default\" href=\"https://documentation.onesignal.com/docs/en/prompt-for-push-permissions\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://documentation.onesignal.com/#organization\",\"name\":\"OneSignal Documentation\",\"url\":\"https://documentation.onesignal.com\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/onesignal/yJcueeDCO7UpHnnY/logo/OneSignal-Logo.svg?fit=max\u0026auto=format\u0026n=yJcueeDCO7UpHnnY\u0026q=85\u0026s=1fcfb6fef6d820fd9d99c74850711107\"}},{\"@type\":\"WebSite\",\"@id\":\"https://documentation.onesignal.com#website\",\"name\":\"OneSignal Documentation\",\"url\":\"https://documentation.onesignal.com\",\"publisher\":{\"@id\":\"https://documentation.onesignal.com/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://documentation.onesignal.com/docs/ko/prompt-for-push-permissions#webpage\",\"url\":\"https://documentation.onesignal.com/docs/ko/prompt-for-push-permissions\",\"name\":\"푸시 권한 요청\",\"description\":\"전략적 타이밍, 인앱 소프트 프롬프트, iOS 임시 알림으로 iOS, Android, Huawei에서 푸시 알림 옵트인율을 높이세요.\",\"dateModified\":\"2026-07-07T02:20:09.185Z\",\"isPartOf\":{\"@id\":\"https://documentation.onesignal.com#website\"},\"breadcrumb\":{\"@id\":\"https://documentation.onesignal.com/docs/ko/prompt-for-push-permissions#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://documentation.onesignal.com/docs/ko/prompt-for-push-permissions#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"메시지 채널\",\"item\":\"https://documentation.onesignal.com/docs/ko/channel-setup\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"푸시\",\"item\":\"https://documentation.onesignal.com/docs/ko/push\"},{\"@type\":\"ListItem\",\"position\":3,\"name\":\"모바일 푸시\",\"item\":\"https://documentation.onesignal.com/docs/ko/mobile-push-setup\"},{\"@type\":\"ListItem\",\"position\":4,\"name\":\"푸시 권한 요청\",\"item\":\"https://documentation.onesignal.com/docs/ko/prompt-for-push-permissions\"}]},{\"@type\":[\"Article\",\"TechArticle\"],\"@id\":\"https://documentation.onesignal.com/docs/ko/prompt-for-push-permissions#article\",\"headline\":\"푸시 권한 요청\",\"name\":\"푸시 권한 요청\",\"description\":\"전략적 타이밍, 인앱 소프트 프롬프트, iOS 임시 알림으로 iOS, Android, Huawei에서 푸시 알림 옵트인율을 높이세요.\",\"url\":\"https://documentation.onesignal.com/docs/ko/prompt-for-push-permissions\",\"mainEntityOfPage\":{\"@id\":\"https://documentation.onesignal.com/docs/ko/prompt-for-push-permissions#webpage\"},\"dateModified\":\"2026-07-07T02:20:09.185Z\",\"keywords\":\"푸시 옵트인, 푸시 구독자 늘리기, 소프트 프롬프트, 임시 알림, 옵트인율, 권한\",\"publisher\":{\"@id\":\"https://documentation.onesignal.com/#organization\"},\"isPartOf\":{\"@id\":\"https://documentation.onesignal.com#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"OneSignal Documentation\",\"creator\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","siteName":"OneSignal Documentation","nav":{"global":null,"languages":[{"language":"en","pages":[{"title":"en","href":"/docs/en/prompt-for-push-permissions"}]},{"language":"cn","pages":[{"title":"cn","href":"/docs/cn/prompt-for-push-permissions"}]},{"language":"ko","tabs":[{"tab":"홈","pages":[{"title":"홈","href":"/docs/ko/home"}]},{"tab":"사용자 가이드","groups":[{"group":"시작하기 \u0026 설정","pages":[{"title":"OneSignal 시작하기","href":"/docs/ko/quickstart-guide"},{"group":"OneSignal 대시보드","pages":[{"title":"앱, 조직 및 계정","href":"/docs/ko/apps-organizations"},{"title":"팀 멤버","href":"/docs/ko/manage-team-members"},{"title":"키 및 ID","href":"/docs/ko/keys-and-ids"},{"title":"감사 로그","href":"/docs/ko/audit-logs"},{"title":"사용량 및 청구","href":"/docs/ko/billing-faq"},{"title":"비활성화된 앱 및 조직","href":"/docs/ko/disabled-apps"}]},{"title":"OneSignal로 마이그레이션","href":"/docs/ko/migrating-to-onesignal"}]},{"group":"메시지 채널","pages":[{"title":"채널 설정","href":"/docs/ko/channel-setup"},{"group":"푸시","pages":[{"title":"푸시 개요","href":"/docs/ko/push"},{"group":"모바일 푸시","pages":[{"title":"모바일 푸시 설정","description":"iOS, Android, Huawei, Amazon 전반에서 OneSignal로 모바일 푸시 알림을 설정하는 체크리스트입니다. SDK 통합, FCM·APNs·HMS·ADM 자격 증명 구성, 권한 프롬프트, 딥 링크와 테스트까지 단계별로 안내합니다.","href":"/docs/ko/mobile-push-setup"},{"title":"푸시 권한 요청","href":"/docs/ko/prompt-for-push-permissions"},{"title":"iOS 임시 푸시 알림","description":"iOS의 임시 푸시 알림을 사용하면 사전 권한 요청 없이 앱이 알림을 보낼 수 있지만, 표시 우선순위가 낮아집니다.","href":"/docs/ko/ios-provisional-push-notifications"},{"title":"Android 알림 카테고리","href":"/docs/ko/android-notification-categories"},{"title":"데이터 및 백그라운드 알림","href":"/docs/ko/data-notifications"},{"title":"VoIP 푸시 알림","href":"/docs/ko/voip-notifications"}]},{"group":"웹 푸시","pages":[{"title":"웹 푸시 설정","href":"/docs/ko/web-push-setup"},{"title":"Web 권한 프롬프트","href":"/docs/ko/permission-requests"},{"title":"웹 푸시 FAQ","href":"/docs/ko/web-push-setup-faq"},{"title":"웹 푸시 브라우저 동작","href":"/docs/ko/browser-behavior-and-unsubscribes"},{"title":"웹 푸시를 위한 OneSignal WordPress 플러그인 설정","href":"/docs/ko/wordpress"},{"title":"WordPress 문제 해결","href":"/docs/ko/troubleshooting-wordpress-web-push"},{"title":"Shopify 웹 푸시 통합","href":"/docs/ko/shopify"}]},{"group":"푸시 기능","pages":[{"title":"알림 아이콘","href":"/docs/ko/notification-icons"},{"title":"알림 이미지 및 리치 미디어","href":"/docs/ko/rich-media"},{"title":"알림 사운드","href":"/docs/ko/notification-sounds"},{"title":"알림 배지","href":"/docs/ko/badges"},{"title":"푸시 알림용 액션 버튼","href":"/docs/ko/action-buttons"},{"title":"푸시 빈도 제한","href":"/docs/ko/frequency-capping"},{"title":"푸시 제한","href":"/docs/ko/throttling"},{"title":"iOS: 집중 모드 및 중단 수준","href":"/docs/ko/ios-focus-modes-and-interruption-levels"},{"title":"iOS: 관련성 점수","href":"/docs/ko/ios-relevance-score"}]},{"group":"푸시 분석 \u0026 문제 해결","pages":[{"title":"푸시 메시지 리포트","href":"/docs/ko/push-notification-message-reports"},{"title":"확인된 전달","href":"/docs/ko/confirmed-delivery"},{"title":"알림 CTR","href":"/docs/ko/notification-ctr"},{"title":"모바일 푸시: 알림이 표시되지 않거나 지연됨","href":"/docs/ko/notifications-show-successful-but-are-not-being-shown"},{"title":"Web push: 알림이 표시되지 않음","href":"/docs/ko/notifications-not-shown-web-push"},{"title":"알림 이미지가 표시되지 않음","href":"/docs/ko/notification-images-not-showing"},{"title":"중복 알림","href":"/docs/ko/duplicated-notifications"},{"title":"FCM 만료 토큰 FAQ","href":"/docs/ko/fcm-expired-token-faq"}]}]},{"group":"인앱 메시지","pages":[{"title":"인앱 개요","href":"/docs/ko/in-app-messages-setup"},{"title":"인앱 트리거","href":"/docs/ko/iam-triggers"},{"title":"인앱 클릭 작업","href":"/docs/ko/iam-click-actions"},{"group":"인앱 디자인","pages":[{"title":"드래그 앤 드롭으로 인앱 메시지 디자인하기","href":"/docs/ko/design-your-in-app-message"},{"title":"HTML로 인앱 메시지 디자인하기","href":"/docs/ko/design-your-in-app-message-with-html"},{"title":"인앱 메시지 템플릿 및 퀵스타트","href":"/docs/ko/in-app-html-templates"},{"title":"인앱 메시지 JavaScript API 레퍼런스","href":"/docs/ko/in-app-message-api"}]},{"title":"인앱 메시지 보고서","href":"/docs/ko/in-app-message-reports"},{"title":"인앱 문제 해결","href":"/docs/ko/in-app-message-troubleshooting"}]},{"group":"이메일","pages":[{"title":"이메일 개요","href":"/docs/ko/email-messaging"},{"group":"Email setup","pages":[{"title":"이메일 설정","href":"/docs/ko/email-setup"},{"title":"이메일 DNS 구성","href":"/docs/ko/email-dns-configuration"},{"title":"발신자","href":"/docs/ko/senders"},{"title":"트랜잭션 이메일","href":"/docs/ko/setup-transactional-emails"},{"title":"사용자 지정 이메일 수신 거부 페이지 만들기","href":"/docs/ko/create-custom-unsubscribe-page"}]},{"group":"이메일 전달 가능성","pages":[{"title":"이메일 메시지 보고서","href":"/docs/ko/email-message-reports"},{"title":"이메일 전달 가능성","href":"/docs/ko/email-deliverability"},{"title":"이메일 평판 모범 사례","href":"/docs/ko/email-reputation-best-practices"},{"title":"이메일 주소 유효성 검사","href":"/docs/ko/email-address-validation"},{"title":"이메일 준비 가이드","href":"/docs/ko/email-warm-up"},{"title":"Google Postmaster Tools","href":"/docs/ko/google-postmaster-tools"},{"title":"차단 목록","href":"/docs/ko/suppressions"},{"title":"이메일 문제 해결","href":"/docs/ko/email-troubleshooting"}]},{"group":"이메일 메시지","pages":[{"title":"드래그 앤 드롭으로 이메일 디자인하기","href":"/docs/ko/design-emails-with-drag-and-drop"},{"title":"HTML로 이메일 디자인하기","href":"/docs/ko/design-emails-with-html"},{"title":"이메일 구독 취소 링크 및 헤더","href":"/docs/ko/unsubscribe-links-email-subscriptions"},{"title":"이메일 템플릿 전달","href":"/docs/ko/email-template-forwarding"}]}]},{"group":"SMS 및 RCS","pages":[{"title":"SMS, MMS, RCS 개요","href":"/docs/ko/sms-messaging"},{"title":"Rich Communication Services (RCS)","href":"/docs/ko/rcs-messaging"},{"group":"SMS 설정","pages":[{"title":"SMS 설정","href":"/docs/ko/sms-setup"},{"title":"발신자 리소스 신청 및 국가별 요구사항","sidebarTitle":"발신자 리소스 신청","href":"/docs/ko/sms-registration-requirements"},{"title":"SMS 옵트인 및 수집","href":"/docs/ko/sms-opt-in-and-collection"},{"title":"SMS 동의 키워드 관리","href":"/docs/ko/sms-consent-keyword-management"},{"title":"SMS 키워드","href":"/docs/ko/keywords"}]},{"group":"SMS 메시지","pages":[{"title":"SMS 메시지 리포트","href":"/docs/ko/sms-message-reports"},{"title":"일회용 비밀번호(OTP)","sidebarTitle":"일회용 비밀번호","href":"/docs/ko/sms-verify"}]}]},{"group":"실시간 현황","pages":[{"title":"Live Activities","href":"/docs/ko/live-activities"},{"title":"Live Activities 분석","href":"/docs/ko/live-activities-analytics"}]},{"group":"기능","pages":[{"title":"A/B 테스팅","href":"/docs/ko/ab-testing"},{"title":"다국어 메시징","href":"/docs/ko/multi-language-messaging"},{"group":"메시지 개인화","pages":[{"title":"개인화","href":"/docs/ko/message-personalization"},{"title":"Liquid 구문 사용","href":"/docs/ko/using-liquid-syntax"},{"title":"데이터 피드","href":"/docs/ko/data-feeds"},{"title":"Custom Events로 개인화하기","href":"/docs/ko/personalization-custom-event"},{"title":"속성을 사용한 개인화","href":"/docs/ko/personalization-properties-and-tags"},{"title":"API custom_data로 메시지 개인화하기","href":"/docs/ko/personalization-api-custom-data"},{"title":"CSV를 사용한 동적 콘텐츠","href":"/docs/ko/dynamic-content"}]},{"group":"URL, 링크, 딥 링크","pages":[{"title":"URL, 링크 및 딥 링크","href":"/docs/ko/links"},{"title":"딥 링킹","href":"/docs/ko/deep-linking"},{"title":"이메일 구독 취소 링크 및 헤더","href":"/docs/ko/unsubscribe-links-email-subscriptions"}]},{"title":"리타겟팅 메시지","href":"/docs/ko/retargeting"},{"title":"템플릿","href":"/docs/ko/templates"},{"title":"레이블","href":"/docs/ko/labels"}]}]},{"group":"Journeys","pages":[{"title":"Journey 개요","href":"/docs/ko/journeys-overview"},{"group":"Journey 기능","pages":[{"title":"Journey 설정","href":"/docs/ko/journeys-settings"},{"title":"Journey 메시지","href":"/docs/ko/journeys-messages"},{"title":"Journey 액션","href":"/docs/ko/journeys-actions"},{"title":"Journey Webhook","href":"/docs/ko/journeys-webhook"},{"title":"Journey Webhook을 통해 WhatsApp 메시지 보내기","href":"/docs/ko/sending-whatsapp-messages-via-journey-webhooks"},{"title":"Journeys 관리","href":"/docs/ko/managing-journeys"},{"title":"Journey 분석","href":"/docs/ko/journeys-analytics"}]},{"title":"Journey 예시","href":"/docs/ko/journeys-examples"}]},{"group":"오디언스 \u0026 사용자 지정 이벤트","pages":[{"title":"세그먼트","href":"/docs/ko/segmentation"},{"group":"Users \u0026 Subscriptions","pages":[{"title":"사용자","href":"/docs/ko/users"},{"title":"구독","href":"/docs/ko/subscriptions"},{"title":"별칭","href":"/docs/ko/aliases"},{"title":"테스트 사용자","href":"/docs/ko/test-users"},{"title":"사용자 삭제","href":"/docs/ko/delete-users"}]},{"group":"사용자 지정 이벤트","pages":[{"title":"사용자 지정 이벤트","href":"/docs/ko/custom-events"},{"title":"사용자 지정 이벤트 저장 및 보존","href":"/docs/ko/custom-event-storage"}]},{"group":"태그","pages":[{"title":"태그","href":"/docs/ko/add-user-data-tags"},{"title":"태그: 시간 연산자","href":"/docs/ko/time-operators"}]},{"title":"가져오기","href":"/docs/ko/import"}]},{"group":"분석 \u0026 통합","pages":[{"group":"분석","pages":[{"title":"분석 개요","href":"/docs/ko/analytics-overview"},{"title":"목표","sidebarTitle":"목표","href":"/docs/ko/goals"},{"title":"템플릿 분석","href":"/docs/ko/template-analytics"},{"title":"데이터 내보내기","href":"/docs/ko/exporting-data"},{"title":"사용자 지정 Outcomes","href":"/docs/ko/custom-outcomes"},{"title":"전환 지표","href":"/docs/ko/conversion-metrics"},{"title":"참여 트렌드","href":"/docs/ko/engagement-analytics"},{"title":"구독 트렌드","href":"/docs/ko/subscription-trends"},{"group":"리텐션 지표","pages":[{"title":"리텐션 지표","href":"/docs/ko/retention-metrics"},{"title":"리텐션 곡선 해석","href":"/docs/ko/interpreting-retention-curves"}]},{"title":"지표 용어집","href":"/docs/ko/analytics-metrics-glossary"}]},{"group":"이벤트 스트림","pages":[{"title":"이벤트 스트림","href":"/docs/ko/event-streams"},{"title":"이벤트 스트림 데이터 참조","sidebarTitle":"이벤트 스트림 데이터","href":"/docs/ko/event-streams-data"},{"title":"인앱 메시지 이벤트 스트림","href":"/docs/ko/iam-event-streams"},{"title":"Event Streams와 Google Sheets 통합","href":"/docs/ko/google-sheets-integration-with-event-streams"}]},{"group":"통합","pages":[{"title":"통합 개요","href":"/docs/ko/integrations"},{"title":"데이터 웨어하우스, DMP 및 CRM 통합","href":"/docs/ko/database-dmp-crm-integration"},{"group":"OneSignal을 데이터 소스로 사용","pages":[{"title":"Amplitude","href":"/docs/ko/amplitude"},{"title":"Databricks","href":"/docs/ko/databricks"},{"title":"Google BigQuery","href":"/docs/ko/bigquery"},{"title":"Mixpanel","href":"/docs/ko/mixpanel"},{"title":"Snowflake","href":"/docs/ko/snowflake"},{"title":"Segment (Twilio)","href":"/docs/ko/segment-onesignal-integration"}]},{"group":"OneSignal을 데이터 목적지로 사용","pages":[{"title":"Adobe Audience Manager","href":"/docs/ko/adobe-audience-manager"},{"title":"AlloyDB","href":"/docs/ko/alloydb"},{"title":"Amazon Athena","href":"/docs/ko/amazon-athena"},{"title":"Amazon S3","href":"/docs/ko/s3"},{"title":"Amplitude","href":"/docs/ko/amplitude"},{"title":"Apache Kafka","href":"/docs/ko/kafka"},{"title":"Amazon Redshift","href":"/docs/ko/amazon-redshift"},{"title":"Azure Synapse","href":"/docs/ko/azure-synapse"},{"title":"ClickHouse","href":"/docs/ko/clickhouse"},{"title":"Confluent Cloud","href":"/docs/ko/confluent-cloud"},{"title":"Databricks","href":"/docs/ko/databricks"},{"title":"Elasticsearch","href":"/docs/ko/elasticsearch"},{"title":"Google BigQuery","href":"/docs/ko/bigquery"},{"title":"Google Cloud SQL","href":"/docs/ko/google-cloud-sql"},{"title":"Google Sheets","href":"/docs/ko/google-sheets"},{"title":"Greenplum","href":"/docs/ko/greenplum"},{"title":"HubSpot","href":"/docs/ko/hubspot"},{"title":"Materialize","href":"/docs/ko/materialize"},{"title":"Microsoft Fabric","href":"/docs/ko/microsoft-fabric"},{"title":"Mixpanel","href":"/docs/ko/mixpanel"},{"title":"MotherDuck","href":"/docs/ko/motherduck"},{"title":"MySQL","href":"/docs/ko/mysql"},{"title":"PostgreSQL","href":"/docs/ko/postgresql"},{"title":"Pub/Sub","href":"/docs/ko/google-pubsub"},{"title":"SingleStore","href":"/docs/ko/singlestore"},{"title":"Snowflake","href":"/docs/ko/snowflake"},{"title":"SQL Server","href":"/docs/ko/sql-server"},{"title":"Starburst Enterprise","href":"/docs/ko/starburst-enterprise"},{"title":"Starburst Galaxy","href":"/docs/ko/starburst-galaxy"},{"title":"Trino","href":"/docs/ko/trino"},{"title":"Segment (Twilio)","href":"/docs/ko/segment-onesignal-integration"}]},{"group":"소비자 추적","pages":[{"title":"RevenueCat","href":"/docs/ko/revenuecat"},{"title":"Adjust","href":"/docs/ko/adjust"},{"title":"BlueConic","href":"/docs/ko/blueconic"}]},{"title":"OneSignal과 통합 구축: 파트너 가이드","href":"/docs/ko/building-an-integration-with-onesignal-partner-guide"}]}]},{"group":"개인 정보 보호 \u0026 보안","pages":[{"group":"보안 자격 증명","pages":[{"title":"SOC 2 Type II","href":"/docs/ko/soc-2-type-ii"},{"title":"ISO 27001","href":"/docs/ko/iso27001"},{"title":"HIPAA","href":"/docs/ko/hipaa"}]},{"group":"데이터 개인 정보 보호 \u0026 규정 준수","pages":[{"title":"GDPR 및 개인 권리","href":"/docs/ko/gdpr-compliance"},{"title":"EU-US 데이터 개인 정보 보호 프레임워크","href":"/docs/ko/eu-us-data-privacy-framework"},{"title":"이메일 규정 준수","href":"/docs/ko/email-compliance"},{"title":"SMS 규제 준수","href":"/docs/ko/sms-regulatory-compliance"},{"title":"Apple 앱 개인정보 보호 요구 사항","href":"/docs/ko/apple-app-privacy-requirements"},{"title":"Google Play 데이터 보안 요구 사항","href":"/docs/ko/google-play-data-safety-requirements"},{"title":"데이터 수집 및 보안 FAQ","href":"/docs/ko/data-questions"},{"title":"OneSignal SDK가 수집하는 데이터","href":"/docs/ko/data-collected-by-the-onesignal-sdk"},{"title":"개인 데이터 처리","href":"/docs/ko/handling-personal-data"}]},{"group":"인증 및 보안","pages":[{"title":"2단계 인증","href":"/docs/ko/2-step-authentication"},{"title":"Single Sign-On (SSO)","href":"/docs/ko/sso"}]}]}]},{"tab":"개발자 가이드","pages":[{"title":"개발자 가이드","href":"/docs/ko/developers"}]},{"tab":"튜토리얼","pages":[{"title":"튜토리얼","href":"/docs/ko/tutorials"}]},{"tab":"API Reference","pages":[{"title":"API Reference","href":"/reference/rest-api-overview"}]},{"tab":"Release Notes","pages":[{"title":"Release Notes","href":"/release-notes/changelog"}]}],"global":{"anchors":[{"anchor":"Blog","icon":"newspaper","href":"https://onesignal.com/blog"},{"anchor":"GitHub","icon":"github","href":"https://github.com/OneSignal"},{"anchor":"YouTube","icon":"youtube","href":"https://www.youtube.com/@onesignalofficial/playlists"}]}},{"language":"ja","pages":[{"title":"ja","href":"/docs/ja/prompt-for-push-permissions"}]},{"language":"tr","pages":[{"title":"tr","href":"/docs/tr/prompt-for-push-permissions"}]},{"language":"pt-BR","pages":[{"title":"pt-BR","href":"/docs/pt-BR/prompt-for-push-permissions"}]},{"language":"es","pages":[{"title":"es","href":"/docs/es/prompt-for-push-permissions"}]},{"language":"fr","pages":[{"title":"fr","href":"/docs/fr/prompt-for-push-permissions"}]}]},"basePath":"","title":"푸시 권한 요청 - OneSignal Documentation","buildId":"dpl_42LwxxU1kGN114H4XzwGYXa9ZDah","deploymentId":"dpl_42LwxxU1kGN114H4XzwGYXa9ZDah","dynamics":["07c022d89b","a74be98ba7"],"chunks":["Frame-5Xwp92K7.js","DynamicMarkdown-BoyYAA8K.js","zoom-image-lightbox-DkE6VzSN.js","lightbox-handle-r17bVUz3.js"]}
