Integration with Adjust

Glossary

Adjust

Mobile attribution and marketing analytics platform. Adjust enables application developers, marketers, and brands to track, measure, and optimize the effectiveness of their marketing campaigns across various channels and devices.

Refer to the Adjust documentation for detailed information about the platform.

App token

Mobile application ID unique for each platform (Android, iOS, etc.). It is automatically generated when adding an application to Adjust. You can find this value in Adjust in the AppView > All apps section next to the name of a corresponding application.

Adjust ID

User ID generated by Adjust.

Lifetime Value (LTV)

Average revenue that a user generates during the time they use your application. Refer to the Adjust documentation for detailed information about the LTV.

Return on advertising spend (ROAS)

Metric that measures the effectiveness of an advertising campaign by calculating the revenue earned per unit of advertising spend. Refer to the Adjust documentation for detailed information about the ROAS.

In-app event

User action within the application. Refer to the Adjust documentation for detailed information about the in-app events. User actions in Web Shop are also considered in-app events in the case of S2S integration and sent to Adjust from the Xsolla back end.

User acquisition

The process of attracting new users to a site, service, platform, or application through marketing activity.

Customer user ID (CUID)

User ID generated and set by the application owner at the time of user registration. The СUID should be the same for the Web Shop and Adjust. This parameter is used for user matching and attribution.

Notice

You need to pass this parameter in the callback. To do this, follow the instructions.

If CUIDs in the Web Shop and your mobile application don’t match, contact your Customer Success Manager or email to csm@xsolla.com to implement the User validation in Web Shop webhook or authentication via a deep link.

Callback

Process of receiving data on in-app events. Refer to the Adjust documentation for detailed information.

Server-to-server (S2S) security token

Token that is used to authorize S2S calls for sending event data to Adjust. It’s generated on the Adjust side. Refer to the Adjust documentation for detailed information about S2S token.

Integration scenario

Adjust and Xsolla support mobile application S2S integration that allows completion of full LTV and ROAS measurement for the purchases within the application and on the Web Shop. Xsolla sends information about Web Shop purchases to Adjust as mobile in-app events, which Adjust then attributes to the number of mobile application installments, 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 Adjust
• use Web Shop solution to sell in-game items

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

How it works

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

  %%{init: {'themeVariables': { 'noteBkgColor': 'transparent', 'noteBorderColor': 'transparent', 'noteTextColor': '#495C6B' }}}%%
sequenceDiagram
    participant User
    participant Mobile App
    participant Web Shop
    participant Xsolla Backend
    participant Adjust
    User->>Mobile App: 1. Logs in
    Mobile App->>Adjust: 2. Sends CUID
    Adjust->>Xsolla Backend: 3. Sends callback
    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->>Adjust: 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 Adjust — for example, login, signup, or other event that includes the CUID.
3. Adjust sends a callback to Xsolla, which includes the app token, Adjust 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 Adjust.
7. Xsolla’s server sends an S2S in-app event to Adjust, which contains the Adjust ID, app token, and other parameters received from Adjust.

Adjust 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 the Publisher Account and go to the Integrations section.
2. Click the Adjust pane.

3. In the Mobile app S2S integration pane, click Configure.
4. In the window that opens, make sure that the Enable this integration box is checked.
5. Enter the following data:
   • Adjust S2S security token.
   • App token for publishing platforms (Android/iOS). To add a platform, click Add app token.
6. Click Save.
7. Enable the integration in Adjust.

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 Adjust pane.
2. In the window that opens, make the necessary changes.
3. Click Save.

How to set up in Adjust

In Adjust, you need to:

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

Get S2S security token

To get an S2S security token:

1. Log in to your Adjust account.
2. Open the AppView > All apps section and go to your application page.
3. Go to the Protection tab.
4. In the S2S security block, click Open S2S security.
5. In the line with the necessary S2S token, click on the copy icon.

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

Activate integration with Xsolla

1. Log in to your Adjust account.
2. Go to the Campaign Lab > Partners section.
3. Click New partner.

4. In the search bar, enter and select Xsolla.
5. Click Next.

6. Select an application for which you configure integration.
7. Click Next.
8. Enable data sharing. To do this, in the Enable data sharing block, click Edit, set the toggle to active, and click Enable.

9. Click Next.
10. Check the settings and click Enable partner. If needed, you can return to the previous steps and update the settings.

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 Adjust. The following purchase information is passed in the event parameters:

Additional data

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