푸시 플랫폼(Android, iOS, Huawei, Amazon)은 제목이나 메시지를 고정된 글자 수에서 자르지 않습니다. 텍스트가 잘리는 위치는 기기, 화면 방향 및 사용자의 시스템 텍스트 크기(접근성 모드)에 따라 달라집니다. Android에서는 런처와 제조사에 따라서도 다릅니다.OneSignal과 전달 서비스(APNs, FCM 등)는 알림을 전송할 뿐 기기가 알림을 렌더링하는 방식은 제어하지 않으므로, 어떤 API나 페이로드 옵션으로도 잘림을 재정의할 수 없습니다. 동일한 텍스트가 한 기기에서는 전부 표시되고 다른 기기에서는 잘릴 수 있습니다.
메시지가 아직 전달되지 않은 경우 메시지를 취소할 수 있습니다. OneSignal은 대기열에 추가되지 않은 모든 구독으로 메시지 전송을 중지합니다. 이미 전달된 경우 기기에서 메시지를 제거하지 않습니다.메시지 리포트에서 Actions > Cancel을 선택하거나 Cancel Message API를 사용합니다.
모든 플랫폼에서 총 페이로드 크기는 약 4KB입니다. data 필드는 최대 2048바이트를 지원합니다. 이러한 제한을 초과하면 알림이 잘리거나 거부될 수 있습니다.
이는 화면에 표시되는 제목/본문 잘림과는 다릅니다. 페이로드 크기는 전달 전에 APNs/FCM이 적용하는 엄격한 제한입니다. 제목과 본문의 표시 잘림은 전달 후 기기에서 발생하며 운영 체제 렌더링에 따라 달라집니다. 위의 제목을 참조하세요.
이 페이지가 도움이 되었나요?
{"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":"6af263cb6575a850b3cad407","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":"custom-rbac-roles","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}],"googleFontsInlined":true},"customCss":[],"page":{"pagePath":"docs/ko/push","slug":"/docs/ko/push","pageMetadata":{"title":"푸시 개요","description":"OneSignal 대시보드와 API로 타겟팅, 개인화, 예약 기능을 활용해 모바일 및 웹 푸시 알림을 전송·관리하는 방법을 안내합니다. iOS, Android, 웹 채널 설정 단계와 이미지, 버튼 등 리치 콘텐츠 옵션, 분석까지 다룹니다.","keywords":["push","푸시 알림","푸시 전송","모바일 푸시","웹 푸시","푸시 API","알림 개인화"],"href":"/docs/ko/push"},"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: \"OneSignal 대시보드와 API로 타겟팅, 개인화, 예약 기능을 활용해 모바일 및 웹 푸시 알림을 전송·관리하는 방법을 안내합니다. iOS, Android, 웹 채널 설정 단계와 이미지, 버튼 등 리치 콘텐츠 옵션, 분석까지 다룹니다.\"\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`,hr:`hr`,li:`li`,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,OptimizedFrame,OptimizedImage,Step,Steps,Table,Tip,Warning}=_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(!OptimizedFrame)_missingMdxReference(`OptimizedFrame`,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);if(!Warning)_missingMdxReference(`Warning`,true);return _jsxs(_Fragment,{children:[_jsx(_components.p,{children:`푸시 알림은 사용자가 앱이나 웹사이트를 적극적으로 사용하지 않을 때에도 모든 기기에서 시의적절하고 개인화된 콘텐츠로 사용자를 다시 참여시킵니다.`}),`\n`,_jsxs(_components.p,{children:[`푸시 알림이 가장 높은 참여를 유도하는 방법을 확인하거나 `,_jsx(_components.a,{href:`#push-setup`,children:`시작하기`}),`로 건너뛰세요.`]}),`\n`,_jsx(Frame,{caption:`푸시 알림이 가장 높은 참여를 유도하는 이유`,children:_jsx(OptimizedFrame,{width:`560`,height:`315`,src:`https://www.youtube.com/embed/atjjj4BQqfc?si=PP-XrMF8ttXkXkuQ`,title:`YouTube video player`,frameborder:`0`,allow:`accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture; web-share`,referrerpolicy:`strict-origin-when-cross-origin`,allowfullscreen:true})}),`\n`,_jsx(_components.p,{children:`OneSignal은 모바일, 웹 및 데스크톱 전반에서 푸시 알림을 관리하는 완벽한 플랫폼을 제공합니다:`}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsx(_components.li,{children:_jsxs(_components.strong,{children:[_jsx(_components.a,{href:`#send-push-notifications`,children:`대시보드`}),` 또는 `,_jsx(_components.a,{href:`/reference/create-message`,children:`API`}),`에서 캠페인 및 트랜잭션 메시지 전송`]})}),`\n`,_jsx(_components.li,{children:_jsxs(_components.strong,{children:[_jsx(_components.a,{href:`/docs/ko/journeys-overview`,children:`Journeys`}),`로 멀티채널 플로우 자동화`]})}),`\n`,_jsx(_components.li,{children:_jsxs(_components.strong,{children:[_jsx(_components.a,{href:`/docs/ko/segmentation`,children:`세그먼트`}),`, 필터 또는 사용자 데이터를 사용하여 사용자를 정확하게 타겟팅`]})}),`\n`,_jsx(_components.li,{children:_jsxs(_components.strong,{children:[_jsx(_components.a,{href:`/docs/ko/ab-testing`,children:`A/B 테스트`}),`로 메시지 성능 최적화`]})}),`\n`,_jsx(_components.li,{children:_jsxs(_components.strong,{children:[`사용자 속성 및 `,_jsx(_components.a,{href:`/docs/ko/message-personalization`,children:`동적 콘텐츠`}),`로 콘텐츠 개인화`]})}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`스택과 연동`}),` — HubSpot, Mixpanel, Amplitude, Zapier 등 `,_jsx(_components.a,{href:`/docs/ko/integrations`,children:`다수`})]}),`\n`]}),`\n`,_jsx(_components.hr,{}),`\n`,_jsx(Heading,{level:`2`,id:`푸시-설정`,children:`푸시 설정`}),`\n`,_jsx(_components.p,{children:`푸시 알림을 보내기 전에 플랫폼 설정을 완료하고, 권한 프롬프트를 구성하고, 필요한 기능을 활성화하세요.`}),`\n`,_jsx(Heading,{level:`3`,id:`플랫폼-설정-가이드`,children:`플랫폼 설정 가이드`}),`\n`,_jsxs(Columns,{cols:2,children:[_jsx(Card,{title:`모바일 푸시 설정`,icon:`mobile`,href:`/docs/ko/mobile-push-setup`,children:_jsx(_components.p,{children:`iOS, Android, Huawei, Amazon 푸시 알림의 엔드투엔드 설정.`})}),_jsx(Card,{title:`웹 푸시 설정`,icon:`globe`,href:`/docs/ko/web-push-setup`,children:_jsx(_components.p,{children:`Chrome, Firefox, Safari, Edge 푸시를 활성화합니다.`})}),_jsx(Card,{title:`모바일 SDK 설정`,icon:`code`,href:`/docs/ko/mobile-sdk-setup`,children:_jsx(_components.p,{children:`OneSignal SDK를 모바일 앱에 통합합니다.`})}),_jsx(Card,{title:`웹 SDK 설정`,icon:`browsers`,href:`/docs/ko/web-sdk-setup`,children:_jsx(_components.p,{children:`OneSignal SDK를 웹사이트에 통합합니다.`})}),_jsx(Card,{title:`OneSignal로 마이그레이션`,icon:`arrow-right-arrow-left`,href:`/docs/ko/migrating-to-onesignal`,children:_jsx(_components.p,{children:`Firebase, Airship, Braze 등 다른 제공업체에서 마이그레이션하는 단계.`})}),_jsx(Card,{title:`macOS 앱 지원`,icon:`desktop`,href:`/docs/ko/macos-app-setup`,children:_jsx(_components.p,{children:`macOS 앱에 맞게 OneSignal을 구성합니다.`})}),_jsx(Card,{title:`Windows 앱 지원`,icon:`desktop`,href:`/docs/ko/windows-app-setup`,children:_jsx(_components.p,{children:`Windows 데스크톱 앱에 맞게 OneSignal을 구성합니다.`})}),_jsx(Card,{title:`watchOS 및 Wear OS 지원`,icon:`clock`,href:`/docs/ko/watchos-and-wear-os-support`,children:_jsx(_components.p,{children:`Apple Watch 및 Wear OS 기기에 OneSignal을 추가합니다.`})})]}),`\n`,_jsx(Heading,{level:`3`,id:`권한`,children:`권한`}),`\n`,_jsx(_components.p,{children:`잘 설계된 옵트인 경험이 푸시 대상을 극대화합니다.`}),`\n`,_jsxs(Columns,{cols:2,children:[_jsx(Card,{title:`모바일 푸시 프롬프트`,icon:`bell`,href:`/docs/ko/prompt-for-push-permissions`,children:_jsx(_components.p,{children:`모바일 앱의 사전 권한 프롬프트 및 모범 사례를 구축합니다.`})}),_jsx(Card,{title:`웹 푸시 프롬프트`,icon:`bell-on`,href:`/docs/ko/permission-requests`,children:_jsx(_components.p,{children:`웹 푸시의 프롬프트 타이밍과 메시지를 사용자 지정합니다.`})}),_jsx(Card,{title:`iOS Provisional 푸시`,icon:`apple`,href:`/docs/ko/ios-provisional-push-notifications`,children:_jsx(_components.p,{children:`전체 권한을 요청하기 전에 알림 센터에 무음 알림을 전달합니다.`})}),_jsx(Card,{title:`Android 알림 카테고리`,icon:`android`,href:`/docs/ko/android-notification-categories`,children:_jsx(_components.p,{children:`Android 사용자가 앱의 알림을 받는 방법을 사용자 지정할 수 있도록 합니다.`})})]}),`\n`,_jsx(Heading,{level:`3`,id:`기능-및-고급-사용-사례`,children:`기능 및 고급 사용 사례`}),`\n`,_jsxs(Columns,{cols:2,children:[_jsx(Card,{title:`메시지 개인화`,icon:`wand-magic-sparkles`,href:`/docs/ko/message-personalization`,children:_jsx(_components.p,{children:`각 사용자를 위해 메시지를 개인화하는 동적 콘텐츠를 추가합니다.`})}),_jsx(Card,{title:`다국어 메시징`,icon:`language`,href:`/docs/ko/multi-language-messaging`,children:_jsx(_components.p,{children:`각 사용자의 선호 언어로 푸시 알림을 전송합니다.`})}),_jsx(Card,{title:`제한`,icon:`gauge-high`,href:`/docs/ko/throttling`,children:_jsx(_components.p,{children:`대규모 대상의 알림 전달 속도를 제어합니다.`})}),_jsx(Card,{title:`빈도 제한`,icon:`hand`,href:`/docs/ko/frequency-capping`,children:_jsx(_components.p,{children:`사용자당 푸시 알림 수를 제한합니다.`})}),_jsx(Card,{title:`데이터 및 백그라운드 알림`,icon:`database`,href:`/docs/ko/data-notifications`,children:_jsx(_components.p,{children:`백그라운드 작업을 위한 데이터 전용 알림을 전송합니다.`})}),_jsx(Card,{title:`VoIP 알림`,icon:`phone`,href:`/docs/ko/voip-notifications`,children:_jsx(_components.p,{children:`통화 앱을 위한 VoIP 전용 푸시 알림을 전송합니다.`})})]}),`\n`,_jsx(_components.hr,{}),`\n`,_jsx(Heading,{level:`2`,id:`푸시-알림-전송`,children:`푸시 알림 전송`}),`\n`,_jsx(_components.p,{children:`여러 가지 방법으로 메시지를 전송할 수 있습니다. 사용 사례에 따라 최적의 방법을 선택하세요.`}),`\n`,_jsxs(Columns,{cols:2,children:[_jsx(Card,{title:`대시보드`,icon:`window-maximize`,href:`#send-from-the-dashboard`,children:_jsx(_components.p,{children:`대시보드 내에서 빠르게 메시지를 작성합니다.`})}),_jsx(Card,{title:`API로 전송`,icon:`code`,href:`/reference/create-message`,children:_jsx(_components.p,{children:`REST API를 사용하여 프로그래밍 방식으로 메시지를 전송합니다.`})}),_jsx(Card,{title:`Journeys`,icon:`route`,href:`/docs/ko/journeys-overview`,children:_jsx(_components.p,{children:`자동화된 멀티스텝 및 멀티채널 플로우를 구축합니다.`})}),_jsx(Card,{title:`A/B 테스트`,icon:`flask`,href:`/docs/ko/ab-testing`,children:_jsx(_components.p,{children:`최대 10개의 메시지 변형을 테스트하여 성능을 최적화합니다.`})})]}),`\n`,_jsx(Heading,{level:`3`,id:`대시보드에서-전송`,children:`대시보드에서 전송`}),`\n`,_jsxs(Steps,{children:[_jsxs(Step,{title:`메시지 채널 선택`,icon:`window-maximize`,children:[_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`만들기…`}),` 를 선택한 후 메시지 채널을 선택합니다. `,_jsx(_components.strong,{children:`메시지`}),` 또는 `,_jsx(_components.strong,{children:`템플릿`}),`으로 이동하여 이전 메시지를 볼 수도 있습니다.`]}),_jsx(Frame,{caption:`OneSignal 대시보드에서 새 메시지를 만듭니다.`,children:_jsx(OptimizedImage,{src:`https://mintcdn.com/onesignal/UDk6E5NjA3sdGdRN/images/dashboard/create-message.png?fit=max\u0026auto=format\u0026n=UDk6E5NjA3sdGdRN\u0026q=85\u0026s=97504cf71555ac4aeb263a36ad2d28b3`,alt:`OneSignal 대시보드의 메시지 만들기 옵션`,\"data-og-width\":`2128`,width:`2128`,\"data-og-height\":`1374`,height:`1374`,\"data-path\":`images/dashboard/create-message.png`,\"data-optimize\":`true`,\"data-opv\":`3`,srcset:`https://mintcdn.com/onesignal/UDk6E5NjA3sdGdRN/images/dashboard/create-message.png?w=280\u0026fit=max\u0026auto=format\u0026n=UDk6E5NjA3sdGdRN\u0026q=85\u0026s=c30e5af403626906cd869b1be7a9a058 280w, https://mintcdn.com/onesignal/UDk6E5NjA3sdGdRN/images/dashboard/create-message.png?w=560\u0026fit=max\u0026auto=format\u0026n=UDk6E5NjA3sdGdRN\u0026q=85\u0026s=52fa73ad6b94c1102311da90430d1a9c 560w, https://mintcdn.com/onesignal/UDk6E5NjA3sdGdRN/images/dashboard/create-message.png?w=840\u0026fit=max\u0026auto=format\u0026n=UDk6E5NjA3sdGdRN\u0026q=85\u0026s=2850d5f86926785cae9518cb18fec1e8 840w, https://mintcdn.com/onesignal/UDk6E5NjA3sdGdRN/images/dashboard/create-message.png?w=1100\u0026fit=max\u0026auto=format\u0026n=UDk6E5NjA3sdGdRN\u0026q=85\u0026s=05ae6c9f9b9a33ba3858713e94dedacb 1100w, https://mintcdn.com/onesignal/UDk6E5NjA3sdGdRN/images/dashboard/create-message.png?w=1650\u0026fit=max\u0026auto=format\u0026n=UDk6E5NjA3sdGdRN\u0026q=85\u0026s=075b97068c06d74f06e1ba79577ac576 1650w, https://mintcdn.com/onesignal/UDk6E5NjA3sdGdRN/images/dashboard/create-message.png?w=2500\u0026fit=max\u0026auto=format\u0026n=UDk6E5NjA3sdGdRN\u0026q=85\u0026s=b7adbaa536006b6cc661ea91eb90ecb5 2500w`})})]}),_jsx(Step,{title:`구성 방법 선택`,icon:`pencil`,children:_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[`처음부터 시작하거나 `,_jsx(_components.a,{href:`/docs/ko/ai-message-composer`,children:`AI 메시지 작성기`}),`를 사용합니다.`]}),`\n`,_jsxs(_components.li,{children:[`사전 구축된 `,_jsx(_components.a,{href:`/docs/ko/templates`,children:`템플릿`}),`을 사용합니다`]}),`\n`]})}),_jsx(Step,{title:`이름 및 레이블 설정`,icon:`tag`,children:_jsxs(_components.p,{children:[`추적 및 보고를 위한 내부 메타데이터를 추가합니다. API 동등: `,_jsx(_components.code,{children:`name`})]})}),_jsxs(Step,{title:`대상 선택`,icon:`users`,children:[_jsxs(_components.p,{children:[`메시지를 받을 사용자를 선택합니다. `,_jsx(_components.a,{href:`/docs/ko/segmentation`,children:`세그먼트`}),`를 포함 및 제외하여 특정 그룹을 타겟팅할 수 있습니다. 세그먼트가 설정되지 않은 경우 기본적으로 모든 “구독된 사용자”로 설정됩니다.`]}),_jsx(Frame,{caption:`대시보드의 이름, 레이블 및 대상 세그먼트 선택.`,children:_jsx(OptimizedImage,{src:`https://mintcdn.com/onesignal/ciRrThfP6xMpI7GY/images/dashboard/message-name-label-audience.png?fit=max\u0026auto=format\u0026n=ciRrThfP6xMpI7GY\u0026q=85\u0026s=1f41b0e42d31211b1c1badf87ba84056`,alt:`메시지 이름, 레이블 및 대상 세그먼트 선택을 위한 대시보드 필드`,\"data-og-width\":`1650`,width:`1650`,\"data-og-height\":`518`,height:`518`,\"data-path\":`images/dashboard/message-name-label-audience.png`,\"data-optimize\":`true`,\"data-opv\":`3`,srcset:`https://mintcdn.com/onesignal/ciRrThfP6xMpI7GY/images/dashboard/message-name-label-audience.png?w=280\u0026fit=max\u0026auto=format\u0026n=ciRrThfP6xMpI7GY\u0026q=85\u0026s=8d04b438d3ca636dc75bd87aa887d3fa 280w, https://mintcdn.com/onesignal/ciRrThfP6xMpI7GY/images/dashboard/message-name-label-audience.png?w=560\u0026fit=max\u0026auto=format\u0026n=ciRrThfP6xMpI7GY\u0026q=85\u0026s=032ade0ee5fa1c405fb4ba2fa7148fcf 560w, https://mintcdn.com/onesignal/ciRrThfP6xMpI7GY/images/dashboard/message-name-label-audience.png?w=840\u0026fit=max\u0026auto=format\u0026n=ciRrThfP6xMpI7GY\u0026q=85\u0026s=0d6f8c3f337d18eda0cd22cf1183e273 840w, https://mintcdn.com/onesignal/ciRrThfP6xMpI7GY/images/dashboard/message-name-label-audience.png?w=1100\u0026fit=max\u0026auto=format\u0026n=ciRrThfP6xMpI7GY\u0026q=85\u0026s=7c645d262e3c29ded6ce1c1d0bbdf45a 1100w, https://mintcdn.com/onesignal/ciRrThfP6xMpI7GY/images/dashboard/message-name-label-audience.png?w=1650\u0026fit=max\u0026auto=format\u0026n=ciRrThfP6xMpI7GY\u0026q=85\u0026s=a5f6c91444a616bc142b58ae1641f676 1650w, https://mintcdn.com/onesignal/ciRrThfP6xMpI7GY/images/dashboard/message-name-label-audience.png?w=2500\u0026fit=max\u0026auto=format\u0026n=ciRrThfP6xMpI7GY\u0026q=85\u0026s=60e9d02aaf36f390d8db8678311e4d7b 2500w`})}),_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`타겟팅 방법`}),_jsx(_components.th,{style:{textAlign:`center`},children:`대시보드`}),_jsx(_components.th,{style:{textAlign:`center`},children:`API`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.a,{href:`/docs/ko/segmentation`,children:_jsx(_components.strong,{children:`세그먼트`})})}),_jsx(_components.td,{style:{textAlign:`center`},children:`예`}),_jsx(_components.td,{style:{textAlign:`center`},children:`예`})]}),_jsxs(_components.tr,{children:[_jsxs(_components.td,{children:[_jsx(_components.strong,{children:`필터`}),` (`,_jsx(_components.a,{href:`/reference/create-message`,children:`API 전용`}),`)`]}),_jsx(_components.td,{style:{textAlign:`center`},children:`아니오`}),_jsx(_components.td,{style:{textAlign:`center`},children:`예`})]}),_jsxs(_components.tr,{children:[_jsxs(_components.td,{children:[_jsx(_components.strong,{children:`별칭`}),` (`,_jsx(_components.a,{href:`/reference/create-message`,children:`API 전용`}),`)`]}),_jsx(_components.td,{style:{textAlign:`center`},children:`아니오`}),_jsx(_components.td,{style:{textAlign:`center`},children:`예`})]})]})]})]}),_jsx(Step,{title:`메시지 디자인 및 전송`,icon:`paper-plane`,children:_jsxs(_components.p,{children:[`아래의 `,_jsx(_components.a,{href:`#design-properties`,children:`디자인 속성`}),`과 `,_jsx(_components.a,{href:`#feature-properties`,children:`기능 속성`}),`을 사용하여 알림을 작성합니다. 그런 다음 즉시 전송하거나 `,_jsx(_components.a,{href:`#delivery-schedule-and-optimization`,children:`전달 일정`}),`을 설정합니다.`]})})]}),`\n`,_jsx(Heading,{level:`3`,id:`전달-일정-및-최적화`,children:`전달 일정 및 최적화`}),`\n`,_jsx(_components.p,{children:`타이밍이 푸시 알림 성능에 미치는 영향을 확인하세요.`}),`\n`,_jsx(Frame,{caption:`타이밍이 전부입니다: 액션을 유도하는 푸시 알림을 보내는 방법`,children:_jsx(OptimizedFrame,{width:`560`,height:`315`,src:`https://www.youtube.com/embed/pRTbUuvYsWY?si=uqL5wSK_vXH6VwMJ`,title:`YouTube video player`,frameborder:`0`,allow:`accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture; web-share`,referrerpolicy:`strict-origin-when-cross-origin`,allowfullscreen:true})}),`\n`,_jsx(_components.p,{children:`OneSignal이 대상 멤버십을 평가하고 메시지 전달을 시작할 시점을 선택합니다.`}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`옵션`}),_jsx(_components.th,{children:`설명`}),_jsx(_components.th,{children:`API 필드`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`즉시 전송`})}),_jsx(_components.td,{children:`지금 대상의 모든 사용자에게 전송을 시작합니다.`}),_jsx(_components.td,{children:`(없음)`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`예약`})}),_jsx(_components.td,{children:`최대 30일 전에 특정 시간에 전송합니다.`}),_jsx(_components.td,{children:_jsx(_components.code,{children:`send_after`})})]})]})]}),`\n`,_jsx(Warning,{children:_jsx(_components.p,{children:`전송 시간이 대상 기준 시점을 결정합니다. OneSignal은 그 시점에 대상 멤버십을 평가하며, 대상에 포함된 모든 사용자는 사용자별 최적화 설정과 관계없이 메시지를 받습니다.`})}),`\n`,_jsx(_components.p,{children:_jsx(_components.strong,{children:`사용자별 전달 시간:`})}),`\n`,_jsx(_components.p,{children:`대상의 각 사용자가 메시지를 수신할 시간을 설정합니다.`}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`옵션`}),_jsx(_components.th,{children:`설명`}),_jsx(_components.th,{children:`API 필드`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`모두에게 동시에`})}),_jsx(_components.td,{children:`모든 수신자가 동시에 메시지를 받습니다. 긴급 메시지에 가장 적합합니다.`}),_jsx(_components.td,{children:`(없음)`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`지능형 전달`})}),_jsx(_components.td,{children:`각 사용자의 세션 활동을 기반으로 최적의 시간에 전송합니다.`}),_jsx(_components.td,{children:_jsx(_components.code,{children:`delayed_option: last-active`})})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`시간대별 사용자 지정 시간`})}),_jsx(_components.td,{children:`각 사용자의 시간대에 설정된 현지 시간에 전송합니다.`}),_jsxs(_components.td,{children:[_jsx(_components.code,{children:`delayed_option: timezone`}),`, `,_jsx(_components.code,{children:`delivery_time_of_day`})]})]})]})]}),`\n`,_jsx(_components.p,{children:_jsx(_components.strong,{children:`전달 재정의:`})}),`\n`,_jsx(_components.p,{children:`이 메시지에 한해 앱 수준의 전달 기본값을 재정의합니다.`}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`설정`}),_jsx(_components.th,{children:`설명`}),_jsx(_components.th,{children:`API 필드`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsxs(_components.strong,{children:[_jsx(_components.a,{href:`/docs/ko/throttling`,children:`제한`}),` 재정의`]})}),_jsx(_components.td,{children:`이 메시지에 대한 제한 속도를 변경합니다.`}),_jsx(_components.td,{children:_jsx(_components.code,{children:`throttle_rate_per_minute`})})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsxs(_components.strong,{children:[_jsx(_components.a,{href:`/docs/ko/frequency-capping`,children:`빈도 제한`}),` 재정의`]})}),_jsx(_components.td,{children:`이 메시지에 대한 빈도 제한을 비활성화합니다.`}),_jsx(_components.td,{children:_jsx(_components.code,{children:`enable_frequency_cap`})})]})]})]}),`\n`,_jsx(Info,{children:_jsx(_components.p,{children:`지능형 전달 또는 시간대별 사용자 지정 시간을 사용하면 대상의 모든 레코드가 메시지를 받을 수 있도록 전달이 24시간에 걸쳐 진행됩니다. 현지 시간 오전 9시 메시지가 전송될 때 수신자가 이미 오전 10시라면 다음 날 오전 9시에 메시지를 받습니다.`})}),`\n`,_jsx(Heading,{level:`3`,id:`디자인-속성`,children:`디자인 속성`}),`\n`,_jsx(_components.p,{children:`푸시 메시지는 사용자 대상 콘텐츠를 표시하거나 백그라운드 작업을 수행할 수 있습니다.`}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`표시 알림`}),`: `,_jsx(_components.a,{href:`#message`,children:`메시지`}),`가 필요하며 제목, 이미지, 액션 버튼 및 기타 시각적 요소를 포함할 수 있습니다.`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`백그라운드/데이터 전용 알림`}),`: `,_jsx(_components.code,{children:`headings`}),`와 `,_jsx(_components.code,{children:`contents`}),`를 생략하고, iOS와 Android 모두에서 `,_jsx(_components.a,{href:`/docs/ko/data-notifications`,children:_jsx(_components.code,{children:`content_available`})}),`을 `,_jsx(_components.code,{children:`true`}),`로 설정하며, 선택적으로 `,_jsx(_components.a,{href:`#additional-data`,children:`추가 데이터`}),`를 포함합니다.`]}),`\n`]}),`\n`,_jsx(Frame,{caption:`웹 및 모바일 푸시 알림의 구조`,children:_jsx(OptimizedImage,{src:`https://mintcdn.com/onesignal/l4Z9oMlZl9nJOS_T/images/push/web-and-mobile-push-notifications-anatomy.jpg?fit=max\u0026auto=format\u0026n=l4Z9oMlZl9nJOS_T\u0026q=85\u0026s=abd46b4656559360cc713cfa98f138fe`,alt:`1 제목, 2 메시지, 3 아이콘, 4 이미지, 5 액션 버튼, 6 앱 이름 또는 브라우저, 7 수신된 타임스탬프가 표시된 푸시 알림 주석 다이어그램`,\"data-og-width\":`1468`,width:`1468`,\"data-og-height\":`2302`,height:`2302`,\"data-path\":`images/push/web-and-mobile-push-notifications-anatomy.jpg`,\"data-optimize\":`true`,\"data-opv\":`3`,srcset:`https://mintcdn.com/onesignal/l4Z9oMlZl9nJOS_T/images/push/web-and-mobile-push-notifications-anatomy.jpg?w=280\u0026fit=max\u0026auto=format\u0026n=l4Z9oMlZl9nJOS_T\u0026q=85\u0026s=4219c1c16ba5a40defb834699ead005f 280w, https://mintcdn.com/onesignal/l4Z9oMlZl9nJOS_T/images/push/web-and-mobile-push-notifications-anatomy.jpg?w=560\u0026fit=max\u0026auto=format\u0026n=l4Z9oMlZl9nJOS_T\u0026q=85\u0026s=71962a9801c53d67eee3baea3026022c 560w, https://mintcdn.com/onesignal/l4Z9oMlZl9nJOS_T/images/push/web-and-mobile-push-notifications-anatomy.jpg?w=840\u0026fit=max\u0026auto=format\u0026n=l4Z9oMlZl9nJOS_T\u0026q=85\u0026s=ea42c1445875618641ac7c45b61e6068 840w, https://mintcdn.com/onesignal/l4Z9oMlZl9nJOS_T/images/push/web-and-mobile-push-notifications-anatomy.jpg?w=1100\u0026fit=max\u0026auto=format\u0026n=l4Z9oMlZl9nJOS_T\u0026q=85\u0026s=3c99801cc540de4d1d501cd02159ee61 1100w, https://mintcdn.com/onesignal/l4Z9oMlZl9nJOS_T/images/push/web-and-mobile-push-notifications-anatomy.jpg?w=1650\u0026fit=max\u0026auto=format\u0026n=l4Z9oMlZl9nJOS_T\u0026q=85\u0026s=4e8cf28c140fbb05d54c97bdf542dda7 1650w, https://mintcdn.com/onesignal/l4Z9oMlZl9nJOS_T/images/push/web-and-mobile-push-notifications-anatomy.jpg?w=2500\u0026fit=max\u0026auto=format\u0026n=l4Z9oMlZl9nJOS_T\u0026q=85\u0026s=c48e4349fe83bf150d94e6bb2bc5d078 2500w`})}),`\n`,_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`범례:`}),` 1 제목, 2 메시지, 3 아이콘, 4 이미지, 5 액션 버튼, 6 앱 이름 또는 브라우저, 7 수신된 타임스탬프.`]}),`\n`,_jsx(Tip,{children:_jsxs(_components.p,{children:[_jsx(_components.a,{href:`/docs/ko/ai-message-composer`,children:`AI 메시지 작성기`}),`를 사용하여 알림의 제목과 본문을 빠르게 생성해 보세요. 클릭 몇 번으로 브랜드에 맞게 톤과 콘텐츠를 쉽게 조정할 수 있습니다.`]})}),`\n`,_jsx(Heading,{level:`4`,id:`제목`,children:`제목`}),`\n`,_jsx(_components.p,{children:`알림의 최상단 사용자 지정 가능한 텍스트입니다. 텍스트 모양은 운영 체제에서 제어합니다.`}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`웹 푸시`}),` 및 `,_jsx(_components.strong,{children:`Huawei`}),`에 필요합니다`]}),`\n`,_jsx(_components.li,{children:`설정되지 않은 경우 웹에서 사이트 이름이 기본값입니다`}),`\n`,_jsx(_components.li,{children:`권장 제한: 25–50자(모바일), 60–80자(웹)`}),`\n`,_jsxs(_components.li,{children:[`지원: `,_jsx(_components.a,{href:`/docs/ko/ai-message-composer`,children:`AI 메시지 작성기`}),`, 이모지, `,_jsx(_components.a,{href:`/docs/ko/message-personalization`,children:`메시지 개인화`}),`, `,_jsx(_components.a,{href:`/docs/ko/multi-language-messaging`,children:`다국어 메시징`})]}),`\n`,_jsxs(_components.li,{children:[`API: `,_jsx(_components.code,{children:`headings`})]}),`\n`]}),`\n`,_jsxs(Note,{children:[_jsx(_components.p,{children:`푸시 플랫폼(Android, iOS, Huawei, Amazon)은 제목이나 메시지를 고정된 글자 수에서 자르지 않습니다. 텍스트가 잘리는 위치는 기기, 화면 방향 및 사용자의 시스템 텍스트 크기(접근성 모드)에 따라 달라집니다. Android에서는 런처와 제조사에 따라서도 다릅니다.`}),_jsx(_components.p,{children:`OneSignal과 전달 서비스(APNs, FCM 등)는 알림을 전송할 뿐 기기가 알림을 렌더링하는 방식은 제어하지 않으므로, 어떤 API나 페이로드 옵션으로도 잘림을 재정의할 수 없습니다. 동일한 텍스트가 한 기기에서는 전부 표시되고 다른 기기에서는 잘릴 수 있습니다.`})]}),`\n`,_jsx(Heading,{level:`4`,id:`부제목`,children:`부제목`}),`\n`,_jsx(_components.p,{children:`iOS 및 macOS에서만 지원되는 보조 텍스트입니다(APNs 경유). Android 또는 웹에서는 사용할 수 없습니다.`}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsx(_components.li,{children:`권장 제한: 25–50자`}),`\n`,_jsxs(_components.li,{children:[`지원: 이모지, `,_jsx(_components.a,{href:`/docs/ko/message-personalization`,children:`메시지 개인화`}),`, `,_jsx(_components.a,{href:`/docs/ko/multi-language-messaging`,children:`다국어 메시징`})]}),`\n`,_jsxs(_components.li,{children:[`API: `,_jsx(_components.code,{children:`subtitle`})]}),`\n`]}),`\n`,_jsx(Info,{children:_jsxs(_components.p,{children:[`부제목은 동일한 운영 체제 렌더링 규칙에 따라 제목과 독립적으로 잘립니다. 위의 `,_jsx(_components.a,{href:`#title`,children:`제목`}),` 참고 사항을 참조하세요.`]})}),`\n`,_jsx(Heading,{level:`4`,id:`메시지`,children:`메시지`}),`\n`,_jsx(_components.p,{children:`알림의 주요 콘텐츠입니다. 사용자 지정 글꼴 또는 스타일을 지원하지 않습니다. 스타일은 운영 체제에서 설정합니다.`}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsx(_components.li,{children:`백그라운드 알림을 보내지 않는 한 필수입니다`}),`\n`,_jsxs(_components.li,{children:[`지원: `,_jsx(_components.a,{href:`/docs/ko/ai-message-composer`,children:`AI 메시지 작성기`}),`, 이모지, `,_jsx(_components.a,{href:`/docs/ko/message-personalization`,children:`메시지 개인화`}),`, `,_jsx(_components.a,{href:`/docs/ko/multi-language-messaging`,children:`다국어 메시징`})]}),`\n`,_jsx(_components.li,{children:`권장 제한: ~150자`}),`\n`,_jsxs(_components.li,{children:[`API: `,_jsx(_components.code,{children:`contents`})]}),`\n`]}),`\n`,_jsx(Info,{children:_jsxs(_components.p,{children:[`메시지 본문은 동일한 운영 체제 렌더링 규칙에 따라 잘리며, 표시되는 양은 알림이 접혀 있는지 펼쳐져 있는지에 따라 달라집니다. 위의 `,_jsx(_components.a,{href:`#title`,children:`제목`}),` 참고 사항을 참조하세요.`]})}),`\n`,_jsx(Heading,{level:`4`,id:`아이콘`,children:`아이콘`}),`\n`,_jsx(_components.p,{children:`Android 및 웹에서 작은 아이콘과 큰 아이콘을 사용자 지정합니다. iOS는 항상 앱 아이콘을 사용합니다.`}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[_jsx(_components.a,{href:`/docs/ko/notification-icons`,children:`알림 아이콘`}),`을 참조하세요`]}),`\n`]}),`\n`,_jsx(Heading,{level:`4`,id:`이미지`,children:`이미지`}),`\n`,_jsx(_components.p,{children:`Android, iOS 및 Windows/Android용 Chrome의 알림에 큰 이미지를 추가합니다.`}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[`권장 크기: `,_jsx(_components.code,{children:`1024×512px`}),`(2:1 가로 세로 비율)`]}),`\n`,_jsx(_components.li,{children:`최대 크기: 1MB, 최대 너비: 2000px`}),`\n`,_jsx(_components.li,{children:`Safari(macOS/iOS) 또는 macOS 알림 센터에서는 지원되지 않습니다`}),`\n`,_jsx(_components.li,{children:`모바일에서 보려면 이미지를 탭하거나 확장해야 합니다`}),`\n`,_jsxs(_components.li,{children:[`지원되는 형식: `,_jsx(_components.code,{children:`PNG`}),`, `,_jsx(_components.code,{children:`JPG`}),`, `,_jsx(_components.code,{children:`GIF`}),`(iOS에서만 애니메이션)`]}),`\n`,_jsxs(_components.li,{children:[`API: `,_jsx(_components.code,{children:`ios_attachments`}),`(iOS), `,_jsx(_components.code,{children:`big_picture`}),`(Android), `,_jsx(_components.code,{children:`chrome_web_image`}),`(Chrome 웹)`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.a,{href:`/docs/ko/rich-media`,children:`이미지 및 리치 미디어`}),`를 참조하세요`]}),`\n`]}),`\n`,_jsx(Heading,{level:`4`,id:`앱-이름`,children:`앱 이름`}),`\n`,_jsx(_components.p,{children:`알림을 표시하는 앱의 이름입니다.`}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`iOS`}),`: Xcode의 _Display Name_에서 설정합니다. 업데이트하려면 기기를 다시 시작해야 합니다`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Android/Amazon/Huawei`}),`: `,_jsx(_components.code,{children:`AndroidManifest.xml`}),`의 `,_jsx(_components.code,{children:`\u003capplication android:label=\"YOUR APP NAME\">`}),`에서 설정합니다`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`웹`}),`: 사이트 이름 및/또는 브라우저를 표시합니다`]}),`\n`]}),`\n`,_jsx(Heading,{level:`3`,id:`기능-속성`,children:`기능 속성`}),`\n`,_jsx(Heading,{level:`4`,id:`액션-버튼`,children:`액션 버튼`}),`\n`,_jsx(_components.p,{children:`푸시 알림에 대화형 버튼을 추가합니다.`}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsx(_components.li,{children:`Android 4.1+ 및 iOS 8.0+에서 지원됩니다`}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.a,{href:`/docs/ko/action-buttons`,children:`액션 버튼`}),`을 참조하세요`]}),`\n`]}),`\n`,_jsx(Heading,{level:`4`,id:`실행-url`,children:`실행 URL`}),`\n`,_jsx(_components.p,{children:`알림을 탭할 때 사용자가 이동하는 위치를 제어합니다.`}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[`API: `,_jsx(_components.code,{children:`url`}),`(단일 범용 URL), `,_jsx(_components.code,{children:`app_url`}),`(딥 링크, 예: `,_jsx(_components.code,{children:`your-app://screen`}),`), `,_jsx(_components.code,{children:`web_url`}),`(http/https 웹 링크)`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.a,{href:`/docs/ko/links`,children:`URL, 링크 및 딥 링크`}),`를 참조하세요`]}),`\n`]}),`\n`,_jsx(Heading,{level:`4`,id:`배지`,children:`배지`}),`\n`,_jsx(_components.p,{children:`앱 아이콘에 점 또는 배지 번호를 표시합니다.`}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`iOS`}),`: 빨간색 숫자 배지, 설정, 증가 또는 지울 수 있습니다. API: `,_jsx(_components.code,{children:`ios_badgeType`}),`, `,_jsx(_components.code,{children:`ios_badgeCount`})]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Android`}),`: `,_jsx(_components.a,{href:`/docs/ko/android-notification-categories`,children:`알림 카테고리`}),`가 필요합니다`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Huawei`}),`: 배지가 숫자 또는 점으로 표시됩니다. API: `,_jsx(_components.code,{children:`huawei_badge_class`}),`, `,_jsx(_components.code,{children:`huawei_badge_set_num`}),`, `,_jsx(_components.code,{children:`huawei_badge_add_num`})]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`웹(Android의 Chrome)`}),`: Android 기기의 Chrome 웹 알림에 표시되는 단색 상태 표시줄 아이콘입니다. 앱 아이콘 배지가 아닙니다. 권장: 정사각형 PNG, `,_jsx(_components.code,{children:`96×96`}),`(최소 `,_jsx(_components.code,{children:`72×72`}),`). API: `,_jsx(_components.code,{children:`chrome_web_badge`}),`. `,_jsx(_components.a,{href:`/docs/ko/notification-icons#android-web-push-badge-icon`,children:`알림 아이콘`}),`을 참조하세요`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.a,{href:`/docs/ko/badges`,children:`배지`}),`를 참조하세요`]}),`\n`]}),`\n`,_jsx(Heading,{level:`4`,id:`소리`,children:`소리`}),`\n`,_jsx(_components.p,{children:`푸시가 전달될 때 소리를 재생합니다.`}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`iOS`}),`: `,_jsx(_components.code,{children:`ios_sound`}),`로 설정합니다`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Android`}),`: `,_jsx(_components.a,{href:`/docs/ko/android-notification-categories`,children:`알림 카테고리`}),`를 통해 설정합니다`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`웹`}),`: 사용할 수 없습니다`]}),`\n`]}),`\n`,_jsx(Heading,{level:`4`,id:`추가-데이터`,children:`추가 데이터`}),`\n`,_jsx(_components.p,{children:`SDK 처리를 위해 페이로드에 사용자 지정 key-value 쌍을 추가합니다.`}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[_jsx(_components.a,{href:`/docs/ko/service-extensions`,children:`모바일 서비스 확장`}),` 및 `,_jsx(_components.a,{href:`/docs/ko/mobile-sdk-reference`,children:`모바일 SDK`}),`와 `,_jsx(_components.a,{href:`/docs/ko/web-sdk-reference`,children:`웹 SDK`}),`의 클릭 리스너에서 사용됩니다`]}),`\n`,_jsxs(_components.li,{children:[`대시보드는 간단한 key-value 데이터만 지원합니다. 중첩된 JSON을 보내려면 `,_jsx(_components.code,{children:`data`}),`와 함께 API를 사용하세요`]}),`\n`,_jsxs(_components.li,{children:[`최대 총 페이로드: ~4KB; `,_jsx(_components.code,{children:`data`}),` 필드: 최대 2048바이트`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.a,{href:`/docs/ko/osnotification-payload`,children:`알림 페이로드 참조`}),`를 참조하세요`]}),`\n`]}),`\n`,_jsx(Heading,{level:`4`,id:`collapse-id-모바일-푸시`,children:`Collapse ID (모바일 푸시)`}),`\n`,_jsxs(_components.p,{children:[`동일한 `,_jsx(_components.code,{children:`collapse_id`}),`를 공유하는 경우 이전 알림을 새 알림으로 교체합니다. 최대 길이: 64자. API: `,_jsx(_components.code,{children:`collapse_id`})]}),`\n`,_jsx(_components.p,{children:`예를 들어, 날씨 앱이 세 가지 경보를 전송합니다. 사용자가 세 가지 모두 전송된 후 기기를 열면 마지막 메시지만 표시됩니다.`}),`\n`,_jsx(Heading,{level:`4`,id:`web-push-topic-웹-푸시`,children:`Web push topic (웹 푸시)`}),`\n`,_jsxs(_components.p,{children:[`고유한 `,_jsx(_components.code,{children:`web_push_topic`}),` 값을 사용하여 웹에서 이전 알림을 교체하지 않도록 합니다. 다른 주제의 알림은 독립적으로 표시됩니다. 최대 길이: 64자. API: `,_jsx(_components.code,{children:`web_push_topic`})]}),`\n`,_jsx(Heading,{level:`4`,id:`우선순위`,children:`우선순위`}),`\n`,_jsx(_components.p,{children:`특히 배터리 절약 모드에서 푸시의 긴급성을 설정합니다.`}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`High`}),`(`,_jsx(_components.code,{children:`10`}),`, 기본값이며 권장): 즉시 표시되는 알림 기반 메시지.`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Normal`}),`(`,_jsx(_components.code,{children:`5`}),`): 백그라운드 및 데이터 전용 알림에 권장됩니다.`]}),`\n`,_jsxs(_components.li,{children:[`API: `,_jsx(_components.code,{children:`priority`})]}),`\n`,_jsxs(_components.li,{children:[`플랫폼 문서: `,_jsx(_components.a,{href:`https://developer.apple.com/documentation/usernotifications/setting_up_a_remote_notification_server/sending_notification_requests_to_apns`,children:`APNs 우선순위`}),`, `,_jsx(_components.a,{href:`https://firebase.google.com/docs/cloud-messaging/android/message-priority`,children:`FCM 우선순위`})]}),`\n`]}),`\n`,_jsx(Heading,{level:`4`,id:`time-to-live-ttl`,children:`Time to live (TTL)`}),`\n`,_jsxs(_components.p,{children:[`기기가 오프라인인 경우 메시지를 보관하는 기간입니다. 기본값: 3일. 범위: 0 ~ 2,419,200초(28일). API: `,_jsx(_components.code,{children:`ttl`})]}),`\n`,_jsxs(_components.p,{children:[`사용자가 오프라인이고 TTL이 만료되면 메시지가 삭제됩니다. 지연 전달이 되어서는 안 되는 메시지에는 `,_jsx(_components.code,{children:`ttl: 0`}),`을 설정하세요.`]}),`\n`,_jsx(Note,{children:_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`iOS 제한`}),`: APNs는 기기가 오프라인인 동안 `,_jsx(_components.strong,{children:`가장 최근`}),` 알림만 저장합니다. 이전 알림은 삭제됩니다. `,_jsx(_components.a,{href:`https://developer.apple.com/library/archive/documentation/NetworkingInternet/Conceptual/RemoteNotificationsPG/APNSOverview.html#//apple_ref/doc/uid/TP40008194-CH8-SW5`,children:`자세히 알아보기`}),`.`]})}),`\n`,_jsx(Heading,{level:`4`,id:`알림-그룹화`,children:`알림 그룹화`}),`\n`,_jsx(_components.p,{children:`기기가 앱에 대한 알림을 4개 이상 받으면 Android 및 iOS가 자동으로 알림을 그룹화합니다.`}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`iOS`}),`: API에서 `,_jsx(_components.code,{children:`thread_id`}),`를 사용하여 메시지를 함께 그룹화합니다.`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Android`}),`: API에서 `,_jsx(_components.code,{children:`android_group`}),`을 사용하거나 대시보드에서 “그룹 키”를 설정합니다. 고급 사용자 지정의 경우 `,_jsx(_components.a,{href:`/docs/ko/service-extensions#android-notification-service-extension`,children:`Android 알림 서비스 확장`}),` 및 `,_jsx(_components.a,{href:`https://developer.android.com/training/notify-user/group`,children:`Android의 그룹 알림 가이드`}),`를 참조하세요.`]}),`\n`]}),`\n`,_jsx(Frame,{caption:`Android에서 그룹화된 알림.`,children:_jsx(OptimizedImage,{src:`https://mintcdn.com/onesignal/6tscVAtiSqz353kV/images/docs/GnEw4PmmSVWWfgX5Uc3W_stacked_notification.png?fit=max\u0026auto=format\u0026n=6tscVAtiSqz353kV\u0026q=85\u0026s=cee04b5675b291562d92add259bc2224`,alt:`동일한 앱에서 그룹화된 푸시 알림을 표시하는 Android 기기`,\"data-og-width\":`900`,width:`900`,\"data-og-height\":`460`,height:`460`,\"data-path\":`images/docs/GnEw4PmmSVWWfgX5Uc3W_stacked_notification.png`,\"data-optimize\":`true`,\"data-opv\":`3`,srcset:`https://mintcdn.com/onesignal/6tscVAtiSqz353kV/images/docs/GnEw4PmmSVWWfgX5Uc3W_stacked_notification.png?w=280\u0026fit=max\u0026auto=format\u0026n=6tscVAtiSqz353kV\u0026q=85\u0026s=c4bd278dff3f89eaa61c885ce8518925 280w, https://mintcdn.com/onesignal/6tscVAtiSqz353kV/images/docs/GnEw4PmmSVWWfgX5Uc3W_stacked_notification.png?w=560\u0026fit=max\u0026auto=format\u0026n=6tscVAtiSqz353kV\u0026q=85\u0026s=c654daf679fd30f9227b70205b8b1dc0 560w, https://mintcdn.com/onesignal/6tscVAtiSqz353kV/images/docs/GnEw4PmmSVWWfgX5Uc3W_stacked_notification.png?w=840\u0026fit=max\u0026auto=format\u0026n=6tscVAtiSqz353kV\u0026q=85\u0026s=37e59c1fca43268eae17d6a0ae388cc8 840w, https://mintcdn.com/onesignal/6tscVAtiSqz353kV/images/docs/GnEw4PmmSVWWfgX5Uc3W_stacked_notification.png?w=1100\u0026fit=max\u0026auto=format\u0026n=6tscVAtiSqz353kV\u0026q=85\u0026s=0b22fdac4d60cd1f2ece5bd3420dd796 1100w, https://mintcdn.com/onesignal/6tscVAtiSqz353kV/images/docs/GnEw4PmmSVWWfgX5Uc3W_stacked_notification.png?w=1650\u0026fit=max\u0026auto=format\u0026n=6tscVAtiSqz353kV\u0026q=85\u0026s=8a7b1ed5ef92404ab40023a12cfcef50 1650w, https://mintcdn.com/onesignal/6tscVAtiSqz353kV/images/docs/GnEw4PmmSVWWfgX5Uc3W_stacked_notification.png?w=2500\u0026fit=max\u0026auto=format\u0026n=6tscVAtiSqz353kV\u0026q=85\u0026s=76c201b5bf0fa883ee75ae0b59f35807 2500w`})}),`\n`,_jsx(Heading,{level:`4`,id:`huawei-메시지-유형-huawei`,children:`Huawei 메시지 유형 (Huawei)`}),`\n`,_jsxs(_components.p,{children:[`OneSignal이 Huawei(HMS) 기기에 푸시를 전달하는 방식을 제어합니다. API: `,_jsx(_components.code,{children:`huawei_msg_type`})]}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:_jsx(_components.code,{children:`data`})}),`: OneSignal SDK가 클라이언트 측에서 알림을 렌더링하여 전체 기능 세트(큰 이미지, 액션 버튼)와 `,_jsx(_components.a,{href:`/docs/ko/confirmed-delivery#huawei`,children:`확인된 전달`}),`을 사용할 수 있습니다. 앱이 강제 종료된 경우 표시되지 않습니다.`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:_jsx(_components.code,{children:`message`})}),`(기본값): HMS Core가 서버 측에서 렌더링합니다. 제목과 본문만 표시되지만 앱이 강제 종료되어도 표시됩니다.`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.a,{href:`/reference/push-notification#body-huawei-msg-type`,children:_jsx(_components.code,{children:`huawei_msg_type`})}),` 및 `,_jsx(_components.a,{href:`/docs/ko/data-notifications#huawei-hms-data-notification-setup`,children:`데이터 및 백그라운드 알림`}),`을 참조하세요.`]}),`\n`]}),`\n`,_jsx(Note,{children:_jsxs(_components.p,{children:[_jsx(_components.code,{children:`huawei_msg_type=data`}),`는 HMS 전송 유형이며 무음 알림이 `,_jsx(_components.strong,{children:`아닙니다`}),`. 표시 가능한 콘텐츠가 있는 `,_jsx(_components.code,{children:`data`}),` 유형 푸시는 여전히 전체 알림을 표시합니다.`]})}),`\n`,_jsx(_components.hr,{}),`\n`,_jsx(Heading,{level:`2`,id:`푸시-알림-취소`,children:`푸시 알림 취소`}),`\n`,_jsxs(_components.p,{children:[`메시지가 아직 `,_jsx(_components.strong,{children:`전달`}),`되지 않은 경우 메시지를 취소할 수 있습니다. OneSignal은 대기열에 추가되지 않은 모든 구독으로 메시지 전송을 중지합니다. 이미 전달된 경우 기기에서 메시지를 제거하지 않습니다.`]}),`\n`,_jsxs(_components.p,{children:[_jsx(_components.a,{href:`/docs/ko/push-notification-message-reports`,children:`메시지 리포트`}),`에서 `,_jsx(_components.strong,{children:`Actions > Cancel`}),`을 선택하거나 `,_jsx(_components.a,{href:`/reference/cancel-message`,children:`Cancel Message API`}),`를 사용합니다.`]}),`\n`,_jsx(Heading,{level:`3`,id:`기기에서-푸시-알림-제거`,children:`기기에서 푸시 알림 제거`}),`\n`,_jsxs(_components.p,{children:[`푸시가 전달되면 `,_jsx(_components.a,{href:`#collapse-id-mobile-push`,children:`Collapse ID`}),` 또는 `,_jsx(_components.a,{href:`#web-push-topic-web-push`,children:`Web push topic`}),`을 설정한 경우에만 푸시 알림을 새 알림으로 교체할 수 있습니다. 이 중 하나도 설정하지 않으면 알림을 교체하거나 제거할 수 없습니다.`]}),`\n`,_jsx(_components.hr,{}),`\n`,_jsx(Heading,{level:`2`,id:`analytics`,children:`Analytics`}),`\n`,_jsx(_components.p,{children:`메시지 성능과 참여를 추적합니다.`}),`\n`,_jsxs(Columns,{cols:2,children:[_jsx(Card,{title:`푸시 메시지 리포트`,icon:`chart-line`,href:`/docs/ko/push-notification-message-reports`,children:_jsx(_components.p,{children:`메시지 수준의 전달률, 열람률 및 클릭률 리포팅.`})}),_jsx(Card,{title:`Analytics 개요`,icon:`chart-bar`,href:`/docs/ko/analytics-overview`,children:_jsx(_components.p,{children:`OneSignal에서 사용 가능한 모든 Analytics 옵션.`})}),_jsx(Card,{title:`Event Streams`,icon:`signal-stream`,href:`/docs/ko/event-streams`,children:_jsx(_components.p,{children:`실시간으로 푸시 이벤트를 데이터 웨어하우스 또는 BI 도구로 스트리밍합니다.`})}),_jsx(Card,{title:`메시지 보기 API`,icon:`code`,href:`/reference/view-messages`,children:_jsx(_components.p,{children:`REST API를 통해 프로그래밍 방식으로 메시지 Analytics를 가져옵니다.`})})]}),`\n`,_jsx(_components.hr,{}),`\n`,_jsx(Heading,{level:`2`,id:`자주-묻는-질문`,children:`자주 묻는 질문`}),`\n`,_jsx(Heading,{level:`3`,id:`onesignal-푸시는-어떤-플랫폼을-지원하나요`,children:`OneSignal 푸시는 어떤 플랫폼을 지원하나요?`}),`\n`,_jsxs(_components.p,{children:[`OneSignal은 iOS(APNs), Android(FCM), Huawei(HMS), Amazon(ADM), 웹 브라우저(Chrome, Firefox, Safari, Edge), macOS, Windows에서 푸시를 지원합니다. 위의 `,_jsx(_components.a,{href:`#platform-setup-guides`,children:`플랫폼 설정 가이드`}),`를 참조하세요.`]}),`\n`,_jsx(Heading,{level:`3`,id:`사용자에게-전송하기-전에-푸시-알림을-테스트하려면-어떻게-해야-하나요`,children:`사용자에게 전송하기 전에 푸시 알림을 테스트하려면 어떻게 해야 하나요?`}),`\n`,_jsxs(_components.p,{children:[_jsx(_components.a,{href:`/docs/ko/test-users`,children:`테스트 구독`}),`을 설정하여 실제 사용자에게 영향을 주지 않고 전달, 렌더링 및 딥 링크를 확인합니다. 빠른 테스트를 위해 단일 사용자 세그먼트에 전송할 수도 있습니다.`]}),`\n`,_jsx(Heading,{level:`3`,id:`푸시-알림이-표시되지-않는-이유는-무엇인가요`,children:`푸시 알림이 표시되지 않는 이유는 무엇인가요?`}),`\n`,_jsxs(_components.p,{children:[`일반적인 원인으로는 플랫폼 자격 증명 누락 또는 만료, 사용자가 권한을 부여하지 않은 경우, 또는 방해 금지 모드와 같은 기기 수준 설정이 포함됩니다. 전체 문제 해결 체크리스트는 `,_jsx(_components.a,{href:`/docs/ko/notifications-show-successful-but-are-not-being-shown`,children:`알림이 표시되지 않거나 지연됨`}),`을 참조하세요.`]}),`\n`,_jsx(Heading,{level:`3`,id:`푸시-알림의-최대-페이로드-크기는-얼마인가요`,children:`푸시 알림의 최대 페이로드 크기는 얼마인가요?`}),`\n`,_jsxs(_components.p,{children:[`모든 플랫폼에서 총 페이로드 크기는 약 4KB입니다. `,_jsx(_components.code,{children:`data`}),` 필드는 최대 2048바이트를 지원합니다. 이러한 제한을 초과하면 알림이 잘리거나 거부될 수 있습니다.`]}),`\n`,_jsx(Note,{children:_jsxs(_components.p,{children:[`이는 화면에 표시되는 제목/본문 잘림과는 다릅니다. 페이로드 크기는 전달 전에 APNs/FCM이 적용하는 엄격한 제한입니다. 제목과 본문의 표시 잘림은 전달 후 기기에서 발생하며 운영 체제 렌더링에 따라 달라집니다. 위의 `,_jsx(_components.a,{href:`#title`,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":"OneSignal 대시보드와 API로 타겟팅, 개인화, 예약 기능을 활용해 모바일 및 웹 푸시 알림을 전송·관리하는 방법을 안내합니다. iOS, Android, 웹 채널 설정 단계와 이미지, 버튼 등 리치 콘텐츠 옵션, 분석까지 다룹니다.","keywords":["push","푸시 알림","푸시 전송","모바일 푸시","웹 푸시","푸시 API","알림 개인화"],"href":"/docs/ko/push"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[{"title":"푸시 설정","slug":"푸시-설정","depth":2,"children":[{"title":"플랫폼 설정 가이드","slug":"플랫폼-설정-가이드","depth":3,"children":[]},{"title":"권한","slug":"권한","depth":3,"children":[]},{"title":"기능 및 고급 사용 사례","slug":"기능-및-고급-사용-사례","depth":3,"children":[]}]},{"title":"푸시 알림 전송","slug":"푸시-알림-전송","depth":2,"children":[{"title":"대시보드에서 전송","slug":"대시보드에서-전송","depth":3,"children":[]},{"title":"전달 일정 및 최적화","slug":"전달-일정-및-최적화","depth":3,"children":[]},{"title":"디자인 속성","slug":"디자인-속성","depth":3,"children":[]},{"title":"제목","slug":"제목","depth":4,"children":[]},{"title":"부제목","slug":"부제목","depth":4,"children":[]},{"title":"메시지","slug":"메시지","depth":4,"children":[]},{"title":"아이콘","slug":"아이콘","depth":4,"children":[]},{"title":"이미지","slug":"이미지","depth":4,"children":[]},{"title":"앱 이름","slug":"앱-이름","depth":4,"children":[]},{"title":"기능 속성","slug":"기능-속성","depth":3,"children":[]},{"title":"액션 버튼","slug":"액션-버튼","depth":4,"children":[]},{"title":"실행 URL","slug":"실행-url","depth":4,"children":[]},{"title":"배지","slug":"배지","depth":4,"children":[]},{"title":"소리","slug":"소리","depth":4,"children":[]},{"title":"추가 데이터","slug":"추가-데이터","depth":4,"children":[]},{"title":"Collapse ID (모바일 푸시)","slug":"collapse-id-모바일-푸시","depth":4,"children":[]},{"title":"Web push topic (웹 푸시)","slug":"web-push-topic-웹-푸시","depth":4,"children":[]},{"title":"우선순위","slug":"우선순위","depth":4,"children":[]},{"title":"Time to live (TTL)","slug":"time-to-live-ttl","depth":4,"children":[]},{"title":"알림 그룹화","slug":"알림-그룹화","depth":4,"children":[]},{"title":"Huawei 메시지 유형 (Huawei)","slug":"huawei-메시지-유형-huawei","depth":4,"children":[]}]},{"title":"푸시 알림 취소","slug":"푸시-알림-취소","depth":2,"children":[{"title":"기기에서 푸시 알림 제거","slug":"기기에서-푸시-알림-제거","depth":3,"children":[]}]},{"title":"Analytics","slug":"analytics","depth":2,"children":[]},{"title":"자주 묻는 질문","slug":"자주-묻는-질문","depth":2,"children":[{"title":"OneSignal 푸시는 어떤 플랫폼을 지원하나요?","slug":"onesignal-푸시는-어떤-플랫폼을-지원하나요","depth":3,"children":[]},{"title":"사용자에게 전송하기 전에 푸시 알림을 테스트하려면 어떻게 해야 하나요?","slug":"사용자에게-전송하기-전에-푸시-알림을-테스트하려면-어떻게-해야-하나요","depth":3,"children":[]},{"title":"푸시 알림이 표시되지 않는 이유는 무엇인가요?","slug":"푸시-알림이-표시되지-않는-이유는-무엇인가요","depth":3,"children":[]},{"title":"푸시 알림의 최대 페이로드 크기는 얼마인가요?","slug":"푸시-알림의-최대-페이로드-크기는-얼마인가요","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/push","matchLevel":1},"cn":{"href":"/docs/cn/push","matchLevel":1},"ko":{"href":"/docs/ko/push","matchLevel":0},"ja":{"href":"/docs/ja/push","matchLevel":1},"tr":{"href":"/docs/tr/push","matchLevel":1},"pt-BR":{"href":"/docs/pt-BR/push","matchLevel":1},"es":{"href":"/docs/es/push","matchLevel":1},"fr":{"href":"/docs/fr/push","matchLevel":1}}},"lastModified":"2026-08-31T16:02:16.338Z","originalFileLocation":"docs/ko/push.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=\"OneSignal 대시보드와 API로 타겟팅, 개인화, 예약 기능을 활용해 모바일 및 웹 푸시 알림을 전송·관리하는 방법을 안내합니다. iOS, Android, 웹 채널 설정 단계와 이미지, 버튼 등 리치 콘텐츠 옵션, 분석까지 다룹니다.\">\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=\"OneSignal 대시보드와 API로 타겟팅, 개인화, 예약 기능을 활용해 모바일 및 웹 푸시 알림을 전송·관리하는 방법을 안내합니다. iOS, Android, 웹 채널 설정 단계와 이미지, 버튼 등 리치 콘텐츠 옵션, 분석까지 다룹니다.\">\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/push\">\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=%ED%91%B8%EC%8B%9C\u0026amp;title=%ED%91%B8%EC%8B%9C+%EA%B0%9C%EC%9A%94\u0026amp;description=OneSignal+%EB%8C%80%EC%8B%9C%EB%B3%B4%EB%93%9C%EC%99%80+API%EB%A1%9C+%ED%83%80%EA%B2%9F%ED%8C%85%2C+%EA%B0%9C%EC%9D%B8%ED%99%94%2C+%EC%98%88%EC%95%BD+%EA%B8%B0%EB%8A%A5%EC%9D%84+%ED%99%9C%EC%9A%A9%ED%95%B4+%EB%AA%A8%EB%B0%94%EC%9D%BC+%EB%B0%8F+%EC%9B%B9+%ED%91%B8%EC%8B%9C+%EC%95%8C%EB%A6%BC%EC%9D%84+%EC%A0%84%EC%86%A1%C2%B7%EA%B4%80%EB%A6%AC%ED%95%98%EB%8A%94+%EB%B0%A9%EB%B2%95%EC%9D%84+%EC%95%88%EB%82%B4%ED%95%A9%EB%8B%88%EB%8B%A4.+iOS%2C+Android%2C+%EC%9B%B9+%EC%B1%84%EB%84%90+%EC%84%A4%EC%A0%95+%EB%8B%A8%EA%B3%84%EC%99%80+%EC%9D%B4%EB%AF%B8%EC%A7%80%2C+%EB%B2%84%ED%8A%BC+%EB%93%B1+%EB%A6%AC%EC%B9%98+%EC%BD%98%ED%85%90%EC%B8%A0+%EC%98%B5%EC%85%98%2C+%EB%B6%84%EC%84%9D%EA%B9%8C%EC%A7%80+%EB%8B%A4%EB%A3%B9%EB%8B%88%EB%8B%A4.\u0026amp;theme=12e705baa88dc8cc6d7a9877\u0026amp;signature=54bf5da4040e76a8d180fa8819f525007bb0ca3ee34bdbf4bc8a9e932d44c1d8\">\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=\"OneSignal 대시보드와 API로 타겟팅, 개인화, 예약 기능을 활용해 모바일 및 웹 푸시 알림을 전송·관리하는 방법을 안내합니다. iOS, Android, 웹 채널 설정 단계와 이미지, 버튼 등 리치 콘텐츠 옵션, 분석까지 다룹니다.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://onesignal.mintlify.site/_mintlify/api/og/v2?division=%ED%91%B8%EC%8B%9C\u0026amp;title=%ED%91%B8%EC%8B%9C+%EA%B0%9C%EC%9A%94\u0026amp;description=OneSignal+%EB%8C%80%EC%8B%9C%EB%B3%B4%EB%93%9C%EC%99%80+API%EB%A1%9C+%ED%83%80%EA%B2%9F%ED%8C%85%2C+%EA%B0%9C%EC%9D%B8%ED%99%94%2C+%EC%98%88%EC%95%BD+%EA%B8%B0%EB%8A%A5%EC%9D%84+%ED%99%9C%EC%9A%A9%ED%95%B4+%EB%AA%A8%EB%B0%94%EC%9D%BC+%EB%B0%8F+%EC%9B%B9+%ED%91%B8%EC%8B%9C+%EC%95%8C%EB%A6%BC%EC%9D%84+%EC%A0%84%EC%86%A1%C2%B7%EA%B4%80%EB%A6%AC%ED%95%98%EB%8A%94+%EB%B0%A9%EB%B2%95%EC%9D%84+%EC%95%88%EB%82%B4%ED%95%A9%EB%8B%88%EB%8B%A4.+iOS%2C+Android%2C+%EC%9B%B9+%EC%B1%84%EB%84%90+%EC%84%A4%EC%A0%95+%EB%8B%A8%EA%B3%84%EC%99%80+%EC%9D%B4%EB%AF%B8%EC%A7%80%2C+%EB%B2%84%ED%8A%BC+%EB%93%B1+%EB%A6%AC%EC%B9%98+%EC%BD%98%ED%85%90%EC%B8%A0+%EC%98%B5%EC%85%98%2C+%EB%B6%84%EC%84%9D%EA%B9%8C%EC%A7%80+%EB%8B%A4%EB%A3%B9%EB%8B%88%EB%8B%A4.\u0026amp;theme=12e705baa88dc8cc6d7a9877\u0026amp;signature=54bf5da4040e76a8d180fa8819f525007bb0ca3ee34bdbf4bc8a9e932d44c1d8\">\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/push\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/docs/ko/push.md\">\u003clink data-mint-head rel=\"alternate\" hreflang=\"ko\" href=\"https://documentation.onesignal.com/docs/ko/push\">\u003clink data-mint-head rel=\"alternate\" hreflang=\"en\" href=\"https://documentation.onesignal.com/docs/en/push\">\u003clink data-mint-head rel=\"alternate\" hreflang=\"zh\" href=\"https://documentation.onesignal.com/docs/cn/push\">\u003clink data-mint-head rel=\"alternate\" hreflang=\"ja\" href=\"https://documentation.onesignal.com/docs/ja/push\">\u003clink data-mint-head rel=\"alternate\" hreflang=\"tr\" href=\"https://documentation.onesignal.com/docs/tr/push\">\u003clink data-mint-head rel=\"alternate\" hreflang=\"pt-BR\" href=\"https://documentation.onesignal.com/docs/pt-BR/push\">\u003clink data-mint-head rel=\"alternate\" hreflang=\"es\" href=\"https://documentation.onesignal.com/docs/es/push\">\u003clink data-mint-head rel=\"alternate\" hreflang=\"fr\" href=\"https://documentation.onesignal.com/docs/fr/push\">\u003clink data-mint-head rel=\"alternate\" hreflang=\"x-default\" href=\"https://documentation.onesignal.com/docs/en/push\">\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/push#webpage\",\"url\":\"https://documentation.onesignal.com/docs/ko/push\",\"name\":\"푸시 개요\",\"description\":\"OneSignal 대시보드와 API로 타겟팅, 개인화, 예약 기능을 활용해 모바일 및 웹 푸시 알림을 전송·관리하는 방법을 안내합니다. iOS, Android, 웹 채널 설정 단계와 이미지, 버튼 등 리치 콘텐츠 옵션, 분석까지 다룹니다.\",\"dateModified\":\"2026-08-31T16:02:16.338Z\",\"isPartOf\":{\"@id\":\"https://documentation.onesignal.com#website\"},\"breadcrumb\":{\"@id\":\"https://documentation.onesignal.com/docs/ko/push#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://documentation.onesignal.com/docs/ko/push#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\":[\"Article\",\"TechArticle\"],\"@id\":\"https://documentation.onesignal.com/docs/ko/push#article\",\"headline\":\"푸시 개요\",\"name\":\"푸시 개요\",\"description\":\"OneSignal 대시보드와 API로 타겟팅, 개인화, 예약 기능을 활용해 모바일 및 웹 푸시 알림을 전송·관리하는 방법을 안내합니다. iOS, Android, 웹 채널 설정 단계와 이미지, 버튼 등 리치 콘텐츠 옵션, 분석까지 다룹니다.\",\"url\":\"https://documentation.onesignal.com/docs/ko/push\",\"mainEntityOfPage\":{\"@id\":\"https://documentation.onesignal.com/docs/ko/push#webpage\"},\"dateModified\":\"2026-08-31T16:02:16.338Z\",\"keywords\":\"push, 푸시 알림, 푸시 전송, 모바일 푸시, 웹 푸시, 푸시 API, 알림 개인화\",\"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/push"}]},{"language":"cn","pages":[{"title":"cn","href":"/docs/cn/push"}]},{"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":"채널 설정","description":"OneSignal에서 푸시 알림, 인앱 메시지, 이메일, SMS, RCS, Live Activities를 설정하여 모든 채널에서 사용자에게 도달합니다.","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 임시 푸시 알림","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":"Shopify 웹 푸시 통합","href":"/docs/ko/shopify"},{"title":"웹 푸시를 위한 OneSignal WordPress 플러그인 설정","href":"/docs/ko/wordpress"},{"title":"WordPress 문제 해결","href":"/docs/ko/troubleshooting-wordpress-web-push"}]},{"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/push"}]},{"language":"tr","pages":[{"title":"tr","href":"/docs/tr/push"}]},{"language":"pt-BR","pages":[{"title":"pt-BR","href":"/docs/pt-BR/push"}]},{"language":"es","pages":[{"title":"es","href":"/docs/es/push"}]},{"language":"fr","pages":[{"title":"fr","href":"/docs/fr/push"}]}]},"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"]}
