메인 콘텐츠로 건너뛰기
이미지가 포함된 푸시 알림을 보낼 때 OneSignal SDK는 OSNotification Payload에서 외부 이미지 URL을 가져와서 알림 내에 표시하려고 시도합니다. 이 프로세스 중에 앱이 닫혀 있는지 여부는 중요하지 않습니다. SDK는 이미지가 다운로드될 때까지 대기하지만 약 25초(Apple에서 강제 적용) 이상 걸리면 이미지 없이 알림이 표시됩니다. OneSignal의 SDK는 다운로드에 실패하면 이미지를 다시 가져오려고 시도하지 않습니다. 이 가이드는 이미지가 표시되지 않는 가장 일반적인 이유와 해결 방법을 다룹니다. 이미지 사양에 대한 자세한 내용은 Images & Rich Media를 참조하세요.

​
이미지 구성

이미지가 올바르게 구성되었는지 확인하려면 먼저 다음 항목을 확인하세요.

​
이미지 크기

이미지 크기는 5MB 미만이어야 합니다. 이미지가 작을수록 더 빠르게 다운로드됩니다. 자세한 내용은 Images & Rich Media를 참조하세요.

​
이미지 URL

  • 이미지 URL은 이미지 리소스에 대한 직접 링크가 필요합니다. 리디렉션이나 이미지를 표시하지만 실제 이미지 리소스가 아닌 페이지에 대한 링크는 사용할 수 없습니다.
    • 일반적으로 이미지 URL은 https://로 시작하고 .png 또는 .jpg와 같은 파일 확장자로 끝나야 합니다.
예시:
  • 작동하지 않음: https://pixabay.com/en/architecture-travel-sky-building-3095716/
  • 이미지를 마우스 오른쪽 버튼으로 클릭하고 새 탭에서 열면 작동함: https://cdn.pixabay.com/photo/2018/01/21/01/46/architecture-3095716_960_720.jpg

​
이미지 호스트

OneSignal에 이미지를 업로드하면 약 33일 동안 서버에 호스팅됩니다. 더 오래 이미지가 필요한 경우 템플릿을 사용하거나 자체 서버에 이미지를 저장하고 템플릿에서 리소스 URL을 직접 참조할 수 있습니다. 이미지를 자체 호스팅하는 경우 서버가 다운로드 양을 처리할 수 있는지 확인해야 합니다. 알림을 받는 각 장치는 이미지를 다운로드해야 합니다. 장치가 이미지를 포함한 모든 알림 리소스를 다운로드하는 데 약 30초가 주어집니다. 시간이 더 오래 걸리면 해당 장치에 표시되지 않습니다.

​
장치 구성

장치의 인터넷 연결을 확인하세요. 불안정한 네트워크 연결로 인해 이미지가 표시되지 않을 수 있습니다.
  • 다른 WiFi 네트워크에서 테스트하세요.
  • 다른 셀룰러 네트워크에서 테스트하세요.
  • 다른 장치에서 테스트하세요.

​
플랫폼 구성

이미지를 받지 못하는 플랫폼에 따라 아래 섹션을 확인하세요.

​
Web push 이미지

  • Windows 및 Android에서 Chrome만 푸시 알림의 큰 이미지를 지원합니다.
    • macOS용 Chrome은 큰 이미지를 지원하지 않습니다.
  • Firefox, Safari 및 Edge는 큰 이미지를 지원하지 않습니다.
  • Android에서 알림을 받으면 알림을 탭하여 확장해야 이미지를 볼 수 있습니다.
모바일 브라우저 앱에 읽지 않은 푸시 알림이 많거나 열려 있는 탭이 많으면 알림이 표시되지 않을 수 있습니다.

​
Android push 이미지

Android 알림 센터에서 알림을 받으면 알림을 확장해야 이미지를 볼 수 있습니다. Android는 푸시 알림에서 이미지를 받기 위한 추가 구성이 필요하지 않습니다.

​
iOS push 이미지

iOS 알림은 Notification Service Extension이 올바르게 설정되어야 합니다. Notification Service Extension 설정은 사용 중인 SDK 버전에 대한 Mobile SDK 설정 가이드에서 다룹니다. 이미지 URL이 HTTP이고 HTTP URL을 사용하여 직접 호스팅하려는 경우 Xcode .plist에서 NSAppTransportSecurity를 NSAllowsArbitraryLoads로 설정해야 합니다.
NSAllowsArbitraryLoads가 활성화되어 있으면 보안 취약점이 생성될 수 있으므로 App Store에 앱을 출시할 때 Apple이 앱을 거부할 수 있습니다. 자세한 내용은 Apple의 Security Overview를 참조하세요.

​
기술적 문제 해결

위의 항목을 확인했지만 이미지가 여전히 표시되지 않으면 SDK의 setLogLevel 메서드를 VERBOSE 로깅과 함께 사용하여 이미지 다운로드와 관련된 특정 오류를 확인하세요. 로그 생성에 대한 자세한 가이드는 Capturing a Debug Log 가이드를 참조하세요. 일반적인 오류는 다음과 같습니다:
  • Could not download image!
  • Encountered an error while attempting to download file with URL:
  • OneSignal encountered an exception while downloading file

​
iOS Notification Service Extension 문제 해결

iOS에서 이미지가 표시되지 않으면 Troubleshooting the iOS Notification Service Extension 가이드를 따르세요. 이 가이드는 Notification Service Extension 설정을 검토하고 문제를 식별하는 데 도움이 됩니다.