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

# Управление моделируемыми конверсиями

моделируемая конверсия — это прокси-цель, по которой ML оптимизирует эксперименты, когда «настоящая» бизнес-цель происходит слишком редко (раз в неделю на пользователя) или слишком поздно. CRUD позволяет программно создавать и обновлять такие конверсии.

База: https://api.sales-ninja.me/public/api/v1/manage/modeled-conversions

HTTP Что делает
GET / Список.
POST /list Список со сложным фильтром.
GET /{id} Полная сущность.
POST / Создать.
PUT /{id} Обновить (полная замена).
PATCH /{id} Частично обновить root-поля.
DELETE /{id} Удалить.

# Тело

{
  "title": "Прокси: 3+ просмотра карточки за сессию",
  "kind": "Regular",
  "state": "Working",
  "optimizationMetric": "ConversionCount",
  "predictionCountStrategy": "Balanced",
  "predictionCountStrategyCustomPredictionRate": 0,
  "skipLastEventConversionTrackingForChain": false,
  "mlModelAtributionType": "AllConversions",
  "mlModelConversionPerSessionAttributionType": "OnlySessionWithConversion",
  "forecastingWindowInDays": 30,
  "sourceType": "Session",
  "useBroadTargeting": false,
  "useBroadTargetingBroadRatio": null,
  "goals": [
    {
      "goalId": "299837db-9b51-45a4-996b-844d3fd05bbd",
      "isMain": true,
      "relationType": "Optimization",
      "contributionPower": 1.0
    }
  ],
  "integrations": [],
  "externalData": null
}

# Поля

Поле Описание
title Название в админке.
kind Regular, UniversalSharedPrediction или ExternalData.
state Working / Active / Stopped / Paused / Archived.
optimizationMetric ConversionCount, Revenue, NetProfit, LtvRevenue, LtvNetProfit.
predictionCountStrategy Balanced, MoreAccuracy, MorePredictCount, CustomPredictionRate, MaxAccuracy.
mlModelAtributionType AllConversions, FirstConversionPerUser, FirstConversionPerSession, MostValuableConversionPerUser, MostValuableConversionPerSession.
mlModelConversionPerSessionAttributionType OnlySessionWithConversion, SessionChain, UserSegments, LeadScore, Retargeting, Brandformance, AntiBot.
sourceType Personalization, Session, PersonalizationHit, ModeledConversionHit, PersonalizationApiHit.
goals[] Цели проекта, по которым учится модель. relationType: "Optimization" — положительная цель, Minus — нежелательная цель.
integrations Массив настроек интеграций для доставки результата, если они нужны. Без настройки не создаёт внешнюю отправку автоматически.
externalData Настройки external-data сценария для kind: "ExternalData", иначе null.

Детали (число и набор фич, метрика обучения) подбираются системой автоматически. Старт и остановка обучения управляются через состояние сущности — программно «включить тренировку прямо сейчас» Public API не предлагает.

# Ответ

{
  "modeledConversionId": "8f3a1e4b-…",
  "entity": {
    "id": "8f3a1e4b-…",
    "title": "Прокси: 3+ просмотра карточки за сессию"
  }
}

# Доступные источники сигналов

goals[].goalId указывает на цели проекта, которые могут опираться на разные платформы. Полный каталог источников и их предусловий — на странице Сигналы для ML. Если хотите подключить новый источник (например, Calltouch или AppMetrica) — см. Каталог интеграций.

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

← Управление аудиторными сегментами →