Данные пользователей
Система хранит данные о людях, которые к вам пришли: кто они (идентификаторы), в какие группы входят (Списки) и какие значения за ними закреплены (Ресурсы) с историей изменений (Транзакции). Все данные привязаны к внутреннему ID пользователя — единому во всех сетях, откуда бы человек ни писал.
Списки
Список — это набор пользователей: его удобно использовать для сегментации («оплатившие», «участники конкурса», «новички») и для рассылок. Раздел — /cabinet/lists.
Внутренний и внешний ID
У каждого пользователя есть внутренний ID — единый номер внутри системы, и внешний ID — его номер в конкретной сети (например, в ВКонтакте). Один и тот же человек из разных сетей — это один внутренний ID. В списках хранится именно внутренний ID, а внешний — для справки и поиска.
Карточка списка
Открыв список, вы видите его участников с постраничной подгрузкой и поиском (по внешнему или внутреннему ID). Пользователя можно добавить двумя способами: по внутреннему ID или указав сеть и внешний ID (если такого пользователя ещё нет в системе — он заведётся автоматически). Повторное добавление того же человека список не задваивает.
Импорт и экспорт
Состав списка можно выгрузить в CSV (кнопка «Экспорт») и загрузить обратно (кнопка «Импорт») — текстом или файлом .csv/.txt. При импорте выбирается режим: внешние ID одной сети, внутренние ID или автораспознавание (для файла, полученного экспортом). За один импорт — до 10 000 строк.
Списки в программах и рассылках
Из программы пользователя можно добавить в список или убрать из списка блоками-действиями, а условием проверить, состоит ли он в списке. По списку можно запустить рассылку — см. Рассылки.
Ресурсы
Ресурс — это переменная, закреплённая за пользователем: баллы, дни подписки, бонусы, число участий в конкурсе, текстовый статус и т. п. Раздел — /cabinet/resources. Значение хранится по внутреннему ID, поэтому баланс у человека единый во всех сетях.
Типы ресурсов
- Числовой — число (баланс, очки, дни). Его можно начислять и списывать, вести историю операций.
- Текст — короткая строка на пользователя (статус, промокод) с версиями.
- Большой текст — объёмный текст (заметка, анкета) с версиями.
Тип выбирается при создании ресурса и потом не меняется.
Короткий ключ
У ресурса есть номер (id) и короткий ключ (name) — необязательное имя латиницей:
money, bonus_days, club_status. В переменных можно писать любой из них:
{res.7.val} — по номеру
{res.money.val} — по короткому ключу (то же значение)
Короткий ключ удобнее: он переживает пересоздание ресурса (номер при этом меняется) и сразу читается в тексте. Задаётся в карточке ресурса, поле «Короткий ключ».
Правила ключа: латиница, цифры, _ и -, начинается с буквы или _, до 64 символов.
Ключ должен быть уникальным в кабинете среди неудалённых ресурсов — иначе
{res.money} было бы непонятно, к какому из них обращаться. Если ключ уже занят,
ресурс сохранится без него (об этом сообщит форма) — почти всегда это опечатка
или забытая старая запись.
Регистр не важен: money и MONEY — один и тот же ключ.
Категории
Ресурсы можно раскладывать по категориям — это просто способ навести порядок в списке ресурсов кабинета. Категории создаются и назначаются в разделе ресурсов.
Режим хранения
Для числового ресурса выбирается, как хранить изменения:
- Записывать транзакции — хранится и текущий баланс, и вся история изменений (по умолчанию);
- Только баланс — хранится лишь текущее значение, без истории (быстрее);
- Без истории — только текущее значение.
Выбирайте историю там, где важно видеть, откуда взялось значение; отключайте — для часто меняющихся служебных счётчиков.
Как меняются значения
Обычно ресурсы меняют программы — блоком «Изменить ресурс» (начислить/списать число или записать новую версию текста), а блок-условие «Проверить ресурс» разветвляет схему по значению (см. Блоки программ). Вручную значение можно посмотреть и поправить в карточке ресурса. Значение ресурса подставляется в тексты переменной {res.<номер>.val} или {res.<ключ>.val} — например {res.money.val} (см. Переменные).
Транзакции
Транзакция — это одно изменение значения числового ресурса: например «+10 за ответ в конкурсе» или «−1 день подписки». Сумма всех транзакций пользователя равна его текущему балансу — так всегда видно, из чего он сложился.
История по пользователю
История операций показывается только по конкретному пользователю — в карточке ресурса, кнопкой «История» (значок часов) в строке нужного человека. Общую историю ресурса целиком система не показывает: у активного ресурса она слишком большая. Поэтому сперва выберите пользователя — и увидите его операции.
Что в записи
Каждая запись истории содержит: размер изменения (дельту со знаком), значение после изменения, причину (если указана), источник изменения и дату. Если операцию внесла программа — рядом показано, какая программа и какой блок схемы её сделал; у ручных правок из кабинета источника нет.
Текстовые ресурсы
У текстовых и больших текстовых ресурсов транзакций нет — вместо них ведутся версии: при каждой записи сохраняется новое значение, а прежние остаются в истории версий. Текущим считается последнее.
Хранилища
Хранилища — таблицы с произвольными колонками для структурированных данных кабинета: каталоги, заказы, анкеты, настройки — всё, что удобнее держать строками и столбцами. В отличие от Ресурсов (одно значение на пользователя) и Списков (членство), хранилище — это полноценная таблица, форму которой вы задаёте сами. Раздел — /cabinet/datastores.
Колонки и типы
У каждого хранилища есть имя и набор колонок. Колонка имеет тип: текст, строка, целое число, десятичное число или дата/время. У даты/времени есть удобный флажок «подставлять текущее»: тогда при добавлении строки поле само заполняется моментом создания.
Прямой доступ к данным
У каждого кабинета — своя база данных под хранилища. Это даёт прямой доступ к вашим данным в обход интерфейса сайта: их можно читать и анализировать внешними инструментами — одна из особенностей платформы.
Хранилища в программах
Из программ с хранилищами работают три блока:
- Записать в хранилище — добавить, изменить или удалить строку, либо очистить таблицу.
- Найти в хранилище — найти строки по колонке; результат доступен дальше по проходу.
- SQL-запрос к хранилищу — произвольный запрос (доступен на выделенном сервере).
Значение из хранилища можно подставлять в тексты переменной {data.<ключ>.<id-строки>.<колонка>} — см. шаблонизатор в разделе «Программы».