푸시 알림 아이콘 모범 사례
- 모든 장치에서 더 나은 렌더링을 위해 투명한 PNG를 사용하세요.
- 아이콘이 작은 크기에서도 간단하고 인식 가능한지 확인하세요.
- 크기 및 색 구성표에 대한 플랫폼별 가이드라인을 따르세요(예: Android 상태 표시줄의 투명한 배경에 흰색 아이콘).
- 아이콘에 텍스트를 사용하지 마세요. 작은 크기에서 읽을 수 없게 될 수 있습니다.
- 잘 디자인된 푸시 알림 아이콘을 포함하면 알림의 효과 및 매력을 크게 향상시킬 수 있습니다.
웹 알림 아이콘
권장 크기는256x256 픽셀입니다. PNG, JPG 및 GIF(애니메이션 아님) 파일 형식이 지원됩니다.
대시보드 Web 설정에서 아이콘을 업로드하거나 이미지 URL을 사용하세요.
iOS 알림 아이콘
iOS 알림은 앱 아이콘과 동일한 이미지를 사용하며 앱 아이콘을 변경하지 않고는 변경할 수 없습니다. iOS는 사용자의 프로필 이미지로 아이콘을 변경할 수 있는 Communication Notifications도 지원합니다.Android 알림 아이콘
Android(Amazon 및 Huawei 포함)는 이 가이드에서 자세히 설명하는 아이콘 설정을 위한 여러 옵션을 제공합니다. Android는 사용자의 프로필 이미지로 아이콘을 변경할 수 있는 Conversation Notifications도 지원합니다. Android는 작은 알림 아이콘과 큰 알림 아이콘을 모두 지원합니다.
작은 알림 아이콘
작은 아이콘은 알림의 왼쪽 상단에 표시됩니다. 기본적으로 OneSignal은 벨 아이콘을 표시하지만 Subscriber가 앱의 알림임을 인식할 수 있도록 사용자 지정하는 것이 좋습니다.대부분의 Android 장치는 아이콘에 대해 알파 채널만 지원합니다. 상태 표시줄에 단색으로 표시되지만 알림 자체의 왼쪽에 강조 색상을 적용할 수 있습니다.
큰 알림 아이콘
큰 알림 아이콘은 알림의 오른쪽에 표시됩니다. 큰 아이콘을 설정하지 않으면 작은 아이콘이 대신 사용됩니다. OneSignal은 아이콘이 잘리는 것을 방지하기 위해 큰 알림 아이콘을 자동으로 스케일링합니다. 큰 아이콘의 권장 크기는256x256 픽셀입니다.
Android 기본 아이콘 추가 방법
모든 Android 및 Amazon 앱에 기본 아이콘을 추가하는 것을 강력히 권장합니다.1
아이콘 생성
나열된 크기 및 알파 투명도로 각 이미지를 추가해야 합니다.알파 투명도가 있는 이미지 생성에 대한 도움말은 Android Asset Studio의 클립아트 링크를 참조하세요.
- Android Asset Studio 사용
- 수동으로 아이콘 생성
권장올바른 설정으로 작은 아이콘을 빠르고 쉽게 생성하려면 Android Asset Studio를 사용하는 것이 좋습니다. 이름으로
ic_stat_onesignal_default를 사용하세요.기본 아이콘 이름, 밀도, 크기
필수: 각 이름 및 픽셀 크기가 앱에 있어야 합니다.| Name | Density (dp) | Size (px) |
|---|---|---|
| ic_stat_onesignal_default | MDPI | 24x24 |
| ic_stat_onesignal_default | HDPI | 36x36 |
| ic_stat_onesignal_default | XHDPI | 48x48 |
| ic_stat_onesignal_default | XXHDPI | 72x72 |
| ic_stat_onesignal_default | XXXHDPI | 96x96 |
| ic_onesignal_large_icon_default.png | XXXHDPI | 256x256 |
2
프로젝트 경로 생성
다음 경로가 있는지 확인하세요. 없는 폴더를 만드세요.필수: 각 이미지는 다음 경로에 있어야 합니다:
- Android Native
- Unity
- Cordova/Ionic
- React Native
- .NET Maui
- Flutter
res/drawable-mdpi/(24x24)res/drawable-hdpi/(36x36)res/drawable-xhdpi/(48x48)res/drawable-xxhdpi/(72x72)res/drawable-xxxhdpi/(96x96)res/drawable-xxxhdpi/(256x256) (Large Icon)
Cordova 7.0 이전 버전의 경우 아이콘 리소스를
config.xml에 추가할 때 위에 표시된 경로 대신 <project-root>/platforms/android/res/drawable-{size}/를 사용해야 합니다기본 OneSignal 벨 아이콘이 표시되면 모든 아이콘 크기를 추가하지 않은 것입니다. 모든 아이콘 크기 및 올바른 경로를 추가하세요.단색 사각형이 표시되면 이미지를 올바른 경로로 설정했지만 이미지에 알파 투명도가 없습니다. 자세한 도움말은 Android Asset Studio 클립아트의 이미지를 사용해 보세요.

