Skip to main content
To effectively analyze user behavior in Airbridge, it is essential to have appropriate event definitions and event taxonomies tailored to the specific industry of the service. Consult the recommended event taxonomy for the commerce services.
NoteBefore you continue reading on, you may need a basic understanding of Airbridge events. Refer to the following articles for more information.The following article from the developer guide is for developers.

Commerce

Users conduct various actions until they make the purchase. Such actions include engaging with ads, checking product information, adding items to their wishlists, and more. User drop-off is frequent, even during the payment process. For example, some users drop off while filling out the required information on the order page. Before defining Airbridge events for your commerce app, it’s important to understand your app’s typical user journey. Collecting the recommended Airbridge events for commerce apps will help answer the following questions:
  • How much revenue has been generated by users who were acquired by certain ad campaigns?
  • At which stage did users drop off?
  • What are the products that users are most interested in?
  • Which products in shopping carts or wishlists are unpopular?
Below is the recommended event taxonomy for commerce apps. The event taxonomy may vary depending on the typical user journey and the product item type. The Install, Deeplink Open, and Open events don’t require any taxonomy setup for Airbridge to collect them, as the events are automatically collected once the Airbridge SDK is installed.

Standard Event

For the full list of Standard Events, refer to this article.
Defining Custom GroupBysBy configuring the Custom GroupBys, you can collect more information using the Action and Label. Refer to the example below.
  1. Define the Action and Label to collect information such as the product item name, product ID, and product category. Use an underscore (_) or hyphen (-). For example, laptop-110-electronics.
  2. Configure the Custom GroupBy using underscore (_) or hyphen (-) that you used in the previous step.
  3. By using the Custom GroupBys as in the Actuals Report, you can view the data by the product item name, product ID, and category.
The purpose of collecting this event
You can identify the users who signed up after installing the game and measure their user retention.
Event definition sample
You may define the Action or Label to collect the platform from which the user signed up. You can use the attribute “Is First Event per User ID By Client,” to collect information that can tell whether the sign-up was the first sign-up event.
The purpose of collecting this event
You can identify the users who signed in and measure their user retention.
Event definition sample
You may define the Action or Label to collect the platform from which the user signed in.
The purpose of collecting this event
You can identify the product items searched for by the users who opened the app through ads and learn which items the users are interested in.
Event definition sample
You may define the Action or Label to collect the search keywords.
The purpose of collecting this event
You can measure the number of users who viewed the home screen.
Event definition sample
The purpose of collecting this event
You can identify the product item lists viewed by the users who opened the app through ads.
Event definition sample
You may define the Action or Label to collect information on the product item list the user viewed.
The purpose of collecting this event
You can identify the product items viewed by the users who opened the app through ads.
Event definition sample
You may define the Action or Label to collect the information on the product items. You can also collect the product price information as Value.
The purpose of collecting this event
You can identify the product items added to the wishlist by the users who opened the app through ads and learn which items the users are interested in.
Event definition sample
You may define the Action or Label to collect information on the users added to their wishlists.
The purpose of collecting this event
You can identify the product items added to the shopping cart by the users who opened the app through ads and learn which items the users are interested in or which items stayed for a long time in the cart but wasn’t purchased.
Event definition sample
You may define the Action, Label, Value, and Attribute to collect information on the product items the users added to their shopping carts.
The purpose of collecting this event
The payment page is where users enter the required information to purchase products. You can measure the drop-off rate of users who have navigated to the payment page.
Event definition sample
You may use the attributes to collect information on product items that the user intended to purchase.
What you can trackMeasure revenue from users acquired through ads. Use this data to calculate LTV (Lifetime Value) and ROI (Return on Investment), or optimize ad campaigns.Event definitionCollect the purchase method using action and label. Collect the purchase amount as value to sum revenue. Use semantic attributes to capture additional order details.
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.
The purpose of collecting this event
To accurately calculate the revenue amount, the refund amount must be subtracted from the total purchase amount.
Event definition sample
You may define the Action or Label to collect information on the payment method and the category of the purchased item that is canceled. The canceled amount shall be collected as Value.
AttentionThe Order Cancel event (airbridge.ecommerce.order.canceled) shall be defined so that the Transaction ID is collected as semantic attributes. The Transaction ID of the Order Cancel event must match the Transaction ID of the Order Complete event (airbridge.ecommerce.order.completed).For more details on defining the Order Cancel event, refer to this article.
The purpose of collecting this event
You can collect information on users who invited friends to the app or who used the sharing feature to share a promo campaign or content.
Event definition sample
You may define the Action or Label to collect the promo campaign or content name the user shared. You can also use Attributes to collect additional information.

Custom Events

If necessary, define additional Custom Events other than the events listed below to collect them.
The purpose of collecting this event
You can measure the impressions received for a promo page.
Event definition sample
You may define the Action or Label to collect information on the promo page type. You can also use the Semantic Attributes to collect more information about the promo, such as the description of the promo page, the location of the promo page within the app, and more.