본문으로 건너뛰기

간격 분석 모델 API

최근 업데이트 2026. 10. 05.

호출 방법은 Open API 문서의 호출 방법 설명을 참고하십시오.

사용 설명서의 간격 분석에서 사용 시나리오를 확인할 수 있습니다.

1. 간격 분석 조회​

인터페이스 URL

/open/interval-analyze?token=xxx

요청 방식

POST

Content-Type

application/json

요청 Query 파라미터

파라미터 이름예시 값파라미터 타입필수 여부파라미터 설명
tokenxxxString예조회 키

요청 Body 파라미터​

{
"eventView": {
"endTime": "2021-10-05 23:59:59",
"filts": [
{
"columnDesc": "브랜드",
"columnName": "brand",
"comparator": "equal",
"filterType": "SIMPLE",
"ftv": [
"Apple",
"Huawei"
],
"specifiedClusterDate": "2022-01-24",
"tableType": "event",
"timeUnit": ""
}
],
"groupBy": [
{
"columnDesc": "브랜드",
"columnName": "brand",
"propertyRange": "",
"specifiedClusterDate": "2022-01-24",
"tableType": "event"
}
],
"recentDay": "114-115",
"relation": "and",
"startTime": "2021-10-04 00:00:00",
"taIdMeasureVo": {
"columnDesc": "유저 고유 ID",
"columnName": "#user_id",
"tableType": "event"
},
"timeParticleSize": "day",
"windowsGapUnit": "hour",
"windowsGapValue": 1
},
"events": [
{
"eventName": "activity_attend",
"eventNameDisplay": "",
"filts": [
],
"relation": "and",
"relationProp": {
"property": {
"columnDesc": "브랜드",
"columnName": "brand",
"specifiedClusterDate": "2022-01-24",
"tableType": "event"
}
},
"type": "first"
},
{
"eventName": "payment",
"eventNameDisplay": "",
"filts": [
],
"relation": "and",
"relationProp": {
"property": {
"columnDesc": "브랜드",
"columnName": "brand",
"specifiedClusterDate": "2022-01-24",
"tableType": "event"
},
"relationOperatorValue": 0,
"relationPropNumberOperator": "r_eq"
},
"type": "second"
}
],
"projectId": 377,
"limit": 10,
"timeoutSeconds": 10,
"useCache": true,
"zoneOffset": 10
}

요청 파라미터 설명​

$$파라미터 이름예시 값파라미터 타입필수 여부파라미터 설명
eventView-Object예지표 공통 속성 부분
eventView.endTime2021-10-05 23:59:59String아니요종료 시간(형식: yyyy-MM-dd HH:mm:ss). 상대 시간이 비어 있을 때 유효
eventView.filts-List아니요전체 필터 항목
eventView.filts.columnDesc브랜드String아니요필드 표시 이름
eventView.filts.columnNamebrandString예필드 이름
eventView.filts.comparatorequalString예참고: 모델 조회 API의 필터 표현식
eventView.filts.filterTypeSIMPLEString아니요필터 모드. SIMPLE: 단순, COMPOUND: 복합
eventView.filts.ftv["Apple"]List아니요속성 비교 경계에 사용하는 리터럴 상수
eventView.filts.specifiedClusterDate2022-01-24String아니요지정한 날짜에 해당하는 태그 이력 버전
eventView.filts.tableTypeeventString예테이블 유형 열거형 값
eventView.filts.timeUnitString아니요속성 비교 값 단위. relativeEvent*에만 유효: day, hour, minute
eventView.groupBy-List아니요그룹 속성. 0개 이상 지정 가능
eventView.groupBy.columnDesc브랜드String아니요필드 표시 이름
eventView.groupBy.columnNamebrandString예필드 이름
eventView.groupBy.propertyRangeString아니요커스텀 속성 구간
eventView.groupBy.specifiedClusterDate2022-01-24String아니요지정한 날짜에 해당하는 태그 이력 버전
eventView.groupBy.tableTypeeventString예테이블 유형 열거형 값
eventView.recentDay114-115String아니요상대 시간(시작 시간, 종료 시간과 함께 모두 비워 둘 수 없음)
eventView.relationandString아니요논리 관계. and: 논리곱, or: 논리합
eventView.startTime2021-10-04 00:00:00String아니요시작 시간(형식: yyyy-MM-dd HH:mm:ss). 상대 시간이 비어 있을 때 유효
eventView.taIdMeasureVo-Object아니요분석 주체 설정
eventView.taIdMeasureVo.columnDesc유저 고유 IDString아니요필드 표시 이름
eventView.taIdMeasureVo.columnName#user_idString예필드 이름
eventView.taIdMeasureVo.tableTypeeventString예테이블 유형 열거형 값
eventView.timeParticleSizeday

