Как настроить программу с creator tag

Как это работает

Creator tag — это уникальный код, который игрок может получить при просмотре онлайн-трансляций на YouTube или Twitch или в других форматах/сервисах и использовать во время внутриигровых покупок, чтобы поддержать своего любимого инфлюенсера. Решение позволяет вам построить доверительные отношения с инфлюенсерами и увеличить свой доход за счет атрибуции (отслеживания) всех внутриигровых покупок.

Сценарий игрока

1. Игрок копирует creator tag или переходит по ссылке для его подключения из сервиса, где инфлюенсер поделился своим кодом. Инфлюенсер может использовать следующие сервисы:
   • Twitch;
   • YouTube;
   • Facebook Gaming;
   • прочие социальные сети.
2. Игрок вводит creator tag в поле на странице, где вы реализовали его подключение. Если игрок переходит по ссылке, creator tag применяется автоматически.

Монетизация

Вы получаете доход со всех внутриигровых покупок. С каждой покупки вычитается доля прибыли инфлюенсера, чей creator tag был применен при ее совершении.

Для кого подходит

Для партнеров, у которых есть игра:

• с ожидаемым ежемесячным доходом не менее $20 000;
• с товарами, доступными для покупки только внутри игры.

Как настроить

Настройка программы с creator tag

Чтобы настроить программу с creator tag:

1. Отправьте заявку на csm@xsolla.com (или на bizdev@xsolla.com, если вы впервые интегрируете продукт Xsolla) и дождитесь ее согласования. Укажите в заявке следующую информацию:
   • название игры;
   • жанр;
   • разработчик (опционально);
   • издатель (опционально);
   • официальный сайт игры;
   • описание;
   • Steam App ID (опционально);
   • дата релиза, если игра еще не опубликована (опционально);
   • ссылка на промоматериалы (опционально);
   • бизнес-модель:
     • премиум;
     • free-to-play.
   • игровая платформа:
     • PC;
     • Steam;
     • мобильная;
     • веб-платформа.
   • Период участия в программе.
   • Процент Revenue share.
   • Дату окончания действия Revenue sharing. Это последний день, когда инфлюенсер может получить долю прибыли от продаж.
   • Список инфлюенсеров. Для каждого укажите: email-адрес, канал в социальной сети и creator tag. При выборе инфлюенсеров учитывайте следующие ограничения:
     • Вывод средств с баланса доступен только для инфлюенсеров старше 18 лет.
     • Xsolla не работает с инфлюенсерами, чьи банковские аккаунты зарегистрированы в странах, которые являются объектами санкций США.

2. Реализуйте механизм подключения creator tag игроком одним из следующих способов:
   • При переходе по ссылке. В этом случае значение будет подгружаться в поле для ввода creator tag автоматически.
   • С помощью ручного ввода.

3. Определите, где будет находиться страница с полем для ввода creator tag:
   • в интерфейсе игры;
   • на рекламном сайте игры;
   • в платежном интерфейсе каждый раз при оплате покупки.

4. Отправьте на csm@xsolla.com ссылку на страницу, на которой выполняется подключение creator tag (если механизм реализован в интерфейсе или на рекламном сайте игры).
5. Реализуйте в игре механизмы привязки creator tag к покупкам игроков, которые его подключили, и отслеживания этих покупок.

Управление программой с creator tag

1. Регулярно передавайте информацию о покупках Xsolla с помощью метода Создание транзакций. Рекомендуемая частота передачи данных — один раз в сутки.

2. Добавляйте в программу новых инфлюенсеров (опционально).

3. С помощью метода Передача статистики по creator tag передавайте Xsolla информацию о статистике по игрокам, которые подключили creator tag инфлюенсера (опционально).

Добавление инфлюенсеров в программу

• самостоятельно;
• через Xsolla.

Самостоятельное добавление

1. Последовательно реализуйте вызов методов Создание creator tag для инфлюенсера и Добавление инфлюенсера в программу.
2. Чтобы пригласить инфлюенсера в программу, отправьте сообщение на influencer@xsolla.com, в котором укажите email, канал в социальной сети и creator tag инфлюенсера, используемый в методе Создание creator tag для инфлюенсера.

Добавление через Xsolla

Методы по работе с creator tag

Получение инфлюенсеров с creator tag

Пример запроса:

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

