Integration with Airbridge

Glossary

Integration scenario

Airbridge and Xsolla support mobile application S2S integration, enabling full LTV and ROAS tracking for both mobile application and Web Shop purchases. Xsolla sends information about Web Shop purchases to Airbridge as mobile in-app events, which Airbridge then attributes to the number of mobile application installations, user acquisition and re-engagement campaigns.

You can configure mobile application integration to get advanced event analytics if you:

• have a mobile application on the Android/iOS platform
• use Airbridge
• use Web Shop solution to sell in-game items

The following event is available via the Xsolla and Airbridge S2S integration:

How it works

The integration includes a bidirectional data flow between Xsolla and Airbridge. Below is the system interaction scenario when a user makes a purchase.

  sequenceDiagram
    participant User
    participant Mobile App
    participant Web Shop
    participant Xsolla Backend
    participant Airbridge
    User->>Mobile App: 1. Logs in
    Mobile App->>Airbridge: 2. Sends CUID
    Airbridge-->>Xsolla Backend: 3. Sends postback
    User->>Web Shop: 4. Logs in using CUID
    User->>Web Shop: 5. Makes a purchase
    Web Shop->>Xsolla Backend: 6. Sends purchase event
    Xsolla Backend->>Airbridge: 7. Sends xsolla-billing-payment event

1. The user (player) signs up or logs in to the mobile application.
2. Your application sends an in-app event to Airbridge — for example, login, signup, or other event that includes the CUID.
3. Airbridge sends a postback to Xsolla, which includes the application store ID, Airbridge ID, CUID, and other related data parameters.
4. The user logs into the Web Shop using the CUID.
5. The user makes a purchase in the Web Shop.
6. The purchase event is sent to the Xsolla server and matched with the data received from Airbridge.
7. Xsolla’s server sends an S2S in-app event to Airbridge, which contains the Airbridge ID, application store ID, and other parameters received from Airbridge.

Airbridge attributes a new event, purchase, and revenue back to the media source that drove the user acquisition or the user re-engagement.

How to set up in Publisher Account

1. Open your project in Publisher Account and go to the Integrations section.
2. Click the Airbridge pane.

3. In the Mobile app S2S integration pane, click Configure.

4. In the window that opens, check the Enable this integration box.
5. Enter the following data:
   • Airbridge S2S token.
   • Application store ID for publishing platforms (Android/iOS). To add a platform, click Add application ID.

1. You need to copy the values for these parameters in your Airbridge account as described below.

6. Click Save.
7. Enable the integration in Airbridge.

Once you save the settings, a green indicator will be displayed on the S2S integration pane.

To make changes to the connected integration:

1. Click the Airbridge pane.
2. In the window that opens, make the necessary changes.
3. Click Save.

How to set up in Airbridge

In Airbridge, you need to:

1. Get the credentials.
2. Activate the integration with Xsolla.

Get credentials

1. Log in to your Airbridge account.
2. Go to the Integration > Third-party integration section.
3. Click the Xsolla pane.

4. In the Set up Xsolla dashboard section, copy values for Application store ID and Airbridge S2S token and paste them in Publisher Account.

Activate integration with Xsolla

After you enabled integration in Publisher Account:

1. Log in to your Airbridge account.
2. Go to the Integration > Third-party integration section.
3. Click the Xsolla pane.
4. Set the Send events toggle to active.

Note

To share data from iOS users who decline App Tracking Transparency (ATT), set the EPC (Extended Privacy Control) toggle to inactive. If this toggle in disabled, go to the Settings > App settings section to update it.

Event value structure

If you want to set up a specific event or if the current integration options don’t cover your needs, contact your Customer Success Manager or email to csm@xsolla.com.

Item purchase

When a user makes a purchase in Web Shop, Xsolla sends the xsolla-billing-payment event to Airbridge. The following purchase information is passed in the event parameters:

Additional data

Additionally, you can pass the following parameters in the postback: