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당 한 번에 최대 하나의 내보내기만 실행할 수 있다는 점에 유의하세요. 내보내기가 완료될 때까지 기다렸다가 다시 시도하세요.
OpenAPI 문서를 다운로드하여 스키마 유효성 검사에 사용할 수 있습니다. 방법을 알아보려면 요청 유효성 검사에 OpenAPI 스키마 사용을 참조하세요.