> ## Documentation Index
> Fetch the complete documentation index at: https://docs.adrop.io/llms.txt
> Use this file to discover all available pages before exploring further.

# 이벤트

> 이벤트는 구매, 장바구니 추가 등 사용자의 행동 데이터입니다. 이벤트를 활용하면 오디언스 타겟팅에서 행동 기반 조건을 추가하고, 전환 추적으로 광고 성과를 측정할 수 있습니다.

***

## 이벤트란?

**이벤트**는 사용자가 앱이나 웹에서 수행하는 행동 데이터입니다. 구매, 장바구니 추가, 회원가입, 문의 완료 등 사용자의 구체적인 행동을 기록합니다.

**프로퍼티**가 사용자의 속성 정보(나이, 성별, 회원 등급 등)라면, **이벤트**는 사용자가 실제로 수행한 행동 정보입니다.

| 구분       | 설명          | 예시                       |
| -------- | ----------- | ------------------------ |
| **프로퍼티** | 사용자의 속성 정보  | 나이, 성별, 회원 등급, 거주 지역     |
| **이벤트**  | 사용자의 행동 데이터 | 구매, 장바구니 추가, 회원가입, 문의 완료 |

이벤트를 활용하면 "구매 이력이 있는 사용자"처럼 행동 기반의 타겟팅 조건을 추가할 수 있어, 프로퍼티만 사용할 때보다 더 정밀한 오디언스 그룹을 구성할 수 있습니다.

***

## 이벤트 카테고리

이벤트는 성격에 따라 세 가지 카테고리로 구분됩니다.

| 카테고리         | 설명          | 대표 이벤트             |
| ------------ | ----------- | ------------------ |
| **COMMON**   | 앱/웹 공통 행동   | 회원가입, 로그인          |
| **COMMERCE** | 커머스 관련 행동   | 구매, 장바구니 추가, 결제 시작 |
| **LEAD**     | 리드 생성 관련 행동 | 문의 완료, 상담 신청       |

***

## 이벤트 프리셋

애드컨트롤은 자주 사용되는 이벤트를 시스템 프리셋으로 기본 제공합니다.

* 프리셋 이벤트는 별도의 등록 없이 바로 사용할 수 있습니다.
* 프리셋 이벤트의 이름과 파라미터는 수정할 수 없습니다.

<Note>
  프리셋 이벤트 목록은 콘솔의 이벤트 페이지에서 확인할 수 있습니다.
</Note>

***

## 이벤트 페이지 사용법

콘솔 좌측 메뉴에서 **이벤트**를 클릭하면 이벤트 페이지로 이동합니다.

### 이벤트 목록

이벤트 페이지에서는 등록된 모든 이벤트를 목록으로 확인할 수 있습니다. 각 이벤트의 카테고리, 이름, 설명 정보를 한눈에 볼 수 있습니다.

### 이벤트 상세

이벤트를 클릭하면 상세 모달이 열립니다. 상세 모달에서는 다음 정보를 확인할 수 있습니다.

* **파라미터 트리**: 이벤트에 포함된 파라미터의 구조와 데이터 타입
* **데이터 로그**: 최근 수신된 이벤트 데이터의 샘플 로그

***

## 오디언스 타겟팅에서 이벤트 사용

오디언스 타겟팅 생성 시 프로퍼티뿐 아니라 이벤트를 조건으로 추가할 수 있습니다.

### 이벤트 조건 추가

1. **타겟팅 → 오디언스**에서 타겟팅을 생성합니다.
2. 조건 설정의 **+Filter**를 클릭합니다.
3. 필터 유형에서 **이벤트**를 선택합니다.
4. 사용할 이벤트를 선택합니다.
5. 필요시 이벤트 파라미터에 추가 조건을 설정합니다.

### 프로퍼티와 이벤트 조합

프로퍼티와 이벤트를 함께 조합하면 더 정밀한 타겟 그룹을 구성할 수 있습니다.

**예시: 커머스 앱 타겟팅**

| 타겟팅 옵션               | 조건                                      |
| -------------------- | --------------------------------------- |
| **구매 경험 있는 서울 유저**   | region is "Seoul" AND Purchase 이벤트 발생   |
| **장바구니 추가 후 미구매 유저** | AddToCart 이벤트 발생 AND Purchase 이벤트 미발생   |
| **VIP 구매 유저**        | membership is "VIP" AND Purchase 이벤트 발생 |

***

## 기술 사양

| 항목            | 내용     |
| ------------- | ------ |
| **데이터 반영 주기** | 10분 단위 |
| **데이터 보관 기간** | 18개월   |

***

## SDK 연동

앱에서 이벤트를 전송하려면 SDK에서 이벤트 트래킹을 연동하세요.

<CardGroup cols={2}>
  <Card title="Android SDK" icon="android" href="/ko/sdk/android/targeting#이벤트-트래킹">
    Android에서 이벤트 트래킹 설정하기
  </Card>

  <Card title="iOS SDK" icon="apple" href="/ko/sdk/ios/targeting#이벤트-트래킹">
    iOS에서 이벤트 트래킹 설정하기
  </Card>
</CardGroup>

***

## 다음 단계

{/* <Card title="전환 추적" icon="chart-line" href="/ko/targeting/conversion-tracking">
광고 클릭 후 전환 발생 여부를 측정하는 방법을 확인하세요
</Card> */}

<Card title="오디언스 타겟팅 만들기" icon="users" href="/ko/targeting/audience">
  프로퍼티와 이벤트를 조합한 타겟팅을 만들어보세요
</Card>

***

## FAQ

<AccordionGroup>
  <Accordion title="이벤트와 프로퍼티의 차이점은 무엇인가요?">
    프로퍼티는 사용자의 속성 정보(나이, 성별, 회원 등급 등)이고, 이벤트는 사용자의 행동 데이터(구매, 장바구니 추가 등)입니다. 프로퍼티는 "어떤 사용자인가"를 나타내고, 이벤트는 "무엇을 했는가"를 나타냅니다.
  </Accordion>

  <Accordion title="프리셋 이벤트를 수정할 수 있나요?">
    프리셋 이벤트의 이름과 파라미터는 수정할 수 없습니다. 시스템에서 기본 제공하는 표준 이벤트이므로, 일관된 데이터 수집과 분석을 위해 그대로 사용해야 합니다.
  </Accordion>

  <Accordion title="이벤트 데이터는 얼마나 빨리 반영되나요?">
    이벤트 데이터는 10분 단위로 반영됩니다. SDK를 통해 수집된 이벤트가 타겟팅 조건에 반영되기까지 최대 10분이 소요될 수 있습니다.
  </Accordion>

  <Accordion title="이벤트 데이터는 얼마 동안 보관되나요?">
    이벤트 데이터는 18개월간 보관됩니다. 18개월이 지난 데이터는 자동으로 삭제됩니다.
  </Accordion>
</AccordionGroup>