세그먼트 데이터를 CSV로 내보내기
이 페이지에서는 세그먼트에서 사용자 데이터의 CSV 내보내기를 요청하는 방법과 내보내기에 포함된 데이터에 대해 설명합니다.
세그먼트 데이터를 CSV로 내보내려면 세그먼트를 편집하는 동안 사용자 데이터 드롭다운을 선택하고 세그먼트의 사용자 데이터 또는 이메일 주소 중 하나를 선택하여 내보내도록 선택합니다.

메인 세그먼트 페이지에서 설정 드롭다운을 선택하여 세그먼트의 CSV 내보내기를 요청할 수도 있습니다.

모든 고객 프로필에서 데이터를 내보내려면 필터가 없는 세그먼트를 생성한 다음 CSV 내보내기를 요청하세요.
CSV 출력에는 내보내기 시점에 세그먼트에서 캡처된 각 고객 프로필의 데이터가 포함되어 있습니다. 기어 아이콘과 CSV 내보내기를 선택하여 세그먼트를 내보낼 수 있습니다. Braze는 보고서를 백그라운드에서 생성하고 현재 로그인한 사용자에게 이메일로 전송합니다.
파일 크기 제한으로 인해 세그먼트의 예상 크기가 500,000명 이상의 사용자일 경우 내보내기가 실패할 수 있습니다. 이 제한은 정확한 계산이 아닌 세그먼트의 예상 크기를 사용한다는 점에 유의하십시오. 자세한 내용은 대규모 세그먼트 내보내기를 참조하세요.
If you’ve linked your Amazon S3 credentials to Braze, the CSV will instead be uploaded in your S3 bucket under the key segment-export/SEGMENT_ID/YYYY-MM-dd/users-RANDOMSTRING.zip. 이메일로 전송된 다운로드 링크에 액세스하려면 대시보드에 로그인해야 합니다.
S3 버킷에 저장된 내보내기 파일은 다운로드 링크가 만료된 후 자동으로 삭제됩니다(내보내기 이메일이 전송된 시점으로부터 4시간 후, 별도로 명시되지 않는 한).
데이터 포함 내보내기
다음은 선택에 따라 내보내기에 포함됩니다.
CSV 내보내기 사용자 데이터
| Field Name | 설명 |
|---|---|
| Appboy ID | 내부 ID (변경할 수 없음) |
| 국가 | Country |
| created_at | 고객 프로필이 생성된 날짜 및 시간 |
| 기기 | Device information |
| date_of_birth | Date of birth |
| 이메일 | Email address |
| unsubscribed_from_emails_at | 이메일 구독 취소 날짜 |
| user_id | External ID |
| first_name | First name |
| first_session | 첫 세션의 날짜 및 시간 |
| 성별 | Gender |
| google_ad_ids | 사용자와 연결된 Google 광고 ID |
| 도시 | 도시 |
| IDFAs | 광고 식별자 (IDFA) 값 |
| IDFVs | 벤더 식별자 (IDFV) 값 |
| 언어 | 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 | Phone number |
| opted_into_push_at | 푸시 알림을 수신하도록 선택한 날짜 |
| unsubscribed_from_push_at | 푸시 알림에서 구독 취소된 날짜 |
| random_bucket | 무작위 버킷 번호 |
| roku_ad_ids | Roku 광고 ID |
| session_count | 총 세션 수 |
| 시간대 | 사용자의 시간대는 IANA 시간대 데이터베이스와 동일한 형식입니다 |
| in_app_purchase_total | 인앱 구매에 사용된 총 금액 |
| user_aliases | 사용자 별칭, 있는 경우 |
| windows_ad_ids | Windows 광고 ID |
| 사용자 지정 이벤트 | 선택에 따른 내보내기 |
| 사용자 지정 속성 | 선택에 따른 내보내기 |
CSV 내보내기 이메일 주소
| 필드 이름 | 설명 |
|---|---|
| user_id | 사용자의 외부 ID |
| first_name | First name |
| last_name | Last name |
| 이메일 | |
| unsubscribed_from_emails_at | 이메일 구독 취소 날짜 |
| opted_in_to_emails_at | 이메일 옵트인 날짜 |
| user_aliases | 사용자 별칭, 있는 경우 |
CSV 및 API 내보내기에 대한 도움말은 문제 해결 기사를 참조하십시오.
대형 세그먼트 내보내기
500,000명 이상의 사용자를 포함하는 대규모 사용자 세그먼트를 내보내는 방법에는 여러 가지가 있습니다.
큰 세그먼트를 작은 세그먼트로 세분화한 다음 각각의 작은 세그먼트를 Braze에서 내보낼 수 있습니다.
무작위 버킷 번호를 사용하여 사용자 기반을 여러 세그먼트로 나눈 다음 내보내기 후에 결합할 수도 있습니다. 예를 들어, 세그먼트를 두 개의 다른 세그먼트로 나누어야 하는 경우 다음 필터를 사용하여 수행할 수 있습니다:
- 세그먼트 1: 무작위 버킷 번호는 5000보다 작습니다 (0-4999 포함)
- 세그먼트 2: 무작위 버킷 번호는 4999보다 큽니다 (5000-9999 포함)
다음 엔드포인트를 활용하여 특정 세그먼트의 사용자 데이터를 내보낼 수도 있습니다. 이러한 엔드포인트는 데이터 제한을 받을 수 있습니다.
GitHub 에서 이 페이지를 편집합니다.