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

# 에어브릿지 이벤트 종류

<Info>
  **알립니다**

  에어브릿지 이벤트는 스탠다드 이벤트와 커스텀 이벤트 두 종류입니다. 수집하려는 유저 행동에 해당하는 스탠다드 이벤트가 있으면 스탠다드 이벤트를 사용하세요. 해당하는 스탠다드 이벤트가 없으면 커스텀 이벤트를 새롭게 정의하세요.
</Info>

## 스탠다드 이벤트

스탠다드 이벤트는 에어브릿지가 주요 유저 행동을 미리 정의한 이벤트입니다. [이벤트 구성요소](/ko/guides/airbridge-event-elements#%EC%97%90%EC%96%B4%EB%B8%8C%EB%A6%BF%EC%A7%80-%EC%9D%B4%EB%B2%A4%ED%8A%B8-%EA%B5%AC%EC%84%B1%EC%9A%94%EC%86%8C-%ED%95%9C%EB%88%88%EC%97%90-%EB%B3%B4%EA%B8%B0) 중에 카테고리만 미리 정해진 상태이며, 이를 제외한 액션, 라벨, 밸류, 어트리뷰트는 사용자가 정의할 수 있습니다. 모든 스탠다드 이벤트는 에어브릿지가 정한 이름대로 대시보드에서 확인할 수 있습니다.

<Accordion title="스탠다드 이벤트 목록">
  이벤트 카테고리는 광고 채널 또는 서드파티로 이벤트를 전송할 때 사용되는 이름으로, 이는 각 채널 또는 서드파티에서 매핑된 이름으로 표시됩니다.

  | 스탠다드 이벤트 (국문) | 스탠다드 이벤트 (영문)      | 이벤트 카테고리                                 |
  | ------------- | ------------------ | ---------------------------------------- |
  | 앱 실행          | App Open           | app\_open                                |
  | 딥링크 실행        | Deeplink Open      | app\_deeplink\_open                      |
  | 앱 설치          | App Install        | app\_install                             |
  | 회원가입          | Sign-up            | airbridge.user.signup                    |
  | 로그인           | Sign-in            | airbridge.user.signin                    |
  | 로그아웃          | Sign-out           | airbridge.user.signout                   |
  | 홈화면 조회        | Home Screen        | airbridge.ecommerce.home.viewed          |
  | 상품리스트 조회      | Product Catalog    | airbridge.ecommerce.productList.viewed   |
  | 검색결과 조회       | Search Results     | airbridge.ecommerce.searchResults.viewed |
  | 상품상세페이지 조회    | Product View       | airbridge.ecommerce.product.viewed       |
  | 결제수단 등록       | Add Payment Info   | airbridge.addPaymentInfo                 |
  | 위시리스트 추가      | Add to Wishlist    | airbridge.addToWishlist                  |
  | 장바구니 담기       | Add to Cart        | airbridge.ecommerce.product.addedToCart  |
  | 결제 시작         | Initiate Checkout  | airbridge.initiateCheckout               |
  | 구매 완료         | Order Complete     | airbridge.ecommerce.order.completed      |
  | 구매 취소         | Order Cancel       | airbridge.ecommerce.order.canceled       |
  | 체험판 시작        | Start Trial        | airbridge.startTrial                     |
  | 구독            | Subscribe          | airbridge.subscribe                      |
  | 구독 취소         | Unsubscribe        | airbridge.unsubscribe                    |
  | 광고 노출         | Ad Impression      | airbridge.adImpression                   |
  | 광고 클릭         | Ad Click           | airbridge.adClick                        |
  | 튜토리얼 완료       | Complete Tutorial  | airbridge.completeTutorial               |
  | 레벨 달성         | Achieve Level      | airbridge.achieveLevel                   |
  | 과제 달성         | Unlock Achievement | airbridge.unlockAchievement              |
  | 평가            | Rate               | airbridge.rate                           |
  | 공유            | Share              | airbridge.share                          |
  | 일정 예약         | Schedule           | airbridge.schedule                       |
  | 크레딧 사용        | Spend Credits      | airbridge.spendCredits                   |
</Accordion>

### 스탠다드 이벤트 예시

<AccordionGroup>
  <Accordion title="회원가입 (airbridge.user.signup)">
    ###### 이벤트 정의 예시

    | <span style={{ display: 'inline-block', minWidth: '80px' }}>구성요소</span> | <span style={{ display: 'inline-block', minWidth: '150px' }}>설명</span> | <span style={{ display: 'inline-block', minWidth: '120px' }}>예시</span> |
    | ----------------------------------------------------------------------- | ---------------------------------------------------------------------- | ---------------------------------------------------------------------- |
    | 카테고리                                                                    | `airbridge.user.signup`                                                | -                                                                      |
    | 액션, 라벨                                                                  | \{회원 가입 시 플랫폼}                                                         | kakao, naver, apple                                                    |
    | 밸류                                                                      | -                                                                      | -                                                                      |
    | 어트리뷰트                                                                   | -                                                                      | -                                                                      |
    | 전송 트리거                                                                  | 유저가 회원가입을 완료한 시점                                                       | -                                                                      |

    <Note>
      **간편 로그인이나 간편 결제를 지원하는 경우**

      네이버, 카카오 등 간편 로그인이나 네이버페이, 카카오페이 등 간편 결제를 지원하는 경우 전송 트리거를 이벤트 완료 화면이 나타났을 때로 하는 것을 권장합니다. 그렇지 않고 유저가 완료 화면으로 이동하는 과정에 이벤트를 전송하면 에어브릿지로 이벤트 수집이 실패할 수 있습니다.
    </Note>
  </Accordion>

  <Accordion title="로그인 (airbridge.user.signin)">
    ###### 이벤트 정의 예시

    | <span style={{ display: 'inline-block', minWidth: '80px' }}>구성요소</span> | <span style={{ display: 'inline-block', minWidth: '150px' }}>설명</span> | <span style={{ display: 'inline-block', minWidth: '120px' }}>예시</span> |
    | ----------------------------------------------------------------------- | ---------------------------------------------------------------------- | ---------------------------------------------------------------------- |
    | 카테고리                                                                    | `airbridge.user.signin`                                                | -                                                                      |
    | 액션, 라벨                                                                  | \{로그인 방식}                                                              | email, apple                                                           |
    | 밸류                                                                      | -                                                                      | -                                                                      |
    | 어트리뷰트                                                                   | -                                                                      | -                                                                      |
    | 전송 트리거                                                                  | 유저가 로그인 완료 페이지나 이전 페이지에 도착한 시점                                         | -                                                                      |

    <Info>
      **알립니다**

      유저가 최종적으로 로그인에 성공했을 때 이벤트를 전송하세요. 로그인에 실패했을 때와 구분돼야 합니다. 그렇지 않으면 로그인 성공과 실패가 에어브릿지로 중복 수집될 수 있습니다.
    </Info>
  </Accordion>

  <Accordion title="구매 완료 (airbridge.ecommerce.order.completed)">
    ###### 수집 목적

    구매 완료 이벤트를 수집하면 광고로 유입된 유저가 발생시킨 매출을 확인할 수 있습니다. 또한 확인한 매출로 LTV(Life Time Value, 생애 가치), ROI(Return on Investment, 광고 지출 대비 수익률) 등을 측정하거나 광고 캠페인을 최적화할 수 있습니다.

    ###### 이벤트 정의 예시

    유저가 구매한 방법이나 유저가 구매한 상품의 카테고리를 확인하기 위해서는 액션과 라벨로 해당 정보를 수집해야 합니다. 또한 매출을 계산하기 위해서는 수집한 정보를 더해야 하기 때문에 구매 금액을 밸류로 수집합니다. 시맨틱 어트리뷰트를 설정하면 다양한 정보를 수집할 수 있습니다.

    | <span style={{ display: 'inline-block', minWidth: '80px' }}>구성요소</span> | <span style={{ display: 'inline-block', minWidth: '150px' }}>설명</span>                                                                                                                                                        | <span style={{ display: 'inline-block', minWidth: '120px' }}>예시</span>                                                     |
    | ----------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------- |
    | 카테고리                                                                    | `airbridge.ecommerce.order.completed`                                                                                                                                                                                         | -                                                                                                                          |
    | 액션과 라벨                                                                  | \{구매 방법}                                                                                                                                                                                                                      | 신용카드, 계좌이체                                                                                                                 |
    | 밸류                                                                      | \{구매 금액}                                                                                                                                                                                                                      | 53250                                                                                                                      |
    | 어트리뷰트                                                                   | - Product ID<br />- Product Name<br />- Product Price<br />- Product Category ID<br />- Product Category Name<br />- Product Brand ID<br />- Product Brand Name<br />- Currency<br />- Product Quantity<br />- Transaction ID | - P12345<br />- 베이직 반팔 티셔츠<br />- 19900<br />- C001<br />- 상의<br />- B100<br />- SSG브랜드<br />- KRW<br />- 20<br />- T12345 |
    | 전송 트리거                                                                  | 유저가 주문을 완료하고 주문서 페이지로 도착한 시점                                                                                                                                                                                                  | -                                                                                                                          |

    <Danger>
      **주의하세요**

      * `eventData.goal.semanticAttributes.currency`를 반드시 전송하세요.
      * 네이버, 카카오 등 간편 로그인이나 네이버페이, 카카오페이 등 간편 결제를 지원하는 경우 전송 트리거를 이벤트 완료 화면이 나타났을 때로 하는 것을 권장합니다. 그렇지 않고 유저가 완료 화면으로 이동하는 과정에 이벤트를 전송하면 에어브릿지로 이벤트 수집이 실패할 수 있습니다.
    </Danger>
  </Accordion>
</AccordionGroup>

<Note>
  **에어브릿지 서버로 이벤트를 전송하세요**

  리포트에서 이벤트 데이터를 조회하려면 에어브릿지 SDK가 수집한 이벤트를 에어브릿지 서버로 전송해야 합니다. 아래 가이드와 이벤트 택소노미를 개발자에게 함께 전달하고 인앱 이벤트 전송을 개발해달라고 요청하세요. 안드로이드, iOS 외에 플러터, 리액트 네이티브 등 다른 플랫폼도 지원하니 개발자 가이드 목록을 확인하세요.

  * [안드로이드 SDK - 인앱 이벤트 전송하기](/ko/developers/android-sdk-v4#%EC%9D%B8%EC%95%B1-%EC%9D%B4%EB%B2%A4%ED%8A%B8-%EC%A0%84%EC%86%A1%ED%95%98%EA%B8%B0)
  * [iOS SDK - 인앱 이벤트 전송하기](/ko/developers/ios-sdk-v4#%EC%9D%B8%EC%95%B1-%EC%9D%B4%EB%B2%A4%ED%8A%B8-%EC%A0%84%EC%86%A1%ED%95%98%EA%B8%B0)
</Note>

## 커스텀 이벤트

커스텀 이벤트는 스탠다드 이벤트 외에 트래킹할 유저 행동을 정의한 이벤트입니다. 사용자가 운영 중인 서비스에 맞춰 모든 [이벤트 구성요소](/ko/guides/airbridge-event-elements#%EC%97%90%EC%96%B4%EB%B8%8C%EB%A6%BF%EC%A7%80-%EC%9D%B4%EB%B2%A4%ED%8A%B8-%EA%B5%AC%EC%84%B1%EC%9A%94%EC%86%8C-%ED%95%9C%EB%88%88%EC%97%90-%EB%B3%B4%EA%B8%B0)를 정의해야 합니다.

### 커스텀 이벤트 예시

<AccordionGroup>
  <Accordion title="게임 플레이 (play_game)">
    ###### 수집 목적

    앱을 설치한 이후에 게임을 플레이하는 유저의 상세한 잔존율을 분석할 수 있습니다.

    ###### 이벤트 정의 예시

    게임 플레이는 게임 장르에 따라 수집하는 시점이 다를 수 있습니다. RPG 장르는 실제 '게임 시작' 버튼을 클릭한 시점에 이벤트를 수집할 수 있습니다. 퍼즐, 아케이드 장르는 스테이지를 시작할 때마다 이벤트를 수집할 수 있습니다.

    | <span style={{ display: 'inline-block', minWidth: '80px' }}>구성요소</span> | <span style={{ display: 'inline-block', minWidth: '240px' }}>설명</span> |
    | ----------------------------------------------------------------------- | ---------------------------------------------------------------------- |
    | 카테고리                                                                    | `play_game`                                                            |
    | 액션, 라벨                                                                  | -                                                                      |
    | 밸류                                                                      | -                                                                      |
    | 어트리뷰트                                                                   | -                                                                      |
    | 트리거                                                                     | 게임을 시작하거나 스테이지를 시작하는 시점                                                |
  </Accordion>

  <Accordion title="보너스 획득 (claim_bonus)">
    ###### 수집 목적

    게임 서비스에서 제공하는 보너스를 획득한 유저를 분석할 수 있습니다. 또한 보너스를 획득하기 위해 유저가 어떻게 게임을 플레이했는지 확인할 수 있습니다.

    ###### 이벤트 정의 예시

    보너스를 통해 여러 종류의 재화를 유저에게 제공한다면 액션 또는 라벨로 제공한 재화 종류에 관한 정보를 수집할 수 있습니다.

    | <span style={{ display: 'inline-block', minWidth: '80px' }}>구성요소</span> | <span style={{ display: 'inline-block', minWidth: '240px' }}>설명</span> |
    | ----------------------------------------------------------------------- | ---------------------------------------------------------------------- |
    | 카테고리                                                                    | `claim_bonus`                                                          |
    | 액션, 라벨                                                                  | \{보너스로 받은 재화 종류}                                                       |
    | 밸류                                                                      | -                                                                      |
    | 어트리뷰트                                                                   | -                                                                      |
    | 트리거                                                                     | 유저가 보너스를 받은 시점                                                         |
  </Accordion>
</AccordionGroup>

<Note>
  **에어브릿지 서버로 이벤트를 전송하세요**

  리포트에서 이벤트 데이터를 조회하려면 에어브릿지 SDK가 수집한 이벤트를 에어브릿지 서버로 전송해야 합니다. 아래 가이드와 이벤트 택소노미를 개발자에게 함께 전달하고 인앱 이벤트 전송을 개발해달라고 요청하세요. 안드로이드, iOS 외에 플러터, 리액트 네이티브 등 다른 플랫폼도 지원하니 개발자 가이드 목록을 확인하세요.

  * [안드로이드 SDK - 인앱 이벤트 전송하기](/ko/developers/android-sdk-v4#%EC%9D%B8%EC%95%B1-%EC%9D%B4%EB%B2%A4%ED%8A%B8-%EC%A0%84%EC%86%A1%ED%95%98%EA%B8%B0)
  * [iOS SDK - 인앱 이벤트 전송하기](/ko/developers/ios-sdk-v4#%EC%9D%B8%EC%95%B1-%EC%9D%B4%EB%B2%A4%ED%8A%B8-%EC%A0%84%EC%86%A1%ED%95%98%EA%B8%B0)
</Note>

<link rel="alternate" hrefLang="en" href="https://help.airbridge.io/en/guides/airbridge-event-types" />

<link rel="alternate" hrefLang="ko" href="https://help.airbridge.io/ko/guides/airbridge-event-types" />
