세그먼트 데이터를 CSV로 내보내기
이 페이지에서는 세그먼트에서 사용자 데이터의 CSV 내보내기를 요청하는 방법과 내보내기에 포함된 데이터에 대해 설명합니다.
세그먼트 데이터를 CSV로 내보내려면 세그먼트를 편집하는 동안 사용자 데이터 드롭다운을 선택하고 세그먼트의 사용자 데이터 또는 이메일 주소 중 하나를 선택하여 내보냅니다.
메인 세그먼트 페이지에서 세그먼트의 설정 드롭다운을 선택하여 CSV 내보내기를 요청할 수도 있습니다.
모든 고객 프로필에서 데이터를 내보내려면 필터가 없는 세그먼트를 생성한 다음 CSV 내보내기를 요청하세요.
CSV 출력에는 내보내기 시점에 세그먼트에서 캡처된 각 고객 프로필의 데이터가 포함되어 있습니다. 기어 아이콘과 CSV 내보내기를 선택하여 세그먼트를 내보낼 수 있습니다. Braze는 보고서를 백그라운드에서 생성하고 현재 로그인한 사용자에게 이메일로 전송합니다.
파일 크기 제한으로 인해 세그먼트의 예상 크기가 500,000명 이상의 사용자일 경우 내보내기가 실패할 수 있습니다. 이 제한은 정확한 계산이 아닌 세그먼트의 예상 크기를 사용한다는 점에 유의하세요. 자세한 내용은 대규모 세그먼트 내보내기를 참조하세요.
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 내보내기 이메일 주소
| 필드 이름 | 설명 |
|---|---|
| user_id | 사용자의 외부 ID |
| first_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 에서 이 페이지를 편집합니다.