Настройки атрибутов
Что такое атрибуты сущностей
Атрибуты — специальные пользовательские поля, добавляемые к сущностям платформы. Они представляют собой определённый параметр c набором возможных значений. С помощью атрибутов можно не только маркировать для поиска определённые группы сущностей, но и использовать их как признак сегментации, переменную или включать их значения в API-запросы. Атрибуты можно назначать для кампаний, рассылок и сценариев.
Атрибуты иерархически наследуются по цепочке: Кампания → Сценарий → Рассылка. Это означает, что если для рассылки не задано значение атрибута, будет использовано значение сценария, а если не задано и там — значение кампании.
Создание и настройка
Чтобы перейти к созданию и настройке атрибутов, откройте раздел Настройки → Настройка атрибутов. Откроется панель управления атрибутами. Создайте первый атрибут, нажав на соответствующую кнопку:
Появится окно с настройками атрибута. Прежде всего задайте для него название и API-идентификатор. Далее отметьте те сущности, для которых будет доступен атрибут — кампании, рассылки или сценарии (как минимум один тип сущности):
Затем отметьте нужные параметры:
- Обязательный атрибут — для любой созданной сущности, в которой доступен атрибут, необходимо указать его значение. Без этого кампания, рассылка или сценарий не будут сохранены.
- Запретить редактирование атрибута в активных сущностях — запрещает изменение значения атрибута в уже активированных сущностях.
- Ограничить по количеству символов — устанавливает максимальную длину значений атрибута.
- Использовать регулярное выражение — проверяет значение атрибута на соответствие регулярному выражению.
Следующим шагом определите значения атрибута. Вы также можете разрешить пользователю не только выбирать значение из заранее созданных, но и добавлять новые при редактировании сущности. Для каждого атрибута можно установить до 30 значений:
Атрибуты иерархически наследуются по цепочке: Кампания → Сценарий → Рассылка. Это означает, что если для рассылки не задано значение атрибута, будет использовано значение сценария, а если не задано и там — значение кампании.
В дальнейшем значения можно не только удалять, но и архивировать:
Архивированное значение нельзя добавить новым сущностям, но оно сохраняется в уже существующих и может использоваться при фильтрации и поиске. Такие значения отмечаются специальным образом:
При необходимости назначьте значение атрибута по умолчанию. Затем сохраните и активируйте атрибут. После сохранения вы можете деактивировать, клонировать или удалить его из списка.
Даже сохраненные изменения в настройках атрибутов могут некорректно отображаться до перезагрузки страницы.
Мы рекомендуем обновлять страницу редактирования каждый раз после сохранения изменений.
Использование атрибутов в платформе
Поиск и фильтрация
Значения атрибутов используются для поиска и фильтрации сущностей платформы:
Сегментация профилей
При сегментации по действиям подписчиков можно использовать значения атрибутов для выбора кампаний, рассылок и сценариев для отбора профилей:
Исключения ГКГ
Пользователь может отключить глобальные контрольные группы для сценариев, рассылок и кампаний с определённым значением атрибута:
Исключения ЛКГ
В настройках локальной контрольной группы (ЛКГ) можно фильтровать профили по значениям атрибутов кампаний, сценариев и рассылок. Это позволяет гибко настраивать правила исключения профилей из контрольной группы.
Подстановка переменной
Значение атрибута можно подставлять в шаблоны и сценарии с помощью переменной {attribute_value("attribute_name")}, где вместо "attribute_name" — API-название атрибута.
Примеры использования:
{attribute_value("test_attribute")}— подставит значение атрибута "test_attribute"{attribute_value("campaign_type")}— подставит значение атрибута "campaign_type"{attribute_value("priority")}— подставит значение атрибута "priority"
API-запросы
Параметры с названием и значением атрибута доступны в некоторых API-запросах к платформе. Подробнее об API можно прочесть в этой статье.