유저 속성

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

1. 기능 소개

기존 상황

• 기존 데이터 모델에서는 데이터가 전송되면 유저 속성, 이벤트 속성 등의 리소스가 바로 생성되었고, 이를 리포트/대시보드 등의 리소스 구성에 사용했습니다
• 다중 소스 데이터 연동을 지원할 수 없으며, 데이터를 전송하기 전에는 분석 시나리오용 리소스를 구축할 수 없습니다

원본 이미지 보기

기존 데이터 모델: 전송된 데이터를 분석 기능에 바로 사용

슈퍼 레이어 모델

• 슈퍼 레이어 모델을 추가하면 소스 데이터와 분석 기능 사이에 격리 레이어가 생겨, 둘 사이의 강한 의존 관계가 해소됩니다
• 여러 소스의 데이터 연동을 지원하며, 슈퍼 레이어 객체를 통해 연결 관계를 설정합니다
• 데이터가 실제로 생성되기 전에도 슈퍼 레이어 객체가 자리 표시 형태로 존재할 수 있어, 리포트와 대시보드 구성 작업을 동시에 진행하기 쉽습니다
• 프로젝트를 마이그레이션해야 할 때 분석 레이어의 리소스 콘텐츠를 슈퍼 레이어 기반으로 마이그레이션할 수 있으며, 마이그레이션 후 발생할 수 있는 비정상 연결 관계를 유연하게 조정할 수 있습니다

원본 이미지 보기

슈퍼 레이어 모델: 슈퍼 레이어 객체를 통해 소스 데이터에 연결한 후 분석에 사용

주의

유저 속성은 이벤트 속성과 달리, 유저 속성마다 데이터 소스(전송 또는 크로스 소스)를 1개만 설정할 수 있습니다

크로스 소스 유저 속성 설정은 데이터 관리자가 활성화해야 합니다. 프로젝트 시작 단계에서 협의하여 확인한 후 관련 작업을 실행하십시오

현재 버전에서는 크로스 소스 유저 속성을 크로스 소스 설정(엔티티 테이블) 에서 설정합니다

주의

슈퍼 레이어 모델을 기반으로 "유저 속성"과 그 출처인 "전송 유저 속성" 또는 "크로스 소스 유저 속성"을 구분하여 설명하기 위해, 이 문서에서는 "유저 속성"을 "슈퍼 레이어 유저 속성"으로 강조하고, "전송 유저 속성"과 "크로스 소스 유저 속성"을 통틀어 "소스 유저 속성"이라고 합니다

분석 시 사용

• 목록 선택: 기존 시스템의 유저 속성 목록은 모두 "전송 유저 속성"이었으나, 슈퍼 레이어 모델로 업그레이드한 후에는 유저 속성 목록이 모두 "슈퍼 레이어 유저 속성"으로 바뀌어 지원하는 데이터 소스가 확장되었으며, 사용 경험은 이전과 동일하게 유지됩니다
• 모델 조회: 리포트를 생성하면 AE 시스템이 슈퍼 레이어 유저 속성의 소스에 따라 전송된 데이터 또는 크로스 소스 데이터를 자동으로 식별하고 읽어 계산하며, 사용 경험은 이전과 동일합니다
• SQL IDE: SQL IDE는 커스텀 수준이 매우 높은 시나리오이므로, 조회 시 소스에 맞춰 실제 from xxx 문을 작성하고 원본 테이블의 데이터를 기반으로 조회 SQL 문을 작성해야 합니다

2. 사용 설명

자동 감지 로직

• 새 유저 속성 데이터가 전송되면 AE 시스템이 자동으로 감지하여 같은 이름의 슈퍼 레이어 유저 속성을 생성하고 연결합니다

• 유저가 "크로스 소스 설정(엔티티 테이블)"을 생성하면 AE 시스템은 마찬가지로 설정의 유저 속성을 읽은 다음 속성의 연결 설정을 자동으로 추가합니다

• 자동 생성/연결 시의 로직

  • 같은 이름의 슈퍼 레이어 유저 속성이 없으면 시스템이 슈퍼 레이어 유저 속성을 자동으로 생성하고 연관합니다
  • 같은 이름과 같은 타입이면서 연결되지 않은 슈퍼 레이어 유저 속성이 이미 있으면 시스템이 해당 슈퍼 레이어 유저 속성에 연관 정보를 설정합니다
  • 같은 이름이지만 타입이 다른 슈퍼 레이어 유저 속성이 이미 있으면 유저가 유저 속성과 연결 관계를 수동으로 확인해야 합니다

목록 페이지

목록 관리 페이지 설명

목록 페이지 각 부분의 기능은 다음과 같으며, 번호는 위 그림의 표시와 대응합니다.

1. 표시 상태: 유저 속성의 표시 상태를 필터링합니다.
2. 속성 이름, 표시 이름, 비고: 유저 속성의 이름, 표시 이름, 비고입니다.
3. 소스 유저 속성 관리: 소스 유저 속성 관리 페이지로 이동하여 소스 유저 속성을 확인하고 관리합니다.
4. 표시 이름: 유저 속성의 표시 이름을 일괄 설정합니다.
5. + 유저 속성: 새 슈퍼 레이어 유저 속성 또는 가상 유저 속성을 생성합니다.
6. 검색창: 유저 속성 이름, 표시 이름, 비고를 검색할 수 있습니다.
7. 행 작업: 현재 슈퍼 레이어 유저 속성을 편집하거나 현재 슈퍼 레이어 유저 속성의 연결 관계를 설정합니다.
8. 더 보기 메뉴: 숨기기는 표시 상태를 전환하고, 복사본 만들기는 속성의 복사본을 만들며, 차원 테이블 추가는 속성에 차원 테이블을 추가하고, 삭제는 현재 슈퍼 레이어 유저 속성을 삭제합니다. 객체/객체 그룹 타입의 속성에는 하위 속성 생성도 있습니다.

