콘텐츠로 건너뛰기

세그먼트 목록 내보내기

get

/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 엔드포인트 세그먼트의 고객 프로필을 내보내어, 전송한 속성, 커스텀 이벤트 및 구매가 프로필에 올바르게 반영되었는지 확인할 수 있습니다.

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_segments_get_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.

New Stuff!