String

예

분석 시간 단위

  • minute: 1분 단위
  • hour: 시간별
  • day: 일별
  • week: 주별
  • month: 월별
  • total: 합계
eventView.firstDayOfWeekInteger아니요timeParticleSize가 week일 때 주의 첫날을 지정. 1: 월요일, 2: 화요일, ..., 7: 일요일. 최소 1, 최대 7
eventView.windowsGapUnithourString아니요윈도우 기간 단위
eventView.windowsGapValue1Integer아니요윈도우 기간
events-List예이벤트 지표 목록
events.eventNameactivity_attendString예이벤트 이름. 특히 anyEvent로 임의의 이벤트를 나타낼 수 있음
events.eventNameDisplayString아니요이벤트 표시 이름
events.filts-List아니요조건 목록
events.relationandString아니요논리 관계. and: 논리곱, or: 논리합
events.relationProp-Object아니요관련 속성
events.relationProp.property-Object아니요관련 속성
events.relationProp.property.columnDesc브랜드String아니요필드 표시 이름
events.relationProp.property.columnNamebrandString아니요필드 이름
events.relationProp.property.specifiedClusterDate2022-01-24String아니요지정한 날짜에 해당하는 태그 이력 버전
events.relationProp.property.tableTypeeventString아니요테이블 유형 열거형 값
events.relationProp.relationOperatorValue0Integer아니요관계 연산 값
events.relationProp.relationPropNumberOperatorr_eqString아니요

관계 연산자

  • r_eq: 같음
  • r_high: 높음
  • r_low: 낮음
events.typefirstString예이벤트 타입. first: 시작 이벤트, second: 종료 이벤트
projectId377Integer예프로젝트 ID
limit10Integer아니요분석 대상별 그룹 수 상한. 선택 파라미터이며 기본값은 1000, 최댓값은 10000
timeoutSeconds10Integer아니요요청 시간 초과 파라미터, 시간이 초과되면 쿼리 작업을 취소합니다
useCachetrueBoolean예true이면 캐시 사용
zoneOffset10Integer아니요시간대

성공 응답 예시​