• 필드 설명은 다음 표와 같습니다

필드 이름	설명
유저 속성 이름	영문자로 시작하며 영문자, 숫자, 밑줄 포함 가능. 최대 80자
유저 속성 표시 이름	중국어 및 영어 지원. 최대 80자
비고	중국어 및 영어 지원. 최대 200자
속성 타입	유저 속성은 분석 모델에 사용되는 기본 속성이며, 다른 기능과 결합하여 가상 속성, 차원 속성, 통화 속성을 생성할 수 있음
데이터 타입	예: 텍스트/숫자/불리언/시간/리스트/객체/객체 그룹 등
실시간 사용 가능 상태	트리거형 운영의 트리거 규칙 및 실시간 알림에 사용할 수 있는지 여부
연결 상태	현재 유저 속성이 소스 데이터와 연결되었는지 여부
데이터 상태	데이터 연결의 사용 가능 상태가 정상인지 여부
작업	편집 = 유저 속성의 기본 정보 편집 복사본 만들기 = 현재 유저 속성을 기반으로 복사본 생성 숨기기/표시 = 유저 속성의 표시 상태를 숨김/표시로 설정 차원 테이블 추가 = 현재 속성에 차원 테이블 추가(객체/객체 그룹 타입 미지원) 차원 테이블 다운로드/업데이트/삭제 = 차원 테이블이 추가된 속성에 해당 작업 추가 하위 속성 생성 = 객체/객체 그룹 타입 속성의 하위 속성 생성 삭제 = 현재 유저 속성 삭제

유저 속성 생성

슈퍼 레이어 유저 속성 생성 설명

프로젝트 초기에 생성해야 할 리소스가 많다면 이벤트 및 속성 일괄 편집 기능을 사용할 수 있습니다

유저 속성 연결 설정

슈퍼 레이어 유저 속성 소스 연결 설정

• 속성 소스 연결 설명:

  • 슈퍼 레이어 속성 1개는 전송 속성 1개와만 연결 관계를 맺을 수 있습니다
  • 객체 그룹 타입의 속성P가 있고 그 안에 하위 속성P1이 포함되어 있다면:
    • 하위 속성P1의 연결 속성도 반드시 하위 속성이어야 하며, 그 상위 속성은 이미 속성P와 연결 관계가 설정되어 있어야 합니다

3. 주요 기능 권한 설명

유저 속성 관련 기능에 필요한 권한은 다음과 같습니다.

권한 ID	기능	사용 권한	기능 상세
19	메타데이터 관리	보기	이벤트, 이벤트 속성, 유저 속성 목록 보기, 데이터 테이블 미리보기
20	메타데이터 관리	편집	원본 이벤트, 이벤트 속성, 유저 속성의 표시 이름 편집
21	메타데이터 관리	편집	가상 이벤트, 차원 테이블, 가상 속성 편집
59	메타데이터 관리	보기	속성의 차원 테이블 내보내기, 데이터 테이블 내용 다운로드, 데이터 테이블 과거 내용 다운로드
89	메타데이터 관리	편집	파일 업로드 방식 데이터 테이블 추가·편집, 파일 업로드 방식 데이터 테이블의 과거 버전 복원
5000	메타데이터 관리	편집	이벤트/이벤트 속성 목록 관리, 데이터 연결 관계 설정, 전송/크로스 소스 리소스 정보 조회

그림의 번호에 해당하는 진입점과 필요한 권한은 다음과 같습니다.

1. 유저 속성 페이지 진입(보기): 권한 ID 19
2. 소스 유저 속성 관리(소스 유저 속성 관리): 권한 ID 5000
3. 표시 이름(표시 이름 편집): 권한 ID 20
4. + 유저 속성: 슈퍼 레이어 유저 속성을 생성하려면 권한 ID 5000, 가상 유저 속성을 생성하려면 권한 ID 21이 필요합니다
5. 행에서 표시 이름 편집, 비고 편집: 권한 ID 20
6. 행 작업: 슈퍼 레이어 유저 속성 편집 및 연결 설정에는 권한 ID 5000, 가상 유저 속성 편집에는 권한 ID 21이 필요합니다

더 보기 메뉴(목록 페이지의 그림 참고)의 각 작업에 필요한 권한은 다음과 같습니다.

• 유저 속성 숨기기: 권한 ID 20
• 유저 속성 복사본 만들기: 권한 ID 5000
• 차원 테이블 추가: 권한 ID 89
• 하위 속성 생성: 권한 ID 5000
• 유저 속성 삭제: 권한 ID 5000
• 차원 테이블이 추가된 속성: 차원 테이블 업데이트에는 권한 ID 89, 차원 테이블 다운로드에는 권한 ID 59, 차원 테이블 삭제에는 권한 ID 21이 필요합니다

4. 파라미터 제한

• 단일 프로젝트에서 슈퍼 레이어 유저 속성을 최대 1,000개 생성할 수 있습니다

5. 자주 묻는 질문

• #user_id 유저 속성을 편집하거나 삭제할 수 없는 이유는 무엇인가요?

  • 분석 모델의 가용성을 보장하기 위해 일부 속성은 페이지에서 편집 기능을 제공하지 않습니다. 해당 속성과 설명은 다음과 같습니다.
  • #user_id AE 시스템의 유저 고유 식별 ID로, 분석 모델에서 기본 유저 고유값 수 계산에 사용됩니다