Настройки атрибутов

Что такое атрибуты сущностей

Атрибуты — специальные пользовательские поля, добавляемые к сущностям платформы. Они представляют собой определённый параметр 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 можно прочесть в этой статье.