# 푸시 구독자 가져오기

다른 푸시 제공업체에서 마이그레이션하는 경우, 기존 푸시 구독자 기반을 CSV 파일에서 Pushwoosh로 가져올 수 있습니다. 앱이 동일한 APNs 키, Firebase 프로젝트 또는 HMS 자격 증명을 사용하는 한 토큰은 계속 작동합니다. 사용자는 앱을 다시 설치하거나 권한을 다시 부여할 필요가 없습니다.

이 가져오기는 푸시 토큰으로 기기를 등록합니다. 세그먼트를 생성하지는 않습니다. 가져온 기기에는 나중에 세그먼트를 만드는 데 사용할 수 있는 **CSV import** 태그가 부여됩니다. 이미 등록된 User ID 또는 Hardware ID 목록을 세그먼트로 가져오려면 [세그먼트 가져오기](/ko/product/audience-data-and-segmentation/segmentation/create-segments/by-import/)를 참조하세요.

## 지원되는 플랫폼

Pushwoosh는 아래 나열된 플랫폼에 대해서만 푸시 토큰을 가져옵니다.

`device_type` 열은 파일의 출처에 따라 두 가지 다른 형식을 허용합니다:

- 숫자, 내보내기 파일이 OneSignal의 자체 플랫폼 코드를 사용하는 경우.
- 단어, Amazon Pinpoint 내보내기 파일이거나 직접 만든 파일인 경우.

두 형식을 한 파일에 혼합하지 마세요. 각 시스템에서 동일한 숫자가 다른 플랫폼을 의미하기 때문입니다. OneSignal이 아닌 소스에서 숫자를 붙여넣으면 기기가 잘못된 플랫폼으로 조용히 가져와질 수 있습니다.

| 플랫폼 | OneSignal `device_type` 번호 | 허용되는 플랫폼 이름 |
| :--- | :--- | :--- |
| iOS | `0` | `ios`, `apns`, `apns_sandbox`, `apns_voip` |
| Android | `1` | `android`, `gcm`, `fcm` |
| Amazon | `2` | `amazon`, `adm`, `fireos` |
| Windows | `6` | `windows`, `wns` |
| macOS | `9` | `macos`, `osx` |
| Huawei (HMS) | `13` | `huawei`, `hms` |

