사용자 가져오기

Braze는 사용자 데이터를 플랫폼에 가져오는 다양한 방법을 제공합니다. SDK, API, 클라우드 데이터 수집, 기술 파트너 통합 및 CSV.

계속 진행하기 전에, Braze는 가져오는 동안 HTML 데이터를 정리(유효성 검사 또는 적절한 형식 지정)하지 않는다는 점에 유의하세요. 이는 웹 개인화를 위한 모든 가져오기 데이터에 대해 스크립트 태그를 제거해야 함을 의미합니다.

데이터를 웹 브라우저에서 개인화 용도로 사용하기 위해 Braze에 가져올 때는 웹 브라우저에서 렌더링될 때 악의적으로 활용될 수 있는 HTML, JavaScript 또는 기타 스크립트 태그가 제거되었는지 확인하세요.

또는 HTML의 경우 Braze Liquid 필터(strip_html)를 사용하여 렌더링된 텍스트를 HTML로 이스케이프할 수 있습니다. 예를 들어, 다음과 같습니다.

• 입력
• 출력

1
{{ "Have <em>you</em> read <strong>Ulysses</strong>?" | strip_html }}

1
Have you read Ulysses?

REST API

/users/track 엔드포인트]12 ]를 사용하여 사용자 지정 이벤트, 사용자 속성 및 사용자에 대한 구매를 기록합니다.

클라우드 데이터 수집

Braze 클라우드 데이터 수집 ]을 사용하여 사용자 속성을 가져오고 유지 관리합니다.

CSV 가져오기

오디언스 > 사용자 가져오기에서 CSV 파일을 통해 고객 프로필을 업로드하고 업데이트할 수 있습니다.

CSV 가져오기는 신발 사이즈와 같은 사용자 지정 속성 외에도 이름, 이메일과 같은 사용자 속성을 기록하고 업데이트하는 기능을 지원합니다. external_id 또는 사용자 별칭의 두 가지 고유 사용자 식별자 중 하나를 지정하여 CSV를 가져올 수 있습니다.

CSV 구성하기

Braze에는 여러 데이터 유형이 있습니다. CSV 파일을 사용하여 사용자 프로필을 가져오거나 업데이트할 때 기본값 사용자 속성 또는 커스텀 속성을 생성하거나 업데이트할 수 있습니다.

• 기본값 사용자 속성은 Braze에서 예약된 키입니다. 예를 들어, first_name 또는 email.
• 커스텀 속성은 사용자 비즈니스에 커스텀입니다. 예를 들어, 여행 예약 앱에는 last_destination_searched이라는 커스텀 속성이 있을 수 있습니다.

Braze는 최대 500MB 크기의 파일에서 표준 CSV 형식의 사용자 데이터를 허용합니다. 다운로드 가능한 CSV 템플릿에 대한 가져오기 섹션을 참조하세요.

데이터 포인트 고려사항

CSV 파일에서 가져온 각 고객 데이터는 외부 ID 및 빈 값을 제외하고 고객 프로필의 기존 값을 덮어쓰며 데이터 포인트로 계산됩니다.

• CSV 파일에서 업로드된 외부 ID는 데이터 포인트를 소모하지 않습니다. 외부 ID만 업로드하여 기존 Braze 사용자를 세그먼트로 나누기 위해 CSV를 업로드하는 경우, 데이터 포인트를 소모하지 않고도 이를 수행할 수 있습니다. 만약 사용자 이메일이나 전화번호와 같은 추가 데이터를 가져오기에 추가한다면, 기존 사용자 데이터를 덮어쓰게 되어 데이터 포인트를 소모하게 됩니다.
  • 세분화 목적의 CSV 가져오기(external_id, braze_id, 또는 user_alias_name을 유일한 필드로 사용하여 가져오기)는 데이터 포인트를 소비하지 않습니다.
• 빈 값은 고객 프로필의 기존 값을 덮어쓰지 않으며, CSV 파일에 모든 기존 고객 속성을 포함할 필요는 없습니다.
• email_subscribe, push_subscribe, subscription_group_id 또는 subscription_state를 업데이트하는 것은 데이터 포인트 소비에 포함되지 않습니다.

