Required event data for Airflux integration

This section outlines the event data that must be collected and sent using the Airflux SDK to ensure proper AI model training and achieve optimal results.

Required event data per revenue model

Depending on the revenue model of your game, different event data is required for utilizing Airflux. Refer to the table below.

Revenue Model
Required Events

In-app advertising only

AD_IMPRESSION, ACHIEVE_LEVEL, SPEND_CREDITS

In-app purchase only

ACHIEVE_LEVEL, ORDER_COMPLETED, SPEND_CREDITS

In-app advertising + In-app purchase

AD_IMPRESSION, ACHIEVE_LEVEL, ORDER_COMPLETED, SPEND_CREDITS

Note that the Install and Open events are automatically collected by the Airbridge SDK upon installation and no additional setup is needed.

Detailed schema per event

Find the key attributes and code examples for collecting the required event data below.

Achieve Level

Track player game progress and how a stage ended.

For example, when a stage ends, call the TrackEvent() function, set the event category to AirfluxCategory.ACHIEVE_LEVEL, and add "stage_type" and "stage_number" to track the stage type and stage number.

Additionally, use "result" to send information on how the stage ended, such as success, fail, giveup, and retry .

Attribute Type
Name
Semantic Attributes Description
Sample Value

Custom Attribute

stage_type

The type of the stage

main: Main stage promotion: Seasonal promotion stage (updated every 3 months)

Custom Attribute

stage_number

The stage number where Success, Fail, Give-up, or Retry occurred.

main: 1, 2, ..., 550 (30 new stages added every months) promotion: 1, 2, ...,100

Custom Attribute

result

The result of the stage

success: Stage completed successfully fail: Stage failed giveup: Stage abandoned retry: Stage retried after failure or exit

Code example

Airflux.TrackEvent(
    // StandardCategory
    category: AirfluxCategory.ACHIEVE_LEVEL, // or "CustomEvent" (CustomCategory)
    // SemanticAttributes
    semanticAttributes: new Dictionary<string, object>(),
    // CustomAttributes
    customAttributes: new Dictionary<string, object>()
    {
        { "stage_type", "main"},
        { "stage_number", 13  },
        { "result", "success" }      
    }
);
Spend Credits

Track in-game currency spending and relevant data, such as in-game currency information, spending amount, and more.

For example, when the player spends in-game currency, such as coins and gems, call the TrackEvent() function, set the event category to AirfluxCategory.SPEND_CREDITS and add "item_type" and "item_amount" to send the in-game currency type and spending amount.

Additionally, use "stage_type" and "stage_number"to to track the stage type and stage number.

Attribute Type
Name
Semantic Attributes Description
Sample Value

Custom Attribute

item_type

The type of the in-game currency spent

coin gem

Custom Attribute

item_amount

The amount of the in-game currency spent

10, 20

Custom Attribute

stage_type

The type of the stage

main: Main stage promotion: Seasonal promotion stage (updated every 3 months)

Custom Attribute

stage_number

The current stage of the player

main: 1, 2, ~ , 550 (30 new stages added every months) promotion: 1, 2, ~ ,100

Code example

Airflux.TrackEvent(
    // StandardCategory
    category: AirfluxCategory.SPEND_CREDITS, // or "CustomEvent" (CustomCategory)
    // SemanticAttributes
    semanticAttributes: new Dictionary<string, object>(),
    // CustomAttributes
    customAttributes: new Dictionary<string, object>()
    {
        { "item_type", "coin" },
        { "item_amount", 100  },
        { "stage_type", "main"},
        { "stage_number", 13 }
    }
);

Last updated