Как настроить программу с 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, если вы впервые интегрируете продукт Иксоллы) и дождитесь ее согласования. Укажите в заявке следующую информацию:
   • название игры;
   • жанр;
   • разработчик (опционально);
   • издатель (опционально);
   • официальный сайт игры;
   • описание;
   • Steam App ID (опционально);
   • дата релиза, если игра еще не опубликована (опционально);
   • ссылка на промоматериалы (опционально);
   • бизнес-модель:
     • премиум;
     • free-to-play.
   • игровая платформа:
     • PC;
     • Steam;
     • мобильная;
     • веб-платформа.
   • Период участия в программе.
   • Процент Revenue share.
   • Дату окончания действия Revenue sharing. Это последний день, когда инфлюенсер может получить долю прибыли от продаж.
   • Список инфлюенсеров. Для каждого укажите: email-адрес, канал в социальной сети и creator tag. При выборе инфлюенсеров учитывайте следующие ограничения:
     • Вывод средств с баланса доступен только для инфлюенсеров старше 18 лет.
     • Иксолла не работает с инфлюенсерами, чьи банковские аккаунты зарегистрированы в странах, которые являются объектами санкций США.

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

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

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

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

Чтобы эффективно управлять программой с creator tag:

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

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

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

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

Вы можете добавить инфлюенсеров в программу одним из следующих способов:

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

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

Чтобы самостоятельно добавить инфлюенсеров в программу:

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

Добавление через Иксоллу

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

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

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

Получает список инфлюенсеров в программе, которые подключили creator tag.

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

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

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

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

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

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

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

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

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

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

Позволяет создавать creator tag для новых инфлюенсеров в программе. В теле запроса передается массив следующих объектов:

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"
  ]
}

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

Позволяет добавлять нового инфлюенсера в программу. В теле запроса передается массив следующих объектов:

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"
  ]
}

Оценить страницу

Что может сделать страницу еще лучше? Отправить

В другой раз

Спасибо за обратную связь!