Типы полей в базе данных

Стандартные поля базы

В таблице ниже представлен список стандартных полей базы, их соответствия в API, типы данных, а также примеры значений, которые можно использовать.

Поле в базе	Имя поля в API	Тип поля в UI	Тип поля в API	Пример значения
Email	email	Строка/Email	string	"example@example.com"
Телефоны	phones	Список телефонов	array	["+79001234567"]
Имя	_fname	Строка	string	"John"
Фамилия	_lname	Строка	string	"Doe"
Дата рождения	_bdate	Дата	string	"2001-12-31" "2001-12-31T00:00+03:00" Время можно передавать только через API.
Пол	_sex	Список	string	"male" "female"
Дата рег.	_regdate	Дата	string	"2023-12-31" "2023-12-31T23:59:59+03:00"
IP адрес рег.	_regip	IP	string	"127.0.0.1"
Город рег.	_regcity	Строка	string	"Москва"
Страна рег.	_regcountry	Строка	string	"Russian Federation" "RU"
Ссылка рег.	_regurl	Строка	string	"https://example.com"
IP адрес	_ip	IP	string	"127.0.0.1"
Город	_city	Строка	string	"Москва"
Страна	_country	Строка	string	"Russian Federation" "RU"
Регион	_region	Строка	string	"Europe/Moscow"
Индекс	_postal_code	Строка	string	"190000"
Временная зона	_tz	Строка	string	"Europe/Moscow"
Поставщик	_vendor	Строка	string	"form #30"

Дополнительные поля базы

От типа поля зависит, какие операторы будут доступны в сегментах и в динамических переменных шаблона, поэтому рекомендуем внимательно выбирать тип дополнительного поля в базе.

Тип поля в UI	Тип поля в API	Пример значения
Целое число	int	100
Число с точкой	float	100.5
Строка	string	"string value"
Дата	string	"2024-05-27T12:00:00Z"
Boolean	boolean	true false
Список	string	"Вариант 1" Также можно передавать значение в виде числа, например, 1. Число соответствует порядковому номеру элемента в списке.
IP	string	"127.0.0.1"
Теги	array	[ "Тег 1", "Тег 2", "Тег 3" ]
Объект	object	{ "key_1": { "sub_key": "sub_value" } }
Массив объектов	array of objects	[ { "key_1": "value_1" }, { "key_2": "value_2" } ]

к сведению

При API-импорте или обновлении полей с типом "Теги" их значения будут перезаписаны, а не добавлены к уже существующим. Чтобы добавить новые значения, не удаляя старые, следует воспользоваться функциональным обновлением.

Допустимые форматы и ограничения

Платформа ожидает определённые форматы значений для каждого типа поля. Убедитесь, что импортируемые данные соответствуют указанным требованиям, иначе система не сможет обработать их корректно.

• Email — формат должен соответствовать стандартам RFC. Для валидации используется регулярное выражение:

^[-a-z0-9!#$%&'*+/=?^_{|}~]+(\.[-a-z0-9!#$%&'*+/=?^_{|}~]+)*@((?:localhost|([a-z0-9]([-a-z0-9]{0,61}[a-z0-9])?\.)*([a-z]{1,24})))$

• Телефоны — номер должен соответствовать международному формату (без пробелов, дефисов и других разделителей, кроме плюса в начале). Подробнее со стандартом можно ознакомиться здесь.

• Даты — записываются в формате RFC 3339 (ISO 8601) с указанием часового пояса.

• Страна — принимается в виде двухбуквенного кода ISO 3166-1 alpha-2 или полного названия (в любом регистре).

• Пол — допустимые значения описаны в этой статье.

• Поставщик — длина строки не больше 26 символов.

• IP — IPv4 формат.

• Строка — не рекомендуется хранить более 100 КБ текста в одном поле.

• Объекты и массивы объектов — можно записывать только одноранговые объекты или одноранговые объекты, вложенные в другие объекты. Если вы используете объекты с более сложной структурой, подключите SQL базу и создайте запросы для выборки профилей. В именах полей объектов допустимо использовать только латинские буквы (в любом регистре), цифры от 0 до 9, символ нижнего подчеркивания _ и дефис -. Можно хранить данные типа int, float, string, boolean.

• Ограничение на объем данных одного профиля в базе составляет 16 МБ, включая все метаданные. Однако не рекомендуется хранить суммарно больше 2 МБ в дополнительных полях профиля.

Соответствие полей базы и элементов формы

Если вы настраиваете импорт данных профиля из полей формы в поля базы, убедитесь, что вы используете корректный тип поля для каждого элемента формы.

Элемент формы	Поле в базе
Короткий текст	Доп. поле с типом "Строка"
Email	Стандартное поле "Email"
Номер телефона	Стандартное поле "Телефоны"
Длинный текст	Доп. поле с типом "Строка"
Число	Доп. поле с типом "Целое число"
Да/Нет	Доп. поле с типом "Boolean"
Один вариант	Доп. поле с типом "Строка"
Множественный выбор	Доп. поле с типом "Теги"
Выпадающий список	Доп. поле с типом "Теги"
Дата	Стандартное или доп. поле с типом "Дата"
Диапазон	Доп. поле с типом "Целое число"

примечание

Хоть вы и можете записать все данные пользователя в строковые поля, это ограничит возможности для дальнейшей сегментации. Например, если дата будет записана в строковое поле, вы не сможете использовать операторы сравнения "дата меньше" или "дата больше" в сегментах или шаблонах.