Event Properties

Airbridge only collects event data that is defined as an Airbridge event. Learn about the properties you need to define an Airbridge event. We recommend reading this guide alongside the Event Types guide.

An Airbridge event is made up of the following properties: Event Category, Event Action, Event Label, Event Value, Attribute, and Trigger.

The Event Category is a required property that you must define for every Airbridge event. It serves as the Airbridge event name. The Event Category also determines which events are sent to ad channels as postbacks.

Airbridge events fall into Standard Events and Custom Events, depending on whether the Event Category is predefined. Standard Events use an Event Category predefined by Airbridge, and the dashboard shows the event name based on that Event Category. Custom Events use an Event Category that you create.

An Event Category must follow these rules:

• It is case-sensitive.

• Standard Event names use an Event Category predefined by Airbridge.

• Custom Event names can contain only letters, numbers, and underscores (_), and cannot begin with airbridge.. The maximum length is 128 characters.

• An Event Category that contains : cannot be used.

The following limitations apply to data collected as the Event Category:

• Events that don't match the data type aren't collected. The Event Category data type is string.

• If the collected data exceeds the maximum length of 128 characters, only data up to the limit is collected.

To view data collected as the Event Category, select the metric with the same name as the Event Category, or select Event Category as a GroupBy, filter, or property. The data is available in Airbridge reports and raw data exports.

Event Action and Event Label are additional details collected as strings in an Airbridge event. You can define up to two.

Collect any detail with Event Action and Event Label

The event details are not related to the literal definitions of the words action and label. This means that you can use the Event Action to collect event details that are not related to user actions.

Event Action and Event Label must follow these rules:

• They can contain letters, Korean characters, and numbers. The maximum length is 128 characters.

• They are case-sensitive. Spaces and special characters (?, !, ,, ., /, &, (, ), -, _) are supported. We recommend using only the underscore (_).

The following limitations apply to data collected as the Event Action and Event Label:

• Events that don't match the data type aren't collected. The Event Action and Event Label data type is string.

• If the collected data exceeds the maximum length of 128 characters, only data up to the limit is collected.

To view data collected as the Event Action and Event Label, select Event Action and Event Label as a GroupBy. The data is available in Airbridge reports and raw data exports.

The Event Value is an additional detail collected as a number in an Airbridge event. For example, to collect the revenue from events that generate revenue, such as Order Complete or an ad click, include the Event Value in the event.

The following limitations apply to data collected as the Event Value:

• Events that don't match the data type aren't collected. The Event Value data type is float.

• If the collected data exceeds the maximum of 9 decimal places, only data up to 9 decimal places is collected.

An Attribute is an additional detail collected in an Airbridge event beyond the Event Action and Event Label. Depending on the Attribute type, it's collected as a string, a number, and so on.

Attention

Data collected as the Attribute cannot be viewed in Airbridge reports. If you want to collect event details and view them in Airbridge reports, use the Event Action and the Event Label.

There are two types of Attributes: Semantic Attributes and Custom Attributes.

• Semantic Attribute: an Attribute predefined by Airbridge.

• Custom Attribute: an Attribute that you define.

A Semantic Attribute is an Attribute predefined by Airbridge.

A Custom Attribute is an Attribute that you define. All data collected as Custom Attributes is contained in a single column in raw data exports. For example, if you define an item type and quantity as Custom Attributes, both sword and 1 are contained in a single column.

The following limitations apply to data collected as the Attribute:

• Events that don't match the Semantic Attribute data type aren't collected. Be careful, as the data type differs for each Semantic Attribute.

• If data collected as a Semantic Attribute exceeds the maximum length, only data up to the limit is collected. The maximum length is 1,024 characters for string and 64 bits for integer or float.

• The maximum length for a Custom Attribute is 2,048. If it exceeds this length, it's recorded as ERROR_MAX_LENGTH_EXCEEDED.

The Trigger is the point at which an Airbridge event is collected. The same Airbridge event can be counted differently depending on when it's collected. For example, if you collect the Order Complete event when the purchase button is selected, the event is counted even when the purchase fails for reasons such as insufficient funds. If you collect the Order Complete event when the order confirmation page appears, you can collect the Order Complete event more accurately.