Skip to content

내보내기 엔드포인트

이 엔드포인트 모음을 사용하면 KPI, 앱 세션, 사용자, 세그먼트, 캠페인, Canvases에 대한 다양한 수준의 세부 정보에 액세스하고 내보낼 수 있습니다. 매개변수 및 요청 본문을 작성할 때 Braze 인스턴스, API 키, API 식별자를 알고 있어야 합니다.

필수 조건

시작하기 전에 다음 사항을 준비하세요.

내보낼 수 있는 항목

다음 표는 내보내기 API를 통해 사용할 수 있는 데이터 카테고리를 요약합니다.

내보내기 데이터 전달 방식

API 내보내기는 대시보드에서 다운로드하는 CSV 파일과 달리 JSON 형식으로 데이터를 반환합니다. 전달 방식은 클라우드 스토리지 연결 여부에 따라 달라집니다.

  • 클라우드 스토리지 미연결 시: Braze는 자체 S3 버킷에 내보내기 파일을 기록하고 API 응답에 임시 다운로드 URL을 포함합니다. 이 URL은 4시간 후에 만료되며, 내보내기는 JSON 파일이 포함된 압축 아카이브(ZIP 또는 GZIP, output_format 매개변수에 따라 다름)로 패키징됩니다. JSON 파일의 각 줄은 하나의 데이터 오브젝트를 나타냅니다.
  • 클라우드 스토리지 연결 시: Braze는 구성된 버킷에 내보내기 파일을 직접 기록합니다. API 응답에는 다운로드 URL이 포함되지 않습니다. 파일은 자체 보존 정책을 따르며, 일반적으로 대규모 내보내기에 더 안정적입니다.

내보내기 전달 및 문제 해결에 대한 자세한 내용은 내보내기 문제 해결을 참조하세요.

내보내기 엔드포인트

다음 표는 사용 가능한 모든 내보내기 API를 나열합니다.

대시보드에서 일회성 내보내기를 수행하려면 다음 문서를 참조하세요.
New Stuff!