Skip to main content
Integrate Xsolla with Airbridge to include Xsolla events in your performance measurement.

Prerequisites

Set the user ID in the Airbridge SDK before you integrate Xsolla with Airbridge.
This setup requires code changes. Ask your developer for help.

Match user IDs

To view accurate integration results, Airbridge and Xsolla must record the same user ID.
  1. When a user completes sign-up or sign-in, set the user ID in the Airbridge SDK by calling setUserID. For platform-specific instructions, see the SDK documentation for each platform, such as Android SDK and iOS SDK.
  2. Then configure your app to send the Sign-up or Sign-in standard event. Airbridge sends this event to Xsolla along with user data.
Attention
  • The Sign-up or Sign-in standard event must be sent to Xsolla with the user ID.
  • When calling setUserID, use the same user ID as the customer user ID (CUID) in your Xsolla web shop. If the values differ, events are still sent to Xsolla but are not matched to web shop users.
See the data flow between Xsolla and Airbridge below.
  1. When a user signs up or signs in, the Airbridge SDK collects the configured user ID along with the event.
  2. Airbridge sends the event to Xsolla along with user data such as the user ID and Airbridge ID.
  3. When the user makes a purchase in the Xsolla web shop, Xsolla identifies the user by comparing the user ID received from Airbridge with the web shop CUID.
  4. Xsolla then sends the purchase event to Airbridge along with user data, and Airbridge receives it as the Order Complete (App) event.
  5. Airbridge measures performance based on the received data.

Set up integration

Integrate Xsolla with Airbridge to send purchase events from your Xsolla web shop to Airbridge.
AttentionBefore proceeding, make sure you’ve completed all of the following. For details, see Prerequisites.
  • The Airbridge SDK collects the user ID when a user completes sign-up or sign-in.
  • The Sign-up or Sign-in standard event is sent to Xsolla with the user ID.
  • The user ID set in the Airbridge SDK matches the CUID in your Xsolla web shop.

Get credentials from Airbridge

Get your credentials from Airbridge to provide to Xsolla. You’ll need:
  • Application Store ID (iOS)
  • Application Store ID (Android)
  • Airbridge S2S token
  1. In the Airbridge dashboard, go to [Integrations]>[Third-party Integration] and select Xsolla.
  2. Copy the Application Store ID for your operating system and Airbridge S2S Token. You’ll paste these values into the Xsolla dashboard in the next step.

Provide credentials to Xsolla

  1. In the Xsolla dashboard, open your project and go to [Integrations].
  2. Select Airbridge.
  3. In the [Mobile app S2S integration], click Configure.
  4. Check the Enable this integration checkbox.
  5. Enter the Application Store ID and Airbridge S2S Token you copied from the Airbridge dashboard into their corresponding fields.
  6. Click Save to complete Xsolla dashboard setup.

Complete setup in Airbridge

  1. In the Airbridge dashboard, turn on the Send events toggle to start sending events.
  2. Check your Extended Privacy Control (EPC) settings. When EPC applies, probabilistically matched iOS conversions are sent to Xsolla as unattributed. To send them with attribution details, turn off both app-level EPC and per-integration EPC for Xsolla. For details, see EPC application rules.

View Xsolla data in Airbridge

Below are the events pre-mapped between Xsolla and Airbridge. This is the same mapping that appears in the Xsolla dashboard.