> ## 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.

# 권장하는 에어브릿지 이벤트 - 콘텐츠

콘텐츠 분야에서 권장하는 이벤트 택소노미를 참고하세요. 에어브릿지 이벤트와 이벤트 택소노미에 대해 먼저 이해하면 더 원활하게 이벤트 택소노미를 정의할 수 있습니다.

* [에어브릿지 이벤트 종류](/ko/guides/airbridge-event-types)
* [에어브릿지 이벤트 구성요소](/ko/guides/airbridge-event-elements)
* [이벤트 택소노미](/ko/guides/airbridge-event-taxonomy)

## **권장 이벤트 택소노미 - 콘텐츠**

콘텐츠 분야에서 권장하는 이벤트 택소노미입니다. 권장 이벤트 택소노미를 참고해 이벤트 택소노미를 정의하세요.

<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>

### 예시

<Info>
  **알립니다**

  앱 설치(Install), 딥링크 실행(Deeplink Open), 앱 실행(Open)은 에어브릿지 SDK를 설치하면 별도 작업을 하지 않아도 에어브릿지로 자동 수집됩니다.
</Info>

#### 스탠다드 이벤트

<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.product.viewed)">
    ###### 이벤트 정의 예시

    | 구성요소   | 설명                                                                                                                                                                                                              | 예시                                                                                                                     |
    | ------ | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------- |
    | 카테고리   | `airbridge.ecommerce.product.viewed`                                                                                                                                                                            | -                                                                                                                      |
    | 액션, 라벨 | \{콘텐츠 유형}, \{유입 위치}                                                                                                                                                                                             | movie, episode, manga, chapter, homepage, search, recommendation, banner                                               |
    | 밸류     | -                                                                                                                                                                                                               | -                                                                                                                      |
    | 어트리뷰트  | - Product ID<br />- Product Name<br />- Product Category ID<br />- Product Category Name<br />- Product Brand ID<br />- Product Brand Name<br />- Product Price<br />- Product Currency<br />- Product Position | - EP\_1001<br />- 나의 해방일지<br />- CAT\_EP<br />- episode<br />- PUB\_001<br />- 스튜디오드래곤<br />- 3900<br />- KRW<br />- 2 |
    | 전송 트리거 | 유저가 콘텐츠 상세 페이지를 조회한 시점                                                                                                                                                                                          | -                                                                                                                      |

    유료 콘텐츠 여부는 어트리뷰트 중 Product Price를 활용하세요. 유저가 콘텐츠 상세 페이지를 조회한 시점에 1회만 전송하세요.
  </Accordion>

  <Accordion title="검색결과 조회 (airbridge.ecommerce.searchResults.viewed)">
    ###### 이벤트 정의 예시

    | 구성요소   | 설명                                                                                                                                                                                | 예시                                                                                                     |
    | ------ | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------ |
    | 카테고리   | `airbridge.ecommerce.searchResults.viewed`                                                                                                                                        | -                                                                                                      |
    | 액션, 라벨 | \{검색 위치}                                                                                                                                                                          | homepage, category\_page                                                                               |
    | 밸류     | -                                                                                                                                                                                 | -                                                                                                      |
    | 어트리뷰트  | - Search Query<br />- Product ID<br />- Product Name<br />- Product Category ID<br />- Product Category Name<br />- Product Price<br />- Product Currency<br />- Product Position | - romance<br />- EP\_1001<br />- 나의 해방일지<br />- CAT\_EP<br />- episode<br />- 3900<br />- KRW<br />- 1 |
    | 전송 트리거 | 유저가 검색 결과 화면을 조회한 시점                                                                                                                                                              | -                                                                                                      |

    <Info>
      **알립니다**

      어트리뷰트 중 Search Query는 꼭 수집하는 것을 권장합니다. 이는 검색어별 전환율 분석에 활용할 수 있습니다.
    </Info>
  </Accordion>

  <Accordion title="위시리스트 추가 (airbridge.addToWishlist)">
    ###### 이벤트 정의 예시

    | 구성요소   | 설명                                                                                                                                                   | 예시                                                                                                       |
    | ------ | ---------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------- |
    | 카테고리   | `airbridge.addToWishlist`                                                                                                                            | -                                                                                                        |
    | 액션, 라벨 | \{콘텐츠 유형}                                                                                                                                            | movie, manga                                                                                             |
    | 밸류     | -                                                                                                                                                    | -                                                                                                        |
    | 어트리뷰트  | - List ID<br />- Product ID<br />- Product Name<br />- Product Category ID<br />- Product Category Name<br />- Product Price<br />- Product Currency | - WATCHLIST\_DEFAULT<br />- EP\_1001<br />- 나의 해방일지<br />- CAT\_EP<br />- episode<br />- 3900<br />- KRW |
    | 전송 트리거 | 유저가 콘텐츠를 즐겨찾기나 보관함에 추가한 시점                                                                                                                           | -                                                                                                        |

    <Info>
      **알립니다**

      유저가 정상적으로 해당 이벤트를 완료한 시점, 즉 최종적으로 해당 이벤트가 성공했을 때 이벤트를 전송하세요.
    </Info>
  </Accordion>

  <Accordion title="결제 시작 (airbridge.initiateCheckout)">
    ###### 이벤트 정의 예시

    | 구성요소   | 설명                                                                                                                                                                                                                                                                          | 예시                                                                                                                                                              |
    | ------ | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------- |
    | 카테고리   | `airbridge.initiateCheckout`                                                                                                                                                                                                                                                | -                                                                                                                                                               |
    | 액션, 라벨 | \{결제 유형}, \{결제 유입 위치}                                                                                                                                                                                                                                                       | subscription, one\_off\_purchase, paywall, content\_detail, promotion\_banner                                                                                   |
    | 밸류     | \{결제 예정 금액}                                                                                                                                                                                                                                                                 | 3900, 9900                                                                                                                                                      |
    | 어트리뷰트  | - Transaction ID<br />- Currency<br />- Total Quantity<br />- Product ID<br />- Product Name<br />- Product Category ID<br />- Product Category Name<br />- Product Brand ID<br />- Product Brand Name<br />- Product Price<br />- Product Currency<br />- Product Quantity | - CHK\_20260201<br />- KRW<br />- 1<br />- EP\_1001<br />- 나의 해방일지<br />- CAT\_EP<br />- episode<br />- PUB\_001<br />- 스튜디오드래곤<br />- 3900<br />- KRW<br />- 1 |
    | 전송 트리거 | 유저가 결제 화면을 열고 결제 대상 및 금액 정보가 모두 노출된 시점                                                                                                                                                                                                                                      | -                                                                                                                                                               |

    <Info>
      **알립니다**

      원활한 퍼널 분석을 하려면 액션이나 라벨을 활용해 구독, 구매 등 결제 유형을 구분해서 이벤트를 수집하는 것을 권장합니다.
    </Info>
  </Accordion>

  <Accordion title="구독 (airbridge.subscribe)">
    ###### 이벤트 정의 예시

    | 구성요소   | 설명                                                                                                                                                                                                     | 예시                                                                                                                                      |
    | ------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | --------------------------------------------------------------------------------------------------------------------------------------- |
    | 카테고리   | `airbridge.subscribe`                                                                                                                                                                                  | -                                                                                                                                       |
    | 액션, 라벨 | \{구독 유형}, \{구독 유입 위치}                                                                                                                                                                                  | monthly, yearly, paywall, onboarding\_offer                                                                                             |
    | 밸류     | \{구독 결제 금액}                                                                                                                                                                                            | 9900                                                                                                                                    |
    | 어트리뷰트  | - Transaction ID<br />- Is Revenue Event<br />- Is Renewal Event<br />- Currency<br />- Product ID<br />- Product Name<br />- Product Price<br />- Product Currency<br />- Period<br />- Renewal Count | - SUB\_20260201<br />- true<br />- false<br />- KRW<br />- PLAN\_MONTHLY<br />- 월정액 프리미엄<br />- 9900<br />- KRW<br />- monthly<br />- 0 |
    | 전송 트리거 | 유저가 구독 결제를 완료하고 구독 상태가 활성화된 시점                                                                                                                                                                         | -                                                                                                                                       |

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

      어트리뷰트 중 `eventData.goal.semanticAttributes.currency`를 반드시 수집하세요.
    </Danger>

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

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

    유저가 재구독했다면 서버 투 서버 방식으로 이벤트를 전송해야 합니다.
  </Accordion>

  <Accordion title="구매 완료 (airbridge.ecommerce.order.completed)">
    ###### 이벤트 정의 예시

    | 구성요소   | 설명                                                                                                                                                                                                                            | 예시                                                                                                                                   |
    | ------ | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------ |
    | 카테고리   | `airbridge.ecommerce.order.completed`                                                                                                                                                                                         | -                                                                                                                                    |
    | 액션, 라벨 | \{콘텐츠 유형}, \{결제 수단}                                                                                                                                                                                                           | episode, movie, manga, creditcard, appleiap, googleiap, kakaopay                                                                     |
    | 밸류     | \{최종 결제 금액}                                                                                                                                                                                                                   | 53250                                                                                                                                |
    | 어트리뷰트  | - Currency<br />- Product ID<br />- Product Name<br />- Product Price<br />- Product Quantity<br />- Product Category ID<br />- Product Category Name<br />- Product Brand ID<br />- Product Brand Name<br />- Transaction ID | - KRW<br />- EP\_1001<br />- 나의 해방일지<br />- 3900<br />- 1<br />- CAT\_EP<br />- episode<br />- PUB\_001<br />- 스튜디오드래곤<br />- T12345 |
    | 전송 트리거 | 유저가 콘텐츠를 구매하고나서 즉시 콘텐츠를 열람할 수 있는 상태가 된 시점                                                                                                                                                                                     | -                                                                                                                                    |

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

      어트리뷰트 중 `eventData.goal.semanticAttributes.currency`를 반드시 수집하세요.
    </Danger>

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

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

<link rel="alternate" hrefLang="ko" href="https://help.airbridge.io/ko/guides/recommended-content-airbridge-events" />