1. Preparing for Airbridge Implementation

Introduction

In the previous document, we provided a general overview of the Airbridge onboarding process. In this document, we will explain in detail the basic tasks that marketers need to prepare for implementing Airbridge. We will guide you through the necessary requirements, including both essential and recommended items such as dashboard creation, advertising channel integration planning, event design, and review of additional development work. Please carefully review the contents below and proceed with the preparation work.

1.1 Register Your App on Airbridge

First, please create an Airbridge account and register your app. For detailed dashboard creation instructions, please refer to the user guide below. ▶ Registering a New App ▶ Go directly to the Airbridge Dashboard : Click the ‘Dashboard’ button. The Airbridge app mode cannot be changed after creation, so please carefully select either Performance Measurement Mode or Development Mode. Generally, you should select Performance Measurement Mode for production apps where you will measure advertising performance, and Development Mode for staging or development apps that require testing during the development process. If you do not have a separate development app, it is fine to create only a Performance Measurement Mode app. Managing Users (Optional) If there are other users, invite them to the Airbridge app. ▶ Managing Users in Your Organization

1.2 Marketing channel planning

Airbridge is fundamentally a Mobile Marketing Performance measurement tool (MMP). Please check the advertising channels you operate and verify whether they can be integrated with Airbridge. You can find a list of advertising channels integrated with Airbridge in the user guide below. If you cannot find an advertising channel you operate, please request that the advertising channel complete an advertising channel integration application form. ▶ List of Advertising Channels Integrated with Airbridge ▶ Advertising Channel Integration Application Form

1.3 Event taxonomy design

Event taxonomy is the process of defining and structuring the events to be collected within an app or website. A well-designed event taxonomy effectively supports data analysis and campaign performance measurement. Please refer to the user guide below to organize the events and sub-properties needed to check advertising performance.

▶ Airbridge Events: You can reference various information about Airbridge events.
▶ Event Taxonomy: This is the official guide on how to design taxonomy.
▶ Follow Along with Event Taxonomy Design: If this is your first time designing taxonomy, check this onboarding guide.
▶ Example event taxonomies by industry can be found in the guides below.

Frequently Asked Questions

How many events do other companies typically collect?

Companies typically collect only 5-15 key events that are essential for checking advertising performance. The more events you collect, the more management resources are required, so it’s best to select and collect only the events that are essential for checking advertising performance.

Can I send events via server-to-server (API) instead of SDK?

If you collect events through the SDK, there is device information that is automatically collected. Airbridge automatically collects certain information such as Country Code and App Version, which is useful for setting up ad fraud verification rules. (▶ Data Automatically Collected by Airbridge SDK) Events that do not fall under the above category can be sent through Airbridge’s Server To Server Event API. When using the API, you must consider the following:

Server To Server Event API uses device ID (cookie ID in the case of web) or User ID as identifiers. You must obtain and store the Device ID from Airbridge SDK and then send it to the API, or set user identifiers in Airbridge SDK so that events sent via API and SDK events are matched by User ID.
The eventTimestamp must be within 24 hours of the event transmission time, and if the difference is more than 24 hours, the Airbridge server will not process the event. Please use an eventTimestamp within 24 hours of the transmission time.
For smooth postback, please send osName and osVersion under device together.

For detailed API requests and restrictions, please refer to the API guide below. ▶ Server To Server Event API Guide

What is the ad impression (adImpression) event? Do I need to collect it to check advertising performance?

The ‘ad impression (adImpression)’ event is an event that tracks whether users saw an ad on in-app ad placements. For example, a game company that generates revenue from ads in mobile apps may have ad placements that provide items to users when they view in-app ads. In this case, the ad impression event is collected when the user views the in-app ad. If you are using an ad mediation platform such as Google AdMob, AppLovin MAX, or Unity LevelPlay, please check the sample code in the guide below. ▶ Integrating Mediation Platforms Ad impression and click data occurring on external placements outside your service are collected through tracking links or once ad channel integration is completed. This data can be viewed as ‘Impressions’ and ‘Clicks’ in the dashboard, and there is no need to additionally collect events within the app.

It’s difficult to determine whether to distinguish user behavior as an event or as a sub-property.

The criterion for Airbridge to postback to media is ‘events’. Please collect information that needs to be posted back to media as events. Examples:

You will postback when level 10 is achieved in a game.
- Collect a custom event such as ‘achieve_level_10’.
First purchase events are sent strictly according to internal criteria.
- Please collect a custom event such as ‘order_complete_first’ separately from the purchase completion event.
Do I need to collect all semantic attributes in Airbridge?

Semantic attributes are optional and should only be collected if needed for advertising performance analysis. In other words, if they are not needed to check advertising performance, you do not need to collect them. The recommended list of semantic attributes is as follows:

Product-related events (e.g., ‘Add to Cart’, ‘Product View’, etc.)
- currency, product ID, product name, price, quantity
Purchase completion and purchase cancellation events
- currency, transactionID, product ID, product name, price, quantity
Ad impression events
- currency

1.4 Additional Items

Since Airbridge provides various features beyond app advertising performance tracking, you can proceed with additional work as described below if necessary. Marketers can determine whether each task is needed and can additionally request the development team to perform the corresponding work. SDK Work Is Required These are tasks that require additional SDK work to use features provided by Airbridge.

Task List	Task Purpose	Reference Materials
Migrating to Airbridge	Migrate from other MMP to Airbridge	Guide
Digital Markets Act (DMA) Compliance	Send data to Airbridge in compliance with Europe’s Digital Markets Act.Can be skipped if not conducting marketing in the European Economic Area (EEA).	Guide
SDK Signature Setup	Apply additional security information to events to prevent SDK spoofing fraud.	Guide
App Uninstall Event Tracking	Track user app uninstall events in Airbridge.	Guide
Website Performance Measurement	In addition to app advertising, you are running ads that land on websites, and you want to check the advertising performance of these websites as well.	Guide
Web-to-App Performance Measurement and Landing Optimization	When users who landed on a website click the ‘View in App’ CTA button, you want the performance to be attributed to the external ad that landed the user on the website.When the ‘View in App’ button is clicked, you want to ensure that users can view the same content in the app that they were viewing on the website.	Guide
Third-Party Integration	You want to send Airbridge attribution data to various third-party platforms. 1. Analytics (e.g. Amplitude, Mixpanel, Google Analytics 4) 2. CRM (e.g. Braze, MoEngage) 3. CDP (e.g. Segment)	Guide

SDK Work Is Not Required These are tasks that do not require additional SDK work when using features provided by Airbridge. However, you will need help from other administrators, so please check the task purpose.

Task List	Task Purpose	Reference Materials
Cloud Storage Integration	*Data storage administrator assistance required In the Airbridge dashboard, raw data can only be extracted for data from the last 6 months.If you want to automate data backup, we recommend integrating Airbridge with data storage (e.g., AWS, GCS, Azure) to automatically send the previous day’s data early the next morning.	Guide
Custom Domain Usage	- DNS administrator assistance required Instead of the default domain (abr.ge), you want to create clean and attractive URLs that include your brand name.You can change the tracking link domain for custom channels to your own subdomain. Example: abr.ge/1234 -> ad.ab180.co/1234	Guide

Next Steps

This completes the integration preparation work. Please deliver the designed event taxonomy and additional development work list to your development team and proceed to the next step. ▶ 2. Performing Airbridge Development Task

​Introduction

​1.1 Register Your App on Airbridge

​1.2 Marketing channel planning

​1.3 Event taxonomy design

​Frequently Asked Questions

​1.4 Additional Items

​Next Steps