{
"data": {
"distributionInterval": [
",300",
"300,600",
"600,900",
"900,1200",
"1200,1500",
"1500,1800",
"1800,2100",
"2100,2400",
"2400,2700",
"2700,3000",
"3000,3300",
"3300,"
],
"groupCols": [
[
"Apple"
],
[
"Huawei"
]
],
"intervalData": {
"dateEntities": [
{
"dateString": "2021-10-04",
"groupEntities": [
{
"groups": [
"Apple"
],
"intervalAggValue": {
"avgValue": 40,
"eventNum": 6646,
"maxValue": 354,
"midValue": 28,
"minValue": 2,
"quarterValue": 16,
"threeQuarterValue": 49,
"userNum": 838
},
"intervalDistributions": [
{
"distribution": "300,600",
"intervalDistributionValue": {
"eventNum": 5,
"userNum": 5
}
},
{
"distribution": ",300",
"intervalDistributionValue": {
"eventNum": 6641,
"userNum": 838
}
}
]
},
{
"groups": [
"Huawei"
],
"intervalAggValue": {
"avgValue": 39,
"eventNum": 5439,
"maxValue": 313,
"midValue": 28,
"minValue": 2,
"quarterValue": 15,
"threeQuarterValue": 50,
"userNum": 683
},
"intervalDistributions": [
{
"distribution": "300,600",
"intervalDistributionValue": {
"eventNum": 2,
"userNum": 2
}
},
{
"distribution": ",300",
"intervalDistributionValue": {
"eventNum": 5437,
"userNum": 683
}
}
]
}
],
"intervalAggValue": {
"avgValue": 39,
"eventNum": 12085,
"maxValue": 354,
"midValue": 28,
"minValue": 2,
"quarterValue": 16,
"threeQuarterValue": 49,
"userNum": 1520
},
"intervalDistributions": [
{
"distribution": "300,600",
"intervalDistributionValue": {
"eventNum": 7,
"userNum": 7
}
},
{
"distribution": ",300",
"intervalDistributionValue": {
"eventNum": 12078,
"userNum": 1520
}
}
]
},
{
"dateString": "2021-10-05",
"groupEntities": [
{
"groups": [
"Apple"
],
"intervalAggValue": {
"avgValue": 39,
"eventNum": 5700,
"maxValue": 303,
"midValue": 28,
"minValue": 2,
"quarterValue": 16,
"threeQuarterValue": 49,
"userNum": 710
},
"intervalDistributions": [
{
"distribution": "300,600",
"intervalDistributionValue": {
"eventNum": 1,
"userNum": 1
}
},
{
"distribution": ",300",
"intervalDistributionValue": {
"eventNum": 5699,
"userNum": 710
}
}
]
},
{
"groups": [
"Huawei"
],
"intervalAggValue": {
"avgValue": 40,
"eventNum": 4779,
"maxValue": 374,
"midValue": 28,
"minValue": 2,
"quarterValue": 15,
"threeQuarterValue": 51,
"userNum": 603
},
"intervalDistributions": [
{
"distribution": "300,600",
"intervalDistributionValue": {
"eventNum": 3,
"userNum": 3
}
},
{
"distribution": ",300",
"intervalDistributionValue": {
"eventNum": 4776,
"userNum": 603
}
}
]
}
],
"intervalAggValue": {
"avgValue": 39,
"eventNum": 10479,
"maxValue": 374,
"midValue": 28,
"minValue": 2,
"quarterValue": 16,
"threeQuarterValue": 50,
"userNum": 1313
},
"intervalDistributions": [
{
"distribution": "300,600",
"intervalDistributionValue": {
"eventNum": 4,
"userNum": 4
}
},
{
"distribution": ",300",
"intervalDistributionValue": {
"eventNum": 10475,
"userNum": 1313
}
}
]
}
],
"groupEntities": [
{
"groups": [
"Apple"
],
"intervalAggValue": {
"avgValue": 39,
"eventNum": 12346,
"maxValue": 354,
"midValue": 28,
"minValue": 2,
"quarterValue": 16,
"threeQuarterValue": 49,
"userNum": 1542
},
"intervalDistributions": [
{
"distribution": "300,600",
"intervalDistributionValue": {
"eventNum": 6,
"userNum": 6
}
},
{
"distribution": ",300",
"intervalDistributionValue": {
"eventNum": 12340,
"userNum": 1542
}
}
]
},
{
"groups": [
"Huawei"
],
"intervalAggValue": {
"avgValue": 39,
"eventNum": 10218,
"maxValue": 374,
"midValue": 28,
"minValue": 2,
"quarterValue": 15,
"threeQuarterValue": 50,
"userNum": 1282
},
"intervalDistributions": [
{
"distribution": "300,600",
"intervalDistributionValue": {
"eventNum": 5,
"userNum": 5
}
},
{
"distribution": ",300",
"intervalDistributionValue": {
"eventNum": 10213,
"userNum": 1282
}
}
]
}
],
"intervalAggValue": {
"avgValue": 39,
"eventNum": 22564,
"maxValue": 374,
"midValue": 28,
"minValue": 2,
"quarterValue": 16,
"threeQuarterValue": 49,
"userNum": 2817
},
"intervalDistributions": [
{
"distribution": "300,600",
"intervalDistributionValue": {
"eventNum": 11,
"userNum": 11
}
},
{
"distribution": ",300",
"intervalDistributionValue": {
"eventNum": 22553,
"userNum": 2817
}
}
]
},
"intervalType": "def",
"timeArray": [
"2021-10-04",
"2021-10-05"
]
},
"return_code": 0,
"return_message": "success"
}

