API разработчика NowG
API NowG позволяет передавать данные о поведении игроков на платформу и получать результаты работы модели — оценки когорт, оповещения о намерениях потерять интерес и сигналы о качестве партнеров — в виде веб-хуков. Это API в формате JSON/HTTPS; каждый запрос привязан к одному клиенту на основе его токена носителя. Базовый URL: https://api.nowg.net/v1.
Аутентификация
Все запросы используют токен носителя, привязанный к одному арендатору. Генерация и смена ключей осуществляется на панели управления. Настройки → APIОтправьте это в Authorization заголовок: Authorization: Bearer $KEYКлючи привязаны к определенной среде (тестовая/рабочая) и не истекают до тех пор, пока не будут сменены.
Пределы скорости
Скорость потребления ограничена определенным количеством веществ. 500 запросов/секунду на одного арендатора, с возможностью увеличения до 1,000. Пакеты считаются одним запросом. При ограничении скорости вы получаете 429 с Retry-After заголовок — отступить и повторить попытку; прием данных идемпотентен, поэтому повторы безопасны.
События игроков
Передача поведенческих событий в режиме реального времени позволяет моделям оценивать склонность к волатильности, риск отклонения от нормы и качество когорты. События дедуплицируются. event_id.
Пакетный импорт
Заполните историю, отправив POST-запрос на массив данных (до определенного количества элементов). События 1,000 в /v1/players/events/batchОтвет возвращает информацию по каждому элементу. accepted и deduped Учитывается порядок событий. Порядок не имеет значения — события отмечаются по времени. tsа не прибытие.
дедупликации
Каждое мероприятие имеет свои особенности. event_id Вы контролируете ситуацию. NowG хранит данные в течение 30 дней; повтор в течение этого периода молча игнорируется (учитывается в dedupedЭто делает повторные попытки, очереди "как минимум один раз" и повторные воспроизведения абсолютно безопасными.
Веб-хук: оценки когорты
Когда модель пересчитывает очки игрока, NowG отправляет POST-запрос. cohort.scored Событие для вашего URL-адреса веб-перехватчика с оценками волатильности, риска неэффективности и качества партнерской программы (0–1). Зарегистрируйте URL-адрес в соответствии с... Настройки → Веб-перехватчики.
Вебхук: оповещения о наклоне
A tilt.alert Событие срабатывает, когда игрок превышает заданный вами порог тильта, что влечет за собой рекомендуемое вмешательство (перезарядка, предупреждение о превышении лимита, отсутствие бонуса). Каждое оповещение регистрируется для аудита в системе Compliance Guardian.
Вебхук: настройка обратной отправки
Чтобы передавать в ваш трекер сигналы партнерского качества, добавьте его URL-адрес для обратной связи в раздел Настройки → Интеграции с {click_id} и {quality_score} Макросы. NowG запускает их на сервере всякий раз, когда существенно изменяется оценка когорты.