Перейти к основному содержимому
Altcraft Docs LogoAltcraft Docs Logo
Для пользователяДля разработчикаДля администратора
Веб-сайтБаза знаний
Русский
  • Русский
  • English
v72
  • v74
  • v73
  • v72
Войти
  • Документация пользователя
  • FAQ
  • Термины
  • Обновления платформы
  • Хранение и сбор данных
  • Каналы коммуникации
  • Сегментация
    • Статические сегменты
    • Динамические сегменты
    • Сегментация профилей по основным данным
    • Сегментация профилей по данным подписок
    • Сегментация профилей по истории действий
    • Сегментация профилей по внешним данным
    • Сегментация профилей по внешним SQL таблицам
    • Сегментация профилей по участию в сегменте
    • Сегментация профилей по UTM
    • Сегментация по структуре профиля
    • Сегментация профилей по лучшему времени отправки
    • Логические операторы "И" и "ИЛИ"
    • Быстрый сегмент
  • Шаблоны сообщений
  • Кампании
  • Сценарии автоматизации
  • Маркет
  • Программы лояльности
  • Веб-слой
  • Отчеты и аналитика
  • Интеграции
  • Настройки
  • API-запросы: с чего начать
  • Библиотека email-маркетолога
Это документация к платформе Altcraft v72. Для этой версии документация больше не обновляется.
Информация по актуальной версии платформы (v74) доступна на этой странице.
  • Сегментация
  • Сегментация по структуре профиля
Документация для версии v72

Сегментация по структуре профиля

Для комплексной сегментации профилей по JSON-полям вы можете сформировать запросы к MongoDB. Такие запросы описываются в EJSON-форме.

Чтобы построить запрос, выберите отбор по Структуре профиля. Условие отбора — EJSON Запрос:

Операторы​

Для расширенного JSON запроса к базе данных используются различные операторы.Подробнее о EJSON для MongoDB читайте в документации. Ниже мы разберем синтаксис основных операторов.

Допустим, в базе есть профиль с дополнительным JSON-поле list:

В это поле записан следующий массив:

[
{
"contract_id": 10,
"category": "A",
"payment": 1000
}
]

В таблицах показаны запросы, которые позволят выбрать данный профиль из базы:

Операторы сравнения​

ОператорОписаниеПример
$eqРавно
{
   "list.category": {
      "$eq": "A"
   }
}
$neНе равно
{
   "list.category": {
      "$ne": "B"
   }
}
$gtБольше
{
   "list.payment": {
      "$gt": 500
   }
}
$gteБольше или равно
{
   "list.payment": {
      "$gte": 1000
   }
}
$ltМеньше
{
   "list.payment": {
      "$lt": 1500
   }
}
$lteМеньше или равно
{
   "list.payment": {
      "$lte": 1000
   }
}
$inСоответствует хотя бы одному значению в массиве
{
   "list.contract_id": {
      "$in": [
         10,
         20,
         30
      ]
   }
}
$ninНе соответствует ни одному значению в массиве
{
   "list.contract_id": {
      "$nin": [
         20,
         30,
         40
      ]
   }
}

Логические операторы​

ОператорОписаниеПример
$andСоответствует всем указанным в массиве условиям
{
   "$and": [
      {
         "list.payment": {
            "$gte": 1000
         }
      },
      {
      "_city":      {
            "$eq": "Москва"
         }
      }
   ]
}
$notНе соответствует указанному условию
{
   "list.category": {
      "$not": {
         "$eq": "D"
      }
   }
}
$orСоответствует хотя бы одному из указанных в массиве условий
{
   "$or": [
      {
         "list.payment": {
            "$gte": 2000
         }
      },
      {
         "_city": {
            "$eq": "Москва"
         }
      }
   ]
}
$norНе соответствует ни одному из указанных в массиве условий
{
   "$nor": [
      {
         "list.payment": {
            "$gte": 1500
         }
      },
      {
         "_city": {
            "$eq": "Казань"
         }
      }
   ]
}

Оператор $elemMatch​

Оператор $elemMatch позволяет выбрать профили, у которых массив, хранящийся в JSON-поле, содержит хотя бы один элемент, удовлетворяющий всем условиям.

Профиль#1Профиль#2

"list":


   [


      {


      "category":"A",


      "payment": 1000


   },


   {


      

"category":"B",


      "payment": 2000


   }
]

"list":


   [


      {


      "category":"B",
      "payment": 1500


   },


   {


      "category":"C",


      "payment": 2000


   }
]

Запрос выберет Профиль#1 и Профиль#2:

{
"list.category": "B",
"list.payment": 2000
}

Запрос выберет только Профиль#1:

{
"list": {
"$elemMatch": {
"category": "B",
"payment": 2000
}
}
}
предупреждение

Возможно сравнение только простых типов данных. Нельзя сравнивать сложные типы (объект, массив), так как не гарантируется сохранение порядка полей в запросе и в самой базе профилей.

Пример недопустимого сравнения:

// Сравнение JSON-поля профиля "list"
{
"list": {
"$eq": {
"contract_id": 10,
"category": "A",
"payment": 1000
}
}
}

Вместо сравнения целых объектов, лучше использовать сравнение по ключам и их значениям. Например:

{
"list.category": {
"$eq": "A"
}
}

Даты​

Аргумент {"$dateNowFunc": "-5"} позволяет задать смещение даты в днях.

Запрос выберет профили, обновленные не позднее чем вчера:

{
"_updatetime": {
"$gte": {
"$dateNowFunc": "-1"
}
}
}

Также можно использовать эту функцию для работы с датами, записанными в JSON-поле. Например, в дополнительное поле профиля "list" записан следующий массив:

"list":
[
{
"contract_id":10,
"category": "A",
"start_date":"2022-07-01",
"expiration_date":"2022-08-01"
},
{
"contract_id":20,
"category": "B",
"start_date":"2022-06-15",
"expiration_date":"2022-09-15"
}
]

Запрос выберет профили, с которыми договор категории "A" был заключен не раньше чем неделю назад:

{
"list": {
"$elemMatch": {
"category": "A",
"start_date.r": {
"$gte": {
"$dateNowFunc": "-7"
}
}
}
}
}

Запрос выберет профили с договором категории "B", который истекает меньше чем через месяц:

{
"list": {
"$elemMatch": {
"category": "B",
"expiration_date.r": {
"$lte": {
"$dateNowFunc": "30"
}
}
}
}
}
подсказка

Обратите внимание, дни рождения, даты регистрации, а также даты, записанные в дополнительные поля, хранятся в платформе в следующем виде:

"date" : {
"r" : ISODate("2020-09-30T07:42:30.501Z"),
"y" : 2020,
"m" : 9,
"d" : 30,
"md" : 930,
"ymd" : 20200930
}

Когда вы прописываете путь к такому полю, добавьте дополнительный ключ — date.r.

Последнее обновление 27 июл. 2022 г.
Предыдущая страница
Сегментация профилей по UTM
Следующая страница
Сегментация профилей по лучшему времени отправки
  • Операторы
    • Операторы сравнения
    • Логические операторы
    • Оператор $elemMatch
  • Даты
© 2015 - 2025 Altcraft. Все права защищены.