이벤트 속성

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

1. 기능 소개

기존 상황

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

원본 이미지 보기

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

슈퍼 레이어 모델

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

원본 이미지 보기

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

주의

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

분석 시 사용

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

비즈니스 시나리오 예시

• 고객 A가 데이터를 직접 전송하여 슈퍼 레이어 이벤트 "유저 가입"이 생성되었으며, 여기에는 이벤트 속성 "채널"이 포함되어 있습니다

• 고객 A가 크로스 소스 설정을 생성하여 슈퍼 레이어 이벤트 "백엔드 주문 완료"가 생성되었으며, 여기에도 이벤트 속성 "채널"이 포함되어 있습니다

• 이때 슈퍼 레이어 이벤트 속성 목록을 보면 이름이 "채널"인 이벤트 속성 1개만 표시됩니다

• 이때 슈퍼 레이어 이벤트 속성 "채널"은 2개의 데이터 소스와 연관되어 있으며, 각각 다음과 같습니다

  • 전송된 데이터의 "유저 가입" 이벤트
  • 크로스 소스 데이터의 "백엔드 주문 완료" 이벤트

• 리포트에서 "유저 가입"의 "채널"에 대한 "고유값 수"를 조회하면, 시스템은 AE 내부 이벤트 테이블의 속성을 읽어 계산하고 결과를 얻습니다

• 리포트에서 "백엔드 주문 완료"의 "채널"에 대한 "고유값 수"를 조회하면, 시스템은 외부 데이터 테이블의 속성을 읽어 계산하고 결과를 얻습니다

2. 사용 설명

자동 감지 로직

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

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

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

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

목록 페이지

목록 관리 페이지 설명

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

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

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

이벤트 속성 생성

슈퍼 레이어 이벤트 속성 생성 설명

• 이벤트 연관 설명: 현재 속성A가 이벤트1과 연관되어 있고 이벤트2와는 연관되어 있지 않다면, 분석 모델에서 사용할 때:

  • 이벤트1을 선택하면 해당 속성 목록에서 속성A를 찾을 수 있습니다
  • 이벤트2를 선택하면 해당 속성 목록에서 속성A를 찾을 수 없습니다

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

이벤트 속성 연결 설정

슈퍼 레이어 이벤트 속성 소스 연결 설정

• 속성 소스 연결 설명:

  • 슈퍼 레이어 속성 1개는 전송 속성 1개와만 연결 관계를 맺을 수 있습니다

  • 슈퍼 레이어 속성 1개는 하나의 크로스 소스 데이터 소스 내에서 크로스 소스 속성 1개와만 연결할 수 있습니다

  • 속성A가 이벤트1, 이벤트2와 연관 관계를 맺었지만 소스 속성 연결을 설정하지 않았다면:

    • 분석 모델에서 조회할 때 계산 결과를 얻을 수 없습니다

  • 속성A가 이벤트1, 이벤트2와 연관 관계를 맺고, 동시에 해당 데이터 소스의 속성과 소스 연결을 설정했다면:

    • 이벤트1을 조회하면 시스템이 이벤트1의 소스 데이터에서 속성A의 연결 속성을 읽어 계산합니다
    • 이벤트2를 조회하면 시스템이 이벤트2의 소스 데이터에서 속성A의 연결 속성을 읽어 계산합니다

  • 객체 그룹 타입의 속성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: 이벤트 속성 숨기기 20, 이벤트 속성 복사본 만들기 5000, 차원 테이블 속성 추가 89, 하위 속성 생성 5000, 이벤트 속성 삭제 5000, 차원 테이블 업데이트 89, 차원 테이블 다운로드 59, 차원 테이블 삭제 21. 가상 이벤트 속성 행의 편집은 21입니다.

4. 파라미터 제한

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

5. 자주 묻는 질문

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

  • 분석 모델의 가용성을 보장하기 위해 일부 속성은 페이지에서 편집 기능을 제공하지 않습니다. 해당 속성과 설명은 다음과 같습니다.
  • #user_id AE 시스템의 유저 고유 식별 ID로, 분석 모델에서 기본 유저 고유값 수 계산에 사용됩니다
  • #event_name 이벤트 이름으로, 분석 모델에서 이벤트 식별에 사용됩니다
  • #event_time 이벤트 시간으로, 분석 모델에서 이벤트 시간 해석 및 시간대 오프셋 계산에 사용됩니다
  • #zone_offset 시간대 오프셋으로, 분석 모델에서 이벤트의 시간대 오프셋 계산에 사용됩니다
  • #te_event_id 이벤트 고유 식별 ID로, 운영 실시간 계산에서 이벤트의 고유성 식별에 사용됩니다