Segment 데이터를 CSV로 내보내기
이 페이지에서는 Segment에서 사용자 데이터의 CSV 내보내기를 요청하는 방법과 내보내기에 포함되는 데이터에 대해 설명합니다.
사전 요구 사항
Segment 데이터를 CSV로 내보내려면 워크스페이스에 대한 “사용자 데이터 내보내기” 권한이 필요합니다.
CSV 내보내기 요청
Segment 데이터를 CSV로 내보내려면 Segment를 편집하는 동안 사용자 데이터 드롭다운을 선택한 다음, 해당 Segment의 사용자 데이터 또는 이메일 주소 중 내보낼 항목을 선택합니다.
기본 Segments 페이지에서 Segment의 설정 드롭다운을 선택하여 CSV 내보내기를 요청할 수도 있습니다.
모든 고객 프로필의 데이터를 내보내려면 필터 없이 Segment를 생성한 다음 CSV 내보내기를 요청하세요.
CSV 출력에는 내보내기 시점에 Segment에 포함된 각 고객 프로필의 데이터가 들어 있습니다. 기어 아이콘과 CSV 내보내기를 선택하면 어떤 Segment든 내보낼 수 있습니다. Braze는 백그라운드에서 보고서를 생성한 후 현재 로그인한 사용자에게 이메일로 보내드립니다.
Segment CSV 내보내기 세부 정보
CSV 이메일 주소 내보내기에는 Segment에 속한 사용자 중 이메일 주소가 있는 사용자의 행만 포함됩니다. 예를 들어 Segment에 사용자가 100,000명 있지만 그중 50,000명만 이메일 주소를 가지고 있다면, CSV 이메일 주소 내보내기는 약 50,000개의 행을 생성합니다. CSV 사용자 데이터 내보내기는 Segment의 모든 사용자 데이터를 내보냅니다.
파일 크기 제한으로 인해 Segment의 예상 크기가 500,000명을 초과하면 내보내기가 실패할 수 있습니다. 이 제한은 정확한 계산값이 아니라 Segment의 예상 크기를 기준으로 적용된다는 점에 유의하세요. 자세한 내용은 대규모 Segment 내보내기를 참조하세요.
Amazon S3 인증정보를 Braze에 연결한 경우, CSV는 대신 S3 버킷의 segment-export/SEGMENT_ID/YYYY-MM-dd/users-RANDOMSTRING.zip 키 아래에 업로드됩니다. 이메일로 전송된 다운로드 링크에 액세스하려면 대시보드에 로그인되어 있어야 합니다.
S3 버킷에 저장된 내보내기 파일은 다운로드 링크가 만료된 후 자동으로 삭제됩니다(별도로 명시되지 않는 한, 내보내기 이메일이 전송된 시점으로부터 4시간 후).
내보내기에 포함되는 데이터
선택한 항목에 따라 다음 데이터가 내보내기에 포함됩니다.
CSV 내보내기 사용자 데이터
| 필드 이름 | 설명 |
|---|---|
| Appboy ID | 내부 ID(변경할 수 없음) |
| country | 국가 |
| created_at | 고객 프로필이 생성된 날짜 및 시간 |
| created_from | 고객 프로필을 생성하는 데 사용된 방법(예: REST API, SDK 또는 CSV 가져오기) |
| devices | 기기 정보 |
| date_of_birth | 생년월일 |
| 이메일 주소 | |
| unsubscribed_from_emails_at | 이메일 수신을 탈퇴한 날짜 |
| user_id | 외부 ID |
| first_name | 이름 |
| first_session | 첫 세션 날짜 및 시간 |
| gender | 성별 |
| google_ad_ids | 사용자와 연결된 Google 광고 ID |
| city | 구/군/시 |
| IDFAs | 광고 식별자(IDFA) 값 |
| IDFVs | 공급업체 식별자(IDFV) 값 |
| language | ISO-639-1 표준 형식의 언어 |
| last_app_version_used | 마지막으로 사용한 앱 버전 |
| last_name | 성 |
| last_session | 마지막 세션 날짜 및 시간 |
| number_of_google_ad_ids | 연결된 Google 광고 ID 수 |
| number_of_IDFAs | 연결된 IDFA 수 |
| number_of_IDFVs | 연결된 IDFV 수 |
| number_of_push_tokens | 연결된 푸시 알림 토큰 수 |
| number_of_roku_ad_ids | 연결된 Roku 광고 ID 수 |
| number_of_windows_ad_ids | 연결된 Windows 광고 ID 수 |
| phone_number | 전화번호 |
| opted_into_push_at | 푸시 알림에 옵트인한 날짜 |
| unsubscribed_from_push_at | 푸시 알림 수신을 탈퇴한 날짜 |
| random_bucket | 무작위 버킷 번호 |
| roku_ad_ids | Roku 광고 ID |
| session_count | 총 세션 수 |
| timezone | IANA 시간대 데이터베이스와 동일한 형식의 사용자 시간대 |
| in_app_purchase_total | 인앱 구매에 지출한 총 금액 |
| user_aliases | 사용자 별칭(있는 경우) |
| windows_ad_ids | Windows 광고 ID |
| Custom events | 내보내기 시 선택한 항목에 따라 다름 |
| Custom attributes | 내보내기 시 선택한 항목에 따라 다름 |
캔버스 단계에서 사용자 데이터를 내보내면 CSV에는 해당 캔버스 단계의 전체 기간 동안 그 단계에 있었던 모든 사용자가 포함됩니다. 내보내기를 특정 날짜 범위나 기타 기간으로 제한할 수는 없습니다. 이러한 내보내기를 실행하는 방법은 Canvas 데이터 내보내기를 참조하세요.
CSV 내보내기 이메일 주소
| 필드 이름 | 설명 |
|---|---|
| user_id | 사용자의 외부 ID |
| first_name | 이름 |
| last_name | 성 |
| 이메일 | |
| unsubscribed_from_emails_at | 이메일 수신 탈퇴 날짜 |
| opted_in_to_emails_at | 이메일 옵트인 날짜 |
| user_aliases | 사용자 별칭(있는 경우) |
구독 그룹 데이터는 Segment 내보내기를 통해 제공되지 않습니다. 구독 상태별로 사용자를 식별하려면 구독 그룹 멤버십을 기준으로 별도의 Segment를 만든 다음 해당 Segment를 내보내세요.
대규모 Segment 내보내기
사용자가 500,000명을 넘는 대규모 사용자 Segment는 여러 가지 방법으로 내보낼 수 있습니다.
대규모 Segment를 더 작은 Segment로 나눈 다음, 각 Segment를 Braze에서 내보낼 수 있습니다.
무작위 버킷 번호를 사용해 사용자 기반을 여러 Segment로 나눈 다음, 내보낸 후에 합칠 수도 있습니다. 예를 들어 Segment를 두 개로 나눠야 한다면 다음 필터를 사용하면 됩니다.
- Segment 1: 무작위 버킷 번호가 5000 미만 (0-4999 포함)
- Segment 2: 무작위 버킷 번호가 4999 초과 (5000-9999 포함)
다음 엔드포인트를 레버리지하여 특정 Segment의 사용자 데이터를 내보낼 수도 있습니다. 이 엔드포인트에는 데이터 한도와 사용량 제한이 적용된다는 점에 유의하세요.
Amazon S3 인증정보를 연결한 경우, Segment CSV 내보내기 세부 정보에 설명된 대로 대규모 내보내기 파일은 이메일로 전송되는 다운로드 링크와 함께 버킷으로도 전달될 수 있습니다.