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.
- PBA Web SDK integration: This integration enables Xsolla to send Web Shop purchases and revenue as web events, allowing AppsFlyer to measure the performance of web campaigns, sending 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
To activate or edit the integration:
-
To activate: In AppsFlyer, from the side menu, select Collaborate > Partner Marketplace.
To edit: In AppsFlyer, from the side menu, select Collaborate > Active Integrations. - Search for the partner and select it.
- Click Set up integration. You’re directed to the integration setup page.
- In the Integration tab, select the app for the integration and turn Activate partner on.
Note: The toggle must be on (activated) for as long as you work with the partner. - Complete the configuration using the relevant tabs, as described below.
The configuration window only makes use of the Integration tab.
For a detailed description of the Partner Configuration Window Header, click here.
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.
In-app event postbacks
In this section, you can map your AppsFlyer events with your partners via postbacks.
- Turn on In-app event postbacks.
- Click Add event to add an SDK or server-to-server event to the list.
- 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.
- Xsolla recommends to avoide sending events that occur too frequently, and not to include the CUID (such as af_app_opened), as it may prevent the integration from functioning.
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.
- 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 PBA Web SDK integration
This integration enables present LTV (Lifetime Value) data and insights for analyzing app performance within the PBA dashboard.
To set up the integration:
-
In AppsFlyer: Add the Xsolla app. Select Web (PBA) as the platform, and enter the following details:
- Use your Web Shop domain as the web app URL. For example, if your Web Shop domain is www.webshop.com, use this as your web app URL.
- Use any value as the app name.
-
In AppsFlyer: Add the Xsolla bundle with the following details:
-
- Enter any bundle name as the bundle name.
- Select the web app you created in the previous step as the web app of the bundle.
-
-
In Xsolla: Connect AppsFlyer with your Xsolla Publisher Account:
- Open your project in your Publisher Account.
- Select your site and click Configure.
- On the Site settings tab, go to the Apps section.
- In the AppsFlyer block, click Connect.
- In the AppsFlyer Dev Key field, enter the AppsFlyer Web developer key. See below how to find this key in AppsFlyer.
- Click Connect.
Finding the Web dev key in AppsFlyer
- From the My apps page, click View brand bundles.
- Click the Copy icon on the Xsolla bundle row.