푸시 구독자 가져오기

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

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

지원되는 플랫폼

Pushwoosh는 아래 나열된 플랫폼에 대한 푸시 토큰만 가져옵니다. device_type의 다른 모든 값은 건너뜁니다. 행을 건너뛰는 이유를 참조하세요.

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에서 만들 경우, 해당 앱이 자동으로 셀을 따옴표로 묶어주므로 아무것도 할 필요가 없습니다. 일반 텍스트 편집기에서 직접 파일을 편집하는 경우, 위 예제와 같이 전체 값을 따옴표로 묶고 그 안의 모든 따옴표를 두 개의 따옴표로 작성하세요("는 ""가 됨).

가져오는 방법

다음 단계에 따라 CSV를 업로드하고 Pushwoosh에 기기를 등록하세요.

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

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

4. 만족스러우면 Start import를 클릭합니다.

가져오기가 완료되면 가져온 기기 수, 실패한 행 수, 사전 검사에서 건너뛴 행 수를 볼 수 있습니다. 사전 검사에서 건너뛴 수에만 다운로드 링크가 있습니다. 문제를 해결할 때 가져온 것과 실패한 것을 별개의 문제로 처리하세요.

행을 건너뛰는 이유

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

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

동일한 파일 다시 가져오기

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

가져오기 후

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

세그먼트는 자동으로 생성되지 않습니다.