Sales Ninja — документация

# Сигналы для ML

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

Источники бывают трёх классов:

  • Опираются на проектную интеграцию. Чтобы тип появился в дропдауне, соответствующая интеграция должна быть подключена в проекте (Настройки → Интеграции).
  • Опираются на JS-события на сайте. Достаточно, чтобы соответствующий скрипт был установлен на сайте.
  • Не требуют интеграции. «Не-платформенные» способы получать сигнал.

Sales Ninja не раскрывает внутреннюю механику обучения и веса фич — это часть ноу-хау модели. На уровне клиента важно одно: «какой тип сигнала указывать в featureGoalIds моделируемой конверсии, чтобы покрыть вот этот источник данных».

# Опираются на проектную интеграцию

# Yandex Metrica {#yandex-metrica}

Два типа:

  • YandexMetrica — счётчик Метрики целиком, события и цели читаются через интеграцию.
  • YandexMetricaByApi — конкретная цель из подключённого счётчика. Тоньше, чем YandexMetrica: вы указываете counter ID, конкретную цель, валюту.

Что нужно: подключённая интеграция «Яндекс» с правом на нужный счётчик.

# Yandex AppMetrica {#yandex-appmetrica}

Сигналы из мобильного приложения через AppMetrica: события приложения, переход в целевое состояние.

Что нужно: подключённая интеграция «Яндекс» с выбранным приложением AppMetrica.

# Vk {#vk}

Сигнал по событиям рекламного аккаунта VK Ads.

Что нужно: подключённая интеграция VK Ads.

# Calltouch {#calltouch}

Сигнал по звонкам и формам CallTouch.

Что нужно: подключённая интеграция CallTouch.

# Telegram {#telegram}

Сигнал по событиям Telegram-бота (если у вас есть бот, который шлёт нам события). Конкретику уточняйте в поддержке — это редкий сценарий.

Что нужно: подключённая интеграция Telegram + кастомный канал событий.

# Опираются на JS-события на сайте

Для этих типов достаточно, чтобы соответствующий скрипт сторонней системы был установлен на сайте — Sales Ninja читает события через свой бандл. Проектной интеграции не требуется.

# Mindbox {#mindbox}

Сигнал по событиям SDK Mindbox: посещения, добавление в корзину, оформление, кастомные операции.

См. также: JS-действие Mindbox в персонализациях.

# Carrot Quest {#carrot-quest}

Сигнал по событиям Carrot Quest: чат-сессии, целевые события, кастомные свойства пользователей.

См. также: JS-действие Carrot Quest.

# Jivo {#jivo}

Сигнал по событиям Jivo: открытие/закрытие чата, отправка сообщения, переход в активный диалог.

См. также: JS-действие Jivo.

# Webim {#webim}

Сигнал по событиям чата Webim.

# Flocktory {#flocktory}

Сигнал по событиям Flocktory (программа удержания, всплывающие предложения).

# RoiStat {#roistat}

Сигнал по событиям SDK RoiStat.

См. также: JS-действие RoiStat.

# Опираются на рекламные пиксели

# Google {#google}

Сигнал по событиям Google Analytics (через установленный на сайте gtag/GA4).

# Meta {#meta}

Сигнал по событиям Meta Pixel (Facebook).

# TikTok {#tiktok}

Сигнал по событиям TikTok Pixel.

# Bing {#bing}

Сигнал по событиям Bing UET (Universal Event Tracking).

# LinkedIn {#linkedin}

Сигнал по событиям LinkedIn Insight Tag.

# MyTracker {#mytracker}

Сигнал по событиям MyTracker (мобильный трекинг от Mail.ru).

# HybridAi {#hybridai}

Сигнал из внешнего AI-провайдера HybridAi (специфичные сценарии).

# Не требуют интеграции

# DataLayer {#datalayer}

Сигнал по событию из dataLayer на сайте. Удобно, если у вас уже есть готовая разметка под GTM — Sales Ninja ловит выбранное событие из dataLayer и трактует его как факт.

Параметры: имя события (goalName), валюта.

Сигнал «у пользователя есть такой cookie с таким значением». Удобно для разметки серверной стороны (вы ставите cookie на бэке после оплаты, Sales Ninja видит её и считает фактом).

# UserParam {#userparam}

Сигнал «в user-scope params пользователя есть такой параметр с таким значением». Чисто фронтовая разметка.

# JavaScriptSubscription {#javascriptsubscription}

Сигнал по JS-подписке — самый гибкий вариант. Вы сами решаете, когда дёрнуть API и сказать «вот произошёл факт».

# Где задаётся в API

В теле POST /public/api/v1/manage/modeled-conversions и POST /public/api/v1/manage/anti-bots — в массиве featureGoalIds[] (целеустремлённые сигналы) и targetGoalIds[] (что мы предсказываем). Каждый id — это goal в Sales Ninja, который вы предварительно создали либо вручную, либо через импорт из соответствующей интеграции.

Точный набор настроек на сигнал (валюта, имя цели, привязка к конкретному счётчику и т.п.) задаётся в админке при создании сигнала. Программно изменить эти параметры через Public API сейчас можно ограниченно — через работу с soup сущностями интеграций; за полным сценарием обратитесь в поддержку.

# Связанные страницы

← JS-действия в персонализациях и A/B-тестах →