The following documentation was deprecated. Current version is available at developers.xsolla.com

Xsolla Network

Xsolla Network — глобальное решение, которое помогает создать бренд игры, найти новых пользователей и распространить игру через доступ к десяткам аффилированных сетей, миллионам инфлюенсеров и сотням игровых медиа-порталов из одного места. Revenue Share или кампании, основанные на CPA легко настраиваются и запускаются за несколько минут, и, поскольку Xsolla интегрирована со всеми аффилированными лицами, разработчику игры не требуется дополнительно интегрироваться. Разработчик игр могут распространять свои предложения или сообщения для инфлюенсеров и игровых платформ и платить прямо из Личного Кабинета Xsolla, без необходимости подписания соглашения с каждым из них, экономя время, деньги и ресурсы R&D.

  • Привлечение новых пользователей без предварительной оплаты;
  • Вы можете сами определять уровень рекламы, в зависимости от процента, который вы готовы платить;
  • Xsolla Network была протестирована с Life is Feudal, и показала себя эффективной;
  • 4M инфлюенсеров на более чем 10 самых популярных платформах;
  • До 100 аффилированных сетей;
  • Распространение новостей во всех игровых медиа;
  • Инструменты отслеживания производительности и аналитики позволяют оценивать эффективность кампании по приобретению пользователей с помощью отслеживаемых ссылок, рекламных кодов или ключей активации продукта.
  • Базовая интеграция не обязательна, если уже интегрирован Xsolla Login.

Xsolla Network — это часть продуктовой линейки Xsolla, и может быть использована вместе с Pay Station, Mobile Pay Station и/или Pay2Play. Для использования данного продукта необходимо реализовать подключение с одним из модулей.

Схема взаимодействия

Xsolla Network

1) Пользователь кликает на рекламный баннер и переходит на прокси-страницу в Xsolla, на которую передается информация об игре. Xsolla сохраняет utm-параметры из URL, включая уникальный ID события (например, Click ID), и создает универсальный параметр Tracking ID для дальнейшего взаимодействия.

2) Tracking ID сохраняется в cookie-файлах пользователя, пользователь автоматически перенаправляется на промо-страницу игры.

3) Пользователь начинает процесс регистрации в игре. Игра должна сохранить Tracking ID данного пользователя вместе с его данными в базе данных игры.

4) Игра уведомляет Xsolla об успешной регистрации пользователя через API метод.

5) При получении токена для инициализации интерфейса оплаты, необходимо добавить параметр Tracking ID. Когда платеж успешно совершен, Xsolla сохраняет данные о платеже вместе с Tracking ID в базе.

6) Информация, собранная на первом шаге, плюс данные об уникальном ID события (например, Click ID) передаются источнику трафика.

Изменения в получении токена

Вам необходимо дополнительно передавать информацию о Tracking ID в JSON для получения токена. Tracking ID передается внутри объекта "user".

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

    curl -v https://api.xsolla.com/merchant/merchants/{merchant_id}/token \
    -X POST \
    -u your_merchant_id:merchant_api_key \
    -H 'Content-Type:application/json' \
    -H 'Accept: application/json' \
    -d '
    {
        "user": {
            "id": {
                "value": "1234567"
            },
            "tracking_id": {
                "value": "trackingID"
            }
        },
        "settings": {
            "project_id": 14004
        }
    }'

Все параметры, которые уже присутствовали в JSON для получения токена, должны остаться без изменений.

Новый метод API

Когда пользователь с Tracking ID успешно регистрируется в игре, игра должна прислать запрос при помощи API метода.

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

curl -v 'https://api.xsolla.com/merchant/merchants/{merchant_id}/xsolla_network/
user_register/{tracking_id}' \
-X PUT \
-u merchant_id:merchant_api_key
Параметр Тип Описание
merchant_id int ID мерчанта.
tracking_id string Tracking ID.

Пример успешного ответа

HTTP/1.1 204 No Content