SportAPI
Букмекерские платформы

Спортбук через iFrame: как встроить раздел ставок в существующий сайт и что проверить до запуска

Что такое Sportsbook iFrame, как встроенный раздел ставок связан с вашими аккаунтами, сессиями и балансами, где принимаются и рассчитываются ставки и какие 12 пунктов проверить до включения.

Ноутбук с блоком спортбука, встроенным в страницу сайта фрагментом iframe, рядом чек-лист проверки перед запуском

Sportsbook iFrame — это готовый раздел ставок с событиями, рынками, коэффициентами и купоном, который загружается внутри страницы вашего сайта. Интерфейс вы не разрабатываете. Вы добавляете контейнер и скрипт-загрузчик, сообщаете встроенному спортбуку, кто игрок, обрабатываете несколько событий и связываете приём ставок со своим кошельком. Сайт, аккаунты и деньги остаются вашими.

Поэтому это самый быстрый способ добавить ставки на спорт в продукт, у которого уже есть пользователи: онлайн-казино, спортивный портал, сайт прогнозов, новый проект, проверяющий спрос. По той же причине его легко запустить плохо: встроенная часть работает с первого дня, а всё вокруг неё — сессии, балансы, согласие, мобильная вёрстка — делать вам. В статье — как собрана интеграция и 12 вещей, которые нужно проверить до запуска. Примеры относятся к спортбук-виджету SportAPI; его можно сначала попробовать в живой демонстрации.

Что на практике называют Sportsbook iFrame

Три названия описывают одно и то же. Спортбук-виджет — это продукт. Bet Embed — формат поставки. Sportsbook iFrame — привычный для отрасли термин: «спортбук, который кто-то другой рисует внутри моей страницы».

На практике это редко голый <iframe src="…">. Современный встроенный спортбук загружается скриптом-загрузчиком в контейнер на вашей странице, потому что обычный фрейм не умеет того, что нужно разделу ставок: подстраиваться по высоте, просить сайт авторизовать игрока, сообщать, что купон изменился, узнавать, что изменился баланс. Загрузчик всё это настраивает; рисует ли он внутри фрейм — деталь реализации.

Что вы получаете внутри контейнера:

  • предстоящие события с расписанием, участниками, рынками и текущими коэффициентами;
  • раздел live со счётом, периодом, статусом матча и обновляемыми коэффициентами;
  • основные и дополнительные рынки с параметрами;
  • купон для ординаров и экспрессов;
  • адаптивную вёрстку для компьютера и телефона;
  • интерфейс и данные на языках, включённых для проекта.

Как собрано встраивание

С вашей стороны странице нужны две вещи — контейнер и загрузчик:

<!-- шапка, вход и баланс остаются вашими -->
<main>
  <h1>Ставки на спорт</h1>
  <div id="sportsbook" style="min-height: 720px"></div>
  <!-- сюда вставляется фрагмент загрузчика с параметрами вашего проекта -->
</main>

При инициализации сайт передаёт виджету небольшой набор значений:

ПараметрЗачем нуженОткуда берётся
Идентификатор проектаСообщает виджету, какой проект и настройки загрузитьВыдаёт менеджер
Разрешённый доменВиджет работает только на доменах, зарегистрированных для проектаНазываете вы: основной, www, мобильный, тестовый
ЯзыкЯзык интерфейса и данныхЛокаль вашей страницы
Режим спортбукаКакой раздел открытьКонтекст вашей страницы
Токен сессии клиентаОпределяет вошедшего игрока, когда нужна сессияВаш backend

Точный фрагмент загрузчика и имена параметров приходят с кодом встраивания проекта от менеджера; техническая инструкция по виджету ещё готовится, поэтому воспринимайте таблицу как список решений, а не как справочник API. Ни одно из решений не сложное, но каждое нужно принять до запуска: какие домены, какие языки, можно ли смотреть линию без входа.

Четыре события, которые должен обработать ваш сайт

Виджет рисует спортбук, а источником истины остаётся ваш сайт. Общаются они через события:

Событие от виджетаЧто делает ваш сайт
Требуется входОткрывает вашу форму входа или регистрации и затем передаёт токен сессии
Купон изменилсяПри необходимости обновляет интерфейс (счётчик в шапке, аналитика)
Обновление балансаОбновляет баланс в шапке
Сессия истеклаВыдаёт свежий токен или отправляет игрока на вход

