Как настроить программу с 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

Чтобы эффективно управлять программой с 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

Получает список контент-мейкеров в программе, которые подключили 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}

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

Создает/обновляет транзакции, к которым применялся creator tag. В теле запроса передается массив следующих объектов:

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

 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}/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

Позволяет передавать статистику по подключению 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 для контент-мейкера

Позволяет создавать 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}