Игры Для кого Задачи Как запустить Статьи Цена Справка Попробовать бесплатно
Уровень 2. Где и как запускать · Запуск

Интеграции: игра спрашивает ваш сервис и выдаёт награду по ответу

Покупка на сайте, запись в CRM, заказ в доставке, даже погода за окном. Всё, что знает ваш сервис, может засчитать задание или выдать промокод в игре. Связь настраивается один раз в разделе «Интеграции», дальше игра сама спрашивает сервис в нужный момент.

Время: 1 часШагов: 11Запуск
Гайд 35 из 35 · Уровень 2. Где и как запускать
Интеграции: игра спрашивает ваш сервис и выдаёт награду по ответу
Что получится

Задание, которое засчитывается по ответу вашего сервиса, и кнопка «Проверить» в игре.

Что понадобится
  • Адрес вашего сервиса, который отвечает в формате JSON
  • Ключ доступа к сервису, если он нужен
  • Игра с заданием, которое хотите засчитывать
  1. Заведите интеграцию

    Откройте «Интеграции» и создайте новую. Имя связи пишется латиницей, например «pogoda» или «crm-zakaz». По этому имени интеграцию найдут задания, предметы и кнопки игры.

  2. Адрес и вид запроса

    Адрес запроса это адрес вашего сервиса. Вид запроса: GET, POST, PUT, PATCH или DELETE, как требует сервис. Ожидание ответа: сколько секунд ждать, например 3s.

  3. Заголовки

    Открытые заголовки видят все, кто правит игру: сюда тип содержимого и прочее несекретное.

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

  4. Тело запроса

    Текст, который уйдёт в сервис, с подстановками из данных игрока. «${user.login}» подставит игрока, «${task.meta.productId}» значение, которое вы записали в само задание. Например: {"player": "${user.login}", "product": "${task.meta.productId}"}.

    Работает только подстановка: формул, условий и значений по умолчанию в теле нет, остальной текст уходит как написан.

  5. Разбор ответа

    Покажите игре, где в ответе лежит нужное. Путь задаётся шагами: имя поля или номер в списке. Например, ответ {"result": {"done": true}} читается путём result → done.

    Что игра умеет прочитать: Выполнено (строго true или false), Промокод и ПИН к нему, Действует с и Действует до (дата и время без пояса), Номер у партнёра, Имя события и Время события.

  6. Повторы и нагрузка

    Попыток всего: сколько раз переспросить сервис, если он не ответил, по умолчанию 3. Пауза между попытками в секундах. Сколько запросов одновременно: по умолчанию 20, чтобы акция не уронила ваш сервис в день рассылки.

  7. Когда проверять

    При входе в игру: включено по умолчанию. Из игры кнопкой: включите, если в игре будет кнопка «Проверить». Не чаще чем раз в: например 3600s (час), тогда сервис не спросят об одном и том же задании игрока чаще раза в час.

  8. Подключите к заданию

    В задании выберите условие «Действие у партнёра» и вашу интеграцию. Когда сервис ответит «выполнено», задание засчитается, и игрок получит его награду.

  9. Кнопка «Проверить»

    На кнопку в игре поставьте действие «Вызвать интеграцию» с именем связи. Игрок вернулся с сайта, нажал, игра спросила сервис, задание обновилось у него на глазах. Сама кнопка призов не выдаёт: приз приходит с заданием.

  10. Промокод из вашей системы

    Предмет с поведением «Интеграция» выдаёт то, что вернул сервис: промокод, ПИН и срок действия. Так игрок получает настоящий код из вашей системы, а не из заранее загруженного списка.

  11. Журнал

    Каждый вызов записывается: адрес, тело, код и тело ответа, сколько ждали. Если сервис не ответил, видно, когда и с какой ошибкой. Застрявшую заявку можно отправить заново.

Важно. Поле «Выполнено» читается строго: true засчитывает задание, всё остальное, включая «yes» и 1, читается как «не выполнено».
Совет. Начните с одной интеграции и одного задания. Проверьте на своём телефоне, посмотрите журнал, потом добавляйте остальное.

Где чаще ошибаются

Сделайте это в своём кабинетеПервые 10 дней бесплатно, карта не нужна. Откройте кабинет и пройдите этот гайд на своей игре. Попробовать бесплатно
← Предыдущий гайдЧековое промо для бренда в сети

По теме

Условия: больше, меньше, диапазонПервое заданиеИгра для постоянных клиентовВсе гайды