manuallatest제품 매뉴얼 / 분포 분석 모델 API
분포 분석 모델 API
호출 방법은 Open API 문서의 호출 방법 설명을 참고하십시오.
사용 시나리오는 사용 설명서의 분포 분석을 참고하십시오.
1. 분포 분석 조회
인터페이스 URL
/open/distribution-analyze?token=xxx
요청 방식
POST
Content-Type
application/json
요청 Query 파라미터
| 파라미터 이름 | 예시 값 | 파라미터 타입 | 필수 여부 | 파라미터 설명 |
|---|---|---|---|---|
| token | xxx | String | 예 | 조회 키 |
요청 Body 파라미터
{
"eventView":{
"endTime":"2021-10-05 23:59:59",
"groupBy":[
{
"columnDesc":"학력",
"columnName":"education",
"propertyRange":"",
"specifiedClusterDate":"2022-01-24",
"tableType":"user"
},
{
"columnDesc":"도시",
"columnName":"city",
"propertyRange":"",
"specifiedClusterDate":"2022-01-24",
"tableType":"user"
}],
"recentDay":"114-115",
"startTime":"2021-10-04 00:00:00",
"taIdMeasureVo":{
"columnDesc":"유저 고유 ID",
"columnName":"#user_id",
"tableType":"event"
},
"timeParticleSize":"day"
},
"events":[
{
"customEvent":"activity_attend.TIMES",
"customFilters":[
],
"eventName":"커스텀 지표",
"eventNameDisplay":"",
"filts":[
{
"columnDesc":"도시",
"columnName":"city",
"comparator":"equal",
"filterType":"SIMPLE",
"ftv":[
"베이징시",
"상하이시",
"광저우시",
"선전시"],
"specifiedClusterDate":"2022-01-27",
"tableType":"user",
"timeUnit":""
}],
"formulation":{
"formulationDeps":[
{
"event":{
"eventDesc":"이벤트 참여",
"eventName":"activity_attend"
}
}]
},
"intervalType":"user_defined",
"quota":"",
"quotaIntervalArr":[
500],
"relation":"and",
"type":"customized"
},
{
"analysis":"TOTAL_TIMES",
"analysisDesc":"총 횟수",
"eventName":"payment",
"eventNameDisplay":"",
"filts":[
],
"intervalType":"def",
"quota":"",
"relation":"and",
"type":"normal"
}],
"projectId":377,
"limit": 2,
"timeoutSeconds": 10,
"useCache": true,
"zoneOffset": 10
}
요청 파라미터 설명
| $$파라미터 이름 | 예시 값 | 파라미터 타입 | 필수 여부 | 파라미터 설명 |
|---|---|---|---|---|
| eventView | - | Object | 예 | 지표 공통 속성 부분 |
| eventView.endTime | 2021-10-05 23:59:59 | String | 아니요 | 종료 시간(형식: yyyy-MM-dd HH:mm:ss). 상대 시간이 비어 있을 때 유효 |
| eventView.groupBy | - | List | 아니요 | 그룹 속성. 0개 이상 지정 가능 |
| eventView.groupBy.columnDesc | 학력 | String | 아니요 | 필드 표시 이름 |
| eventView.groupBy.columnName | education | String | 예 | 필드 이름 |
| eventView.groupBy.propertyRange | String | 아니요 | 커스텀 속성 구간 | |
| eventView.groupBy.specifiedClusterDate | 2022-01-24 | String | 아니요 | 지정한 날짜에 해당하는 태그 이력 버전 |
| eventView.groupBy.tableType | user | String | 예 | 테이블 유형 열거형 값 |
| eventView.recentDay | 114-115 | String | 아니요 | 상대 시간(시작 시간, 종료 시간과 함께 모두 비워 둘 수 없음) |
| eventView.startTime | 2021-10-04 00:00:00 | String | 아니요 | 시작 시간(형식: yyyy-MM-dd HH:mm:ss). 상대 시간이 비어 있을 때 유효 |
| eventView.taIdMeasureVo | - | Object | 아니요 | 분석 주체 설정 |
| eventView.taIdMeasureVo.columnDesc | 유저 고유 ID | String | 아니요 | 필드 표시 이름 |
| eventView.taIdMeasureVo.columnName | #user_id | String | 예 | 필드 이름 |
| eventView.taIdMeasureVo.tableType | event | String | 예 | 테이블 유형 열거형 값 |
| eventView.timeParticleSize | day | String | 예 | 분석 시간 단위
|
| events | - | List | 예 | 이벤트 지표 목록 |
| events.analysis | TOTAL_TIMES | String | 아니요 | 분석 관점. 자세한 내용은 분포 집계 유형 열거형 값 참고 |
| events.analysisDesc | 총 횟수 | String | 아니요 | 분석 관점 설명(표시 이름) |
| events.customEvent | activity_attend.TIMES | String | 아니요 | 수식 표현식. 분석 항목 또는 수치 상수의 사칙연산으로 구성됩니다. 분석 항목은 eventName.columnName.analysis 또는 eventName.analysis 두 가지 형식입니다. 수식에 분석 지표가 포함된 경우 고정 접두사+지표 이름 방식을 사용합니다. 예: $metric.metricName/eventName.columnName.analysis 또는 $metric.metricName1/$metric.metricName2 |
| events.customFilters | [] | List | 아니요 | 수식 표현식 필터 항목 목록 |
| events.eventName | login | String | 예 | 지표 이벤트 이름. anyEvent로 임의의 이벤트를 나타낼 수 있음 |
| events.eventNameDisplay | String | 아니요 | 커스텀 지표 표시 이름 | |
| events.filts | - | List | 아니요 | 조건 필터 목록 |
| events.filts.columnDesc | 도시 | String | 아니요 | 필드 표시 이름 |
| events.filts.columnName | city | String | 예 | 필드 이름 |
| events.filts.comparator | equal | String | 예 | 참고: 모델 조회 API의 필터 표현식 |
| events.filts.filterType | SIMPLE | String | 아니요 | 필터 모드. SIMPLE: 단순, COMPOUND: 복합 |
| events.filts.ftv | ["베이징시"] | List | 아니요 | 속성 비교 경계에 사용하는 리터럴 상수 |
| events.filts.specifiedClusterDate | 2022-01-27 | String | 아니요 | 지정한 날짜에 해당하는 태그 이력 버전 |
| events.filts.tableType | user | String | 예 | 테이블 유형 열거형 값 |
| events.filts.timeUnit | String | 아니요 | 필터 시간 단위 | |
| events.intervalType | user_defined | String | 아니요 | 구간 간격 유형
|
| events.quota | String | 아니요 | 지표 속성 | |
| events.quotaIntervalArr | [500] | List | 아니요 | 커스텀 지표 구간 |
| events.relation | and | String | 아니요 | 논리 관계. and: 논리곱, or: 논리합 |
| events.type | normal | String | 예 | 지표 유형:
|
| projectId | 0 | Integer | 예 | 프로젝트 ID |
| limit | 2 | Integer | 아니요 | 분석 대상별 그룹 수 상한. 선택 파라미터이며 기본값은 1000, 최댓값은 10000 |
| timeoutSeconds | 10 | Integer | 아니요 | 요청 시간 초과 파라미터, 시간이 초과되면 쿼리 작업을 취소합니다 |
| useCache | true | Boolean | 예 | true이면 캐시 사용 |
| zoneOffset | 10 | Integer | 아니요 | 시간대 |
성공 응답 예시
{
"data": {
"distribution_interval": [
",500",
"500,"
],
"result_generate_time": "2022-01-27 11:25:44",
"x": [
"2021-10-04",
"2021-10-05"
],
"y": {
"2021-10-04": [
{
"groupCols": [
"전체",
"전체"
],
"isTotal": 1,
"meanwhileValues": [
"28249",
"-"
],
"totalMeanwhileValue": "28249",
"totalUserNum": 1722,
"values": [
1722,
0
]
},
{
"groupCols": [
"기타",
"베이징시"
],
"isTotal": 0,
"meanwhileValues": [
"3842",
"-"
],
"totalMeanwhileValue": "3842",
"totalUserNum": 235,
"values": [
235,
0
]
},
{
"groupCols": [
"전문대",
"베이징시"
],
"isTotal": 0,
"meanwhileValues": [
"2421",
"-"
],
"totalMeanwhileValue": "2421",
"totalUserNum": 154,
"values": [
154,
0
]
},
{
"groupCols": [
"기타",
"상하이시"
],
"isTotal": 0,
"meanwhileValues": [
"2518",
"-"
],
"totalMeanwhileValue": "2518",
"totalUserNum": 151,
"values": [
151,
0
]
},
{
"groupCols": [
"기타",
"선전시"
],
"isTotal": 0,
"meanwhileValues": [
"2355",
"-"
],
"totalMeanwhileValue": "2355",
"totalUserNum": 142,
"values": [
142,
0
]
},
{
"groupCols": [
"기타",
"광저우시"
],
"isTotal": 0,
"meanwhileValues": [
"1906",
"-"
],
"totalMeanwhileValue": "1906",
"totalUserNum": 116,
"values": [
116,
0
]
},
{
"groupCols": [
"전문대",
"선전시"
],
"isTotal": 0,
"meanwhileValues": [
"1738",
"-"
],
"totalMeanwhileValue": "1738",
"totalUserNum": 107,
"values": [
107,
0
]
},
{
"groupCols": [
"학사",
"베이징시"
],
"isTotal": 0,
"meanwhileValues": [
"1720",
"-"
],
"totalMeanwhileValue": "1720",
"totalUserNum": 106,
"values": [
106,
0
]
},
{
"groupCols": [
"전문대",
"상하이시"
],
"isTotal": 0,
"meanwhileValues": [
"1658",
"-"
],
"totalMeanwhileValue": "1658",
"totalUserNum": 101,
"values": [
101,
0
]
},
{
"groupCols": [
"학사",
"상하이시"
],
"isTotal": 0,
"meanwhileValues": [
"1595",
"-"
],
"totalMeanwhileValue": "1595",
"totalUserNum": 96,
"values": [
96,
0
]
},
{
"groupCols": [
"석사",
"베이징시"
],
"isTotal": 0,
"meanwhileValues": [
"1315",
"-"
],
"totalMeanwhileValue": "1315",
"totalUserNum": 78,
"values": [
78,
0
]
},
{
"groupCols": [
"학사",
"선전시"
],
"isTotal": 0,
"meanwhileValues": [
"1276",
"-"
],
"totalMeanwhileValue": "1276",
"totalUserNum": 75,
"values": [
75,
0
]
},
{
"groupCols": [
"전문대",
"광저우시"
],
"isTotal": 0,
"meanwhileValues": [
"1207",
"-"
],
"totalMeanwhileValue": "1207",
"totalUserNum": 75,
"values": [
75,
0
]
},
{
"groupCols": [
"석사",
"상하이시"
],
"isTotal": 0,
"meanwhileValues": [
"1032",
"-"
],
"totalMeanwhileValue": "1032",
"totalUserNum": 63,
"values": [
63,
0
]
},
{
"groupCols": [
"학사",
"광저우시"
],
"isTotal": 0,
"meanwhileValues": [
"796",
"-"
],
"totalMeanwhileValue": "796",
"totalUserNum": 49,
"values": [
49,
0
]
},
{
"groupCols": [
"석사",
"선전시"
],
"isTotal": 0,
"meanwhileValues": [
"678",
"-"
],
"totalMeanwhileValue": "678",
"totalUserNum": 42,
"values": [
42,
0
]
},
{
"groupCols": [
"석사",
"광저우시"
],
"isTotal": 0,
"meanwhileValues": [
"674",
"-"
],
"totalMeanwhileValue": "674",
"totalUserNum": 38,
"values": [
38,
0
]
},
{
"groupCols": [
"박사",
"베이징시"
],
"isTotal": 0,
"meanwhileValues": [
"514",
"-"
],
"totalMeanwhileValue": "514",
"totalUserNum": 33,
"values": [
33,
0
]
},
{
"groupCols": [
"박사",
"선전시"
],
"isTotal": 0,
"meanwhileValues": [
"361",
"-"
],
"totalMeanwhileValue": "361",
"totalUserNum": 21,
"values": [
21,
0
]
},
{
"groupCols": [
"박사",
"광저우시"
],
"isTotal": 0,
"meanwhileValues": [
"327",
"-"
],
"totalMeanwhileValue": "327",
"totalUserNum": 20,
"values": [
20,
0
]
},
{
"groupCols": [
"박사",
"상하이시"
],
"isTotal": 0,
"meanwhileValues": [
"316",
"-"
],
"totalMeanwhileValue": "316",
"totalUserNum": 20,
"values": [
20,
0
]
}
],
"2021-10-05": [
{
"groupCols": [
"전체",
"전체"
],
"isTotal": 1,
"meanwhileValues": [
"24907",
"-"
],
"totalMeanwhileValue": "24907",
"totalUserNum": 1503,
"values": [
1503,
0
]
},
{
"groupCols": [
"기타",
"베이징시"
],
"isTotal": 0,
"meanwhileValues": [
"3535",
"-"
],
"totalMeanwhileValue": "3535",
"totalUserNum": 221,
"values": [
221,
0
]
},
{
"groupCols": [
"기타",
"상하이시"
],
"isTotal": 0,
"meanwhileValues": [
"2833",
"-"
],
"totalMeanwhileValue": "2833",
"totalUserNum": 162,
"values": [
162,
0
]
},
{
"groupCols": [
"전문대",
"베이징시"
],
"isTotal": 0,
"meanwhileValues": [
"2183",
"-"
],
"totalMeanwhileValue": "2183",
"totalUserNum": 130,
"values": [
130,
0
]
},
{
"groupCols": [
"기타",
"광저우시"
],
"isTotal": 0,
"meanwhileValues": [
"1946",
"-"
],
"totalMeanwhileValue": "1946",
"totalUserNum": 116,
"values": [
116,
0
]
},
{
"groupCols": [
"기타",
"선전시"
],
"isTotal": 0,
"meanwhileValues": [
"1743",
"-"
],
"totalMeanwhileValue": "1743",
"totalUserNum": 109,
"values": [
109,
0
]
},
{
"groupCols": [
"학사",
"베이징시"
],
"isTotal": 0,
"meanwhileValues": [
"1753",
"-"
],
"totalMeanwhileValue": "1753",
"totalUserNum": 107,
"values": [
107,
0
]
},
{
"groupCols": [
"전문대",
"상하이시"
],
"isTotal": 0,
"meanwhileValues": [
"1606",
"-"
],
"totalMeanwhileValue": "1606",
"totalUserNum": 92,
"values": [
92,
0
]
},
{
"groupCols": [
"학사",
"상하이시"
],
"isTotal": 0,
"meanwhileValues": [
"1421",
"-"
],
"totalMeanwhileValue": "1421",
"totalUserNum": 81,
"values": [
81,
0
]
},
{
"groupCols": [
"학사",
"선전시"
],
"isTotal": 0,
"meanwhileValues": [
"1093",
"-"
],
"totalMeanwhileValue": "1093",
"totalUserNum": 68,
"values": [
68,
0
]
},
{
"groupCols": [
"석사",
"베이징시"
],
"isTotal": 0,
"meanwhileValues": [
"1037",
"-"
],
"totalMeanwhileValue": "1037",
"totalUserNum": 65,
"values": [
65,
0
]
},
{
"groupCols": [
"전문대",
"광저우시"
],
"isTotal": 0,
"meanwhileValues": [
"947",
"-"
],
"totalMeanwhileValue": "947",
"totalUserNum": 59,
"values": [
59,
0
]
},
{
"groupCols": [
"전문대",
"선전시"
],
"isTotal": 0,
"meanwhileValues": [
"963",
"-"
],
"totalMeanwhileValue": "963",
"totalUserNum": 58,
"values": [
58,
0
]
},
{
"groupCols": [
"석사",
"상하이시"
],
"isTotal": 0,
"meanwhileValues": [
"698",
"-"
],
"totalMeanwhileValue": "698",
"totalUserNum": 42,
"values": [
42,
0
]
},
{
"groupCols": [
"학사",
"광저우시"
],
"isTotal": 0,
"meanwhileValues": [
"608",
"-"
],
"totalMeanwhileValue": "608",
"totalUserNum": 39,
"values": [
39,
0
]
},
{
"groupCols": [
"석사",
"선전시"
],
"isTotal": 0,
"meanwhileValues": [
"560",
"-"
],
"totalMeanwhileValue": "560",
"totalUserNum": 37,
"values": [
37,
0
]
},
{
"groupCols": [
"석사",
"광저우시"
],
"isTotal": 0,
"meanwhileValues": [
"553",
"-"
],
"totalMeanwhileValue": "553",
"totalUserNum": 31,
"values": [
31,
0
]
},
{
"groupCols": [
"박사",
"베이징시"
],
"isTotal": 0,
"meanwhileValues": [
"478",
"-"
],
"totalMeanwhileValue": "478",
"totalUserNum": 29,
"values": [
29,
0
]
},
{
"groupCols": [
"박사",
"광저우시"
],
"isTotal": 0,
"meanwhileValues": [
"353",
"-"
],
"totalMeanwhileValue": "353",
"totalUserNum": 22,
"values": [
22,
0
]
},
{
"groupCols": [
"박사",
"상하이시"
],
"isTotal": 0,
"meanwhileValues": [
"339",
"-"
],
"totalMeanwhileValue": "339",
"totalUserNum": 19,
"values": [
19,
0
]
},
{
"groupCols": [
"박사",
"선전시"
],
"isTotal": 0,
"meanwhileValues": [
"258",
"-"
],
"totalMeanwhileValue": "258",
"totalUserNum": 16,
"values": [
16,
0
]
}
]
}
},
"return_code": 0,
"return_message": "success"
}
응답 파라미터 설명
| $$파라미터 이름 | 예시 값 | 파라미터 타입 | 파라미터 설명 |
|---|---|---|---|
| return_code | 0 | Integer | 반환 코드 |
| return_message | success | String | 반환 정보 |
| data | - | Object | 반환 결과 |
| data. distribution_interval | [",500","500,"] | List | 분포 간격 |
| data.result_generate_time | 2022-01-27 11:25:44 | String | 결과 생성 시간 |
| data.x | ["2021-10-04"] | List | x축 정보 |
| data.y | - | List | y축 정보 |
| data.y.{dateMap} | "2021-10-04": {dateData} | Map | 날짜 단위를 key로 하는 map |
| data.y.{dateMap}.{key} | 2021-10-04 | String | 날짜 문자열 |
| data.y.{dateMap}.{value} | - | List | 표 데이터 |
| data.y.{dateMap}.{value}.isTotal | false | Boolean | 합계 여부 |
| data.y.{dateMap}.{value}.values | - | List | 주 집계 값 |
| data.y.{dateMap}.{value}.meanwhileValues | - | List | 함께 보기 집계 값 |
오류 응답 예시
{
"return_code": -1008,
"return_message": "파라미터(token)가 비어 있습니다"
}
| 파라미터 이름 | 예시 값 | 파라미터 타입 | 파라미터 설명 |
|---|---|---|---|
| return_code | -1008 | Integer | 반환 코드 |
| return_message | 파라미터(token)가 비어 있습니다 | String | 반환 정보 |
2. 분포 분석 전체 다운로드
인터페이스 URL
/open/streaming-download/distribution-analyze?token=xxx
요청 방식
POST
Content-Type
application/json
요청 Query 파라미터
| 파라미터 이름 | 예시 값 | 파라미터 타입 | 필수 여부 | 파라미터 설명 |
|---|---|---|---|---|
| token | xxx | String | 예 | 조회 키 |
요청 Body 파라미터
{
"eventView": {
"endTime": "2022-03-07 17:36:54",
"groupBy": [
{
"columnDesc": "channel",
"columnName": "channel",
"propertyRange": "",
"specifiedClusterDate": "2022-03-08",
"tableType": "event"
}
],
"recentDay": "1-7",
"startTime": "2022-03-01 17:36:54",
"taIdMeasureVo": {
"columnDesc": "유저 고유 ID",
"columnName": "#user_id",
"tableType": "event"
},
"timeParticleSize": "day"
},
"events": [
{
"analysis": "TIMES",
"analysisDesc": "횟수",
"eventName": "LogOut",
"eventNameDisplay": "",
"filts": [],
"intervalType": "def",
"quota": "",
"relation": "and",
"type": "normal"
}
],
"projectId": 319,
"interval": "['1']",
"zoneOffset": 10
}
요청 파라미터 설명
| $$파라미터 이름 | 예시 값 | 파라미터 타입 | 필수 여부 | 파라미터 설명 |
|---|---|---|---|---|
| eventView | - | Object | 예 | 분포 분석 조회 API와 파라미터 내용이 같음 |
| events | - | List | 예 | 분포 분석 조회 API와 파라미터 내용이 같음 |
| projectId | 0 | Integer | 예 | 프로젝트 ID |
| interval | ['1','2'] | String | 예 | 전체 다운로드 간격 |
| meanwhileOnly | Boolean | 아니요 | 함께 보기 데이터만 다운로드할지 여부. default: false | |
| zoneOffset | 10 | Integer | 아니요 | 시간대 |
팁
요청 파라미터는 AE 시스템의 분포 분석 페이지에서 바로 내보낸 뒤 interval 등 다른 파라미터를 추가하면 됩니다. 이 파라미터는 전체 다운로드 페이지에서 캡처할 수 있습니다.
응답
AE 시스템의 이벤트 분석 전체 다운로드와 동일
3. 분포 분석 유저 목록
인터페이스 URL
/open/distribution-user-list?token=xxx
요청 방식
POST
Content-Type
application/json
요청 Query 파라미터
| 파라미터 이름 | 예시 값 | 파라미터 타입 | 필수 여부 | 파라미터 설명 |
|---|---|---|---|---|
| token | xxx | String | 예 | 조회 키 |
요청 Body 파라미터
{
"projectId": 0,
"eventView": {
"startTime": "2019-10-28 00:00:00",
"endTime": "2019-11-26 00:00:00",
"recentDay": "D31",
"timeParticleSize": "week",
"groupBy": [
{
"columnName": "#province",
"tableType": "event"
}
]
},
"events": [{
"analysis": "TIMES",
"eventName": "consume_item",
"intervalType": "def",
"quota": "",
"relation": "and",
"filts": [
{
"columnName": "#os",
"comparator": "equal",
"ftv": [
"android"
],
"tableType": "event"
}
]
}],
"interval": "10,20",
"sliceDate": "2019-11-18",
"sliceGroupVal": ["베이징시"],
"timeoutSeconds": 10,
"zoneOffset": 10
}
요청 파라미터 설명
| $$파라미터 이름 | 예시 값 | 파라미터 타입 | 필수 여부 | 파라미터 설명 |
|---|---|---|---|---|
| projectId | 0 | String | 예 | 파라미터 설명 |
| eventView | - | Object | 예 | 분포 분석 조회 API와 파라미터 내용이 같음 |
| events | List | 예 | 분포 분석 조회 API와 파라미터 내용이 같음 | |
| interval | 10,20 | String | 아니요 | 드릴다운할 구간 |
| groupBit | 0 | Integer | 아니요 | 합계 열 드릴다운 여부. 1은 합계 열, 그 외는 합계 외 열 |
| sliceDate | "2019-11-18" | String | 아니요 | 드릴다운할 날짜 |
| sliceGroupVal | ["베이징시"] | List | 예 | 드릴다운할 그룹 |
| timeoutSeconds | 10 | Integer | 아니요 | 요청 시간 초과 파라미터, 시간이 초과되면 쿼리 작업을 취소합니다 |
| zoneOffset | 10 | Integer | 아니요 | 시간대 |
성공 응답 예시
{
"data": {
"datalist": [
{
"#account_id": "h7784497",
"#distinct_id": "h14456917",
"user_level": 13,
"register_time": "2019-11-24 21:52:38",
"diamond_num": 1201,
"latest_login_time": "2019-11-24 23:35:49",
"channel": "Baidu Mobile Assistant",
"#user_id": 3336217
},
{
"#account_id": "h6201359",
"#distinct_id": "h11516759",
"user_level": 68,
"register_time": "2019-06-23 09:25:18",
"diamond_num": 1686,
"first_recharge_time": "2019-06-23 09:25:38",
"latest_login_time": "2019-11-18 23:01:49",
"channel": "Huawei AppGallery",
"#user_id": 2657759
},
{
"#account_id": "g4102426",
"#distinct_id": "g7618786",
"user_level": 47,
"register_time": "2019-07-29 13:58:23",
"diamond_num": 1,
"first_recharge_time": "2019-07-29 15:42:20",
"latest_login_time": "2019-11-24 16:04:03",
"channel": "Tencent MyApp",
"#user_id": 1758186
}
],
"columMeta": {
"#account_id": "계정 ID",
"#distinct_id": "게스트 ID",
"user_level": "유저 레벨",
"register_time": "가입 시간",
"diamond_num": "현재 보유 다이아몬드 수",
"first_recharge_time": "첫 충전 시간",
"latest_login_time": "마지막 로그인 시간",
"channel": "채널"
}
},
"return_code": 0,
"return_message": "success"
}
응답 파라미터 설명
| $$파라미터 이름 | 예시 값 | 파라미터 타입 | 파라미터 설명 |
|---|---|---|---|
| return_code | 0 | Integer | 반환 코드 |
| return_message | success | String | 반환 정보 |
| data | - | Object | 반환 결과 |
| data.datalist | - | List<Map> | 유저 정보 |
| data.columMeta | - | Map | 필드 의미 매핑 |
오류 응답 예시
{
"return_code": -1008,
"return_message": "파라미터(token)가 비어 있습니다"
}
| 파라미터 이름 | 예시 값 | 파라미터 타입 | 파라미터 설명 |
|---|---|---|---|
| return_code | -1008 | Integer | 반환 코드 |
| return_message | 파라미터(token)가 비어 있습니다 | String | 반환 정보 |
4. 분포 분석 유저 목록 다운로드
인터페이스 URL
/open/streaming-download/distribution-user-list?token=xxx
요청 방식
POST
Content-Type
application/json
요청 Query 파라미터
| 파라미터 이름 | 예시 값 | 파라미터 타입 | 필수 여부 | 파라미터 설명 |
|---|---|---|---|---|
| token | xxx | String | 예 | 조회 키 |
요청 Body 파라미터
{
"eventView": {
"endTime": "2022-03-07 17:36:54",
"groupBy": [
{
"columnDesc": "channel",
"columnName": "channel",
"propertyRange": "",
"specifiedClusterDate": "2022-03-08",
"tableType": "event"
}
],
"recentDay": "1-7",
"startTime": "2022-03-01 17:36:54",
"taIdMeasureVo": {
"columnDesc": "유저 고유 ID",
"columnName": "#user_id",
"tableType": "event"
},
"timeParticleSize": "day"
},
"events": [
{
"analysis": "TIMES",
"analysisDesc": "횟수",
"eventName": "LogOut",
"eventNameDisplay": "",
"filts": [],
"intervalType": "def",
"quota": "",
"relation": "and",
"type": "normal"
}
],
"projectId": 319,
"groupBit": 0,
"sliceDate": "2022-03-01",
"sliceGroupVal": [
"VIVO App Store"
],
"selectedColumns": [
"#account_id",
"#distinct_id"
],
"zoneOffset": 10
}
요청 파라미터 설명
| $$파라미터 이름 | 예시 값 | 파라미터 타입 | 필수 여부 | 파라미터 설명 |
|---|---|---|---|---|
| projectId | 0 | String | 예 | 파라미터 설명 |
| eventView | - | Object | 예 | 분포 분석 조회 API와 파라미터 내용이 같음 |
| events | - | List | 예 | 분포 분석 조회 API와 파라미터 내용이 같음 |
| interval | 10,20 | String | 예 | 드릴다운할 구간 |
| groupBit | 0 | Integer | 아니요 | 합계 열 드릴다운 여부. 1은 합계 열, 그 외는 합계 외 열 |
| sliceDate | "2019-11-18" | String | 아니요 | 드릴다운할 날짜 |
| sliceGroupVal | ["베이징시"] | List | 예 | 드릴다운할 그룹 |
| selectedColumns | ["#account_id"] | array | 아니요 | 다운로드할 열 |
| zoneOffset | 10 | Integer | 아니요 | 시간대 |
응답
AE 시스템의 분포 분석 유저 목록 다운로드와 동일
분포 분석 공통 열거형
분포 집계 유형 열거형 값
| 값 | 설명 | 속성 필요 여부 |
|---|---|---|
| TIMES | 횟수 | 아니요 |
| NUMBER_OF_DAYS | 일수 | 아니요 |
| NUMBER_OF_HOURS | 시간 수 | 아니요 |
| SUM | 수치 합계 | 예 |
| AVG | 수치 평균값 | 예 |
| MAX | 수치 최댓값 | 예 |
| MIN | 수치 최솟값 | 예 |
| DISTINCT | 고유값 수 | 예 |
| TRUE | 참 값 수 | 예 |
| FALSE | 거짓 값 수 | 예 |
| IS_NOT_EMPTY | Not Null 값 수 | 예 |
| IS_EMPTY | Null 값 수 | 예 |
| ARRAY_DISTINCT | 리스트 고유값 수 | 예 |
| ARRAY_SET_DISTINCT | 집합 고유값 수 | 예 |
| ARRAY_ITEM_DISTINCT | 요소 고유값 수 | 예 |
| MEDIAN | 중앙값 | 예 |
이 문서가 도움이 되었나요?