기본값 사용자 데이터 열 머리글

CSV 가져오기

CSV 파일을 가져오려면 사용자 가져오기 페이지로 이동하여 Audiences 섹션 아래로 이동하십시오. 여기에서 가장 최근의 가져오기를 나열한 테이블을 찾을 수 있으며, 업로드 날짜, 업로더 이름, 파일 이름, 타겟팅 가능 여부, 가져온 행 수 및 각 가져오기 상태와 같은 세부 정보가 포함됩니다.

파일 찾아보기 및 파일을 선택하십시오. Braze는 파일을 업로드하고 열 헤더와 각 열의 데이터 유형을 확인합니다.

CSV 템플릿을 다운로드하려면 이 페이지의 외부 ID로 가져오기 또는 사용자 별칭으로 가져오기 섹션을 참조하세요.

업로드가 완료되면 파일 내용의 미리보기가 포함된 모달이 표시됩니다. 이 테이블의 모든 정보는 CSV 파일의 상위 몇 개 행의 값을 기반으로 합니다. 열 머리글의 경우 표준 속성은 일반 텍스트로 작성되고 커스텀 속성은 이탤릭체로 작성되며 괄호 안에 유형이 표시됩니다. 팝업 상단에는 파일 요약도 있습니다.

한 번에 여러 개의 CSV를 가져올 수 있습니다. CSV 가져오기는 동시에 실행되므로 업데이트 순서가 순차적일 것이라고 보장할 수 없습니다. CSV 가져오기가 연달아 실행되도록 하려면, 첫 번째 CSV 가져오기가 완료된 후 두 번째 CSV를 업로드하세요.

Braze가 업로드 중 파일에서 잘못된 점을 발견하면 이러한 오류가 요약과 함께 표시됩니다. 예를 들어, 파일에 잘못된 행이 포함된 경우 파일을 가져올 때 미리보기에서 해당 오류가 표시됩니다. 따라서 파일은 오류가 있는 상태로 가져올 수 있지만, 가져오기가 시작된 후에는 취소하거나 롤백할 수 없습니다. 미리보기를 검토하고 오류가 있으면 가져오기를 취소하고 파일을 수정하십시오.

외부 ID가 없거나 잘못된 행은 가져오지 않습니다. 다른 모든 오류는 가져올 수 있지만 세그먼트를 만들 때 필터링에 방해가 될 수 있습니다. 자세한 내용은 문제 해결 섹션으로 건너뛰십시오.

업로드에 만족하면 가져오기를 시작하십시오. 팝업이 닫히고 백그라운드에서 가져오기가 시작됩니다. 사용자 가져오기 페이지에서 진행 상황을 추적할 수 있으며, 5초마다 새로고침되거나 최근 가져오기 상자에서 새로고침 버튼을 누르면 새로고침됩니다.

처리한 줄 아래는 가져오기 진행 상황입니다. 완료되면 상태가줄 완료로 변경됩니다. 가져오기 중에도 나머지 Braze 대시보드는 계속 사용할 수 있으며, 가져오기가 시작되고 종료되면 알림을 받게 됩니다.

가져오기 프로세스에서 오류가 발생하면 파일의 총 줄 수 옆에 노란색 경고 아이콘이 표시됩니다. 아이콘 위에 마우스를 올리면 특정 줄이 실패한 이유에 대한 세부 정보를 볼 수 있습니다. 가져오기가 완료되면 모든 데이터가 기존 프로필에 추가되거나 새 프로필이 만들어집니다.

외부 ID로 가져오기

고객 데이터를 가져올 때는 각 고객의 고유 식별자(external_id)를 지정해야 합니다. CSV 가져오기를 시작하기 전에 엔지니어링 팀으로부터 Braze에서 사용자를 식별하는 방법을 이해하는 것이 중요합니다. 일반적으로, 이것은 내부 데이터베이스 ID입니다. 이는 모바일과 웹에서 Braze SDK가 사용자를 식별하는 방식과 일치해야 하며 각 고객이 여러 기기에서 Braze 내에서 단일 고객 프로필을 가질 수 있도록 설계되었습니다. Braze 고객 프로필 수명주기에 대해 자세히 알아보세요.

