Tracking ID Handling

How It Works

You can track in-game purchases and enable revenue sharing for them as well. To do this, you must implement the storage and handling of an additional Tracking ID parameter. The parameter is created when a user follows a tracking link and is added to their cookies. You must save the Tracking ID when the user signs up with your game. Afterwards, you must send it in the token when initializing the payment UI.

Advanced cookie-based tracking is relevant for free-to-play games, where in-game purchases are the main method of user engagement and monetization.

Who Can Use It

  • Partners who have Partner Network integrated and have free-to-play games
  • Partners who have Partner Network integrated, have premium games, and want to track in-game purchases

How to Get It

  1. Implement the handling of the tracking_id in the database when registering a user.
  2. Implement the sending of data to Xsolla via the Register User API method.
  3. Add tracking_id to the JSON request body in the Get Token method. The parameter is sent within the user object when opening the payment UI.


curl -v{merchant_id}/token \
-u your_merchant_id:merchant_api_key \
-H 'Content-Type:application/json' \
-H 'Accept: application/json' \
-d '{
    "user": {
        "id": {
            "value": "1234567"
        "tracking_id": {
            "value": "trackingID"
    "settings": {
        "project_id": 14004