# 기기 유형 설명

Pushwoosh 에 등록된 기기에 대한 기록에는 세 가지 유형이 있습니다:

*   [총 기기](#total-devices)
*   [푸시 활성화 기기](#push-enabled-devices)
*   [푸시 알림 활성화 기기](#push-alerts-enabled-devices)

## 총 기기

**총 기기** 수는 Pushwoosh 계정의 Control Panel 왼쪽 상단에 있는 오른쪽 숫자로 표시됩니다.

**총 기기**에는 Pushwoosh 에 **등록된 모든 기기** 중 **최근 90일 이내에 활성화된** 기기가 포함됩니다. 이 기기들은 push token 을 가지고 있을 수도 있고 없을 수도 있습니다. push token 이 없는 기기는 In-App Messages 로 도달할 수 있습니다.

<Aside type="note">
Push token 은 특정 기기에서 앱을 식별하는 고유 키입니다. 클라우드 게이트웨이에서 발급하며 기기에 push notifications 을 전송하는 데 사용됩니다.
</Aside>

사용자가 설치 후 처음으로 Pushwoosh SDK 가 포함된 앱을 열면 기기가 등록됩니다. 앱이 실행되면 SDK 는 `/applicationOpen` 및 `/getInApps` 와 같은 여러 호출을 백엔드로 보냅니다. 예를 들면 다음과 같습니다:

```
Pushwoosh request:
 Url: https://api.pushwoosh.com/json/1.3/applicationOpen
 Payload: {"request": {"jailbroken": 0, "notificationTypes": 7,
"app_version": "1.11.2","application": "66716-7F06D","device_type": 1,
"userId": "76051F70-....-46B5-B4BA-F3FC94BD3534", "language": "en",
"hwid": "76051F70-....-46B5-B4BA-F3FC94BD3534","package": "com.pushwoosh.pushon",
"os_version": "12.1.4","v": "5.9.1","device_model": "iPhone10,1"}}
```

이렇게 하면 기기가 hwid (하드웨어 ID)와 함께 Pushwoosh 데이터베이스에 기록되고 In-App Messages 를 수신할 수 있게 되며, 앱 실행 통계가 1 증가합니다. 기기가 데이터베이스에 기록되면 해당 기기에 대한 Tag 를 제출하고 필요한 경우 User ID 를 할당할 수 있습니다.

이 시점에서는 아직 push token 이 존재하지 않으며, 이 기기는 총 기기 카테고리에 속하게 됩니다.

만약 기기가 90일 이상 비활성 상태인 경우(예: 해당 기기에 대한 SDK 의 `/applicationOpen` 요청이 없고, 트리거된 Events 가 없으며, push token 이 없는 경우) 데이터베이스에서 삭제됩니다. 이 비활성 기간은 구성할 수 있습니다. 비활성 기간을 재설정하려면 고객 성공 관리자 또는 고객 지원팀에 문의하세요.

## 푸시 활성화 기기

푸시 활성화 기기는 push token 이 연결된 기기입니다. 즉, 이러한 기기에 push notifications 을 보낼 수 있으며 클라우드 게이트웨이가 푸시를 전달합니다.

푸시 활성화 기기 수는 Pushwoosh 계정의 Control Panel 왼쪽 상단에 있는 왼쪽 숫자로 표시됩니다.

사용자가 push notifications 수신에 동의하면 APNS 및 FCM 과 같은 클라우드 게이트웨이에서 push token 이 발급되고, SDK 는 이 토큰과 함께 Pushwoosh 의 [`/registerDevice`](../../api-reference/device-api#registerdevice) 엔드포인트로 API 요청을 보냅니다:

```
Pushwoosh request:
 Url: https://api.pushwoosh.com/json/1.3/registerDevice
 Payload: {"request": {"gateway": "production", "jailbroken": 0,
 "notificationTypes": 7, "app_version": "1.11.2", "application": "66716-7F06D",
 "sounds": ["bubble.wav"], "device_type": 1, "userId": "76051F70-....-46B5-B4BA-F3FC94BD3534",
 "language": "en", "hwid": "76051F70-....-46B5-B4BA-F3FC94BD3534",
 "package": "com.pushwoosh.pushon", "timezone": "25200", "os_version": "12.1.4",
 "push_token": "9c943351faaa7080a1c076343521.......17d220a0c68f42125cd98bb",
 "v": "5.9.1", "device_model": "iPhone10,1"}}
```

이제 기기에 대한 push token 이 데이터베이스에 등록되었으므로, 이 기기는 푸시 활성화된 것으로 간주되며 해당 기기로 push notifications 을 보낼 수 있습니다.

<Aside type="note">
실제로 기기에 push token 이 연결되어 있더라도 일부 사용자는 기기 설정에서 수동으로 알림을 비활성화한 경우 push notifications 을 보지 못할 수 있습니다. 이러한 사용자는 백그라운드(자동) 푸시, In-App Messages 로 도달할 수 있으며, Inbox 로 알림을 받을 수 있습니다. 자세한 내용은 [푸시 알림 활성화](#push-alerts-enabled-devices)를 참조하세요.
</Aside>

push notification 을 보낼 때 APNS 와 FCM 은 각 수신자의 push token 상태를 반환합니다. 토큰이 유효하지 않거나 존재하지 않는 것으로 표시되면 데이터베이스에서 해당 토큰을 제거하고, 푸시 활성화 기기 수가 그에 따라 감소합니다.

push token 이 시스템에서 제거되면 해당 기기는 더 이상 푸시 활성화 카테고리에 속하지 않지만 총 기기에는 남아 있습니다. 그 후 사용자가 앱을 열면 기기에 새로운 push token 이 할당되어 다시 푸시 활성화 기기로 돌아갑니다. 토큰 제거 후 90일 이내에 활동이 없으면 기기는 데이터베이스에서 완전히 삭제됩니다.

## 푸시 알림 활성화 기기

푸시 알림 활성화 기기는 앱 외부(잠금 화면, 알림 센터 또는 앱 아이콘의 배지)에 push notification 알림을 표시할 수 있습니다. 이는 사용자가 기기 설정에서 push notification 알림을 활성화 또는 비활성화하는지에 따라 다릅니다.

알림이 활성화된 기기는 Push Alerts Enabled 기본 태그의 값이 "True"로 표시되고, 나머지는 "False"로 표시됩니다. 이는 태그 통계에서 확인할 수 있습니다. 이 Tag 는 앱이 백그라운드에 있거나 닫혀 있을 때 실제로 push notification 알림을 받을 수 있는 사용자 수를 추적합니다.

Push Alerts Enabled 태그는 기본 태그이며 Pushwoosh SDK 에 의해 자동으로 수집됩니다. 최신 버전의 Pushwoosh SDK (2018년 가을 또는 그 이후 출시)가 필요합니다.

<Aside type="caution" title="중요">


알림 상태는 사용자가 기기 설정에서 알림 환경 설정을 변경한 후 앱을 한 번 이상 열어야만 Pushwoosh 에서 업데이트될 수 있습니다. 사용자가 push notification 알림을 허용했지만 앱을 열지 않으면, 해당 사용자를 푸시 알림 활성화 사용자로 인식하지 못합니다. 이것이 바로 최대 도달 범위를 확보하기 위해 토큰이 있는 모든 기기를 타겟팅하는 것이 중요한 이유입니다.
</Aside>

푸시 활성화 기기와 푸시 알림 활성화 기기를 비교하면 옵트인 비율을 더 잘 파악하고 더 넓은 잠재 고객과 소통하기 위한 올바른 커뮤니케이션 채널을 선택하는 데 도움이 될 수 있습니다. 알림이 비활성화된 기기 세그먼트를 구축하면 대체 채널을 통해 이들에게 도달하고 알림을 다시 활성화하도록 유도할 수 있습니다.