Пример ответа:

 1{
 2  "items": [
 3    {
 4      "creator_tag": "creatorOne",
 5      "revenue_share_percent": 5
 6    },
 7    {
 8      "creator_tag": "creatorTwo",
 9      "revenue_share_percent": 10
10    },
11    {
12      "creator_tag": "creatorThree",
13      "revenue_share_percent": 50
14    }
15  ],
16  "total_count": 32
17}

Создание транзакций

Пример запроса:

 1PUT https://influencer.xsolla.com/api/partner/v2/programs/{PROGRAM_ID}/transactions HTTP/1.1
 2
 3X-API-key: {YOUR_API_KEY}
 4Content-Type: application/json
 5
 6[
 7  {
 8    "transaction_id": "123456789",
 9    "creator_tag": "creatorOne",
10    "platform_id": "steam",
11    "user_id": "0123456",
12    "transaction_date": "2020-04-10T06:06:24.830Z",
13    "item_id": "GAME_sku_1",
14    "item_name": "hk416",
15    "transaction_currency_code": "USD",
16    "transaction_value": 5
17  },
18  {
19    "transaction_id": "123456788",
20    "creator_tag": "creatorOne",
21    "platform_id": "steam",
22    "transaction_date": "2020-04-10T06:06:24.830Z",
23    "item_id": "GAME_sku_2",
24    "item_name": "hk416",
25    "transaction_currency_code": "EUR",
26    "transaction_value": 10
27  },
28  {
29    "transaction_id": "123456781",
30    "creator_tag": "creatorOne",
31    "platform_id": "xbox",
32    "transaction_date": "2020-04-10T06:06:24.830Z",
33    "item_id": "GAME_sku_1",
34    "item_name": "hk416",
35    "transaction_currency_code": "USD",
36    "transaction_value": 3
37  }
38]

Отмена транзакций

Пример запроса:

 1PUT https://influencer.xsolla.com/api/partner/v2/programs/{PROGRAM_ID}/transactions HTTP/1.1
 2
 3X-API-key: {YOUR_API_KEY}
 4Content-Type: application/json
 5
 6[
 7  {
 8    "transaction_id": "123456789",
 9    "creator_tag": "creatorOne",
10    "platform_id": "steam",
11    "user_id": "0123456",
12    "transaction_date": "2020-04-10T06:06:24.830Z",
13    "item_id": "GAME_sku_1",
14    "item_name": "hk416",
15    "transaction_currency_code": "USD",
16    "transaction_value": 5
17  },
18  {
19    "transaction_id": "123456788",
20    "creator_tag": "creatorOne",
21    "platform_id": "steam",
22    "transaction_date": "2020-04-10T06:06:24.830Z",
23    "item_id": "GAME_sku_2",
24    "item_name": "hk416",
25    "transaction_currency_code": "EUR",
26    "transaction_value": 10
27  },
28  {
29    "transaction_id": "123456781",
30    "creator_tag": "creatorOne",
31    "platform_id": "xbox",
32    "transaction_date": "2020-04-10T06:06:24.830Z",
33    "item_id": "GAME_sku_1",
34    "item_name": "hk416",
35    "transaction_currency_code": "USD",
36    "transaction_value": 3
37  }
38]

Передача статистики по creator tag

Пример запроса:

 1PUT https://influencer.xsolla.com/api/partner/v2/programs/{PROGRAM_ID}/supporters HTTP/1.1
 2
 3X-API-key: {YOUR_API_KEY}
 4Content-Type: application/json
 5
 6[
 7  {
 8    "date": "2020-04-10",
 9    "creator_tag": "creatorOne",
10    "new_supporters": 125,
11    "total_supporters": 35900
12  },
13  {
14    "date": "2020-04-10",
15    "creator_tag": "creatorTwo",
16    "new_supporters": 123,
17    "total_supporters": 34567
18  }
19]

Создание creator tag для инфлюенсера

Пример запроса:

 1PUT https://influencer.xsolla.com/api/partner/v2/tags HTTP/1.1
 2
 3X-API-key: {YOUR_API_KEY}
 4Content-Type: application/json
 5
 6{
 7  "creator_tag": "creatorOne",
 8  "creator_email": "influencer@example.com",
 9  "creator_channels": [
10    "https://www.twitch.tv/creatorOne"
11  ]
12}

Добавление инфлюенсера в программу

Пример запроса:

1PUT https://influencer.xsolla.com/api/partner/v2/programs/{PROGRAM_ID}/deals HTTP/1.1
2X-API-key: {YOUR_API_KEY}
3
4Content-Type: application/json
5
6{
7  "creator_tag": "creatorOne",
8  "revenue_share": 30
9}