세그먼트 목록 내보내기
/segments/list
이 엔드포인트를 사용하면 세그먼트 목록을 내보낼 수 있습니다. 각 세그먼트에는 이름, Segment API 식별자, 분석 추적 활성화 여부가 포함됩니다.
세그먼트는 생성 시간순으로 정렬되어 100개 단위로 반환됩니다(기본값은 가장 오래된 것부터 최신 순). 아카이브된 세그먼트는 포함되지 않습니다.
이 엔드포인트를 사용하는 경우
이벤트와 구매 데이터는 /users/track 엔드포인트를 통해 Braze로 전송합니다. 세그먼트에 대한 해당 데이터를 시간 경과에 따라 확인하려면 세그먼트에 분석 추적이 활성화되어 있어야 합니다. 이 엔드포인트 응답의 analytics_tracking_enabled 필드를 보면 어떤 세그먼트에 분석 추적이 활성화되어 있는지 확인할 수 있습니다.
세그먼트 세부 정보 내보내기 엔드포인트는 이 설정을 반환하지 않으므로, API로 이 설정을 확인하려면 이 엔드포인트를 사용해야 합니다.
이 엔드포인트를 사용하여 다음 작업을 할 수 있습니다.
- 새 데이터를 전송하기 전에 추적이 활성화되어 있는지 확인합니다. Braze는 추적을 활성화하기 이전의 매출 및 구매 데이터를 소급해 채우지 않습니다. 비교하려는 세그먼트의
analytics_tracking_enabled가true인지 먼저 확인하세요. - 비어 있는 세그먼트 보고서 문제를 해결합니다. 세그먼트의 세션, 커스텀 이벤트 또는 매출 보고서가 비어 있다면, 통합을 디버깅하기 전에
analytics_tracking_enabled가false인지 확인하세요. - 추적 중인 세그먼트 수를 파악합니다. 워크스페이스에서는 최대 25개의 세그먼트에 대해 추적을 활성화할 수 있습니다.
page파라미터를 사용하여 모든 페이지를 조회한 다음,analytics_tracking_enabled가true인 세그먼트 수를 세어 남은 개수를 확인하세요.
몇 개의 세그먼트를 한 번만 확인하려면 Segments 페이지에서 Advanced Tracking Segments Only 필터를 선택하세요. 스크립트나 스케줄된 작업에서 결과가 필요할 때는 이 엔드포인트를 사용하세요.
이 엔드포인트는 추적 설정을 읽기만 하며 변경하지는 않습니다. 추적을 활성화하려면 세그먼트의 Segment Details 섹션으로 이동하여 Analytics Tracking을 켜세요.
이 엔드포인트와 다른 엔드포인트 함께 사용하기
다음 엔드포인트는 사용자 추적 워크플로의 나머지 부분을 다룹니다. 세그먼트 엔드포인트의 경우, 이 엔드포인트 응답의 id를 segment_id로 사용하세요.
| 엔드포인트 | 사용자 추적 워크플로를 지원하는 방법 |
|---|---|
/users/track 엔드포인트 |
추적 중인 세그먼트가 보고하는 커스텀 이벤트, 구매 및 속성 업데이트를 기록합니다. |
| 세그먼트 세부 정보 내보내기 엔드포인트 | 지정된 segment_id에 대한 세그먼트의 필터 설명과 태그를 조회합니다. |
| 세그먼트 분석 내보내기 엔드포인트 | 시간 경과에 따른 세그먼트의 예상 크기를 조회합니다. |
/users/export/segment 엔드포인트 |
세그먼트의 고객 프로필을 내보내므로, 전송한 속성, 커스텀 이벤트 및 구매가 프로필에 제대로 반영되었는지 확인할 수 있습니다. |
OpenAPI 문서를 다운로드하여 스키마 검증에 사용할 수 있습니다. 방법은 요청 검증에 OpenAPI 스키마 사용하기를 참조하세요.