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

Как настроить программу с 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 не работает с инфлюенсерами, чьи банковские аккаунты зарегистрированы в странах, которые являются объектами санкций США.

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

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

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

Чтобы эффективно управлять программой с creator tag:
  1. Регулярно передавайте информацию о покупках Xsolla с помощью метода Создание транзакций. Рекомендуемая частота передачи данных — один раз в сутки.
Примечание
В случае оформления возврата покупки, к которой применен creator tag, передавайте эту информацию Xsolla с помощью метода Отмена транзакций.
  1. Добавляйте в программу новых инфлюенсеров (опционально).
Примечание
Если вы добавляете инфлюенсеров через Xsolla, регулярно подгружайте их список с помощью метода Получение инфлюенсеров с creator tag. Рекомендуемая частота получения данных — один раз в сутки.
  1. С помощью метода Передача статистики по creator tag передавайте Xsolla информацию о статистике по игрокам, которые подключили creator tag инфлюенсера (опционально).

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

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

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

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

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

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

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

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

Получает список инфлюенсеров в программе, которые подключили creator tag.
ПараметрТипОписание
limit
integerЧисло инфлюенсеров в списке (по умолчанию: 20, максимально: 100).
offset
integerЗначение, на которое происходит смещение при подгрузке инфлюенсеров в списке (по умолчанию: 0).
Copy
Full screen
Small screen
GET https://influencer.xsolla.com/api/partner/v2/programs/{PROGRAM_ID}/deals?limit=3&offset=0 HTTP/1.1

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

Создает/обновляет транзакции, к которым применялся creator tag. В теле запроса передается массив следующих объектов:
ПараметрТипОписание
creator_tag
stringУникальный код инфлюенсера в программе. Обязательный.
transaction_id
stringID транзакции. Обязательный.
transaction_currency
stringКод валюты, в которой совершена транзакция. Используется трехбуквенное обозначение валюты согласно стандарту ISO 4217. Обязательный.
transaction_value
numberСумма транзакции. Обязательный.
transaction_date
stringДата транзакции в формате YYYY-MM-DD’T’HH:MM:SS. Обязательный.
platform_id
stringПлатформа, на которой совершена транзакция. Обязательный.
user_id
stringID игрока. Обязательный.
item_id
stringID купленного товара. Обязательный.
item_name
stringНазвание купленного товара. Обязательный.
Copy
Full screen
Small screen
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. В теле запроса передается массив следующих объектов:
ПараметрТипОписание
transaction_id
stringID транзакции, которую требуется отменить. Обязательный.
refund_id
stringВнешний ID возврата платежа.
reason
stringПричина возврата платежа.
refund_date
stringДата возврата платежа в формате YYYY-MM-DD’T’HH:MM:SS. Обязательный.
Copy
Full screen
Small screen
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 инфлюенсера (по дням). Эта информация будет размещаться в разделе Статистика в Кабинете инфлюенсера. В теле запроса передается массив следующих объектов:
ПараметрТипОписание
date
stringДата передачи статистики по creator в формате YYYY-MM-DD. Обязательный.
creator_tag
stringУникальный код инфлюенсера в программе. Обязательный.
new_supporters
integerЧисло новых игроков, которые использовали creator tag инфлюенсера. Обязательный.
total_supporters
integerЧисло всех игроков, которые использовали creator tag инфлюенсера. Обязательный.
Copy
Full screen
Small screen
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 для новых инфлюенсеров в программе. В теле запроса передается массив следующих объектов:
ПараметрТипОписание
creator_tag
stringУникальный код инфлюенсера в программе. Обязательный.
creator_email
stringEmail инфлюенсера. Обязательный.
creator_channels
array of stringsСсылка на канал инфлюенсера. Каналов может быть несколько. Обязательный.
Copy
Full screen
Small screen
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"
  ]
}

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

Позволяет добавлять нового инфлюенсера в программу. В теле запроса передается массив следующих объектов:
ПараметрТипОписание
creator_tag
stringУникальный код инфлюенсера в программе. Обязательный.
revenue_share
integerПроцент прибыли, который получает инфлюенсер за каждую покупку, к которой применялся его creator tag. Обязательный.
Copy
Full screen
Small screen
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"
  ]
}
Была ли статья полезна?
Спасибо!
Что может сделать страницу еще лучше? Сообщение
Жаль, что так произошло
Расскажите, почему статья не была полезна. Сообщение
Спасибо за обратную связь!
Ваши мысли и идеи помогут нам улучшить ваш пользовательский опыт.
Оценить страницу
Оценить страницу
Что может сделать страницу еще лучше?

В другой раз

Спасибо за обратную связь!
Последнее обновление: 22 января 2024

Нашли опечатку или ошибку в тексте? Выделите ее и нажмите Ctrl+Enter.

Сообщите о проблеме
Мы постоянно улучшаем качество нашей документации. Ваш отзыв поможет нам в этом.
Укажите email-адрес, чтобы мы могли связаться с вами
Спасибо за обратную связь!