새 기본 아이콘으로 모든 설정이 완료되어야 합니다.
기본이 아닌 아이콘
기본이 아닌 아이콘으로 푸시를 보내는 방법(선택 사항)
기본이 아닌 아이콘으로 푸시를 보내는 방법(선택 사항)
기본 아이콘을 추가한 후 기본이 아닌 아이콘을 더 추가할 수 있습니다. 이를 통해 앱이 보내는 알림 유형에 따라 다른 아이콘을 표시할 수 있습니다. 예를 들어 “Jewel Breaker”와 같은 제목의 게임은 사용자의 레벨을 나타내는 알림마다 다른 색상의 보석 아이콘을 원할 수 있습니다. 한편 소셜 네트워크는 사용자가 다른 사용자로부터 메시지를 받을 때 채팅 버블 아이콘을 표시하여 해당 알림을 더 일반적인 시스템 알림과 구별할 수 있습니다.OneSignal은 메시지별로 기본 아이콘을 재정의하는 것을 지원합니다.
1
아이콘 생성
위의 단계에 따라 아이콘을 생성하고 SDK의 적절한 폴더에 배치하세요.
2
기본이 아닌 아이콘 이름 지정
기본이 아닌 아이콘을 추가하려면 위에 지정된 기본 이름이 아닌 다른 이름을 지정해야 합니다. 예를 들어
message_icon으로 이름을 지정할 수 있습니다.3
기본이 아닌 아이콘으로 알림 보내기
기본 아이콘을 생성하기 위한 위의 단계를 따르고 앱을 업데이트한 경우 알림을 보낼 때 해당 아이콘을 참조할 수 있습니다. 사용자 지정 아이콘으로 알림을 보내려면:
대시보드
Messages > New Push > Platform Settings > Google Android Options로 이동 > 파일 확장자 없이 아이콘 이름을 설정합니다. 큰 알림 아이콘의 경우 아이콘이 표시될 URL을 제공할 수도 있습니다.
REST API
small_icon 및 large_icon REST API 속성으로 알림 아이콘을 설정합니다. 파일 확장자 없이 아이콘 이름을 설정합니다. 자세한 내용은 Create notification REST API 문서를 참조하세요.작은 아이콘 강조 색상
알림의 작은 아이콘 주변에 표시되는 색상을 변경할 수 있습니다.
작은 아이콘 강조 색상 설정
기본 색상을 설정하려면 프로젝트의res/values/strings.xml 파일에 다음 줄을 추가하세요.
다크 모드에 대해 다른 색상을 원하는 경우 res/values-night/strings.xml에도 키를 추가하세요.
HEX 값을 사용하세요. 도움이 필요하면 Android Asset Studio Color scheme을 사용하세요.
android_accent_color를 설정하거나 Messages > New Push > Platform Settings > Google Android Options의 Accent color 필드에 값을 입력하세요.

앱에 아이콘 리소스를 최근에 추가한 경우 아이콘을 사용하여 알림을 보내기 전에 며칠 기다리는 것이 좋습니다. 대다수의 사용자가 새 아이콘이 포함된 최신 버전으로 앱을 업데이트하는 데 며칠 또는 몇 주가 걸릴 수 있기 때문입니다.