푸시 구독자 가져오기

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

이 가져오기는 푸시 토큰으로 기기를 등록합니다. 세그먼트를 생성하지는 않습니다. 가져온 기기에는 나중에 세그먼트를 만드는 데 사용할 수 있는 CSV import 태그가 부여됩니다. 이미 등록된 User ID 또는 Hardware ID 목록을 세그먼트로 가져오려면 세그먼트 가져오기를 참조하세요.

지원되는 플랫폼

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

다른 값을 가진 행은 다음을 포함하여 건너뜁니다(행을 건너뛰는 이유 참조):

• 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를 일반 텍스트 형식으로 나타내면 다음과 같습니다:

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""}"

참고

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

가져오는 방법

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

   

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

   주의

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

   

3. 요약을 검토합니다:

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

4. Start import를 클릭합니다.

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

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

참고

이전 가져오기에는 Devices created 및 Devices updated 대신 단일 Devices imported 수치가 표시됩니다.

행을 건너뛰는 이유

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

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

동일한 파일 다시 가져오기

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

가져오기 후

가져온 기기에는 가져오기 날짜 및 시간 값과 함께 CSV import 태그가 지정됩니다. 동일한 태그는 세그먼트 가져오기에서도 사용됩니다. 이 태그를 사용하여 가져온 기기로 세그먼트를 만들거나 User Explorer에서 개별적으로 찾을 수 있습니다.