> For the complete documentation index, see [llms.txt](https://document.wisetracker.co.kr/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://document.wisetracker.co.kr/before-start/faq/app-push/case.md).

# 이미지/알림 수신되지 않음 CASE

## 🖼️이미지가 보이지 않는 경우

### 저전력, 에너지 절전 모드

{% hint style="warning" %}
저전력 모드 설정 시 이미지가 보이지 않을 뿐 아니라, 메시지 수신이 불가할 수도 있습니다.
{% endhint %}

일부 기기에는 알림 표시 속도를 중지하거나 줄이는 특정한 배터리 최적화 기능이 있습니다.

**Android** : 설정에서 다음을 검색하세요.

* **절전 모드** 또는 **에너지 절약** - "절전 모드" 및/또는 "앱 및 홈 화면 제한"이 활성화된 경우 모든 백그라운드 활동(푸시 알림) 수신이 제한됩니다.
* **적응형 절전 모드** - 활성화된 경우, 기기는 사용 패턴에 따라 "절전 모드"를 자동으로 켜거나 끕니다.
* 또는 **배터리 최적화** 또는 **백그라운드 앱 사용 제한** - 배터리 최적화 앱은 백그라운드 기능(푸시 알림 등)이 제한됩니다. 앱이 최적화되지 않았는지 확인하세요.

<figure><img src="/files/hWYGcQB1cg7NPKVdbJbE" alt=""><figcaption><p>Android</p></figcaption></figure>

**iOS** : 기기에 저전력 모드가 활성화되어 있고 전력이 낮으면 알림을 받을 수 있는 속도가 줄어듭니다. **설정 > 배터리 > 저전력 모드** 가 활성화되어 있는지 확인해주세요.

<figure><img src="/files/CaqNMA5e1Gzyzqtb3CCd" alt="" width="375"><figcaption></figcaption></figure>

##

***

## 🔕메시지가 수신되지 않는 경우

### 네트워크 문제

<details>

<summary>인터넷 없음</summary>

푸시 알림을 받으려면 기기가 온라인 상태여야 합니다. 다음의 경우 적절한 연결이 이루어질 때까지 푸시가 표시되지 않습니다.

* 기기가 꺼져 있음
* 비행기 모드
* 인터넷 연결이 없거나 불안정한 경우

</details>

<details>

<summary>Wifi 연결, 방화벽 또는 VPN</summary>

Apple 또는 Google 서버와의 연결이 끊어졌을 수 있습니다.

* 연결된 네트워크/WiFi를 확인해주세요.&#x20;
* 인터넷 연결을 비활성화했다가 다시 활성화해 보세요.
* 셀룰러 데이터를 사용하여 Wi-Fi 없이 시도해 보세요.

</details>

### 타겟 설정 체크

푸시 발송 대상을 확인하고 올바르게 설정되었는지 확인해주세요.

### 앱 푸시 알림 비허용

> <mark style="color:red;">**Android**</mark>**&#x20;:** 기기 설정 > 어플리케이션 > 앱
>
> "알림 표시"가 활성화되어 있고 그 아래의 모든 카테고리가 활성화되어 있어야 합니다. 카테고리를 비활성화한 경우 해당 카테고리에서 알림을 받지 못합니다.
>
> <mark style="color:red;">**iOS**</mark>**&#x20;:** 기기 설정 > 앱 > 알림

위의 설정에서 푸시 알림을 켜거나 끌 수 있습니다. 기기에 푸시 권한이 활성화되어 있는지 확인해주세요.

<figure><img src="/files/kNn2PYmnzoTuqeiCDXBy" alt="" width="563"><figcaption></figcaption></figure>

### 앱이 켜져 있는(포그라운드) 상태일 때

테스트할 때는 앱을 계속 실행하지만 백그라운드로 두거나 초점에서 벗어나게 합니다.

보내는 동안 앱이 열려 있으면 화면에 알림 메시지가 보여지도록 구현하지 않은 이상 화면에 배너 형태로 알림 메시지가 보이지 않습니다.

### 방해 금지 모드

**방해 금지 모드가** 활성화되어 있으면 알림이 화면에 "팝업"되지 않지만 "알림 센터"에는 계속 표시됩니다.

> <mark style="color:red;">**Android**</mark>**&#x20;:** 기기 설정 > 알림 > 방해 금지
>
> <mark style="color:red;">**iOS**</mark>**&#x20;:** 제어센터 > 방해금지 모드 (집중모드)
>
> 방해금지 모드뿐 아니라, 집중모드 설정에 따라서도 알림이 수신되지 않을 수 있습니다.

위의 설정에서 방해 금지 모드를 비활성화해주세요.

<figure><img src="/files/iJa2p7ihjCFloPUIFDj4" alt="" width="563"><figcaption></figcaption></figure>

### SDK 최신 버전 업데이트

앱의 와이즈트래커 SDK가 오래된 버전일 경우 메시지가 수신되지 않을 수 있습니다.

와이즈트래커 SDK가 최신 버전이 맞는지 확인해주세요.

{% content-ref url="/spaces/-M\_ZKcnBFmefw9Yfed6b-3102695190" %}
[🧑‍💻 개발자 가이드](https://document.wisetracker.co.kr/v2-developer/)
{% endcontent-ref %}
