Segment별 사용자 프로필 내보내기
/users/export/segment
이 엔드포인트를 사용하여 Segment 내의 모든 사용자를 내보낼 수 있습니다.
이 엔드포인트를 사용할 때는 다음 사항에 유의하세요.
1. 이 API 요청의 fields_to_export 필드는 필수입니다.
2. custom_events, purchases, campaigns_received, canvases_received 필드에는 지난 90일 동안의 데이터만 포함됩니다.
사용자 데이터는 줄 바꿈으로 구분된 사용자 JSON 오브젝트(예: 한 줄에 하나의 JSON 오브젝트)가 담긴 여러 파일로 내보내집니다. 데이터는 자동으로 생성된 URL로 내보내지며, 이 통합이 이미 설정되어 있다면 S3 버킷으로 내보내집니다.
내보내기 출력 형식: 내보내기에 성공했고 클라우드 스토리지 자격 증명을 구성하지 않은 경우, HTTP 응답에 압축된 아카이브(ZIP 또는 GZIP 파일)를 다운로드할 수 있는 URL이 포함됩니다. 클라우드 스토리지 자격 증명(S3, Azure 또는 Google Cloud Storage)을 구성한 경우에는 Braze가 내보내기 파일을 버킷에 직접 기록하며, 응답에 다운로드 URL이 포함되지 않습니다. 내보내기에 실패하면 대신 이메일 알림을 받게 됩니다. 클라우드 스토리지 자격 증명을 설정하면 대규모 내보내기의 실패 가능성을 줄일 수 있습니다.
회사당 이 엔드포인트를 사용하여 Segment별로 한 번에 최대 하나의 내보내기만 실행할 수 있습니다. 내보내기가 완료될 때까지 기다렸다가 다시 시도하세요.
Endpoint reference
This reference is generated from the OpenAPI specification for this endpoint. To run the endpoint, copy the generated cURL example and send it from your terminal or Postman. You can also download the raw OpenAPI spec for this page at /docs/ko/assets/api/openapi/export_user_data_post_users_segment.yaml. Use this spec to validate that your requests include the correct parameters, fields, and structure before you send them. To learn how, see Use OpenAPI schemas for request validation.