이벤트 스키마 (Event Schemas)

이벤트 스키마는 Appier가 추적된 이벤트를 읽고, 표시하고, 처리하는 방식을 정의합니다. 각 이벤트 스키마는 행동과 그 속성을 설명하며, 모든 리포트, 세그먼트 및 사용자 프로필에서 데이터의 일관성을 보장합니다.

📘
참고
AIRIS가 활성화된 계정의 경우, 미리 빌드된 스키마 전체 목록은 시스템 이벤트 스키마를 참조하세요.

이벤트 스키마를 조회하고 관리하려면 공통 설정 > 데이터 관리로 이동한 다음 이벤트 스키마를 선택합니다.

이벤트 스키마 생성

기존 스키마를 수정하여 언제든지 스키마 이름을 바꾸거나, 설명을 업데이트하거나, 속성을 수정할 수 있습니다. 시스템 이벤트 스키마 중에 필요한 추적 항목이 없는 경우, 유입되는 데이터로부터 자동 생성되기를 기다리거나 다음 단계에 따라 커스텀 이벤트 스키마를 생성할 수 있습니다.

📘
전제 조건
스키마를 생성하고 편집하려면 관리자 권한이 필요합니다. 접근 권한이 없는 경우 CSM에게 문의하세요.

공통 설정 > 데이터 관리 > 이벤트 스키마에서 + 이벤트 스키마 추가를 클릭합니다.

스키마 정보 섹션에서 스키마를 입력하고 이벤트 유형을 선택합니다.

이벤트 속성 섹션에서 새 속성 패널을 펼친 후 추가 속성마다 + 속성 추가를 클릭합니다. 선택적으로 수식 및 민감한 정보를 토글할 수 있습니다.

이벤트 템플릿 섹션에서 동적 변수가 포함된 가독성 있는 문장을 만듭니다. 이 변수들은 개별 사용자의 타임라인이나 이벤트 히스토리를 볼 때 자동으로 채워집니다.
생성을 클릭하여 스키마를 저장합니다.

스키마 정보

스키마 정보 섹션을 사용하여 이벤트 자체의 스키마 수준 세부 정보를 정의합니다.

이벤트 스키마 키는 대소문자를 구분합니다. 영문 대소문자, 숫자, 언더바(_), 대시(-), 공백을 사용할 수 있습니다.
키를 입력한 후 스키마 이름 및 설명 필드의 플레이스 홀더에 있는 AI 아이콘을 클릭하면 사람이 읽기 쉬운 메타데이터를 자동으로 생성할 수 있습니다. 이러한 의미론적 힌트는 팀원들이 기술적인 해석 없이도 세분화나 리포팅에 해당 필드를 어떻게 활용할 수 있는지 빠르게 이해하는 데 도움이 됩니다.

필드	설명
스키마 이름	리포트 및 사용자 프로필 등 콘솔에 표시되는 이벤트 이름입니다. 팀이 해당 이벤트가 무엇을 나타내는지 이해하기 쉬운 이름을 사용하세요.
스키마 키	추적 코드에서 전송되는 이벤트 이름입니다. 이 값은 SDK 또는 연동 환경에서 직접 전달되며 정확히 일치해야 합니다. 이 값은 변경하지 마세요. 이벤트 이름을 변경해야 하는 경우 스키마에서 중복 이벤트가 발생하지 않도록 스키마 이름을 변경하세요.
설명	이벤트에 대한 설명입니다. 명확한 설명을 제공하면 모든 팀원, 특히 SDK 연동에 참여하지 않은 인원도 이 이벤트의 목적을 이해하는 데 도움이 됩니다.
이벤트 유형	이벤트가 사용자 프로필에 표시되는 방식을 정의합니다. • 활성: 사용자의 직접적인 행동에 의해 트리거된 이벤트입니다. • 비활성: 백그라운드 프로세스에 의해 트리거되었거나 사용자를 대신하여 추적된 이벤트입니다.

🚧
중요
기존 이벤트 스키마의 스키마 키 값을 업데이트할 때는 주의하세요. 코드를 업데이트하지 않고 변경하면 스키마에 중복 이벤트가 생성됩니다.

이벤트 속성

이벤트 속성 섹션에서 이벤트 발생 시 수집되는 개별 데이터 포인트를 정의합니다. 스키마 내 각 속성에 다음 필드를 구성하세요.

필드	설명
속성 키	추적 코드에서 전송되는 속성 이름입니다(예: `amount`).
속성 이름	리포트 및 세그먼트 등 콘솔에 표시되는 속성 이름입니다.
설명	이벤트 속성에 대한 설명입니다. 이 정보를 통해 팀원들이 이 속성이 무엇을 나타내고 어떻게 추적되는지 이해하도록 돕습니다.
데이터 유형	속성 값의 형식입니다(예: 텍스트, 숫자, 불리언). 유형 및 서식 옵션 전체 목록은 데이터 유형을 참조하세요.
집계	리포트 및 세그먼트에서 속성이 요약되는 방식을 정의합니다. 그룹, 고유, 합계 설정에 대한 자세한 내용은 집계를 참조하세요.
버킷	트렌드 리포트에서 사용하기 위해 숫자 속성을 정의된 범위로 그룹화합니다. 설정 방법은 버킷을 참조하세요.
수식 (AIRIS)	이 속성의 값을 계산하기 위한 커스텀 수식을 정의합니다.
민감한 정보 (AIRIS)	이 속성을 민감한 데이터로 분류하려면 토글을 켜세요.