연락처 가져오기

하나의 CSV 파일로 이메일, SMS, WhatsApp, Viber 연락처를 등록하세요. 전화번호 열 하나로 SMS와 WhatsApp 모두에 연락처를 등록할 수 있으므로 채널별로 별도의 파일이 필요하지 않습니다.

CSV 파일 준비하기

파일 형식

첫 번째 행에는 각 열의 데이터를 설명하는 열 헤더가 포함되어야 합니다.
이후의 각 행은 헤더에 해당하는 값을 가진 단일 연락처를 나타냅니다.
값은 쉼표로 구분해야 합니다.
문자가 올바르게 표시되도록 파일을 UTF-8 인코딩으로 저장하세요.
최대 파일 크기는 100MB입니다.

연락처 열

연락처를 등록하려는 채널에 따라 다음 열 중 하나 이상을 포함하세요:

이메일: 수신자의 이메일 주소입니다.
전화번호(SMS, WhatsApp, Viber용): +와 국가 코드로 시작하는 국제 형식이어야 합니다(예: +120XXXXX234). whatsapp: 또는 viber: 접두사 없이 일반 번호를 입력하세요. 열을 해당 채널에 매핑하면 Pushwoosh가 접두사를 추가합니다.

전화번호가 유효한 국제 형식이 아니면 해당 채널에서 건너뜁니다. 행의 나머지 부분은 계속 가져옵니다.

선택적 열

User ID: 사용자의 고유 식별자입니다(예: 이름 또는 이메일). 필수는 아니지만, 연락처의 채널이 여러 개가 아닌 하나의 사용자 프로필을 공유하도록 권장됩니다.
다른 모든 열은 세분화 및 개인화를 위해 시스템 태그에 매핑할 수 있습니다(예: Location, Birthday, Language 또는 Customer type).

예제 CSV 파일

Email,Mobile,User ID,Name,Location
john.smith@email.com,+120XXXXX234,john.smith@email.com,John Smith,New York
jane.smith@email.com,+131XXXXX890,jane.smith@email.com,Jane Smith,Los Angeles

CSV 파일 업로드 및 매핑하기

Audience → Import CSV → Import Contacts로 이동합니다.
CSV 업로드를 클릭하고 파일을 선택합니다. 파일을 교체하려면 다른 CSV 업로드를 클릭하세요.

Pushwoosh는 파일을 업로드할 때 파일 전체를 검사합니다. 구문 분석할 수 없는 행(열 수가 헤더와 일치하지 않거나 따옴표로 묶인 값이 닫히지 않은 경우)이 있으면 파일이 즉시 거부됩니다. 토스트 메시지에 행 번호와 원인이 표시됩니다. 예: “Row 42: the number of values does not match the header.” 이 경우 아무것도 가져오지 않습니다. 해당 행을 수정하고 파일을 다시 업로드하세요.
가져온 연락처에 대한 Segment name을 입력합니다.
Contact column in CSV 아래에서 열을 선택하고, 그 옆에서 등록할 Channel(Email, SMS, WhatsApp 또는 Viber)을 선택합니다. 다른 열을 매핑하거나 동일한 열을 추가 채널에 매핑하려면 + Add channel을 클릭하세요.
파일에 고유 사용자 식별자가 있는 열이 있다면 UserId column in CSV 아래에서 해당 열을 선택합니다.
세분화를 위해 추가 데이터를 포함하려면 CSV에서 Column Name을 선택하고 Tag를 할당합니다. 더 많은 속성을 매핑하려면 + Add Column을 클릭하세요.
가져오기 시작을 클릭합니다.

가져오기 후, 연락처는 매핑한 채널의 캠페인에 사용할 수 있습니다. 세그먼트 목록에 새 세그먼트로 표시되며 사용자 탐색기를 통해서도 액세스할 수 있습니다.

완료 화면에는 두 가지 수치가 표시됩니다:

Created: 앱에 새로 추가된 채널 등록입니다.
Updated: 이미 존재하던 채널 등록입니다. 같은 주소나 번호가 다른 User ID 또는 다른 기기 플랫폼으로 다시 등록된 경우도 포함됩니다.

두 수치 모두 연락처나 CSV 행이 아닌 채널 등록 수를 계산합니다. 두 채널(예: SMS 및 WhatsApp)에 매핑된 연락처는 2를 더합니다.

업데이트된 연락처의 경우 6단계에서 매핑한 태그만 변경됩니다. 해당 값은 CSV 값으로 덮어씁니다. 연락처에 이미 설정된 다른 태그는 그대로 유지됩니다.

가져오기 중 건너뛴 행

완료 화면은 건너뛴 행을 이유별로 그룹화합니다:

이메일 주소가 유효하지 않음
전화번호가 유효하지 않음
행에 연락처 주소 없음: 매핑된 모든 열이 비어 있음

행이 부분적으로 가져와져도 이 분석에 표시될 수 있습니다. 예를 들어, 이메일 열은 성공했지만 전화번호 열은 유효성 검사에 실패한 경우입니다.

Download skipped rows를 클릭하여 해당 행만 포함된 CSV를 받으세요. 이 파일은 건너뛴 이유를 추가 열로 추가하므로 행을 수정하고 다시 업로드할 수 있습니다.

가져오기 등록에 실패한 행

일부 행은 파일에서 문제가 없어 보이지만 처리되지 않는 경우가 있습니다. 예를 들어, 이메일 주소의 철자가 정확하더라도 일회용 또는 반송된 도메인에 속하기 때문에 거부될 수 있습니다. Pushwoosh는 이러한 행을 Created, Updated, Skipped와 별도로 Failed로 계산합니다.

Failed 행은 이유별로 분류되지 않으며 건너뛴 행 다운로드에 포함되지 않습니다. 이러한 행을 찾으려면 원본 CSV를 가져온 세그먼트와 비교하세요. 누락된 주소를 수정(예: 일회용 또는 반송된 도메인 제거)한 다음, 새 가져오기에서 해당 행만 다시 업로드하세요.