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

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

The following events are available via the Xsolla and AppsFlyer S2S integration:

How it works

The integration includes a bi-directional data flow between Xsolla and AppsFlyer. Below is the scenario of system interaction when a user makes a purchase.

1. The user (game’s player) signs up or logs in to the Android/iOS mobile application.
2. Your application sends a standard in-app event to AppsFlyer: af_login, af_signup or any event that contains CUID.
3. AppsFlyer sends a postback to Xsolla, including application ID, AppsFlyer ID and CUID.
4. The user logs in Web Shop using CUID.
5. The user makes a purchase in Web Shop.
6. The purchase event is sent to the Xsolla backend and matches the information received from AppsFlyer.
7. The Xsolla backend sends an S2S in-app event to AppsFlyer containing the AppsFlyer ID.

AppsFlyer attributes this 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 the Publisher Account.
2. In the side menu, click Integrations.
3. Click the AppsFlyer pane.

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

5. In the window that appears, enter the following data:
   1. AppsFlyer S2S token.
   2. Application IDs on publishing platforms (Android/iOS). To add a platform, click Add application ID.
6. Click Save.

After saving, the toggle on the AppsFlyer pane will be turned on.
To make changes to the connected integration:

1. Click AppsFlyer pane.
2. In the window that appears, make the necessary changes.
3. Click Save.

How to set up in AppsFlyer

In AppsFlyer, you need to:

1. Get an S2S token.
2. Activate the integration with Xsolla.

Getting S2S token

To retrieve the S2S token:

1. Log in to your AppsFlyer HQ account.
2. Go to the Account > Security Center > AppsFlyer API and S2S tokens and S2S tokens section.
3. In the line with the S2S token, click on the copy icon in the Token column.

If you don’t yet have the S2S token, create one.

Activating the integration with Xsolla

1. In your AppsFlyer HQ account, select the required Android/iOS application and go to the Collaborate > Partner marketplace section.

2. Find and select Xsolla in the search bar.

3. Click Set up integration.

4. On the integration tab:
   1. Turn on the Activate Partner toggle.
   2. For iOS applications only: set the Advanced Privacy toggle according to your privacy policy:
      • On — all events are sent to Xsolla
      • Off — only ATT consented events are sent to Xsolla

1. 3. Leave the Default postbacks value — off (by default).
   4. Turn on the In-app event postbacks toggle.
   5. Configure at least one in-app event that includes login information (CUID).
   6. Enter any value in the mapped to partner event field. Xsolla supports any event name.
   7. Save the integration.

You can read more about integration settings on the AppsFlyer side in the documentation.

Event value structure

If you want to set up a specific event or if the current integration capabilities 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 AppsFlyer. The following purchase information is passed in the event parameters:

Event example with single SKU:

{
    "af_content_id": "test-coin",
    "af_quantity": "11",
    "af_revenue": "99.99",
    "af_currency": "USD",
    "af_purchase_currency": "USD",
    "af_receipt_id": "1234567890"
}

Event example with multiple SKU:

{
    "af_content_id": ["test-coin-1", "test-coin-2"],
    "af_quantity": ["5", "60"],
    "af_revenue": "99.99",
    "af_currency": "USD",
    "af_purchase_currency": "USD",
    "af_receipt_id": "1234567890"
}

Refund

When a user initiates a payment refund, Xsolla sends the xsolla-billing-refund event to AppsFlyer. The following refund information is passed in the event parameters:

Event example with multiple SKU:

{
    "af_content_id": ["test-coin-1", "test-coin-2"],
    "af_quantity": ["5", "60"],
    "af_revenue": "-99.99",
    "af_currency": "USD",
    "af_purchase_currency": "USD",
    "af_receipt_id": "1234567890"
}