CSV 가져오기

CSV 가져오기를 사용하여 사용자 속성 및 커스텀 이벤트를 기록하고 업데이트하는 방법을 알아보세요.

CSV 가져오기 정보

CSV 가져오기를 사용하여 다음 사용자 속성 및 커스텀 이벤트를 기록하고 업데이트할 수 있습니다.

CSV 가져오기 사용

1단계: CSV 템플릿 다운로드

CSV 가져오기를 열려면 오디언스 > 사용자 가져오기로 이동합니다. 여기에는 업로드 날짜, 업로더 이름, 파일 이름, 타겟팅 사용 가능성, 가져온 행 수, 가져오기 상태 등 가장 최근 가져오기에 대한 세부 정보가 나열된 표가 있습니다.

CSV를 시작하려면 속성 또는 이벤트에 대한 템플릿을 다운로드하세요.

Braze 대시보드의 ‘사용자 가져오기’ 페이지.](/docs/ko/assets/img/csv_import/import_users_page.png?0df1987be02a12967c97903c8182d403)

2단계: 식별자 선택

가져오는 CSV에는 전용 식별자가 필요합니다. 다음 중에서 선택할 수 있습니다:

• external id
• user alias
• braze id
• email address and phone numbers

3단계: CSV 파일 구축하기

다음 데이터 유형 중 하나를 단일 CSV 파일로 업로드할 수 있습니다. 두 개 이상의 데이터 유형을 업로드하려면 여러 개의 CSV 파일을 업로드하세요.

• 사용자 속성: 여기에는 기본 및 커스텀 사용자 속성이 모두 포함됩니다. 기본 사용자 속성은 Braze에 예약된 키(예: first_name 또는 email)이며 커스텀 속성은 비즈니스에 고유한 사용자 속성(예: last_destination_searched)입니다.
• 커스텀 이벤트: 이는 비즈니스에 고유하며 사용자가 수행한 작업(예: 여행 예약 앱의 경우 trip_booked )을 반영합니다.

CSV 파일 구축을 시작할 준비가 되면 다음 정보를 참조하세요:

• user attributes
• custom events

4단계: 데이터 업로드 및 미리 보기

Braze가 CSV를 처리하기 전에 처음 몇 행의 미리 보기를 생성하여 문제가 있는지 확인할 수 있습니다. 미리보기를 생성하려면 속성 또는 이벤트를 선택한 다음 파일 찾아보기를 선택하고 CSV 파일을 업로드합니다.

!단일 열에 데이터 유형이 혼합된 오류와 함께 CSV 업로드가 완료됨

5단계: 타겟팅 기본 설정 선택하기

다음 타겟팅 기본 설정 중에서 선택할 수도 있습니다. 가져오기에서 새 타겟팅 필터 또는 세그먼트를 만들 필요가 없는 경우 이 목록을 타겟팅 필터로 사용할 수 없도록 설정하지 않음을 선택합니다.

“할로윈 시즌 재미”라는 제목의 CSV 파일이 포함된 “업데이트/가져온 CSV” 필터 그룹이 있습니다.](/docs/ko/assets/img/csv_import/add_filter_group.png?59c959394e0cb32af8c093f00378dc8f){: style=”max-width:85%;”}

6단계: CSV 가져오기 시작

준비가 완료되면 가져오기 시작을 선택합니다. 5초마다 자동으로 새로고침되는 사용자 가져오기 페이지에서 현재 진행 상황을 추적할 수 있습니다.

문제가 없으면 상태가 완료로 업데이트되고 처리된 행 수가 표시됩니다. 처리된 행의 모든 데이터는 기존 프로필이나 새로 만든 프로필에 추가됩니다.

데이터 포인트 고려 사항

CSV 파일에서 가져온 각 고객 데이터는 외부 ID와 공백 값을 제외하고 고객 프로필의 기존 값을 덮어쓰고 데이터 포인트를 기록합니다. Braze 데이터 포인트의 미묘한 차이에 대해 궁금한 점이 있으면 Braze 계정 매니저가 답변해 드립니다.

문제 해결

CSV 가져오기에 문제가 있는 경우 다음과 같은 일반적인 문제를 검토하세요. 아직도 도움이 필요하신가요? 지원팀에 문의@braze.com.

파일 서식 문제

잘못된 행

업로드가 오류와 함께 완료된 경우 CSV 파일에 잘못된 행이 있을 수 있습니다.