가져오기에 external_id를 제공하면 Braze는 동일한 external_id를 가진 기존 사용자를 업데이트하거나 해당 external_id 세트가 없는 경우 새로 식별된 사용자를 생성합니다.

다운로드: [CSV 가져오기 템플릿][템플릿]

사용자 별칭으로 가져오는 중

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 별칭 가져오기 템플릿

Braze ID로 가져오기

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

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

커스텀 데이터 가져오기

기본 사용자 데이터와 정확히 일치하지 않는 헤더는 Braze 내에서 사용자 지정 속성을 생성합니다.

다음 데이터 유형은 사용자 가져오기에 허용됩니다:

• 날짜: ISO-8601 형식으로 저장해야 합니다.
• 부울: true 또는 false
• 번호: 공백이나 쉼표가 없는 정수 또는 부동 소수점, 부동 소수점은 마침표(.)를 소수점 구분 기호로 사용해야 합니다.
• 문자열: 열 값 주위에 큰따옴표("")가 있는 경우 쉼표를 포함할 수 있습니다.
• 공백: 빈 값은 사용자 프로필의 기존 값을 덮어쓰지 않으며, CSV 파일에 기존의 모든 사용자 속성을 포함할 필요는 없습니다.

람다 사용자 CSV 가져오기

서버리스 S3 Lambda CSV 가져오기 스크립트를 사용하여 사용자 속성을 플랫폼에 업로드할 수 있습니다. 이 솔루션은 CSV 업로더로 작동하며, CSV를 S3 버킷에 넣으면 스크립트가 API를 통해 업로드합니다.

1,000,000개의 행이 있는 파일의 예상 실행 시간은 5분 정도입니다. 자세한 내용은 사용자 속성 CSV를 Braze로 가져오기를 참조하십시오.

구독 그룹 상태 업데이트 중

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

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

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

사용자 가져오기에서 세그먼트 만들기

사용자 가져오기는 가져오기를 시작하기 전에 이 CSV에서 가져온 사용자로부터 세그먼트 자동 생성을 선택하여 세그먼트를 생성하는 데 사용할 수도 있습니다.

세그먼트의 이름을 설정하거나 기본값을 수락할 수 있습니다. 기본값은 파일의 이름입니다. 세그먼트를 만드는 데 사용된 파일에는 가져오기가 완료된 후 세그먼트를 볼 수 있는 링크가 표시됩니다.

세그먼트를 생성하는 데 사용된 필터는 선택한 가져오기에서 생성되거나 업데이트된 사용자를 선택하며 편집 세그먼트 페이지의 다른 모든 필터와 함께 사용할 수 있습니다.

고려 사항

문제 해결

누락된 행

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

• 중복된 외부 ID: 외부 ID 열이 중복된 경우 행의 형식이 올바르게 지정되어 있어도 잘못된 형식이거나 가져오지 않은 행이 발생할 수 있습니다. 일부 경우에는 특정 오류를 보고하지 않을 수 있습니다. CSV에 중복된 외부 ID가 있는지 확인하십시오. 그렇다면 중복을 제거하고 다시 업로드해 보세요.
• 강세 문자: 귀하의 CSV에는 악센트가 포함된 이름이나 속성이 있을 수 있습니다. 문제를 방지하려면 파일을 항상 UTF-8로 인코딩하세요.

잘못된 행

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

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

여러 데이터 유형

Braze는 열의 각 값이 동일한 데이터 유형이어야 합니다. 속성의 데이터 유형과 일치하지 않는 값은 세그먼테이션에 오류를 일으킵니다.

잘못된 형식의 날짜

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

문자열 따옴표

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

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

기본 사용자 데이터(예: email 또는 first_name)를 사용자 지정 속성으로 가져온 경우 CSV 파일의 대소문자와 띄어쓰기를 확인하세요. 예를 들어 First_name은 커스텀 속성으로 가져오지만 first_name은 고객 프로필의 ‘이름’ 필드에 올바르게 가져옵니다.