How to set up program with Creator tag

How it works

Creator tag is a unique code that a player can receive when watching streams on YouTube or Twitch or in other formats/services. A player (supporter) can use this tag during in-game purchases to support their favorite influencer. The solution allows you to build trust and relationships with influencers and increase your income through attribution (tracking) of all in-game purchases.

Gamer flow

1. The player copies the Creator tag or follows the link to connect it from the service where the influencer shared their code. An influencer can use the following services:
   • Twitch
   • YouTube
   • Facebook Gaming
   • other social networks
2. The player enters the Creator tag in the field on the page where you implemented its connection. If the player clicks on the link, the Creator tag is automatically applied.

Monetization

You get income from all in-game purchases. A share of the influencer’s profit is deducted from each purchase, whose Creator tag was applied when making the purchase.

Who can use it

Partners who have a game with:

• an expected monthly income of at least $ 20,000
• goods available for purchase only within the game

How to get it

Set up program with Creator tag

To set up a program with a Creator tag:

1. Send an application to csm@xsolla.com (or to bizdev@xsolla.com, if you are integrating an Xsolla product for the first time) and wait for its submission. Specify the following information in the application:
   • Game name.
   • Genre.
   • Developer (optional).
   • Publisher (optional).
   • Official site of the game.
   • Game description.
   • Steam App ID (optional).
   • Release date, if the game is still not published (optional).
   • Link to promo materials (optional).
   • Business model:
     • premium
     • free-to-play
   • Game platform:
     • PC
     • Steam
     • mobile
     • web
   • Program participation period.
   • Revenue share percentage.
   • End of revenue sharing. The day participating influencers stop receiving Revenue share.
   • List of influencers. For each influencer, specify their email, social network channel and Creator tag. Consider the following limitations when choosing influencers:
     • Withdrawal of funds from the balance is available only for influencers over 18 years old.
     • Xsolla doesn’t work with influencers whose bank accounts are registered in countries that are subject to US sanctions.

2. Implement the Creator tag connection mechanism by the player in one of the following ways:
   • By clicking the link. In this case, the Creator tag value will be loaded into the specific input field automatically.
   • Using manual input.

3. Determine where the page with the Creator tag will be:
   • in the game interface
   • on the advertising game site
   • in the payment interface every time the player pays for a purchase

4. Send csm@xsolla.com a link to the page on which the Creator tag is connected (if the mechanism is implemented in the interface or on the game website).
5. In the game, implement mechanisms for linking the Creator tag to the purchases of supporters, and tracking these purchases.

Manage program with Creator tag

1. Send your purchases to Xsolla regularly using the Creating transactions method. The recommended frequency for transmitting this data is once a day.

2. Add new influencers to the program (optional).

3. Using the Sending statistics by Creator tag method, transfer to Xsolla the information about statistics for supporters (optional).

Add influencers to program

• yourself
• via Xsolla

Self-add

1. Call the Creating Creator tag for influencer and Adding influencer to program methods sequentially.
2. To invite an influencer to the program, send a message to influencer@xsolla.com with the email, social network channel and Creator tag of the influencer used in the Creating Creator tag for influencer method.

Add via Xsolla

API methods for working with Creator tag

Getting influencers with Creator tag

GET https://influencer.xsolla.com/api/partner/v2/programs/{PROGRAM_ID}/deals?limit=3&offset=0 HTTP/1.1

Creating transactions

PUT https://influencer.xsolla.com/api/partner/v2/programs/{PROGRAM_ID}/transactions HTTP/1.1

X-API-key: 7890ZYXWVUTSRQPONMLKJIHG
Content-Type: application/json

[
  {
    "transaction_id": "123456789",
    "creator_tag": "creatorOne",
    "platform_id": "steam",
    "user_id": "0123456",
    "transaction_date": "2020-04-10T06:06:24.830Z",
    "item_id": "GAME_sku_1",
    "item_name": "hk416",
    "transaction_currency_code": "USD",
    "transaction_value": 5
  },
  {
    "transaction_id": "123456788",
    "creator_tag": "creatorOne",
    "platform_id": "steam",
    "transaction_date": "2020-04-10T06:06:24.830Z",
    "item_id": "GAME_sku_2",
    "item_name": "hk416",
    "transaction_currency_code": "EUR",
    "transaction_value": 10
  },
  {
    "transaction_id": "123456781",
    "creator_tag": "creatorOne",
    "platform_id": "xbox",
    "transaction_date": "2020-04-10T06:06:24.830Z",
    "item_id": "GAME_sku_1",
    "item_name": "hk416",
    "transaction_currency_code": "USD",
    "transaction_value": 3
  }
]

Canceling transactions

PUT https://influencer.xsolla.com/api/partner/v2/programs/{PROGRAM_ID}/transactions HTTP/1.1

X-API-key: 7890ZYXWVUTSRQPONMLKJIHG
Content-Type: application/json

[
  {
    "transaction_id": "123456789",
    "creator_tag": "creatorOne",
    "platform_id": "steam",
    "user_id": "0123456",
    "transaction_date": "2020-04-10T06:06:24.830Z",
    "item_id": "GAME_sku_1",
    "item_name": "hk416",
    "transaction_currency_code": "USD",
    "transaction_value": 5
  },
  {
    "transaction_id": "123456788",
    "creator_tag": "creatorOne",
    "platform_id": "steam",
    "transaction_date": "2020-04-10T06:06:24.830Z",
    "item_id": "GAME_sku_2",
    "item_name": "hk416",
    "transaction_currency_code": "EUR",
    "transaction_value": 10
  },
  {
    "transaction_id": "123456781",
    "creator_tag": "creatorOne",
    "platform_id": "xbox",
    "transaction_date": "2020-04-10T06:06:24.830Z",
    "item_id": "GAME_sku_1",
    "item_name": "hk416",
    "transaction_currency_code": "USD",
    "transaction_value": 3
  }
]

Sending statistics by Creator tag

PUT https://influencer.xsolla.com/api/partner/v2/programs/{PROGRAM_ID}/supporters HTTP/1.1

X-API-key: 7890ZYXWVUTSRQPONMLKJIHG
Content-Type: application/json

[
  {
    "date": "2020-04-10",
    "creator_tag": "creatorOne",
    "new_supporters": 125,
    "total_supporters": 35900
  },
  {
    "date": "2020-04-10",
    "creator_tag": "creatorTwo",
    "new_supporters": 123,
    "total_supporters": 34567
  }
]

Creating Creator tag for influencer

PUT https://influencer.xsolla.com/api/partner/v2/tags HTTP/1.1

X-API-key: 7890ZYXWVUTSRQPONMLKJIHG
Content-Type: application/json

{
  "creator_tag": "creatorOne",
  "creator_email": "influencer@example.com",
  "creator_channels": [
    "https://www.twitch.tv/creatorOne"
  ]
}

Adding influencer to program

PUT https://influencer.xsolla.com/api/partner/v2/tags HTTP/1.1

X-API-key: 7890ZYXWVUTSRQPONMLKJIHG
Content-Type: application/json

{
  "creator_tag": "creatorOne",
  "creator_email": "influencer@example.com",
  "creator_channels": [
    "https://www.twitch.tv/creatorOne"
  ]
}