Skip to content

CSV import

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

CSV 가져오기 정보

You can use CSV import to record and update the following user attributes and custom events.

CSV 가져오기 사용

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

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

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

Braze 대시보드의 '사용자 가져오기' 페이지입니다.

2단계: 식별자 선택

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

고객 데이터를 가져올 때 external_id 을 각 고객의 고유 식별자로 사용할 수 있습니다. 가져오기에 external_id 을 입력하면 Braze는 기존 사용자를 동일한 external_id 으로 업데이트하거나, 사용자를 찾을 수 없는 경우 해당 external_id 설정으로 새로 식별된 사용자를 생성합니다.

external_id 이 없는 사용자를 타겟팅하려면 사용자 별칭 지정이 있는 사용자 목록을 가져오기하면 됩니다. 별칭은 대체 고유 사용자 식별자 역할을 하며, 앱에 가입하거나 계정을 만들지 않은 익명 사용자를 대상으로 마케팅하려는 경우 유용하게 사용할 수 있습니다.

사용자 프로필을 별칭만으로 업로드하거나 업데이트하는 경우 CSV에 다음 두 열이 있어야 합니다:

  • user_alias_name: 고유 사용자 식별자; external_id의 대안
  • user_alias_label: 사용자 별칭을 그룹화하는 일반적인 레이블

가져오기에 user_alias_name 및 user_alias_label 모두 제공하면 Braze는 기존 사용자를 동일한 user_alias_name 및 user_alias_label로 업데이트합니다. 사용자를 찾을 수 없는 경우 Braze는 해당 user_alias_name 설정으로 새로 식별된 사용자를 생성합니다.

다운로드: CSV 속성 가져오기 템플릿: 사용자 별칭 지정

external_id 또는 user_alias_name, user_alias_label 값 대신 내부 Braze ID 값을 사용하여 기존 고객 프로필을 업데이트하려면 열 헤더로 braze_id를 지정하세요.

이는 세분화 내의 CSV 내보내기 옵션을 통해 Braze에서 사용자 데이터를 내보낸 후 기존 사용자에게 새로운 사용자 지정 속성을 추가하려는 경우에 유용할 수 있습니다.

외부 ID 또는 사용자 별칭을 생략하고 이메일 주소 또는 전화번호를 사용하여 사용자를 가져올 수 있습니다. 이메일 주소나 전화번호가 포함된 CSV 파일을 가져오기 전에 다음 사항을 확인하세요:

  • CSV 파일에 이러한 프로필에 대한 외부 ID나 사용자 별칭이 없는지 확인합니다. 이 경우 Braze는 이메일 주소보다 외부 ID 또는 사용자 별칭을 우선적으로 사용하여 프로필을 식별합니다.
  • CSV 파일이 올바르게 형식화되었는지 확인하십시오.

기존 프로필에 해당 이메일 주소나 전화번호가 있는 경우, 해당 프로필이 업데이트되며, Braze는 새 프로필을 생성하지 않습니다. 해당 이메일 주소와 동일한 여러 프로필이 있는 경우, Braze는 가장 최근에 업데이트된 프로필이 업데이트되는 /users/track 엔드포인트와 동일한 논리를 사용할 것입니다.

해당 이메일 주소 또는 휴대폰 번호가 포함된 프로필이 없는 경우 Braze는 해당 식별자를 사용하여 새 프로필을 생성합니다. 당신은 나중에 이 /users/identify 엔드포인트을 사용하여 이 프로필을 식별할 수 있습니다. 사용자 프로필을 삭제하려면 /users/delete 엔드포인트를 사용할 수도 있습니다.

3단계: CSV 파일 구축하기

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

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

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

필수 식별자

external_id 은 필수는 아니지만 다음 식별자 중 하나를 CSV 파일의 헤더로 포함해야 합니다. 각 항목에 대한 자세한 내용은 식별자 선택을 검토하세요.

  • external_id
  • braze_id
  • user_alias_name 그리고 user_alias_label
  • email
  • phone

Custom attributes

다음 데이터 유형을 CSV 가져오기에 대한 커스텀 속성으로 사용할 수 있습니다. 기본 속성과 정확히 일치하지 않는 열 헤더에는 Braze에서 커스텀 속성이 부여됩니다.

기본 속성

구독 그룹 상태 업데이트하기(선택 사항)

또한 사용자 가져오기를 통해 이메일 또는 SMS 구독 그룹에 사용자를 추가할 수 있습니다. 이는 SMS 채널로 메시지를 보내려면 사용자가 SMS 구독 그룹에 등록되어 있어야 하므로 SMS에 특히 유용합니다. 자세한 내용은 SMS 구독 그룹을 참조하십시오.

구독 그룹 상태를 업데이트하는 경우 CSV에 다음 두 개의 열이 있어야 합니다:

  • subscription_group_id: id의 구독 그룹.
  • subscription_state: 사용 가능한 값은 unsubscribed (구독 그룹에 속하지 않음) 또는 subscribed (구독 그룹에 속함)입니다.

필수 식별자

external_id 은 필수는 아니지만 다음 식별자 중 하나를 CSV 파일의 헤더로 포함해야 합니다. 각 항목에 대한 자세한 내용은 식별자 선택을 검토하세요.

  • external_id
  • braze_id
  • user_alias_name 그리고 user_alias_label
  • email
  • phone

커스텀 이벤트 필드

CSV에는 다음 외에도 이벤트 속성정보에 대한 추가 열 헤더가 포함될 수 있습니다. 이러한 속성의 열 헤더는 <event_name>.properties.<property name>.

예를 들어, 커스텀 이벤트 trip_booked 에는 destination 및 duration 속성이 있을 수 있습니다. 열 헤더를 trip_booked.properties.destination 및 trip_booked.properties.duration 로 지정하여 가져올 수 있습니다.

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

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

CSV 업로드가 단일 열에서 혼합된 데이터 유형과 관련된 오류와 함께 완료되었습니다

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

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

"할로윈 시즌 재미"라는 제목의 CSV 파일이 포함된 "업데이트됨/CSV에서 가져온" 필터 그룹입니다.

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 파일 선택 버튼이 작동하지 않는 데에는 몇 가지 이유가 있습니다:
Github   GitHub 에서 이 페이지를 편집합니다.
New Stuff!