크로스 소스 이벤트 테이블
이 문서에서는 크로스 소스 이벤트 테이블 설정의 고유 필드와 리소스 목록의 고유 로직만 설명합니다
크로스 소스 리소스 설정 기능의 일반 설명은 다음을 참조하십시오: 크로스 소스 리소스 설정 기능 설명
1. 기본 정보
AE 규격의 이벤트 테이블 데이터 구조에는 몇 가지 핵심 데이터 열이 포함되며, 이러한 핵심 데이터 열은 이후 분석 모델의 기능 사용에 영향을 줍니다
예: $part_event, #event_time, $part_date 등
그 밖의 열은 커스텀 이벤트 속성입니다. 예를 들어 아래 표 예시의 channel, role_level, amount입니다
| #user_id | $part_event | #event_time | #zone_offset | $part_date | channel | role_level | amount |
|---|---|---|---|---|---|---|---|
| 홍길동 | login | 2025-10-29 10:25:59 | 8 | 2025-10-29 | Douyin | ||
| 김철수 | level_up | 2025-10-09 04:00:48 | 8 | 2025-10-09 | 47 | ||
| 이영희 | payment | 2025-10-20 10:29:16 | 0 | 2025-10-20 | 70 | 166 | |
| 박민수 | battle_win | 2025-10-08 15:56:31 | -4 | 2025-10-08 | 83 |
AE 이벤트 테이블 예시
외부 데이터 소스를 크로스 소스 이벤트 테이블로 설정할 때는 AE 규격 형식으로 변환하고 크로스 소스 설정 필드에서 설정해야 합니다
이벤트 속성으로 사용할 그 밖의 열은 비즈니스 요구에 따라 리소스 목록에서 설정할 수 있습니다
⚠ 크로스 소스 설정 필드에서 이미 설정한 열은 리소스 목록에서 리소스로 다시 설정할 필요가 없습니다
| uid | action | ts | timezone | pt | channel | role_level | amount |
|---|---|---|---|---|---|---|---|
| 홍길동 | login | 2025-10-26 04:21:54 | 8 | 2025-10-26 | Douyin | ||
| 김철수 | level_up | 2025-10-09 15:22:26 | 8 | 2025-10-09 | 77 | ||
| 이영희 | payment | 2025-10-15 06:28:51 | 0 | 2025-10-15 | 54 | 166 | |
| 박민수 | battle_win | 2025-10-21 19:23:40 | -4 | 2025-10-21 | 71 |
외부 데이터 소스 예시
2. 크로스 소스 설정 필드 설명
2.1 주체 정보
데이터 소스에서 AE 이벤트 테이블의 #user_id에 해당하는 데이터 열을 설정합니다. 예시 데이터에서는 uid입니다
광고 어트리뷰션 이벤트, 집계 데이터 이벤트 등 유저 행동과 무관한 데이터는 여기를 비워 두면 됩니다
⚠ 프로젝트 데이터에 "전송 이벤트와 크로스 소스 이벤트 혼용", "크로스 소스 유저 속성과 크로스 소스 이벤트 드릴다운" 등 복잡한 시나리오가 포함되는 경우, 연동 초기에 ThinkingAI 담당자와 데이터 상태 및 처리 방안을 확인하십시오
주체 열_미리보기
2.2 이벤트 이름 정보
데이터 소스에서 AE 이벤트 테이블의 $part_event 정보에 해당하는 값을 읽는 방식을 설정합니다
🔵 열 값 읽기
데이터 소스에서 이벤트 이름을 기록한 데이터 열을 직접 선택합니다
예시 데이터에서는
action입니다⚠ 조회 성능을 높이려면 데이터 소스에서 이 열을 파티션 키로 사용하는 것을 권장합니다
이벤트 이름_열 값 읽기 미리보기
🔵 고정값
데이터 소스에 이벤트 1개의 데이터만 있고 이벤트 이름을 기록한 열이 없는 경우, 여기에서 고정값을 선택합니다
동시에 이벤트 이름 필드에 해당 이름을 입력합니다. 예: user_login
이벤트 이름_고정값 미리보기
2.3 이벤트 시간 정보
데이터 소스에서 AE 이벤트 테이블의 #event_time 정보에 해당하는 값을 읽는 방식을 설정합니다
🔵 열 값 읽기
데이터 소스에서 이벤트 시간을 기록한 데이터 열을 직접 선택합니다. 데이터 타입은 시간이어야 합니다
예시 데이터에서는
ts입니다
이벤트 시간_열 값 읽기 미리보기
🔵 커스텀 SQL
데이터 소스에 이벤트 시간 정보가 텍스트, 숫자 타임스탬프 등의 형식으로 기록되어 있다면 SQL 함수로 시간 타입으로 변환해야 합니다
예: try_cast( "ts" as timestamp )
그 밖의 복잡한 시나리오는 다음을 참조하십시오: 크로스 소스 설정 복잡한 시나리오 및 SQL 예시
이벤트 시간_커스텀 SQL 미리보기
2.4 이벤트 시간대 정보
데이터 소스에서 AE 이벤트 테이블의 #zone_offset 정보에 해당하는 값을 읽는 방식을 설정합니다
🔵 열 값 읽기
데이터 소스에서 이벤트 시간대를 기록한 데이터 열을 직접 선택합니다. 데이터 타입은 숫자여야 합니다
예시 데이터에서는
timezone입니다
이벤트 시간대_열 값 읽기 미리보기
🔵 고정값
데이터 소스의 데이터가 모두 같은 시간대에서 온 경우(예: 서버가 UTC+8 기준으로 수집한 로그) 해당 시간대로 설정하면 됩니다
이벤트 시간대_고정값 미리보기
🔵 커스텀 SQL
데이터 소스에 시간대 정보가 다른 형식으로 기록되어 있다면 SQL 함수로 숫자 타입으로 변환해야 합니다
예: try_cast( substr( 'UTC+8' , 4 , 9 ) as double ) /* 사용 시 'UTC+8'을 열 이름으로 바꾸십시오 */
그 밖의 복잡한 시나리오는 다음을 참조하십시오: 크로스 소스 설정 복잡한 시나리오 및 SQL 예시
이벤트 시간대_커스텀 SQL 미리보기
2.5 데이터 파티션 방식
데이터 소스에서 AE 이벤트 테이블의 $part_date 정보에 해당하는 값을 읽는 방식을 설정합니다
🔵 날짜 정보 열
데이터 소스에서 날짜 파티션을 기록한 데이터 열을 직접 선택합니다. 데이터 타입은 텍스트여야 합니다
예시 데이터에서는
pt입니다⚠ 조회 성능을 높이려면 데이터 소스에서 이 열을 파티션 키로 사용하는 것을 권장합니다
🔵 커스텀 푸시다운 로직
데이터 소스가 다른 방식으로 파티션되어 있다면 커스텀 푸시다운 로직을 사용해야 합니다. 조회 시 프런트엔드의 날짜 범위를 변수로 삼아 해당 푸시다운 로직 SQL을 작성합니다
자세한 내용은 다음을 참조하십시오: 크로스 소스 설정 복잡한 시나리오 및 SQL 예시
3. 크로스 소스 리소스 목록 설정 설명
크로스 소스 이벤트 테이블 설정에서 리소스 설정은 이벤트 속성, 이벤트, 이벤트와 속성의 매핑 관계 세 가지로 나뉘며, 각각 설정해야 합니다
크로스 소스 이벤트 테이블의 여러 타입 리소스 미리보기
3.1 이벤트 속성
3.1.1 리소스 데이터 타입
크로스 소스 이벤트 속성의 리소스는 다음 타입을 지원합니다:
텍스트, 숫자, 불리언, 시간, 리스트, 객체, 객체 그룹
값 가져오기 방식의 복잡한 시나리오는 다음을 참조하십시오: 크로스 소스 설정 복잡한 시나리오 및 SQL 예시
크로스 소스 이벤트 속성 데이터 타입 미리보기
3.1.2 공통 속성
크로스 소스 이벤트 속성을 설정할 때 확장 정보에서 특정 속성을 공통 속성으로 설정할 수 있습니다
설정하면 해당 속성은 현재 설정의 모든 이벤트와 매핑 관계를 맺습니다(다른 크로스 소스 설정에는 영향 없음)
크로스 소스 이벤트 속성의 공통 속성 미리보기
3.2 이벤트
⚠ 이벤트 리소스에서 리소스 스캔을 사용하기 전에 설정 필드의 이벤트 이름 정보 설정을 완료해야 합니다
스캔하면 리소스 목록의 첫 번째 열에 스캔된 이벤트 이름이 표시되며, 이때 출력 이벤트의 표시 이름과 설명을 수정할 수 있습니다
- 출력 이벤트가 원본 값과 같다면 원본 이벤트 목록을 비워 두면 됩니다(아래 그림의 payment)
- 여러 이벤트를 하나의 이벤트로 합치려면 합칠 이벤트 목록을 영문 괄호와 작은따옴표로 입력해야 합니다(아래 그림의 battle_end)
- 단일 이벤트의 출력 이름을 수정하려면 원본 이벤트 목록에 이벤트 1개만 포함된 목록을 입력하면 됩니다(아래 그림의 activity_attend)
이벤트 리소스 설정 미리보기
3.3 이벤트와 속성의 매핑 관계
분석 모델에서 이벤트 A를 선택하면 해당 이벤트의 속성 B로 필터링하거나 계산할 수 있으며, 이와 무관한 속성 C는 나타나지 않습니다
이 로직을 이벤트와 속성의 매핑 관계라고 합니다. 이 로직은 비즈니스 담당자가 이벤트 데이터 간의 연관을 파악하기 쉽게 하여 작업 효율을 높여 줍니다
AE 시스템의 이벤트와 속성 관계 미리보기
AE 시스템에서는 전송 방식으로 저장된 데이터의 경우 ETL 단계에서 각 이벤트와 속성의 관계를 해석할 수 있습니다
그러나 크로스 소스로 매핑된 데이터는 시스템이 외부 데이터 소스의 관계를 자동으로 식별할 수 없으므로 설정에서 지정해야 합니다
이벤트와 속성 관계 설정 미리보기
설정할 때는 먼저 전체 매핑 관계 테이블 다운로드를 사용할 수 있습니다. 시스템이 설정된 이벤트 속성과 이벤트 이름을 읽어 전체 매핑 관계 데이터를 생성합니다. 또한 전체 매핑 관계 일괄 설정을 클릭하면 이벤트 속성과 이벤트를 바로 전체 매핑 관계로 설정할 수 있습니다
그런 다음 데이터에서 필요 없는 데이터를 삭제하고 UTF-8 형식의 CSV 파일로 내보냅니다 (UTF-8 형식의 CSV 파일을 내보내는 방법은?)
| 출력 이벤트 이름 | 출력 속성 이름 |
|---|---|
| event_a | prop_a |
| event_a | prop_b |
| event_a | prop_c |
| event_b | prop_a |
| event_b | prop_b |
처리 후 매핑 관계 미리보기
완료한 후 매핑 관계 업로드를 클릭하여 해당 파일을 업로드하고 절차에 따라 진행합니다
해석이 완료되면 시스템이 팝업으로 업로드 및 해석 결과를 알려 줍니다
⚠ 설정에서 매핑 관계를 설정하지 않으면 이후 분석 모델에서 이벤트를 사용하는 데 영향을 줄 수 있으며, 이때 페이지에 팝업 알림이 표시됩니다
매핑 관계 오류 팝업 미리보기