응답 파라미터 설명​

$$파라미터 이름예시 값파라미터 타입파라미터 설명
return_code0Integer반환 코드
return_messagesuccessString반환 정보
data-Object반환 결과
data.distributionInterval[",300","300,"]List분포 간격
data.groupCols[["Apple"],["Huawei"]]List<List>그룹
data.intervalData-Object날짜 데이터
data.intervalData.dateEntities-List날짜 리스트
data.intervalData.dateEntities.dateString2021-10-04String날짜
data.intervalData.groupEntities-List그룹 리스트
data.intervalData.groupEntities.groups["Apple"]List그룹 값 리스트
data.intervalData.intervalAggValue-Object집계 값
data.intervalData.intervalAggValue.avgValue39Long평균값
data.intervalData.intervalAggValue.eventNum22564Long이벤트 수
data.intervalData.intervalAggValue.maxValue374Long최댓값
data.intervalData.intervalAggValue.midValue28Long중앙값
data.intervalData.intervalAggValue.minValue2Long최솟값
data.intervalData.intervalAggValue.quarterValue16Long상위 4분위수
data.intervalData.intervalAggValue.threeQuarterValue49Long하위 4분위수
data.intervalData.intervalAggValue.userNum2817Long유저 수
data.intervalData.intervalDistributions-List분포 구간 리스트
data.intervalData.intervalDistributions.distribution300,600String분포 구간
data.intervalData.intervalDistributions.intervalDistributionValue-Object분포 구간 값
data.intervalData.intervalDistributions.intervalDistributionValue.eventNum11Long이벤트 수
data.intervalData.intervalDistributions.intervalDistributionValue.userNum11Long유저 수

data.intervalType

defString

타입

  • discrete: 이산 숫자
  • def: 기본 구간
  • user_defined: 사용자 정의
data.timeArray["2021-10-04"]List이벤트 목록

오류 응답 예시

{
"return_code": -1008,
"return_message": "파라미터(token)가 비어 있습니다"
}
파라미터 이름예시 값파라미터 타입파라미터 설명
return_code-1008Integer반환 코드
return_message파라미터(token)가 비어 있습니다String반환 정보

2. 간격 분석 전체 다운로드​

인터페이스 URL

/open/streaming-download/interval-analyze?token=xxx

요청 방식

POST

Content-Type

application/json

요청 Query 파라미터

파라미터 이름예시 값파라미터 타입필수 여부파라미터 설명
tokenxxxString예조회 키

요청 Body 파라미터​

{
"eventView": {
"endTime": "2022-03-07 17:17:04",
"filts": [],
"groupBy": [],
"recentDay": "1-7",
"relation": "and",
"startTime": "2022-03-01 17:17:04",
"taIdMeasureVo": {
"columnDesc": "User ID",
"columnName": "#user_id",
"tableType": "event"
},
"timeParticleSize": "day",
"windowsGapUnit": "hour",
"windowsGapValue": 1
},
"events": [{
"eventName": "Login",
"eventNameDisplay": "",
"filts": [],
"relation": "and",
"type": "first"
}, {
"eventName": "Recharge",
"eventNameDisplay": "",
"filts": [],
"relation": "and",
"type": "second"
}],
"projectId": 319,
"format": "AGG_TABLE",
"zoneOffset": 10
}

요청 파라미터 설명​

$$파라미터 이름예시 값파라미터 타입필수 여부파라미터 설명
eventView-Object예지표 공통 속성 부분. 간격 분석 조회 인터페이스와 파라미터 내용이 같음
events-List예이벤트 지표 목록
projectId377Integer예프로젝트 ID
formatAGG_TABLEString예

AGG_TABLE 박스플롯을 표로 변환

DISTRIBUTION_TABLE 분포를 표로 변환

