연락처 가져오기

하나의 CSV 파일을 업로드하여 이메일, SMS, WhatsApp, Viber 구독자로 연락처를 한 번에 등록하세요. 연락처 주소가 있는 각 열을 해당 채널에 매핑합니다. 전화번호와 같은 동일한 열을 여러 채널에 매핑할 수 있으므로, 동일한 번호인 SMS와 WhatsApp 번호를 위해 별도의 파일이 더 이상 필요하지 않습니다.

CSV 파일 준비하기

CSV 형식 규칙

일반 구조

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

연락처 열

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

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

유효한 국제 형식이 아닌 전화번호는 가져오기 중에 전체 행이 실패하는 대신 해당 채널에서 제외됩니다.

선택적 열

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로 이동합니다.

Audience 섹션의 Import CSV 허브, Import Contacts 카드와 함께 Update tag values, Import push subscribers, Import events, Import subscription categories가 표시됨

Upload CSV를 클릭하고 파일을 선택합니다. 파일을 교체하려면 Upload Another CSV를 클릭하세요.
가져온 연락처에 대한 Segment name을 입력합니다.
Contact column in CSV 아래에서 열을 선택하고, 그 옆에서 등록할 Channel(Email, SMS, WhatsApp 또는 Viber)을 선택합니다. 다른 열을 매핑하거나 동일한 열을 추가 채널에 매핑하려면 + Add channel을 클릭하세요.
UserId column in CSV 아래에서 파일에 고유 사용자 식별자가 있는 열을 선택합니다.
세분화를 위해 추가 데이터를 포함하려면 CSV에서 Column Name을 선택하고 Tag를 할당합니다. 더 많은 속성을 매핑하려면 + Add Column을 클릭하세요.

Import Contacts 마법사의 매핑 단계, 한 열은 Email에 매핑되고, Mobile 열은 SMS, WhatsApp, Viber에 매핑되며, City 열은 태그에 매핑됨

Start Import를 클릭하여 파일 처리를 시작합니다.

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

가져오기 중 건너뛴 행

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

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

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

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

가져오기 등록에 실패한 행

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

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