Event Properties

To optimize your marketing strategy, it is crucial to track and measure events in your digital service and understand user behavior. Define the events you want to track with Airbridge using the Airbridge event properties.

Event Properties Overview

In Airbridge, an event is defined by its properties, namely the Event Category, Event Action, Event Label, Event Value, Attributes, and Trigger.

Event Property

Data Type

Description

Event Category

string

- Required for all events

- Used for event naming and postback configuration

- For Standard Events, the Event Category is pre-set by Airbridge

Event Action; Event Label

string

- Used to collect event details in addition to the Event Category

- Can be viewed in Airbridge reports

Event Value

float

- Used to collect numerical data for calculations

Attributes

Varies by Attribute

- Used to collect event details in addition to the Event Action and Event Label

- Cannot be viewed in Airbridge reports

- Is divided into Semantic Attributes and Custom Attributes; Semantic Attributes are Airbridge’s presets

Trigger

-

- Required for all events

- Determines the point at which an event is collected, which is ideally the point at which the event takes place

 

Event Category

The Event Category is an essential property that must be configured to define an event. In addition to being used as the name of an event, the Event Category can be used when you select the events to send via postbacks.

Events are divided into Standard Events and Custom Events. The Event Category of Standard Events is pre-set by Airbridge, whereas that of Custom Events shall be configured by Airbridge users.

Rules and limitations for Event Category

The Event Category is subject to the following rules:

  • The Event Category is case-sensitive.

  • For Standard Events, the Event Category is pre-set by Airbridge.

  • For Custom Events, the Event Category can include letters in mixed case and numbers, but cannot start with airbridge.. As for the use of symbols, it is advised to use underscores _ only. The maximum length is 128 characters.

Data collected as the Event Category is subject to the following limitations:

  • The event cannot be collected in case of a data type mismatch. The data type of the Event Category is string.

  • If the data to be collected exceeds the maximum length, it is truncated to the maximum length, which is 128 characters for the Event Category.

View data by Event Category

Select a metric to view the event count where the metric name corresponds to the Event Category. Data collected as the Event Category can be viewed by selecting the “Event Category” GroupBy or filter in Airbridge reports or as a property in raw data exports.

 

Event Action and Event Label

By configuring the Event Action and the Event Label, you can determine up to 2 additional event details to collect. Data collected as the Event Action and Event Label can be viewed in Airbridge reports.

Event details collected as Event Action and Event Label

Any event detail can be collected as the Event Action and the 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.

Rules and limitations for Event Action and Event Label

The Event Action and the Event Label are subject to the following rules:

  • The Event Action and the Event Label can include letters in mixed cases and numbers and are case-sensitive. The maximum length is 128 characters.

  • As for the use of symbols, it is advised to use underscores _ only. Spaces and the following symbols are also supported: ?, !, ,, ., /, &, (, ).

Data collected as the Event Action and Event Label is subject to the following limitations:

  • The event cannot be collected in case of a data type mismatch. The data types of both the Event Action and the Event Label are strings.

  • If the data to be collected exceeds the maximum length, it is truncated to the maximum length, which is 128 characters for both the Event Action and the Event Label.

View data by Event Action and Event Label

Data collected as the Event Action and the Event Label can be viewed by selecting the “Event Action” and “Event Label” GroupBys in Airbridge reports.

 

Event Value

The Event Value must be configured to perform calculations with numerical data collected. Only data collected as the Event Value can be used for calculations in Airbridge. Numbers with up to 9 decimal places can be collected.

For instance, you must have configured the Event Value to find out your total revenue by adding up the prices of the products sold or your total subscription revenue by adding subscription fees in the Revenue Report.

Understanding Event Value

Data collected as the Event Value can be used for calculations with other data collected as the Event Value. Data collected as the Event Action or the Event Label cannot be used for calculations. Note that the event count is tracked whether or not the Event Value is configured.

Limitations for Event Value

Data collected as the Event Value is subject to the following limitations:

  • The event cannot be collected in case of a data type mismatch. The data type of the Event Label is float.

  • If the data to be collected exceeds the maximum length, it is truncated to the maximum length, which is up to 9 decimal places for the Event Value.

  

Attributes

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.

Attributes can be used to collect additional event details. Data collected as the Attribute can be viewed only via raw data exports but not in Airbridge reports.

Attributes are divided into Semantic Attributes and Custom Attributes. Semantic Attributes are pre-defined by Airbridge, whereas Custom Attributes can be configured by Airbridge users.

Semantic Attributes

Semantic Attributes are pre-defined by Airbridge. Read on to learn more about Semantic Attributes and their use cases.

Custom Attributes

Custom Attributes can be configured by Airbridge users to collect additional event details that reflect the nature of business and marketing objectives.

Note that all data collected as Custom Attributes can be viewed in raw data exports under a single column. For instance, let's say you configured Custom Attributes to collect the product's color and size. Then, both the color and size data will appear under the same column.

Limitations for Attributes

Data collected as Attributes is subject to the following limitations:

  • The data will not be collected in case of a Semantic Attribute data type mismatch. However, the data with the correct data type and the other event properties will still be collected.

  • The event will not be collected in case of a Custom Attribute data type mismatch. Keep in mind that the data types of Custom Attributes may vary.

  • Data collected as Semantic Attributes will be truncated to the maximum length, which is 1,024 characters for string data and 64 bits for integer or float data.

  • When the data collected as Custom Attributes exceeds the maximum length, ERROR_MAX_LENGTH_EXCEEDED will be recorded instead of the actual data.

Trigger

The Trigger is the point at which an event is collected. Different data could be collected depending on the data collection point. Make sure your Trigger is aligned with what you aim to measure by collecting the event.

Was this page helpful?

Have any questions or suggestions?