다른 값을 가진 행은 다음을 포함하여 건너뜁니다([행을 건너뛰는 이유](#why-a-row-gets-skipped) 참조):

- OneSignal의 자체 웹 푸시, 이메일 및 SMS 기기 유형.
- Pushwoosh가 지원하지 않는 플랫폼(예: 단종된 Windows Phone 또는 Baidu 푸시).

웹 푸시 구독은 어떤 제공업체에서도 이전할 수 없습니다. 해당 사용자는 웹사이트에서 Pushwoosh SDK를 통해 다시 구독해야 합니다.

## CSV 파일 준비

CSV는 100MB 미만이어야 합니다. 아래 표시된 대로 열 이름을 정확하게 지정하세요. 대소문자는 중요하지 않습니다. UI에서 열을 매핑할 수 없으므로 일치하지 않는 헤더는 이름을 바꾸세요:

| 헤더 | 매핑 대상 |
| :--- | :--- |
| `identifier` | 푸시 토큰 (필수) |
| `device_type` | 플랫폼 (필수) |
| `external_id` 또는 `external_user_id` | User ID |
| `language` | 기기 언어 |
| `tags` | 사용자 지정 태그 값의 JSON 객체 |
| `invalid_identifier` | OneSignal의 "구독 취소" 플래그. 여기에 플래그가 지정된 행은 건너뜁니다 |

timezone 열이 있는 경우, 내보내기 버전에 따라 형식이 다르기 때문에 가져오지 않습니다.

### 예제 CSV

다음은 두 개의 기기가 포함된 `subscribers.csv` 예제입니다. 하나는 플랫폼 이름을 사용하고 다른 하나는 OneSignal 숫자 코드를 사용합니다:

| identifier | device_type | external_id | language | tags |
| :--- | :--- | :--- | :--- | :--- |
| `ios-token-0001` | `ios` | `user-1001` | `en` | `{"plan":"pro"}` |
| `android-token-0002` | `1` | `user-1002` | `en` | `{"plan":"free"}` |

`subscribers.csv`를 일반 텍스트 형식으로 나타내면 다음과 같습니다:

```txt
identifier,device_type,external_id,language,tags
ios-token-0001,ios,user-1001,en,"{""plan"":""pro""}"
android-token-0002,1,user-1002,en,"{""plan"":""free""}"
```

<Aside type="note">
`tags` 값은 내부에 따옴표가 포함된 JSON 객체입니다. Excel이나 Google Sheets에서 파일을 만들면 해당 앱이 셀을 따옴표로 묶어줍니다. 일반 텍스트 편집기에서 편집하는 경우, 위 예제와 같이 전체 값을 따옴표로 묶고 그 안의 모든 따옴표를 두 개의 따옴표로 작성하세요(`"`는 `""`가 됨).
</Aside>

## 가져오는 방법

1. **Audience** → **Import CSV**로 이동하여 **Import push subscribers** 카드를 선택합니다.

   <img src="/push-notifications-import-push-subscribers-1.webp" alt="Update Tag Values, Import push subscribers, Import events 카드가 있는 CSV 가져오기 화면."/>

2. CSV 파일을 선택합니다.

   <Aside type="caution">
   Pushwoosh는 파일을 선택하는 즉시 전체 파일을 검사합니다. 닫히지 않은 따옴표가 있는 행이 있으면 파일이 즉시 거부됩니다. 다른 CSV 가져오기와 달리 열 개수 불일치는 여기서 허용됩니다. 토스트 메시지에 행과 이유가 표시됩니다(예: "Row 3: a quote mark isn't closed properly."). 이 경우 아무것도 가져오지 않습니다. 해당 행을 수정하고 파일을 다시 선택하세요.
   </Aside>

   <img src="/push-notifications-import-push-subscribers-malformed-toast.webp" alt="The file cannot be imported 제목과 Row 3: a quote mark isn't closed properly. Nothing was imported. 메시지가 표시된 토스트."/>

3. 요약을 검토합니다:
   - 파일의 총 행 수 및 플랫폼별로 분류된 가져올 수 있는 행 수.
   - 건너뛴 행, 이유별로 분류, 건너뛴 행을 CSV로 다운로드할 수 있는 링크 포함 (원본 열에 `skip_reason` 열 추가).
   - `tags` 열에서 감지된 사용자 지정 태그, Pushwoosh가 각 태그에 대해 추론한 유형(`string`, `integer`, `boolean` 또는 `date`) 포함. 계정에 다른 유형의 태그 이름이 이미 존재하는 경우 충돌로 플래그가 지정됩니다. 이 가져오기에 대해 유형을 변경하거나 해당 태그를 건너뛸 수 있습니다.

   <img src="/push-notifications-import-push-subscribers-2.webp" alt="플랫폼별로 가져온 행과 이유별로 분류된 건너뛴 행을 보여주는 맵 단계 요약."/>

4. **Start import**를 클릭합니다.

가져오기가 완료되면 다음 수치를 확인하세요:

* **Devices created:** 새로 생성된 기기.
* **Devices updated:** 이미 존재하던 기기.
* **Skipped rows:** Map 단계(3단계)에서 제외된 행으로, 이유별로 분류되며 다운로드 링크가 제공됩니다.

<img src="/push-notifications-import-push-subscribers-3.webp" alt="Devices created, Devices updated, 그리고 이유별로 분류된 건너뛴 행과 다운로드 링크를 보여주는 가져오기 완료 화면."/>

<Aside type="note">
이전 가져오기에는 **Devices created** 및 **Devices updated** 대신 단일 **Devices imported** 수치가 표시됩니다.
</Aside>

<span id="why-a-row-gets-skipped" />

### 행을 건너뛰는 이유

다음은 맵 요약 및 건너뛴 행 CSV에 표시되는 건너뛰기 이유입니다.

| 이유 | 원인 |
| :--- | :--- |
| 웹 구독 | 다른 제공업체의 키에 바인딩되어 있습니다. 이전할 수 없습니다 |
| 잘못된 토큰 | APNs / FCM에서 이미 거부됨 (OneSignal의 `invalid_identifier` 플래그) |
| 이메일 주소 | 대신 [연락처 가져오기](/ko/product/first-steps/start-with-your-project/register-users/import-contacts/)를 사용하세요 |
| 전화번호 | 대신 [연락처 가져오기](/ko/product/first-steps/start-with-your-project/register-users/import-contacts/)를 사용하세요 |
| 중복된 토큰 | 동일한 푸시 토큰이 파일에 두 번 이상 나타납니다. 첫 번째 행이 우선하며 이후 행은 건너뜁니다 |
| 지원되지 않는 플랫폼 | Pushwoosh가 지원하지 않는 플랫폼입니다 (예: Windows Phone, Baidu) |
| 알 수 없는 플랫폼 | 플랫폼 값을 전혀 인식할 수 없습니다 |
| 빈 푸시 토큰 | 푸시 토큰 열에 값이 없습니다 |

## 동일한 파일 다시 가져오기

Pushwoosh는 각 가져온 기기의 Hardware ID (HWID)를 푸시 토큰에서 생성하며, 동일한 토큰은 항상 동일한 HWID를 생성합니다. 따라서 동일한 파일을 다시 가져오면 중복을 생성하는 대신 기존 기기를 업데이트합니다. 매핑 문제를 수정한 후 가져오기를 다시 실행하거나 새 내보내기에서 주기적으로 태그 값을 다시 동기화하는 것은 안전합니다.

## 가져오기 후

가져온 기기에는 가져오기 날짜 및 시간 값과 함께 **CSV import** 태그가 지정됩니다. 동일한 태그는 [세그먼트 가져오기](/ko/product/audience-data-and-segmentation/segmentation/create-segments/by-import/)에서도 사용됩니다. 이 태그를 사용하여 가져온 기기로 세그먼트를 만들거나 [User Explorer](/ko/product/audience-data-and-segmentation/user-explorer/)에서 개별적으로 찾을 수 있습니다.