Оформление
Сигналы для ML
При создании моделируемой конверсии или антибота вы указываете, на каких источниках сигнала система учится. Источник — это «откуда у нас факты, что пользователь сделал X».
Источники бывают трёх классов:
- Опираются на проектную интеграцию. Чтобы тип появился в дропдауне, соответствующая интеграция должна быть подключена в проекте (
Настройки → Интеграции). - Опираются на JS-события на сайте. Достаточно, чтобы соответствующий скрипт был установлен на сайте.
- Не требуют интеграции. «Не-платформенные» способы получать сигнал.
Sales Ninja не раскрывает внутреннюю механику обучения и веса фич — это часть ноу-хау модели. На уровне клиента важно одно: какие цели проекта можно указать в goals[].goalId, чтобы модель получила факты из нужного источника данных.
Опираются на проектную интеграцию
Yandex Metrica
Два типа:
YandexMetrica— счётчик Метрики целиком, события и цели читаются через интеграцию.YandexMetricaByApi— конкретная цель из подключённого счётчика. Тоньше, чемYandexMetrica: вы указываете counter ID, конкретную цель, валюту.
Что нужно: подключённая интеграция «Яндекс» с правом на нужный счётчик.
Yandex AppMetrica
Сигналы из мобильного приложения через AppMetrica: события приложения, переход в целевое состояние.
Что нужно: подключённая интеграция «Яндекс» с выбранным приложением AppMetrica.
Vk
Сигнал типа Vk в настройках модели. Проектная интеграция VK Ads сейчас подтверждена как подключение и ограниченный read-контур; не используйте это как обещание автоматической отправки событий обратно в VK Ads.
Что нужно: подключённая интеграция VK Ads.
Calltouch
Сигнал по звонкам и формам CallTouch.
Что нужно: подключённая интеграция CallTouch.
Telegram
Сигнал по событиям Telegram-бота (если у вас есть бот, который шлёт нам события). Конкретику уточняйте в поддержке — это редкий сценарий.
Что нужно: подключённая интеграция Telegram + кастомный канал событий.
Опираются на JS-события на сайте
Для этих типов достаточно, чтобы соответствующий скрипт сторонней системы был установлен на сайте — Sales Ninja читает события через свой бандл. Проектной интеграции не требуется.
Mindbox
Сигнал по событиям SDK Mindbox: посещения, добавление в корзину, оформление, кастомные операции.
См. также: Интеграционные JS-действия в персонализациях.
Carrot Quest
Сигнал по событиям Carrot Quest: чат-сессии, целевые события, кастомные свойства пользователей.
См. также: Интеграционные JS-действия.
Jivo
Сигнал по событиям Jivo: открытие/закрытие чата, отправка сообщения, переход в активный диалог.
См. также: Интеграционные JS-действия.
Webim
Сигнал по событиям чата Webim.
Flocktory
Сигнал по событиям Flocktory (программа удержания, всплывающие предложения).
RoiStat
Сигнал по событиям SDK RoiStat.
См. также: Интеграционные JS-действия.
Опираются на рекламные пиксели
Google
Сигнал по событиям Google Analytics (через установленный на сайте gtag/GA4).
Meta
Сигнал по событиям Meta Pixel (Facebook).
TikTok
Сигнал по событиям TikTok Pixel.
Bing
Сигнал по событиям Bing UET (Universal Event Tracking).
LinkedIn
Сигнал по событиям LinkedIn Insight Tag.
MyTracker
Сигнал по событиям MyTracker (мобильный трекинг от Mail.ru).
HybridAi
Сигнал из внешнего AI-провайдера HybridAi (специфичные сценарии).
Не требуют интеграции
DataLayer
Сигнал по событию из dataLayer на сайте. Удобно, если у вас уже есть готовая разметка под GTM — Sales Ninja ловит выбранное событие из dataLayer и трактует его как факт.
Параметры: имя события (goalName), валюта.
Cookie
Сигнал «у пользователя есть такой cookie с таким значением». Удобно для разметки серверной стороны (вы ставите cookie на бэке после оплаты, Sales Ninja видит её и считает фактом).
UserParam
Сигнал «в user-scope params пользователя есть такой параметр с таким значением». Чисто фронтовая разметка.
JavaScriptSubscription
Сигнал по JS-подписке — самый гибкий вариант. Вы сами решаете, когда дёрнуть API и сказать «вот произошёл факт».
Где задаётся в API
В теле POST /public/api/v1/manage/modeled-conversions и POST /public/api/v1/manage/antibots — в массиве goals[]. Каждый goalId — это goal в Sales Ninja, который вы предварительно создали вручную, через runtime goals/reach или через импорт из соответствующей интеграции.
relationType задаёт смысл цели для обучения:
relationType | Для моделируемых конверсий и сегментов | Для антибота |
|---|---|---|
Optimization | целевое поведение, которое нужно предсказывать | ботоподобное/нежелательное поведение |
Minus | нежелательная конверсия, которую нужно подавлять | хорошее поведение, которое нельзя отсекать |
Точный набор настроек на сигнал (валюта, имя цели, привязка к конкретному счётчику и т.п.) задаётся в админке при создании сигнала. Программно изменить эти параметры через Public API сейчас можно ограниченно — через доступные публичные поля сущностей; за полным сценарием обратитесь в поддержку.
Связанные страницы
- Каталог интеграций.
- Управление моделируемыми конверсиями (REST).
- Управление антиботами (REST).
- JS-действия в персонализациях — для тех же платформ можно настраивать поведение варианта на показе.