---
description: 본 문서는 애드브릭스에서 제공하는 이벤트를 정의하고 설명합니다.
---

# 애드브릭스 이벤트 정의

<figure><img src="https://1736594929-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Ffo5AottIGGR8ygwUVwQ9%2Fuploads%2FWSEp8LKrmrbZKsH61sXU%2F%E1%84%85%E1%85%B5%E1%84%91%E1%85%A9%E1%84%90%E1%85%B3.png?alt=media&#x26;token=0c4e9d3d-d390-4ec8-9e4b-19c5892e2af6" alt=""><figcaption></figcaption></figure>

## **개요**

***

애드브릭스의 '**이벤트**'는 두 가지로 구분됩니다.

* 앱오픈 이벤트 : 앱 실행 이벤트 (New install, Re install, Deeplink Open)
* 인앱 이벤트 : 회원가입, 캐릭터 생성, 구매 등 앱 내 이용자 활동 이벤트와 속성 값



앱 분석에 필요한 이벤트를 정의하고 정확하게 연동하여 측정하는 것은 데이터 분석에 있어서 가장 중요한 작업입니다.



## **앱 오픈 이벤트**

***

애드브릭스의 앱 실행 이벤트는 아래와 같이 구분됩니다.

| **구분**       | **종류**    | **이벤트 명**          | **정의**                                                                              |
| ------------ | --------- | ------------------ | ----------------------------------------------------------------------------------- |
| **앱 오픈 이벤트** | 신규 설치     | abx:new\_install   | <ul><li>앱을 처음으로 설치 후 실행한 디바이스 수</li><li>최초 1회만 발생 가능</li></ul>                      |
|              | 재 설치      | abx:re\_install    | <ul><li>New Install 후, 앱을 삭제하고 다시 설치 후 실행한 수</li><li>중복 발생 가능</li></ul>             |
|              | 딥링크 오픈    | abx:deeplink\_open | <ul><li>앱이 설치되어 있는 상태에서, 딥링크를 통해 앱이 실행된 수</li><li>애드브릭스 트래킹링크를 통해서만 발생 가능</li></ul> |
|              | 첫 설치 후 실행 | abx:firstopen      | <ul><li>앱 설치 후 앱을 실행한 수의 합</li><li>New Install + Re-Install를 의미</li></ul>           |



## **인앱 이벤트**

***

애드브릭스는 인앱 이벤트를 아래와 같이 구분합니다.

* **표준 이벤트** : 이용 편의를 위해 애드브릭스가 미리 정의한 이벤트 (공통, 커머스, 게임)
* **커스텀 이벤트** : 고객사가 직접 정의할 수 있는 이벤트





## **공통(일반) 이벤트**

***