Большинство ошибок интеграции живёт в этой таблице. Виджет, который просит войти, пока сайт ничего не делает, для игрока выглядит сломанным, хотя сам виджет в порядке. По каждому событию решите, что увидит игрок, и проверьте каждое руками.

Авторизация: как передать игрока в виджет

Виджет никогда не видит пароль и не должен видеть вашу основную сессионную cookie. Backend выдаёт короткоживущий токен для вошедшего игрока, а страница передаёт его виджету при инициализации. Схема выглядит так:

// GET /api/sportsbook-session: короткоживущий токен для вошедшего игрока
app.get('/api/sportsbook-session', requireUser, (req, res) => {
  const token = jwt.sign(
    { sub: String(req.user.id), currency: req.user.currency },
    process.env.SPORTSBOOK_SESSION_SECRET, // остаётся на сервере
    { expiresIn: '10m' },
  );
  res.json({ token });
});

Формат токена и точный порядок работы с сессией согласуются при технической интеграции, поэтому код показывает форму решения: токен выдаёт ваш сервер, он привязан к одному игроку, живёт минуты и обновляется, когда виджет сообщает об истёкшей сессии. Анонимный посетитель токена не получает и может смотреть линию; виджет попросит войти, когда он попробует поставить.

Ставки и деньги: что делает виджет, а что ваш сервер

Виджет даёт купон. Приём ставки и её расчёт идут через Coupon API — сервис приёма и расчёта ставок, а кошелёк ваш:

  1. Игрок подтверждает купон в виджете.
  2. Ваш сервер проверяет баланс и лимиты и резервирует сумму.
  3. Ставка создаётся через Coupon API, который в этот момент перепроверяет коэффициент и доступность каждого исхода. Запрос описан в разделе размещение купона.
  4. Если коэффициент изменился, ставка отклоняется или принимается по новой цене — в зависимости от выбранного режима.
  5. После матча купон рассчитывается автоматически, и ваш сервер получает подписанный callback.
  6. Сервер выплачивает по итогу и сообщает виджету, что баланс изменился.

Балансы игроков, депозиты, выводы и выплаты не покидают вашу платформу. В этом главное отличие встроенного спортбука от отправки пользователей на чужой сайт ставок: клиент, деньги и данные остаются у вас.

Что проверить до запуска

  1. Домены. Все домены, на которых будет работать виджет, зарегистрированы для проекта: основной, www, мобильный поддомен, тестовый.
  2. Размер контейнера. У контейнера задана минимальная высота, и на телефоне у страницы не появляется вторая полоса прокрутки.
  3. Языки. Язык виджета следует за языком страницы, и спортивные данные на этом языке есть в вашем проекте.
  4. Вход. Анонимный посетитель при попытке поставить видит вашу форму входа и возвращается к тому же купону.
  5. Истечение сессии. Оставьте вкладку открытой дольше срока жизни токена и сделайте ставку. Игрока не должно молча выбросить.
  6. Баланс. Баланс в шапке меняется после приёма ставки и ещё раз после расчёта.
  7. Изменение коэффициентов. Поставьте в live, пока коэффициенты движутся, и убедитесь, что игрок видит новую цену или понятный отказ.
  8. Content Security Policy. Если сайт отправляет заголовок CSP, хост виджета разрешён для скриптов, фреймов и соединений.
  9. Согласие и возраст. Спортбук загружается после подтверждения возраста и выбора cookies, а не до.
  10. Скорость. Загрузчик не блокирует страницу: он подключается после основного содержимого, а контейнер резервирует высоту, чтобы вёрстка не прыгала.
  11. Собственный контент. У страницы есть свой заголовок и текст. То, что внутри виджета, для поисковиков не является текстом вашей страницы.
  12. Сбой. Если загрузчик не скачался, игрок видит сообщение и кнопку повтора, а не пустой прямоугольник.

Двум пунктам нужна строка настройки. Для CSP добавьте хост из кода встраивания в нужные директивы:

Content-Security-Policy: script-src 'self' https://WIDGET_HOST; frame-src https://WIDGET_HOST; connect-src 'self' https://WIDGET_HOST

Для скорости загружайте спортбук, когда контейнер приближается к видимой области:

const box = document.getElementById('sportsbook');
new IntersectionObserver((entries, observer) => {
  if (!entries[0].isIntersecting) return;
  observer.disconnect();
  // сюда вставляется фрагмент загрузчика из кода встраивания
}, { rootMargin: '300px' }).observe(box);