interval[1]array아니요전체 구간
zoneOffset10Integer아니요시간대

응답​

AE 시스템의 간격 분석 전체 다운로드와 동일

3. 간격 분석 유저 목록​

인터페이스 URL

/open/interval-user-list?token=xxx

요청 방식

POST

Content-Type

application/json

요청 Query 파라미터

파라미터 이름예시 값파라미터 타입필수 여부파라미터 설명
tokenxxxString예조회 키

요청 Body 파라미터​

{
"eventView": {
"endTime": "2021-10-05 23:59:59",
"filts": [
{
"columnDesc": "브랜드",
"columnName": "brand",
"comparator": "equal",
"filterType": "SIMPLE",
"ftv": [
"Apple",
"Huawei"
],
"specifiedClusterDate": "2022-01-24",
"tableType": "event",
"timeUnit": ""
}
],
"groupBy": [
{
"columnDesc": "브랜드",
"columnName": "brand",
"propertyRange": "",
"specifiedClusterDate": "2022-01-24",
"tableType": "event"
}
],
"recentDay": "114-115",
"relation": "and",
"startTime": "2021-10-04 00:00:00",
"taIdMeasureVo": {
"columnDesc": "유저 고유 ID",
"columnName": "#user_id",
"tableType": "event"
},
"timeParticleSize": "day",
"windowsGapUnit": "hour",
"windowsGapValue": 1
},
"events": [
{
"eventName": "activity_attend",
"eventNameDisplay": "",
"filts": [
],
"relation": "and",
"relationProp": {
"property": {
"columnDesc": "브랜드",
"columnName": "brand",
"specifiedClusterDate": "2022-01-24",
"tableType": "event"
}
},
"type": "first"
},
{
"eventName": "payment",
"eventNameDisplay": "",
"filts": [
],
"relation": "and",
"relationProp": {
"property": {
"columnDesc": "브랜드",
"columnName": "brand",
"specifiedClusterDate": "2022-01-24",
"tableType": "event"
},
"relationOperatorValue": 0,
"relationPropNumberOperator": "r_eq"
},
"type": "second"
}
],
"projectId": 377,
"timeoutSeconds": 10,
"interval": "2,3",
"sliceDate": "",
"sliceGroupVal": ["Apple", "Huawei"],
"zoneOffset": 10
}

요청 파라미터 설명​

$$파라미터 이름예시 값파라미터 타입필수 여부파라미터 설명
eventView-Object예간격 분석 조회 인터페이스와 파라미터 내용이 같음
events-List예간격 분석 조회 인터페이스와 파라미터 내용이 같음
projectId377Integer예프로젝트 ID
timeoutSeconds10Integer아니요요청 시간 초과 파라미터, 시간이 초과되면 쿼리 작업을 취소합니다
interval2,3String아니요드릴다운할 구간
sliceDate2021-10-21String아니요드릴다운할 날짜
sliceGroupVal["Apple", "Huawei"]List아니요드릴다운할 그룹
zoneOffset10Integer아니요시간대

성공 응답 예시​

