How can we help?

Xsolla integration with AppsFlyer

  • Updated

At a glance: Xsolla, an AppsFlyer integrated partner, is a gaming commerce tech partner specializing in payment processing outside of traditional app platforms. The integration between Xsolla and AppsFlyer enables Xsolla to automate Web Shop purchases and revenue to be sent to AppsFlyer, to present the full ROAS and LTV of the game, including purchases made in the Xsolla Web Shop.

 Important!

Some media sources restrict sharing data with third parties. Therefore, postbacks for restricted events won't be sent to this partner, regardless of the configured selection for sending postbacks.

Integration types

There are two available integration methods with Xsolla:

  • Tech partner integration: This integration enables Xsolla to send Web Shop purchases and revenue as mobile in-app events, thereby enhancing the mobile app campaign ROAS and LTV beyond the standard App store purchases.
  • Web integration: This integration enables Xsolla to send Web Shop visits, purchases, and revenue to your AppsFlyer website app, so AppsFlyer can measure the performance of web campaigns that send game users directly to the Web Shop.

Prerequisites: 

  • Before setting up the integration, make sure you contact the partner and open an account with them.
  • To enable the integration to function properly, make sure to share the Customer User ID (CUID) with AppsFlyer, and that it matches the user ID shared with Xsolla. This alignment allows users to log in to Xsolla's Web Shop and ensures that user data is accurately sent to AppsFlyer.

Setting up the tech partner integration

Prerequisite: An account with the partner. If you don't have an account, contact the partner to open one before setting up the integration.

To set up a new integration:

  1. In AppsFlyer, go to Collaborate > Partner Integrations > Marketplace tab.
    (To edit an existing integration: Go to Collaborate > Partner Integrations > Active integrations tab.)
  2. Select the relevant app. 
  3. Search for the partner and select Integrate.
  4. In the Integration tab, turn on the Activate partner toggle. 
    Note: The toggle must stay on (active) as long as you work with the partner. Learn more 
  5. Complete the configuration using the relevant tabs, as described below. Learn more about partner integrations.

The configuration window only uses the Integration tab.

Integration tab

Activate partner

On your first visit, you'll need to turn on the Activate partner toggle to set up the integration. The toggle must remain on for as long as you work with Xsolla. Learn more about partner activation. 

Advanced Privacy

For iOS apps, the Advance Privacy toggle appears. When turned on, it limits the sharing of user identifiers with the partner. Note that when the Aggregated Advanced Privacy toggle is turned on in the App Settings, Advanced Privacy (for iOS 14.5+ and later) is turned on and locked by default.

Default postbacks

AppsFlyer sends default postbacks to Xsolla following user installs. Use this section to define these postbacks.

  • Off: Install postbacks aren't sent to Xsolla.
    Note: Xsolla's integration with AppsFlyer doesn't require sending install postbacks. Therefore, it's recommended to set it to Off.
  • All media sources, including organic: Install postbacks are sent for events attributed to any partner and for organic events.

default_postbacks.png

In-app event postbacks

In this section, you can map your AppsFlyer events with your partners via postbacks. 

xsolla-af-login-3.jpg

  1. Turn on In-app event postbacks.
  2. Click Add event to add an SDK or server-to-server event to the list.
  3. Complete the following parameters:

    Parameter Name Description
    AppsFlyer event

    The name of the event, as received by AppsFlyer either from the SDK integrated into your app or from server-to-server events.

    Note:

    • For Xsolla, make sure to add the af_login event or any other event that represents user login to the mobile app, as shown in the screenshot above.
    mapped to partner event Enter the corresponding event name you want to send to Xsolla. Xsolla's naming is flexible and any name can be used in this field.
    for users from Select All media sources, including organic to send postbacks for events attributed to any partner and for organic events.
    including
    • No values & no revenue: Send just the event itself without any parameters (values or revenue).
    • Values & no revenue: Send all the parameters excluding the revenue value.
    • Values & revenue: Send all the event parameters, including the revenue value (if exists in the event).

    Note: Xsolla's integration with AppsFlyer doesn't require sending values or revenue. Therefore, any option selected is applicable. 

  4. Click Save Integration.

Attribution link tab

Attribution links aren't available for Xsolla.

Cost tab

Cost data isn't supported in the integration with Xsolla.

Ad revenue tab

Ad revenue data isn't supported in the integration with Xsolla.

Permissions tab

Permissions aren't available for Xsolla.

Setting up the Web integration

This integration measures Web Shop visits and purchases, attributes them to your web campaigns, and shows them in the Web Performance Measurement reports.

Important

People-Based Attribution (PBA) is being deprecated on November 30, 2026, and replaced by Web Performance Measurement. If you already use the PBA Web SDK integration with Xsolla, follow Migrating an existing PBA integration below.

Setting up the Web SDK integration

To set up the integration:

  1. In AppsFlyer: Add a website app.
    1. Use your Web Shop domain as the website URL. For example, if your Web Shop domain is www.webshop.com, use it as the website URL.
    2. Follow the full onboarding steps.
  2. In AppsFlyer: Copy the Web SDK ID from the app settings page of the website app.
  3. In Xsolla: Connect AppsFlyer to your Xsolla Publisher Account:
    1. Open your project in your Publisher Account.
    2. Select your site and click Configure.
    3. On the Site settings tab, go to the Apps section.
    4. In the AppsFlyer block, click Connect.
      xsolla-connect.jpg
    5. In the AppsFlyer Dev Key field, paste the Web SDK ID you copied in step 2.
    6. Click Connect.

Migrating an existing PBA integration

If Xsolla is already connected with your PBA web Dev Key, you keep the same Dev Key and don't need to change anything in Xsolla.

In AppsFlyer: When you add a website app, in the Web SDK ID field, select your existing web Dev Key (the one entered in Xsolla).

Identifying Xsolla's events in AppsFlyer

Tech partner (S2S) integration:

Xsolla sends AppsFlyer 2 in-app events:

  • xsolla-billing-payment - Item purchased
  • xsolla-billing-refund - Item purchase refund

Both events are part of the mobile app in-app events.

Web Performance Measurement integration:

Xsolla sends AppsFlyer Web Shop visits and multiple web events, customized to the specific advertiser activity. The most important one is named "PURCHASE" and contains revenue.

Xsolla's visits and events appear in the Web Performance Measurement dashboard of your website app, and in the End User Events report in Data Locker.

Traits and limitations

PC / Console support - the AppsFlyer integration with Xsolla does not support PC / Console Apps at this phase