# 이벤트

## 개요 <a href="#overview" id="overview"></a>

이벤트는 구매, 회원가입, 로그인 등 고객 여정 상의 주요 행동을 의미하며, CRM 전체 분석과 타겟팅의 기반이 되는 핵심 구조입니다.

{% hint style="warning" %}
사전에 정의된 텍소노미는 **단순히 콘솔에서 설정을 마치는 것으로 끝나지 않으며**, 실제 데이터를 수집하기 위해서는 개발자의 연동 작업이 반드시 필요합니다.

즉, SDK 또는 API를 통해 실시간 이벤트 및 속성 데이터가 전송되어야 하며, 이를 위해 반드시 [Event 및 User 텍소노미 개요](https://app.gitbook.com/s/TQoY0rYrzNUQxhlUfYFm/taxonomy/overview "mention")를 기준으로 정의된 구조에 맞게 구현되어야 합니다.
{% endhint %}

## 1. 이벤트 목록

<figure><img src="https://3826783036-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FyROeODSgPulCgZ9LFAYn%2Fuploads%2FLrypg50rK46FELUZLYxX%2F%E1%84%89%E1%85%B3%E1%84%8F%E1%85%B3%E1%84%85%E1%85%B5%E1%86%AB%E1%84%89%E1%85%A3%E1%86%BA%202025-07-15%20%E1%84%8B%E1%85%A9%E1%84%92%E1%85%AE%203.28.56.png?alt=media&#x26;token=62b7b6ee-42c4-4b4f-a969-a31665a66453" alt=""><figcaption></figcaption></figure>

* **이벤트명**은 개발 연동 시 SDK 또는 API를 통해 수집되는 고유 키입니다.
* **표기명**은 마케터가 콘솔에서 식별하기 쉬운 형태로 표시되는 이름입니다.
* **유형**은 `표준`과 `커스텀`으로 구분되며, 표준 이벤트는 마켓탭에서 기본 제공되며 `mkt_` 접두어가 붙습니다.
* **수집 상태**는 `활성` / `비활성`으로 설정 가능하며, 비활성화 시 해당 이벤트는 더 이상 수집되지 않습니다.

{% hint style="danger" %}
이벤트가 **비활성화**되면 해당 이벤트의 데이터는 더 이상 수집되지 않으며,\
이후 **오디언스, 캠페인 조건, 리포트** 등에서 사용할 수 없습니다.

비활성화 후 다시 **활성화**하더라도, **최대 1시간까지 데이터 수집이 지연**될 수 있으므로, 운영 중인 이벤트의 상태 변경은 신중하게 진행해 주세요.
{% endhint %}

## 2. 이벤트 추가하기

<figure><img src="https://3826783036-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FyROeODSgPulCgZ9LFAYn%2Fuploads%2FIaQf5GrP4aOPFuRnEwRe%2F%E1%84%89%E1%85%B3%E1%84%8F%E1%85%B3%E1%84%85%E1%85%B5%E1%86%AB%E1%84%89%E1%85%A3%E1%86%BA%202025-07-15%20%E1%84%8B%E1%85%A9%E1%84%92%E1%85%AE%203.44.03.png?alt=media&#x26;token=dca9ba0c-4529-41cf-b287-a76df8815a8b" alt=""><figcaption></figcaption></figure>

* 사용자는 **\[이벤트 추가하기]**&#xB97C; 통해 특정 비즈니스에 맞는 커스텀 이벤트를 직접 정의할 수 있습니다.
* 여러 개의 커스텀 이벤트를 추가 후, 한 번에 **\[생성 완료하기]** 버튼을 눌러 반영할 수 있습니다.

{% hint style="warning" %}
커스텀 이벤트는 사용자가 직접 정의하는 이벤트로, `mkt_` 접두어를 사용할 수 없습니다.
{% endhint %}

{% hint style="warning" %}
동일한 이벤트명이 이미 존재하는 경우, **중복된 이벤트명으로는 생성할 수 없습니다.**
{% endhint %}