애드브릭스가 미리 정의한 이벤트(Pre-defined Events) 중 앱 카테고리와 관계없이 공통으로 사용할 수 있는 이벤트입니다. (\*아래 내용은 일부입니다.)\
미리 정의한 이벤트는 "`abx:`"값으로 노출되게 됩니다. 자세한 사항은 [연동가이드](https://adbrix.gitbook.io/developer-guide/platform/android/event#undefined-28)를 확인해주세요.

| **구분** | **정의된 이벤트** | **이벤트 명**       | **정의**                  |
| ------ | ----------- | --------------- | ----------------------- |
| 공통     | 회원가입        | abx:sign\_up    | 신규 회원가입 이벤트가 발생한 경우     |
|        | 결제하기\*      | abx:purchase    | 앱 내에서 결제(구매)가 발생한 경우    |
|        | 앱 업데이트      | abx:app\_update | 앱 업데이트가 발생한 경우          |
|        | 사용자 초대      | abx:invite      | 사용자 초대 이벤트가 발생한 경우      |
|        | 로그인         | abx:login       | 사용자 로그인 이벤트가 발생한 경우     |
|        | 로그아웃        | abx:logout      | 사용자 로그아웃 이벤트가 발생한 경우    |
|        | 크레딧 사용      | abx:use\_credit | 앱 내 가상화폐 사용 이벤트가 발생한 경우 |

\*분석 및 광고 운영을 위해 가장 일반적으로 연동하는 추천 이벤트입니다.



### **커머스 이벤트**

***

애드브릭스가 미리 정의한 이벤트(Pre-defined Events) 중 커머스 앱을 위한 이벤트입니다. \
커머스 앱뿐 아니라 콘텐츠, O2O, 리쿠르팅 등 콘텐츠와 서비스를 판매하는 구조의 앱에도 적용할 수 있습니다.

각 이벤트 하위속성에 상품ID, 상품명, 주문ID, 카테고리 등 프로퍼티 값을 추가하여 더 세부적인 분석을 수행할 수 있습니다. 자세한 사항은 [연동가이드](https://adbrix.gitbook.io/developer-guide/platform/android/event#undefined-28)를 확인해주세요.

| **구분** | **정의된 이벤트** | **이벤트 명**              | **정의**                  |
| ------ | ----------- | ---------------------- | ----------------------- |
| 커머스    | 홈 화면 진입     | abx:view\_home         | 홈 화면으로 이동               |
|        | 카테고리 진입     | abx:category\_view     | 특정 카테고리 혹은 기획전으로 이동     |
|        | 상품 상세 보기\*  | abx:product\_view      | 상품 상세보기 페이지 진입          |
|        | 장바구니 담기\*   | abx:add\_to\_cart      | 장바구니 담기 완료 및 상품 정보      |
|        | 관심상품 추가     | abx:add\_to\_wishlist  | 관심 상품 추가 및 해당 상품 정보     |
|        | 주문 확인       | abx:review\_order      | 주문 확인 및 해당 상품 정보        |
|        | 환불\*        | abx:refund             | 구매 후 환불 및 환불 상품 정보      |
|        | 상품 검색\*     | abx:search             | 상품 검색 키워드 및 검색 결과 상품 정보 |
|        | 상품 공유       | abx:share              | 상품 공유 및 공유 상품 정보        |
|        | 상품 목록 조회    | abx:list\_view         | 상품 목록 조회 및 상품 정보        |
|        | 장바구니 조회     | abx:cart\_view         | 장바구니 조회 결과 및 상품 정보      |
|        | 지불정보 입력     | abx:paymentinfo\_added | 결제에 활용하는 지불 수단 정보       |

* 분석 및 광고 운영을 위해 가장 일반적으로 연동하는 추천 이벤트입니다.



### **게임 이벤트**

***

애드브릭스가 미리 정의한 이벤트(Pre-defined Events) 중 게임 앱을 위한 이벤트입니다.

각 이벤트에 튜토리얼 완료 여부, 스테이지 이름, 레벨 구간 등 프로퍼티 값을 추가하여 더 세부적인 분석을 수행할 수 있습니다. 자세한 사항은 [연동 가이드](https://adbrix.gitbook.io/developer-guide/platform/android/event#undefined-63)를 확인해주세요.

| **구분** | **정의된 이벤트** | **이벤트 명**              | **정의**               |
| ------ | ----------- | ---------------------- | -------------------- |
| 게임     | 튜토리얼 완료     | abx:tutorial\_complete | 게임 내에서 튜토리얼이 완료되었을 때 |
|        | 캐릭터 생성      | abx:character\_created | 캐릭터 생성이 완료되었을 때      |
|        | 스테이지 완료     | abx:stage\_cleared     | 특정 스테이지가 완료되었을 때     |
|        | 레벨 달성       | abx:level\_achieved    | 특정 레벨을 달성했을 때        |



## **커스텀 이벤트**

***

애드브릭스는 미리 정의된 이벤트 외에도 고객사가 원하는 인-앱 이벤트를 직접 구성하여 분석할 수 있도록 지원합니다. 커스텀 이벤트는 "`custom:`"값으로 노출되게 됩니다.  \
자세한 사항은 [연동 가이드](https://adbrix.gitbook.io/developer-guide/platform/android/event#undefined-75)를 확인해주세요.



### **인앱 이벤트 하위 속성값**(Property)

애드브릭스는 이벤트에 하위 정보인 속성값(Property)를 함께 연동하고 분석할 수 있도록 지원합니다. \
세부적인 분석과 고도화된 데이터 기반 광고 운영을 위해서는 각 이벤트가 제공하는 속성값(Property)을 적절하게 이용하는 것이 매우 중요합니다.

### **'구매' 이벤트 예시**

아래는 구매를 의미하는 Purchase 이벤트에 추가할 수 있는 이벤트 속성 목록과 샘플코드입니다.&#x20;

([Android- Java](https://adbrix.gitbook.io/developer-guide/platform/android/event#undefined-25)).

Order ID, Payment method 등의 필수 항목과 커스텀 이벤트 속성을 추가할 수 있습니다.

<figure><img src="https://1736594929-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Ffo5AottIGGR8ygwUVwQ9%2Fuploads%2F6t3MbACftVdy4lEvRtSF%2F%E1%84%86%E1%85%AE%E1%84%8C%E1%85%A6%202.jpg?alt=media&#x26;token=ec985d6e-fa11-4a28-b82a-711e7706789e" alt=""><figcaption></figcaption></figure>

구매 이벤트의 상품 정보에 'Category'와 'Product name'을 함께 연동하면 아래 예시처럼 분석을 세분화할 수 있습니다. 예를 들어, 특정 카테고리에 속해 있는 상품의 판매 결과만을 분석하거나, 특정 광고를 통해 목적한 상품이 정말로 판매되었는지 세분화하여 분석할 수 있습니다.

혹은 [오디언스  스튜디오](../undefined-4)를 이용하여 특정 카테고리에서 100만 원 이상 구매한 이용자만을 대상으로 코호트 분석을 하거나 광고 식별값을 추출하여 타게팅 광고를 시작할 수 있습니다.

<figure><img src="https://1736594929-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Ffo5AottIGGR8ygwUVwQ9%2Fuploads%2Fb8QiWsO2Sbm6hIArFlwo%2F%E1%84%8F%E1%85%A1%E1%84%90%E1%85%A6%E1%84%80%E1%85%A9%E1%84%85%E1%85%B5%20%E1%84%89%E1%85%A6%E1%84%87%E1%85%AE%E1%86%AB%E1%84%92%E1%85%AA.png?alt=media&#x26;token=f2fa1442-cb3a-497b-a38b-c98f080a4637" alt=""><figcaption></figcaption></figure>

