이벤트 및 속성 일괄 편집

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

1. 기능 소개

기존 상황

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

원본 이미지 보기

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

슈퍼 레이어 모델

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

원본 이미지 보기

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

주의

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

일괄 편집

• 트래킹 방안 협의를 마치고 데이터 연동을 기다리는 동안, 비즈니스 담당 멤버는 이벤트, 이벤트 속성, 유저 속성 페이지에서 해당 리소스를 하나씩 생성하여 리포트와 대시보드 구축에 사용할 수 있습니다
• 관련 리소스의 생성 효율을 더욱 높이기 위해, 현재 일괄 가져오기/내보내기 기능을 통해 협의를 마친 트래킹 방안이나 데이터 규격이 비슷한 프로젝트의 전체 리소스 방안을 바로 가져오거나 EXCEL에서 수정한 후 현재 프로젝트로 가져올 수 있어, 이후 대시보드 구축 작업을 더 빠르게 진행할 수 있습니다

2. 기능 진입점

이벤트, 이벤트 속성, 유저 속성 페이지로 이동한 후 오른쪽 상단의 [관리] 버튼을 클릭하면 더 많은 기능 목록이 펼쳐집니다

여기에 리소스 설정 가져오기 및 내보내기 기능의 진입점이 포함되어 있습니다

기능 진입점

각 기능에 필요한 권한은 다음과 같습니다

기능 진입점	권한 대응 기능 이름	카테고리	권한 대응 기능 상세
리소스 설정 내보내기	메타데이터 관리	보기	이벤트, 이벤트 속성, 유저 속성 목록 보기, 데이터 테이블 미리보기
리소스 설정 가져오기	메타데이터 관리	편집	이벤트/이벤트 속성 목록 관리, 데이터 연결 관계 설정, 전송/크로스 소스 리소스 정보 조회

권한 설정 페이지

3. 작업 절차

3.1 리소스 설정 내보내기

내보내기를 클릭하면 브라우저에서 다운로드 창이 자동으로 열리며, EXCEL 파일을 바로 저장하면 됩니다

3.2 리소스 설정 가져오기

⚠ 리소스 설정을 가져오면 시스템은 리소스 이름을 기준으로 프로젝트 내 해당 리소스의 타입, 표시 이름, 비고 등의 정보를 생성하거나 변경합니다

⚠ 설정 EXCEL에서 어떤 정보가 비어 있으면 시스템은 프로젝트 내 리소스 정보도 함께 비웁니다. 예: 비고, 표시 이름 비우기 등

⚠ 프로젝트에 이미 있지만 EXCEL에 입력되지 않은 리소스 정보는 변경하지 않습니다. 즉, EXCEL에 없는 리소스를 일괄 삭제하지 않습니다

알림 팝업

⚠ 리소스 설정을 업로드하기 전에 내용이 사용 가능한지 확인하여, 잘못된 설정을 업로드한 후 리소스를 자주 삭제해야 하는 상황을 피하는 것을 권장합니다

가져오기를 클릭하면 팝업에 주요 정보가 표시됩니다. [계속]을 클릭하여 다음 단계로 이동한 후 가져올 설정 파일을 선택합니다

설정 파일 업로드

가져오면 시스템은 먼저 EXCEL 내용을 해석하고, 결과를 확인한 후 리소스 설정 가져오기를 실행합니다

해석 결과 확인

가져오기 실행 결과

4. EXCEL 템플릿 설명

노트

리소스 가져오기 기능은 <트래킹 관리>의 EXCEL 파일 업로드를 지원합니다. 트래킹 방안이 확정되면 방안 EXCEL을 바로 가져와 이벤트와 속성을 생성하고 리포트와 대시보드 구축을 시작할 수 있습니다

4.1 하위 시트 목록 설명

리소스 설정 EXCEL 파일을 내보내서 열면 3개의 하위 시트가 있습니다

EXCEL 하위 시트 미리보기

각 하위 시트의 역할은 다음과 같습니다

하위 시트 이름	설명
#이벤트 데이터	이벤트와 연관된 이벤트 속성의 정보를 기록합니다. 규격은 <트래킹 관리> 기능의 트래킹 방안 표와 비슷합니다
#공통 이벤트 속성	어떤 이벤트 속성이 모든 이벤트와 연관된 경우 이 시트에 따로 입력할 수 있으며, 가져오면 시스템이 해당 속성의 공통 속성 상태를 활성화합니다
#유저 속성	유저 속성의 정보를 기록합니다

4.2 이벤트 데이터 시트

단일 이벤트의 정보와 연관된 이벤트 속성은 아래 표를 참고하여 입력합니다

이벤트 이름(필수)	이벤트 표시 이름	이벤트 설명	속성 이름(필수)	속성 표시 이름	속성 타입(필수)	속성 설명
activity_attend	이벤트 참여	이벤트 보상 수령	activity_type	이벤트 타입1	텍스트	신규 유저 이벤트 등
			channel	유입 채널	텍스트	IOS/Android
			level	레벨업 후 레벨	숫자
			platform	시스템 플랫폼 식별자	텍스트	플랫폼 식별자: android, IOS, harmonyOS, PC
			serverid	서버 ID	숫자
			vip_level	vip 레벨	숫자
			#device_id		텍스트
			#lib		텍스트
			#lib_version		텍스트
			#os		텍스트

이벤트 데이터 시트 미리보기

각 필드의 설명은 다음과 같습니다:

필드 이름	설명
이벤트 이름(필수)	소문자로 시작하며, 소문자, 숫자, 밑줄로 구성되고, 길이는 60자 이하
이벤트 표시 이름	길이는 60자 이하
이벤트 설명	길이는 200자 이하
속성 이름(필수)	소문자로 시작하며, 소문자, 숫자, 밑줄로 구성되고(객체 그룹의 하위 속성에는 영문 마침표가 포함됨), 길이는 80자 이하
속성 표시 이름	길이는 80자 이하
속성 타입(필수)	숫자, 텍스트, 시간, 불리언, 리스트, 객체, 객체 그룹
속성 설명	길이는 200자 이하

4.3 공통 이벤트 속성 시트

속성이 모든 이벤트와 연관된 경우 여기에 속성 정보를 입력하면 됩니다

⚠ 어떤 속성을 <이벤트 데이터 시트>와 <공통 이벤트 속성 시트>에 중복 입력하면 공통 이벤트 속성으로 간주합니다

속성 이름(필수)	속성 표시 이름	속성 타입(필수)	속성 설명
channel	채널	텍스트
level	레벨	숫자
gold_left	남은 골드	숫자

공통 이벤트 속성 시트 미리보기

각 필드의 설명은 다음과 같습니다:

필드 이름	설명
속성 이름(필수)	소문자로 시작하며, 소문자, 숫자, 밑줄로 구성되고(객체 그룹의 하위 속성에는 영문 마침표가 포함됨), 길이는 80자 이하
속성 표시 이름	길이는 80자 이하
속성 타입(필수)	숫자, 텍스트, 시간, 불리언, 리스트, 객체, 객체 그룹
속성 설명	길이는 200자 이하

4.4 유저 속성 시트

유저 속성 정보는 아래 표를 참고하여 입력하면 됩니다

속성 이름(필수)	속성 표시 이름	속성 타입(필수)	속성 설명
ad	광고 id	텍스트
ad_set	광고 그룹 ID	텍스트
campaign	광고 Campaign	텍스트
channel	유입 채널	텍스트	app store,Huawei AppGallery,Xiaomi GetApps,vivo,taptap,Wandoujia=first
current_level	현재 레벨	숫자
first_login_time	첫 로그인 시간	시간	첫 로그인 시 설정

유저 속성 시트 미리보기

각 필드의 설명은 다음과 같습니다:

필드 이름	설명
속성 이름(필수)	소문자로 시작하며, 소문자, 숫자, 밑줄로 구성되고(객체 그룹의 하위 속성에는 영문 마침표가 포함됨), 길이는 80자 이하
속성 표시 이름	길이는 80자 이하
속성 타입(필수)	숫자, 텍스트, 시간, 불리언, 리스트, 객체, 객체 그룹
속성 설명	길이는 200자 이하