데이터를 올바르게 가져오려면 헤더 행이 있어야 합니다. 각 행에는 머리글 행과 동일한 수의 셀이 있어야 합니다. 길이가 헤더 행보다 크거나 작은 값의 행은 가져오기에서 제외됩니다. 값의 쉼표는 구분 기호로 해석되어 이 오류가 발생할 수 있습니다. 또한 모든 데이터는 UTF-8로 인코딩되어야 합니다.

CSV 파일에 빈 행이 있고 가져오는 행 수가 CSV 파일의 총 행 수보다 적은 경우, 빈 행은 가져올 필요가 없으므로 가져오기에 문제가 없는 것으로 간주할 수 있습니다. 올바르게 가져온 회선 수를 확인하고 가져오기하려는 사용자 수와 일치하는지 확인합니다.

누락된 행

가져온 사용자 수가 CSV 파일의 총 행 수와 일치하지 않을 수 있는 몇 가지 이유가 있습니다:

문자열 따옴표

작은따옴표('') 또는 큰따옴표("")로 묶인 값은 가져오기 시 문자열 값으로 읽힙니다.

잘못된 형식의 날짜

ISO-8601 형식이 아닌 날짜는 가져오기 시 datetimes 로 읽히지 않습니다.

데이터 구조 문제

잘못된 이메일 주소

업로드가 오류와 함께 완료된 경우 하나 이상의 잘못된 암호화된 이메일 주소가 있을 수 있습니다. 이메일 주소를 Braze로 가져오기 전에 모든 이메일 주소가 제대로 암호화되었는지 확인하세요.

• Braze에서 ** 이메일 주소를 업데이트하거나 가져올 때** 이메일이 포함될 때마다 해시된 이메일 값을 사용하세요. 이러한 해시 이메일 값은 내부 팀에서 제공합니다.
• 새 사용자를 만들 때 사용자의 암호화된 이메일 값과 함께 email_encrypted 을 추가해야 합니다. 그렇지 않으면 사용자가 생성되지 않습니다. 마찬가지로 이메일이 없는 기존 사용자에게 이메일 주소를 추가하는 경우 email_encrypted 을 추가해야 합니다. 그렇지 않으면 사용자가 업데이트되지 않습니다.

커스텀 속성으로 가져온 데이터

기본 사용자 데이터(예: email 또는 first_name)를 커스텀 속성으로 가져온 경우 CSV 파일의 대소문자와 간격을 확인하세요. 예를 들어 First_name 을 커스텀 속성으로 가져오는 반면, first_name 은 사용자 프로필의 ‘이름’ 필드에 올바르게 가져올 수 있습니다.

여러 데이터 유형

Braze는 열의 각 값이 동일한 데이터 유형일 것으로 예상합니다. 속성의 데이터 유형과 일치하지 않는 값은 세그먼트화에 오류를 일으킵니다.

또한 숫자 속성을 0으로 시작하면 0으로 시작하는 숫자는 문자열로 간주되므로 문제가 발생할 수 있습니다. Braze가 해당 문자열 값을 변환할 때 0에서 7까지의 숫자를 사용하는 8진수 값처럼 취급될 수 있으며, 이는 해당 10진수 값으로 변환된다는 의미입니다. 예를 들어 CSV 파일의 값이 0130이면 Braze 프로필에 88이 표시됩니다. 이 문제를 방지하려면 문자열 데이터 유형이 있는 속성을 사용하세요. 그러나 이 데이터 유형은 세분화 번호 비교에서는 사용할 수 없습니다.

기본 속성 유형

일부 기본 속성은 사용자 업데이트에 대해 특정 값만 유효한 것으로 허용할 수 있습니다. 지침은 CSV 구성을 참조하세요.

후행 공백과 대소문자 차이로 인해 값이 유효하지 않은 것으로 해석될 수 있습니다. 예를 들어, 다음 CSV 파일에서 허용된 값이 unsubscribed, subscribed, opted_in 이므로 첫 번째 행(brazetest1)에 있는 사용자만 이메일 및 푸시 상태가 성공적으로 업데이트됩니다.

1
2
3
external_id,email,email_subscribe,push_subscribe
brazetest1,[email protected],unsubscribed,unsubscribed
brazetest2,[email protected],Unsubscribed,Unsubscribed

“CSV 파일 선택”이 작동하지 않습니다.

CSV 파일 선택 버튼이 작동하지 않는 데에는 몇 가지 이유가 있습니다: