본문으로 건너뛰기

속성 분석 모델 API

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

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

사용 시나리오는 사용 설명서의 속성 분석을 참고하십시오.

1. 유저 속성 분석 조회​

인터페이스 URL

/open/user-prop-analyze?token=xxx

요청 방식

POST

Content-Type

application/json

요청 Query 파라미터

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

요청 Body 파라미터​

{
  "eventView": {
    "userCrowds": [
      {
        "crowdName": "여성",
        "filts": [
          {
            "columnDesc": "성별",
            "columnName": "gender",
            "comparator": "equal",
            "filterType": "SIMPLE",
            "ftv": [
              "여성"],
            "specifiedClusterDate": "2022-01-27",
            "tableType": "user",
            "timeUnit": ""
          }],
        "relation": "and"
      },
      {
        "crowdName": "남성",
        "filts": [
          {
            "columnDesc": "성별",
            "columnName": "gender",
            "comparator": "equal",
            "filterType": "SIMPLE",
            "ftv": [
              "남성"],
            "specifiedClusterDate": "2022-01-27",
            "tableType": "user",
            "timeUnit": ""
          }],
        "relation": "and"
      },
      {
        "crowdName": "성별 알 수 없음",
        "filts": [
          {
            "columnDesc": "성별",
            "columnName": "gender",
            "comparator": "equal",
            "filterType": "SIMPLE",
            "ftv": [
              "알 수 없음"],
            "specifiedClusterDate": "2022-01-27",
            "tableType": "user",
            "timeUnit": ""
          }],
        "relation": "and"
      }]
  },
  "events": [
    {
      "analysis": "SUM",
      "analysisDesc": "합계",
      "eventNameDisplay": "잔액 합계",
      "filts": [
        {
          "columnDesc": "잔액",
          "columnName": "accountbalance",
          "comparator": "greater",
          "filterType": "SIMPLE",
          "ftv": [
            "1"],
          "specifiedClusterDate": "2022-01-27",
          "tableType": "user",
          "timeUnit": ""
        }],
      "quota": "accountbalance",
      "relation": "and",
      "tableType": "user"
    }],
  "projectId": 377,
  "limit": 10,
  "timeoutSeconds": 10,
  "useCache": true
}

요청 파라미터 설명​

$$파라미터 이름예시 값파라미터 타입필수 여부파라미터 설명
eventView-Object예그룹 속성
eventView.userCrowds-Object아니요유저 그룹
eventView.userCrowds.crowdName여성String예유저 그룹 이름
eventView.userCrowds.filts-List예필터 객체
eventView.userCrowds.filts.columnDesc성별String아니요필드 표시 이름
eventView.userCrowds.filts.columnNamegenderString예필드 이름
eventView.userCrowds.filts.comparatorequalString예참고: 모델 조회 API의 필터 표현식
eventView.userCrowds.filts.filterTypeSIMPLEString아니요필터 모드. SIMPLE: 단순, COMPOUND: 복합
eventView.userCrowds.filts.ftv["여성"]List아니요속성 비교 경계에 사용하는 리터럴 상수
eventView.userCrowds.filts.specifiedClusterDate2022-01-27String아니요지정한 날짜에 해당하는 태그 이력 버전
eventView.userCrowds.filts.tableTypeuserString예테이블 타입 열거형 값
eventView.userCrowds.filts.timeUnitString아니요필터 시간 단위
eventView.userCrowds.relationandString예논리 관계. and: 논리곱, or: 논리합
events-List예이벤트 지표 목록
events.analysisSUMString예분석 관점
events.analysisDesc합계String아니요분석 관점 설명(표시 이름)
events.eventNameDisplay잔액 합계String아니요이벤트 표시 이름
events.filts-List아니요조건 목록
events.filts.columnDesc잔액String아니요필드 표시 이름
events.filts.columnNameaccountbalanceString예필드 이름
events.filts.comparatorgreaterString예참고: 모델 조회 API의 필터 표현식
events.filts.filterTypeSIMPLEString아니요필터 모드. SIMPLE: 단순, COMPOUND: 복합
events.filts.ftv["1"]List아니요속성 비교 경계에 사용하는 리터럴 상수
events.filts.specifiedClusterDate2022-01-27String아니요지정한 날짜에 해당하는 태그 이력 버전
events.filts.tableTypeuserString예테이블 타입 열거형 값
events.filts.timeUnitString아니요필터 시간 단위
events.quotaaccountbalanceString아니요논리 관계. and: 논리곱, or: 논리합
events.relationandString아니요논리 관계. and: 논리곱, or: 논리합
events.tableTypeuserString예테이블 타입 열거형 값
projectId377Integer예프로젝트 ID
limit10Integer아니요분석 대상별 그룹 수 상한. 선택 파라미터이며 기본값은 1000, 최댓값은 10000
timeoutSeconds10Integer아니요요청 시간 초과 파라미터, 시간이 초과되면 쿼리 작업을 취소합니다
useCachetrueBoolean예true이면 캐시 사용

성공 응답 예시​

{
  "data": {
    "data_list": [
      {
        "group_cols": [
          "여성"
        ],
        "values": 1140523491
      },
      {
        "group_cols": [
          "남성"
        ],
        "values": 1141720850
      },
      {
        "group_cols": [
          "성별 알 수 없음"
        ],
        "values": 227565607
      }
    ],
    "group_cols_sorted": [
      [
        "여성",
        "남성",
        "성별 알 수 없음"
      ]
    ],
    "group_num": 0,
    "result_generate_time": "2022-01-27 15:01:51",
    "unit": ""
  },
  "return_code": 0,
  "return_message": "success"
}

응답 파라미터 설명​

$$파라미터 이름예시 값파라미터 타입파라미터 설명
return_code0Integer반환 코드
return_messagesuccessString반환 정보
data-Object반환 결과
data.data_list-List데이터 리스트
data.data_list.group_cols["여성"]List그룹 또는 유저 그룹 목록
data.data_list.values1140523491Integer유저 수
data.group_cols_sorted["여성"]List전체 그룹 또는 유저 그룹의 순서 목록
data.group_num0Integer그룹 수
data.result_generate_time2022-01-27 15:01:51String결과 생성 시간
data.unitString숫자 속성 단위

오류 응답 예시

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

2. 유저 속성 분석 전체 다운로드​

인터페이스 URL

/open/streaming-download/user-prop-analyze?token=xxx

요청 방식

POST

Content-Type

application/json

요청 Query 파라미터

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

요청 Body 파라미터​

{
        "eventView": {
                "groupBy": [{
                        "columnDesc": "채널",
                        "columnName": "channel",
                        "propertyRange": "",
                        "specifiedClusterDate": "2022-03-10",
                        "tableType": "user"
                }],
                "userCrowds": []
        },
        "events": [{
                "analysis": "TRIG_USER_NUM",
                "analysisDesc": "유저 수",
                "eventNameDisplay": "",
                "filts": [{
                        "columnDesc": "계정 ID",
                        "columnName": "#account_id",
                        "comparator": "notNull",
                        "filterType": "SIMPLE",
                        "ftv": [],
                        "specifiedClusterDate": "2022-03-10",
                        "tableType": "user",
                        "timeUnit": ""
                }],
                "quota": "",
                "relation": "and",
                "tableType": "user"
        }],
        "projectId": 390
}

요청 파라미터 설명​

$$파라미터 이름예시 값파라미터 타입필수 여부파라미터 설명
eventView-Object예파라미터 내용은 유저 속성 분석 조회 API와 동일
events-List예파라미터 내용은 유저 속성 분석 조회 API와 동일
projectId377Integer예프로젝트 ID

응답​

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

3. 유저 속성 분석 유저 목록​

인터페이스 URL

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

요청 방식

POST

Content-Type

application/json

요청 Query 파라미터

파라미터 이름예시 값파라미터 타입필수 여부파라미터 설명
tokenxxxString예조회 키
projectId0Integer예프로젝트 ID

요청 Body 파라미터​

{
  "projectId": 0,
  "events": [{
    "analysis": "AVG",
    "filts": [
      {
        "columnName": "latest_login_time",
        "comparator": "relativeCurrentBetween",
        "ftv": [
          "7",
          "1"
        ],
        "tableType": "user"
      }
    ],
    "quota": "diamond_num",
    "relation": "and",
    "tableType": "user"
  }],
  "eventView": {
    "groupBy": [
      {
        "columnName": "user_level",
        "tableType": "user"
      },
      {
        "columnName": "channel",
        "tableType": "user"
      }
    ]
  },
  "sliceGroupVal": [
    "31",
    "app store"
  ],
  "timeoutSeconds": 10
}

요청 파라미터 설명​

$$파라미터 이름예시 값파라미터 타입필수 여부파라미터 설명
projectId0Integer예프로젝트 ID
events-List예파라미터 내용은 유저 속성 분석 조회 API와 동일
eventView-Object예파라미터 내용은 유저 속성 분석 조회 API와 동일
sliceGroupVal["31","app store"]List아니요드릴다운할 그룹
eventIndex0Integer예유저 그룹 비교의 유저 그룹 인덱스, 0부터 시작
timeoutSeconds10Integer아니요요청 시간 초과 파라미터, 시간이 초과되면 쿼리 작업을 취소합니다

성공 응답 예시​

{
  "data": {
    "datalist": [
      {
        "#account_id": "b6909071",
        "#distinct_id": "b12831131",
        "user_level": 31,
        "register_time": "2019-09-23 09:33:31",
        "diamond_num": 1250,
        "first_recharge_time": "2019-11-18 08:50:33",
        "latest_login_time": "2019-11-26 18:15:51",
        "channel": "app store",
        "#user_id": 2961031
      },
      {
        "#account_id": "a6013000",
        "#distinct_id": "a11167000",
        "user_level": 31,
        "register_time": "2019-09-02 19:15:08",
        "diamond_num": 72,
        "first_recharge_time": "2019-09-02 19:18:36",
        "latest_login_time": "2019-11-24 10:02:38",
        "channel": "app store",
        "#user_id": 2577000
      },
      {
        "#account_id": "j2614535",
        "#distinct_id": "j4855535",
        "user_level": 31,
        "register_time": "2019-08-24 20:40:19",
        "diamond_num": 820,
        "latest_login_time": "2019-11-21 14:16:42",
        "channel": "app store",
        "#user_id": 1120535
      }
    ],
    "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_code0Integer반환 코드
return_messagesuccessString반환 정보
data-Object반환 결과
data.datalist-List<Map>유저 정보
data.columMeta-Map필드 의미 매핑

오류 응답 예시

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

4. 속성 분석 유저 목록 다운로드​

인터페이스 URL

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

요청 방식

POST

Content-Type

application/json

요청 Query 파라미터

파라미터 이름예시 값파라미터 타입필수 여부파라미터 설명
tokenxxxString예조회 키
projectId0Integer예프로젝트 ID

요청 Body 파라미터​

{
        "eventView": {
                "endTime": "2022-03-08 16:14:02",
                "groupBy": [],
                "recentDay": "",
                "startTime": "2022-03-08 16:14:02",
                "userCrowds": [{
                        "crowdName": "그룹1",
                        "filts": [],
                        "relation": "and"
                }, {
                        "crowdName": "그룹2",
                        "filts": [],
                        "relation": "and"
                }]
        },
        "events": [{
                "analysis": "TRIG_USER_NUM",
                "analysisDesc": "유저 수",
                "eventNameDisplay": "",
                "filts": [{
                        "columnDesc": "계정 ID",
                        "columnName": "#account_id",
                        "comparator": "notNull",
                        "filterType": "SIMPLE",
                        "ftv": [],
                        "specifiedClusterDate": "2022-03-08",
                        "tableType": "user",
                        "timeUnit": ""
                }],
                "quota": "",
                "relation": "and",
                "tableType": "user"
        }],
        "projectId": 319,
        "sliceGroupVal": ["그룹2"],
        "eventIndex": 0,
        "selectedColumns": ["#account_id", "#distinct_id", "accountid"]
}

요청 파라미터 설명​

$$파라미터 이름예시 값파라미터 타입필수 여부파라미터 설명
projectId0Integer예프로젝트 ID
events-List예파라미터 내용은 유저 속성 분석 조회 API와 동일
eventView-Object예파라미터 내용은 유저 속성 분석 조회 API와 동일
sliceGroupVal["31","app store"]List아니요드릴다운할 그룹
eventIndex0Integer예유저 그룹 비교의 유저 그룹 인덱스, 0부터 시작
selectedColumns["#account_id"]array예다운로드할 열

응답​

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

5. 유저 이벤트 목록 조회​

인터페이스 URL

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

요청 방식

POST

Content-Type

application/json

요청 Query 파라미터

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

요청 Body 파라미터​

{
  "eventNames": [
    "payment",
    "level_up",
    "activity_attend",
    "draw_card",
    "register",
    "logout",
    "login",
    "gold_get",
    "gold_consume"
  ],
  "pagerHeader": {
    "pageNum": 1,
    "pageSize": 2
  },
  "projectId": 377,
  "startDateTime": ["2021-11-04 00:00:00"],
  "dateFormat": "week",
  "firstDayOfWeek": 1,
  "userId": 795687603434164226,
  "timeoutSeconds": 10,
  "useCache": true,
  "zoneOffset": 8
}

요청 파라미터 설명​

$$파라미터 이름예시 값파라미터 타입필수 여부파라미터 설명
eventNames["payment"]List예포함된 이벤트 목록
pagerHeader-Object예공통 페이지네이션 요청 헤더
pagerHeader.pageNum1Long아니요시작 페이지
pagerHeader.pageSize2Long아니요페이지당 개수
projectId377Integer예프로젝트 ID
startDateTime["2021-11-04 00:00:00"]List아니요시작 시간 목록 yyyy-MM-dd HH:mm:ss
dateFormat

week

String예

시간 차원 단위

  • day: 일별
  • week: 주별
  • month: 월별
  • total: 합계
firstDayOfWeek1Integer아니요주의 첫째 날
userId795687603434164226Long예분석 대상의 유저 ID
timeoutSeconds10Integer아니요요청 시간 초과 파라미터, 시간이 초과되면 쿼리 작업을 취소합니다
useCachetrueBoolean예true이면 캐시 사용
zoneOffset10Integer아니요시간대

성공 응답 예시​

{
  "data": {
    "columnDescMeta": {
      "network": "네트워크 타입",
      "ip": "IP",
      "browser": "브라우저",
      "browser_version": "브라우저 버전",
      "manufacturer": "제조사",
      "#lib": "SDK 타입",
      "channel": "유입 채널",
      "platform": "플랫폼",
      "serverid": "서버 ID",
      "device_type": "디바이스 타입",
      "#lib_version": "SDK 버전",
      "os_version": "OS 버전",
      "app_version": "앱 버전",
      "os": "운영 체제",
      "lib": "런타임 라이브러리",
      "level": "유저 레벨",
      "model": "기기 모델",
      "screen_height": "화면 높이",
      "carrier_name": "통신사",
      "vip_level": "VIP 레벨",
      "brand": "브랜드",
      "currency_type": "통화",
      "pay_amount": "결제 금액",
      "diamond_get_amount": "다이아몬드 획득량",
      "payment_name": "구매 패키지명",
      "is_first_pay": "첫 결제 여부",
      "#country_code": "국가/지역 코드",
      "#ip": "클라이언트 IP",
      "#city": "도시",
      "#province": "주/도",
      "#country": "국가/지역",
      "screen_width": "화면 너비",
      "device_id": "디바이스 ID",
      "#zone_offset": "시간대 오프셋"
    },
    "eventNameDescMeta": {
      "anyEvent": "임의의 이벤트",
      "activity_attend": "이벤트 참여",
      "draw_card": "뽑기 이벤트",
      "gold_consume": "골드 소모",
      "gold_get": "골드 획득",
      "level_up": "레벨업 이벤트",
      "login": "로그인",
      "logout": "유저 로그아웃",
      "payment": "결제 이벤트",
      "register": "가입"
    },
    "resultGenerateTime": "2022-01-27 15:46:08",
    "userEventSeqList": [
      {
        "event_name": "login",
        "properties": {
          "#event_time": "2021-11-04 15:59:39.179",
          "network": "WIFI",
          "ip": "27.17.30.245",
          "browser": "Safari",
          "browser_version": "Safari 11.0.3",
          "manufacturer": "Apple",
          "#lib": "easydata",
          "channel": "Baidu",
          "platform": "WeGame 플랫폼",
          "serverid": "10",
          "device_type": "desktop",
          "#lib_version": "1.0",
          "os_version": "iOS 11.4",
          "app_version": "V1.0",
          "os": "iOS",
          "lib": "JS",
          "level": "93",
          "model": "iPhone X",
          "screen_height": "681",
          "carrier_name": "China Unicom",
          "vip_level": "1",
          "brand": "Apple",
          "#country_code": "",
          "#ip": "localhost",
          "#city": "알 수 없음",
          "#province": "알 수 없음",
          "#country": "알 수 없음",
          "screen_width": "360",
          "device_id": "47BjM",
          "#zone_offset": "-5"
        },
        "time": "2021-11-04 15:59:39.179"
      },
      {
        "event_name": "payment",
        "properties": {
          "#event_time": "2021-11-04 15:59:46.179",
          "network": "WIFI",
          "ip": "27.17.30.245",
          "browser": "Safari",
          "browser_version": "Safari 11.0.3",
          "manufacturer": "Apple",
          "#lib": "easydata",
          "channel": "Baidu",
          "platform": "WeGame 플랫폼",
          "serverid": "10",
          "device_type": "desktop",
          "#lib_version": "1.0",
          "os_version": "iOS 11.4",
          "app_version": "V1.0",
          "os": "iOS",
          "lib": "JS",
          "level": "93",
          "model": "iPhone X",
          "screen_height": "681",
          "carrier_name": "China Unicom",
          "vip_level": "1",
          "brand": "Apple",
          "currency_type": "포인트",
          "pay_amount": "536",
          "diamond_get_amount": "7485",
          "payment_name": "지존 패키지",
          "is_first_pay": false,
          "#country_code": "",
          "#ip": "localhost",
          "#city": "알 수 없음",
          "#province": "알 수 없음",
          "#country": "알 수 없음",
          "screen_width": "360",
          "device_id": "47BjM",
          "#zone_offset": "-5"
        },
        "time": "2021-11-04 15:59:46.179"
      }
    ]
  },
  "return_code": 0,
  "return_message": "success"
}

응답 파라미터 설명​

$$파라미터 이름예시 값파라미터 타입파라미터 설명
return_code0Integer반환 코드
return_messagesuccessString반환 정보
data-Object반환 결과
data.columnDescMeta-Map속성 이름 매핑
data.eventNameDescMeta-Map이벤트 이름
data.resultGenerateTime2022-01-27 15:46:08String결과 생성 시간
data.userEventSeqList-List유저 시퀀스 목록
data.userEventSeqList.event_nameloginString이벤트 이름
data.userEventSeqList.properties-Map이벤트 속성 상세 정보
data.userEventSeqList.time2021-11-04 15:59:46.179String시간

오류 응답 예시

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

유저 속성 분석 공통 열거형​

유저 속성 분석 집계 타입 열거형 값​

값설명속성 필요 여부
TRIG_USER_NUM유니크 유저 수아니요
SUM수치 합계예
AVG수치 평균값예
MAX수치 최댓값예
MIN수치 최솟값예
DISTINCT고유값 수예
TRUE참 값 수예
FALSE거짓 값 수예
IS_NOT_EMPTYNot Null 값 수예
IS_EMPTYNull 값 수예
ARRAY_DISTINCT리스트 고유값 수예
ARRAY_SET_DISTINCT집합 고유값 수예
ARRAY_ITEM_DISTINCT요소 고유값 수예
MEDIAN중앙값예
PERCENTILE분위수예
이 문서가 도움이 되었나요?
이 페이지의 내용