Offerwall

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

Offerwall — это страница с различными платными рекламными объявлениями и предложениями, которые вознаграждают пользователей бесплатной виртуальной валютой за выполнение определенных заданий (например, получить 1000 монет за достижение 11 уровня). Offerwall функционирует как маркетплейс, соединяющий рекламодателей, игровых издателей и их пользователей.

Квесты или предложения представляют собой платные размещения от рекламодателей — как игровых, так и неигровых, — которые оплачивают рекламу в зависимости от результата или вовлеченности. Игровые рекламодатели обычно используют эти квесты для привлечения пользователей, тогда как неигровые рекламодатели запускают кампании с оплатой за целевое действие и платят за такие действия, как загрузка приложения, регистрация аккаунта или другие покупки.

Когда вы соглашаетесь интегрировать Offerwall в свою игру (либо внутри приложения, либо через Web Shop), вы настраиваете курс обмена валюты через интеграцию по вебхуку (например, X USD = Y единиц внутриигровой валюты). После выполнения квеста рекламодатель выплачивает Xsolla полную сумму, которая затем распределяется между Xsolla и издателем игры в соответствии с моделью разделения доходов.

Примечание
Конверсии отслеживаются Xsolla с помощью нашего рекламного сервера и интеграций с MMP (сторонними трекинговыми платформами, такими как Adjust, AppsFlyer и Singular).

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

  1. Выполните предварительные действия.
  2. Направьте пользователей на вашу страницу Offerwall:

Предварительные настройки

  1. Создайте виртуальную валюту.
Примечание
Для оптимальной конфигурации виртуальная валюта должна иметь низкую стоимость в эквиваленте USD. Например, цена за единицу в размере 0,001 USD подразумевает курс обмена 1 USD = 1 000 единиц виртуальной валюты. Курс обмена по умолчанию для данной валюты должен быть установлен в USD. Статус виртуальной валюты всегда должен оставаться доступным.
  1. Настройте вебхуки для валидации пользователей и начисления им виртуальной валюты:
    1. Настройте обработку следующих вебхуков:
      • Проверка пользователей. Xsolla отправляет этот вебхук, чтобы проверить, что пользователь зарегистрирован в игре. Запрос отправляется несколько раз в рамках процесса начисления вознаграждения/оплаты.
Copy
Full screen
Small screen
 1{
 2  "notification_type": "user_validation",
 3  "settings": {
 4    "project_id": 123456,
 5    "merchant_id": 789012
 6  },
 7  "user": {
 8    "id": "11111111-1111-1111-1111-111111111111"
 9  }
10}
      • Успешная оплата заказа (с деталями платежа и транзакции). Xsolla отправляет этот вебхук, когда пользователь завершает предложение. В приведённом ниже примере ответа пользователь получает вознаграждение в виде 100 золотых монет. Внешний ID пользователя соответствует идентификатору игрока (gamer ID). Идентификатор игрока передается как query-параметр в URL-адресе страницы Offerwall.
Copy
Full screen
Small screen
 1{
 2  "user": {
 3    "email": "noreply+offewall@xsolla.com",
 4    "country": "US",
 5    "external_id": "11111111-1111-1111-1111-111111111111"
 6  },
 7  "items": [
 8    {
 9      "sku": "GOLD_COINS",
10      "type": "virtual_currency",
11      "amount": "0.01",
12      "quantity": 100,
13      "promotions": [],
14      "is_pre_order": false
15    }
16  ]
17}
Примечание
Чтобы обеспечить безопасную передачу данных, убедитесь, что вебхук действительно был отправлен с сервера Xsolla. Для этого сгенерируйте собственную подпись на основе тела запроса и сравните её с подписью из заголовка авторизации того же запроса.
    1. Протестируйте вебхуки.

Как добавить блок на сайт созданный с помощью конструктора сайтов Xsolla

Чтобы добавить блок Offerwall:

  1. В проекте в Личном кабинете перейдите в раздел Каналы продаж > Веб-сайты.
  2. В разделе Сайты выберите ваш сайт и нажмите Открыть Site Builder.
  3. Нажмите Добавить блок.
  4. Выберите блок Offerwall.

  1. Настройте блок (опционально):
    • Настройте макет блока.
    • Выберите цвет фона и изображение.
Примечание
Вы можете оставить кнопку призыва к действию по умолчанию или удалить её, если фоновое изображение уже содержит встроенный элемент с призывом к действию.
    • Настройте кнопку.
    • Настройте заголовок.
Примечание
Используйте понятный, ориентированный на действие текст, который подчеркивает пользу для пользователя и мотивирует его действовать. Игроки лучше всего реагируют на мотивирующие формулировки, обещающие значимые внутриигровые награды, например:
  • Получите бесплатные монеты прямо сейчас!
  • Откройте премиум-контент бесплатно!
  • Выполните задание и получите награду!
Если вам нужна помощь с интеграцией, свяжитесь с вашим персональным менеджером или напишите на offerwall_publishers@xsolla.com.

Вы можете предоставить пользователям прямую ссылку на Offerwall, например:

  • через апселл-изображение в магазине в вашем приложении.
  • маркетинговое сообщение в ленте приложения или в главном меню (например, “Заработайте бесплатные монеты!”).
  • push-уведомление (с согласия пользователя), ведущее на страницу Offerwall внутри приложения.
  • Примечание
    Если вы планируете использовать Offerwall независимо от сайта, созданного с помощью конструктора сайтов Xsolla, пожалуйста, свяжитесь с командой Offerwall по адресу offerwall_publishers@xsolla.com.
    URL-адрес страницы Offerwall имеет формат, указанный ниже, где:
    • GAMER_ID — это внутриигровой ID пользователя, уникальный для вашего приложения. Xsolla поддерживает любую простую буквенно-цифровую строку. Рекомендуется использовать формат UUID.
    • PLACEMENT_ID — это ID размещения, который направляет трафик и также указывает приложение, из которого приходит пользователь.
    Copy
    Full screen
    Small screen
      1http://quests.xsolla.com/offerwall/<PLACEMENT_ID>?gamer_id=<GAMER_ID>  
      
      Была ли статья полезна?
      Спасибо!
      Что может сделать страницу еще лучше? Сообщение
      Жаль, что так произошло
      Расскажите, почему статья не была полезна. Сообщение
      Спасибо за обратную связь!
      Ваши мысли и идеи помогут нам улучшить ваш пользовательский опыт.
      Последнее обновление: 26 января 2026

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

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