{
"data": {
"columMeta": {
"country": "국가",
"education": "학력",
"birthdate": "생년월일",
"gender": "성별",
"last_login_time": "last_login_time",
"city": "도시",
"nation": "민족",
"channel": "유저 작업 타입",
"weight": "체중(KG)",
"#distinct_id": "게스트 ID",
"firstcharge": "첫 충전 여부",
"register_time": "register_time",
"#account_id": "계정 ID",
"companynature": "직장 유형",
"accountbalance": "잔액",
"maritalstatus": "결혼 여부",
"interest": "취미",
"name": "이름",
"accountpoint": "포인트",
"rank": "회원 등급",
"first_login_time": "first_login_time",
"email": "이메일",
"height": "신장(CM)"
},
"datalist": [
{
"country": "중국",
"birthdate": "2013-05-21",
"education": "전문대",
"last_login_time": "2021-12-04 02:18:46.111",
"gender": "남성",
"city": "상하이시",
"nation": "한족",
"#user_id": 795692987887919100,
"channel": "위챗",
"weight": "125",
"#distinct_id": "5694fdd8-e1dc-4459-97dd-33b10df01400",
"firstcharge": false,
"register_time": "2021-10-06 00:00:23.000",
"#account_id": "b406f8a7-424d-4909-a08a-7b00191b7493",
"companynature": "국유 기업",
"accountbalance": "42606",
"maritalstatus": "미혼",
"interest": [
"여행",
"운동",
"운동"
],
"accountpoint": "81910",
"name": "UaLEhzdn",
"rank": "골드 카드",
"first_login_time": "2021-10-06 00:01:56.000",
"email": "ElqqXwdL@thinkingdata.cn",
"height": "174"
},
{
"country": "중국",
"birthdate": "1964-12-26",
"education": "전문대",
"last_login_time": "2021-10-05 00:02:35.000",
"gender": "남성",
"city": "상하이시",
"nation": "한족",
"#user_id": 795692395992715300,
"channel": "공식 웹사이트",
"weight": "197",
"#distinct_id": "5caf9f1a-3253-4279-9723-49c950a48020",
"firstcharge": true,
"register_time": "2021-10-05 00:00:30.000",
"#account_id": "cb6ab625-f45d-4977-bbae-973ead82acba",
"companynature": "외국계 기업",
"accountbalance": "49013",
"maritalstatus": "미혼",
"interest": [
"운동",
"노래",
"운동"
]
}
],
"totalNum": 2
},
"return_code": 0,
"return_message": "success"
}

응답 파라미터 설명​

$$파라미터 이름예시 값파라미터 타입파라미터 설명
return_code0Integer반환 코드
return_messagesuccessString반환 정보
data-Object반환 결과
data.datalist-List<Map>유저 정보
data.columMeta-Map필드 의미 매핑
data.totalNum2Integer총계

오류 응답 예시

{
"return_code": -1008,
"return_message": "파라미터(token)가 비어 있습니다"
}
파라미터 이름예시 값파라미터 타입파라미터 설명
return_code-1008Integer반환 코드
return_message파라미터(token)가 비어 있습니다String반환 정보

4. 간격 분석 유저 목록 다운로드​

인터페이스 URL

/open/streaming-download/interval-user-list?token=xxx

요청 방식

POST

Content-Type

application/json

요청 Query 파라미터

파라미터 이름예시 값파라미터 타입필수 여부파라미터 설명
tokenxxxString예조회 키

요청 Body 파라미터​

{
"eventView": {
"endTime": "2022-03-07 17:17:04",
"filts": [],
"groupBy": [],
"recentDay": "1-7",
"relation": "and",
"startTime": "2022-03-01 17:17:04",
"taIdMeasureVo": {
"columnDesc": "User ID",
"columnName": "#user_id",
"tableType": "event"
},
"timeParticleSize": "day",
"windowsGapUnit": "hour",
"windowsGapValue": 1
},
"events": [
{
"eventName": "Login",
"eventNameDisplay": "",
"filts": [],
"relation": "and",
"type": "first"
},
{
"eventName": "Recharge",
"eventNameDisplay": "",
"filts": [],
"relation": "and",
"type": "second"
}
],
"projectId": 319,
"sliceGroupVal": null,
"sliceDate": "2022-03-01",
"selectedColumns": [
"#account_id",
"#distinct_id",
"accountid"
],
"zoneOffset": 10
}

요청 파라미터 설명​

$$파라미터 이름예시 값파라미터 타입필수 여부파라미터 설명
eventView-Object예간격 분석 조회 인터페이스와 파라미터 내용이 같음
events-List예간격 분석 조회 인터페이스와 파라미터 내용이 같음
projectId377Integer예프로젝트 ID
selectedColumns["#account_id"]array예다운로드할 항목
interval2,3String드릴다운할 구간
sliceDate2021-10-21String아니요드릴다운할 날짜
sliceGroupVal["Apple", "Huawei"]List아니요드릴다운할 그룹
zoneOffset10Integer아니요시간대

응답​

AE 시스템의 간격 분석 유저 목록 다운로드와 동일

이 문서가 도움이 되었나요?