Виджет, API или платформа под ключ

Встроенный спортбук — один из трёх способов получить продукт для ставок, и он правильный в конкретной ситуации:

У вас естьВам нужноБерите
Сайт с пользователями и своими аккаунтамиРаздел ставок в этом месяцеСпортбук-виджет
Команда разработки и идея продуктаСвой интерфейс и сценарииЛинию и Coupon API
Рынок и бизнес-модель, разработчиков нетГотовый продукт с бэк-офисомПлатформу под ключ

Компромисс виджета — интерфейс: это интерфейс виджета на ваших языках внутри вашей страницы, а не собственный дизайн. Многие проекты начинают со встраивания, чтобы проверить спрос, и позже переходят на свой фронтенд; данные и обработка ставок под ним остаются теми же. Полное сравнение — в статье «Платформа под ключ или сборка на API».

Ошибки, которые всплывают после запуска

  • Встраивание как «вставил и забыл». Четыре события и есть интеграция. Без них виджет — витрина, а не спортбук.
  • Долгоживущие токены. Токен на несколько дней — это сессия, которую можно украсть. Минуты, с обновлением.
  • Перенос кошелька «для удобства». Держите балансы в своей системе с первой ставки. Именно это позволит позже сменить интерфейс, не трогая деньги.
  • Выплата по купону. Выплата берётся из итога расчёта, а не из возможного выигрыша, показанного в купоне.
  • Нет запасного сценария. Блокировщики рекламы и строгие корпоративные сети режут сторонние скрипты. Покажите сообщение.
  • Пустая страница вокруг виджета. Странице, на которой только встраивание, нечего отдать поисковикам и нечего показать, пока виджет грузится.

Как это устроено в SportAPI

Виджет SportAPI использует те же данные, что и API спортивной линии, и подключает ставки через Coupon API, поэтому линия, проверка коэффициентов и расчёт ведут себя так же, как у команд, которые делают свой фронтенд. Для старта от менеджера нужны три вещи: идентификатор проекта, ваши домены, разрешённые для проекта, и код встраивания. Инструкция по установке готовится, поэтому инициализацию, авторизацию и события под вашу систему показывает менеджер.

Что сделать до этого разговора: открыть живую демонстрацию на телефоне и на компьютере, решить, можно ли смотреть линию без входа, и составить список доменов и языков. Цена виджета согласуется под проект; у сервисов под ним минимальные тарифы открыты — от $30 в месяц за вид спорта за линию и от $300 в месяц за приём и расчёт ставок.

Частые вопросы

Sportsbook iFrame — это настоящий iframe?

Иногда, внутри. Устанавливаете вы контейнер и JavaScript-загрузчик, потому что раздел ставок должен обмениваться событиями с сайтом, а голый фрейм этого не умеет. «iFrame» — отраслевое название всей категории встроенных спортбуков.

Игроки действительно могут ставить через него?

Да, когда подключён приём ставок. Виджет даёт купон и события; ставки создаются и рассчитываются через Coupon API, а операции с кошельком идут в вашей платформе.

Работает ли он с нашей авторизацией?

Да. Ваш backend выдаёт токен сессии для вошедшего игрока, а виджет сообщает сайту, когда нужен вход. Точный порядок работы с сессией согласуется при технической интеграции.

Замедлит ли встроенный спортбук сайт?

Нет, если загружать его после основного содержимого и резервировать высоту контейнера. Подключайте его лениво, когда контейнер приближается к видимой области, как в примере выше.

Вредно ли это для SEO?

Для страницы это нейтрально, если у неё есть собственный контент. Поисковики индексируют ваши заголовки и текст; матчи и коэффициенты внутри встраивания текстом страницы не считаются. Не стройте сайт из страниц, на которых нет ничего, кроме виджета.

Можно ли изменить внешний вид?

Интерфейс — виджета, на языках вашего проекта, адаптивный для компьютера и телефона. Если важен именно собственный дизайн, собирайте на API или заказывайте платформу; встроенный формат — про скорость.

Прежде чем просить код встраивания

Откройте демонстрацию на двух устройствах, запишите домены и языки, определите правило входа и набросайте, что делает сайт по каждому из четырёх событий. С таким списком первый разговор будет о вашем проекте, а не об основах. Отправьте его менеджеру SportAPI в Telegram и попросите показать виджет на вашей платформе.

← Все статьи