이 페이지는 AI로 자동 번역되었으며 부정확한 내용이 포함될 수 있습니다. 번역 오류를 신고하려면 페이지 오른쪽 목차 아래에 있는 피드백 기능을 사용하세요.

내보내기 엔드포인트

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

필수 조건

시작하기 전에 다음 사항을 준비했는지 확인하세요:

요구 사항	설명
Braze REST API 키	호출하려는 엔드포인트에 적합한 내보내기 권한이 있는 REST API 키입니다. API 키는 특정 엔드포인트로 범위가 지정되며, 생성 후에는 권한을 변경할 수 없습니다. 자세한 내용은 REST API 키를 참조하세요.
관련 식별자	내보내려는 데이터의 식별자(예: Campaign ID, Segment ID 또는 Canvas ID)입니다. Braze 대시보드에서 확인할 수 있습니다. 전체 목록은 API 식별자 유형을 참조하세요.
클라우드 스토리지 자격 증명(선택 사항)	대용량 데이터셋을 내보내는 경우, Amazon S3, Microsoft Azure Blob Storage 또는 Google Cloud Storage 버킷을 연결하여 내보내기 파일을 스토리지에 직접 저장할 수 있습니다.

참고

API 액세스 권한이 없는 마케터 또는 팀원인 경우, 조직 내 개발자 또는 관리자에게 API 키 및 통합 설정을 요청하세요.

내보낼 수 있는 항목

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

카테고리	포함 항목	API 참고 자료
Campaigns	성능 분석, Campaign 세부 정보, Campaign 목록 및 발송 분석	Campaign 엔드포인트
Canvases	데이터 시계열 분석, 분석 요약, Canvas 세부 정보 및 Canvas 목록	Canvas 엔드포인트
Segments	Segment 목록, Segment 분석 및 Segment 세부 정보	Segment 엔드포인트
사용자 데이터	식별자 또는 Segment별 전체 고객 프로필 및 글로벌 컨트롤 그룹별 사용자	사용자 데이터 엔드포인트
핵심 성과 지표(KPI)	일일 활성 사용자, 월간 활성 사용자, 일일 신규 사용자 및 날짜별 삭제 수	KPI 엔드포인트
세션	앱 세션 시계열 데이터	세션 엔드포인트
커스텀 이벤트	이벤트 이름, 이벤트 목록 및 시간에 따른 이벤트 분석	커스텀 이벤트 엔드포인트
커스텀 속성	속성 이름	커스텀 속성 엔드포인트
구매	시간별 매출 데이터, 제품 ID 목록 및 구매 횟수	구매 엔드포인트

내보내기 데이터 전달 방식

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

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

팁

“클라우드 스토리지”란 자체 스토리지 버킷(예: Amazon S3, Microsoft Azure Blob Storage 또는 Google Cloud Storage)을 의미합니다. 파트너 통합 > 기술 파트너에서 버킷을 연결하면 Braze가 내보내기 파일을 해당 버킷에 직접 저장할 수 있습니다.

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