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

# Event Types

<Info>
  **Note**

  Airbridge events come in two types, Standard Events and Custom Events. Use a Standard Event if one matches the user action you want to track. If no Standard Event matches, define a new Custom Event.
</Info>

## Standard Events

Standard Events are events Airbridge has predefined for major user actions. Only the category is predefined in the [event components](/en/guides/airbridge-event-elements#airbridge-event-components-at-a-glance). You can define the action, label, value, and attribute. Each Standard Event appears in the dashboard with its predefined name.

<Accordion title="List of Standard Events">
  The event category is the identifier used when forwarding events to ad channels or third-party platforms. Each destination displays it under its own mapped name.

  | Name               | Event Category                           |
  | ------------------ | ---------------------------------------- |
  | 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>

### Standard Event Examples

<AccordionGroup>
  <Accordion title="Sign-up (airbridge.user.signup)">
    **Event Definition Example**

    | <span style={{ display: 'inline-block', minWidth: '80px' }}>**Component**</span> | <span style={{ display: 'inline-block', minWidth: '150px' }}>**Description**</span> | <span style={{ display: 'inline-block', minWidth: '120px' }}>**Example**</span> |
    | -------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------- | ------------------------------------------------------------------------------- |
    | Category                                                                         | `airbridge.user.signup`                                                             | -                                                                               |
    | Action, Label                                                                    | \{Sign-up platform}                                                                 | kakao, naver, apple                                                             |
    | Value                                                                            | -                                                                                   | -                                                                               |
    | Attribute                                                                        | -                                                                                   | -                                                                               |
    | Trigger                                                                          | When the user completes sign-up                                                     | -                                                                               |

    <Note>
      **If you support social login or one-click payment**

      If your app supports social login (e.g., Naver, Kakao) or one-click payment (e.g., Naver Pay, Kakao Pay), set the trigger to when the confirmation screen appears. Sending the event before the confirmation screen loads may cause the event to fail to reach Airbridge.
    </Note>
  </Accordion>

  <Accordion title="Sign-in (airbridge.user.signin)">
    **Event Definition Example**

    | <span style={{ display: 'inline-block', minWidth: '80px' }}>**Component**</span> | <span style={{ display: 'inline-block', minWidth: '150px' }}>**Description**</span> | <span style={{ display: 'inline-block', minWidth: '120px' }}>**Example**</span> |
    | -------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------- | ------------------------------------------------------------------------------- |
    | Category                                                                         | `airbridge.user.signin`                                                             | -                                                                               |
    | Action, Label                                                                    | \{Sign-in method}                                                                   | email, apple                                                                    |
    | Value                                                                            | -                                                                                   | -                                                                               |
    | Attribute                                                                        | -                                                                                   | -                                                                               |
    | Trigger                                                                          | When the user arrives at the sign-in completion page or the previous page           | -                                                                               |

    <Info>
      **Note**

      Send the event only when the user successfully signs in. This must be distinct from failed sign-in attempts. Otherwise, both successful and failed sign-ins may be collected in Airbridge.
    </Info>
  </Accordion>

  <Accordion title="Order Complete (airbridge.ecommerce.order.completed)">
    **What you can track**

    Measure revenue from users acquired through ads. Use this data to calculate LTV (Lifetime Value) and ROI (Return on Investment), or optimize ad campaigns.

    **Event definition**

    Collect the purchase method using action and label. Collect the purchase amount as value to sum revenue. Use semantic attributes to capture additional order details.

    | <span style={{ display: 'inline-block', minWidth: '80px' }}>Element</span> | <span style={{ display: 'inline-block', minWidth: '150px' }}>Description</span>                                                                                                                                               | <span style={{ display: 'inline-block', minWidth: '120px' }}>Example</span>                                                        |
    | -------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------- |
    | Category                                                                   | `airbridge.ecommerce.order.completed`                                                                                                                                                                                         | -                                                                                                                                  |
    | Action, Label                                                              | \{purchase method}                                                                                                                                                                                                            | Credit card, Bank transfer                                                                                                         |
    | Value                                                                      | \{purchase amount}                                                                                                                                                                                                            | 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 />- Basic T-Shirt<br />- 19900<br />- C001<br />- Tops<br />- B100<br />- SSG Brand<br />- KRW<br />- 20<br />- T12345 |
    | Trigger                                                                    | When the user completes the order and arrives at the order confirmation page                                                                                                                                                  | -                                                                                                                                  |

    <Danger>
      **Important**

      * Always send `eventData.goal.semanticAttributes.currency`.
      * If your app supports social login (e.g., Naver, Kakao) or one-click payment (e.g., Naver Pay, Kakao Pay), set the trigger to when the confirmation screen appears. Sending the event before the confirmation screen loads may cause the event to fail to reach Airbridge.
    </Danger>
  </Accordion>
</AccordionGroup>

<Note>
  **Send events to the Airbridge server**

  To view event data in reports, your Airbridge SDK must send collected events to the Airbridge server. Share the guides below and your event taxonomy with your developer and ask them to implement in-app event tracking. Airbridge supports Android, iOS, Flutter, React Native, and more — check the developer guide list for all available platforms.

  * [Android SDK - Send in-app events](/en/developers/android-sdk-v4#send-in-app-events)
  * [iOS SDK - Send in-app events](/en/developers/ios-sdk-v4#send-in-app-events)
</Note>

## Custom Events

Custom Events are events you define to track user actions beyond Standard Events. Define all [event components](/en/guides/airbridge-event-elements#airbridge-event-components-at-a-glance) to fit your service.

### Custom Event Examples

<AccordionGroup>
  <Accordion title="Game Play (play_game)">
    **What you can track**

    Analyze detailed retention for users who play the game after installing the app.

    **Event definition**

    The trigger timing varies by genre. For RPG games, collect the event when the user taps the Start Game button. For puzzle or arcade games, collect it at the start of each stage.

    | <span style={{ display: 'inline-block', minWidth: '80px' }}>**Element**</span> | <span style={{ display: 'inline-block', minWidth: '240px' }}>**Description**</span> |
    | ------------------------------------------------------------------------------ | ----------------------------------------------------------------------------------- |
    | Category                                                                       | -                                                                                   |
    | Action, Label                                                                  | -                                                                                   |
    | Attribute                                                                      | -                                                                                   |
    | Trigger                                                                        | When the user starts a game or stage                                                |
  </Accordion>

  <Accordion title="Claim Bonus (claim_bonus)">
    **What you can track**

    Analyze users who claim bonuses in your game. Track which in-game actions lead to bonus claims.

    **Event definition**

    If your game distributes multiple reward types through bonuses, use the action or label to capture the reward type.

    | <span style={{ display: 'inline-block', minWidth: '80px' }}>**Component**</span> | <span style={{ display: 'inline-block', minWidth: '240px' }}>**Description**</span> |
    | -------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------- |
    | Category                                                                         | `claim_bonus`                                                                       |
    | Action, Label                                                                    | \{bonus reward type}                                                                |
    | Value                                                                            | -                                                                                   |
    | Attribute                                                                        | -                                                                                   |
    | Trigger                                                                          | When the user claims a bonus                                                        |
  </Accordion>
</AccordionGroup>

<Note>
  **Send events to the Airbridge server**

  To view event data in reports, your Airbridge SDK must send collected events to the Airbridge server. Share the guides below and your event taxonomy with your developer and ask them to implement in-app event tracking. Airbridge supports Android, iOS, Flutter, React Native, and more — check the developer guide list for all available platforms.

  * [Android SDK - Send in-app events](/en/developers/android-sdk-v4#send-in-app-events)
  * [iOS SDK - Send in-app events](/en/developers/ios-sdk-v4#send-in-app-events)
</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" />