Кейсы использования атрибутов

Атрибуты — это структурированные метки для кампаний, рассылок и сценариев. В отличие от свободных тегов, значение атрибута выбирается из заданного списка и проходит валидацию. Сущности наследуют значения по цепочке Кампания — Сценарий — Рассылка, а сами атрибуты доступны в поиске, сегментации, шаблонах и API.

Ниже — применение атрибутов по задачам: от наведения порядка в списках до передачи данных во внешние системы. Примеры условные и легко адаптируются под конкретный бизнес.

Маркировка и поиск сущностей

Задача. Кампании и рассылки накапливаются, и найти нужную группу в общих списках становится сложно: разные сотрудники используют разные формулировки, сущности разных проектов перемешиваются.

Решение. Атрибут задаёт единые значения для маркировки. Создайте атрибут Тип коммуникации со значениями Таргетирование, Информирование, Сервис — и каждый сотрудник при создании рассылки выбирает тип из списка, а не придумывает свою формулировку. В списках рассылок, кампаний и сценариев сущности фильтруются по значению атрибута, а сегменты и отчёты строятся по типу коммуникации.

Так же решаются похожие задачи:

• продуктовые линейки — маркировка рассылок по категориям товаров;
• несколько брендов или клиентов в одном аккаунте — атрибут Клиент разводит кампании по брендам;
• структура компании — атрибут Отдел отделяет кампании маркетинга от кампаний продаж.

подсказка

Атрибуты, в отличие от тегов, не позволяют создать «случайное» значение: пользователь выбирает из заданного списка, поэтому маркировка всегда единообразна. Значение наследуется по цепочке Кампания — Сценарий — Рассылка: достаточно пометить кампанию, и рассылки внутри неё считаются помеченными.

Контроль заполнения и формата

Задача. Каждая сущность должна нести определённые данные — например, ответственного и номер заявки, — а значения с некорректным форматом не должны попадать в систему.

Решение. Обязательный атрибут Ответственный со значениями Иванов, Петрова, Сидорова: без выбранного значения сущность не сохранится. Атрибут Номер заявки настройте с ограничением по количеству символов и регулярным выражением, чтобы проверять длину и формат записи.

Как работают проверки формата:

• Регулярное выражение проверяет вводимое значение атрибута на соответствие шаблону. Шаблон описывает допустимый формат записи — например, /[A-Z]{2}-\d{4}/ требует значение вида AB-1234. Значение, которое не подходит под шаблон, сущность примет нельзя: при попытке сохранить кампанию, рассылку или сценарий с таким значением платформа отклонит сохранение.

• Ограничение по количеству символов задаёт максимальную длину значения. Полезно, когда значение атрибута передаётся во внешнюю систему с жёстким лимитом на длину поля (например, номер договора до 20 символов), либо когда значение выводится в шаблоне и не должно «раздувать» контент. Длинное значение, превышающее лимит, не будет принято.

подсказка

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

Опция Запретить редактирование атрибута в активных сущностях блокирует изменение значений после активации, а значение по умолчанию подставляется автоматически, если пользователь не выбрал своё.

предупреждение

Атрибуты контролируют полноту и формат данных, но не управляют запуском: разрешение на запуск сущности настраивается ролями и группами доступа, а не атрибутами.

Отбор аудитории

Маркировка сущностей атрибутами работает как основа для отбора профилей.

Сегментация. В сегментации по действиям профили отбираются по участию в рассылках с определённым значением атрибута. Например, сегмент «получившие таргетированную рассылку» строится по атрибуту Тип коммуникации = Таргетирование — без ручного перечисления рассылок в условии. Такой сегмент автоматически учитывает новые рассылки с этим атрибутом и помогает контролировать частоту коммуникаций: например, отобрать подписчиков, получивших несколько сервисных сообщений подряд, или не отправлять таргетированные сообщения тем, кто недавно получал акционные.

Контрольные группы. В настройках глобальной контрольной группы исключаются сущности со значением атрибута — например, сервисные рассылки не участвуют в расчёте эффективности. В настройках локальной контрольной группы (ЛКГ) фильтр по значениям атрибутов строит правила исключения профилей по атрибутам конкретных кампаний, сценариев и рассылок.

Персонализация контента

Задача. Подставить в шаблон или ссылку значение, которое маркетолог задаёт один раз на уровне сущности и которое меняется от запуска к запуску, — например, ссылку на лендинг с UTM-метками. Шаблон при этом остаётся один: не нужно править вёрстку или копировать его под каждую кампанию.

Решение. Создайте атрибут, например Ссылка на акцию, и укажите его API-идентификатор — он используется в переменных. Значение задаётся на сущности при её создании или изменении: вручную маркетологом либо через API. Для рассылок значение можно не дублировать — оно будет унаследовано от кампании или сценария.

Вставьте переменную в ссылку кнопки шаблона:

https://example.com/promo?utm_source=news&utm_campaign={attribute_value("promo_url")}

При отправке платформа подставит в неё значение атрибута, заданное на сущности (или унаследованное). Например, один промо-шаблон с кнопкой «Подробнее об акции» используется для всех запусков, а адрес лендинга с UTM-метками меняется в каждой кампании: задали в кампании ссылку с меткой spring_2026 — кнопка ведёт на неё; следующий запуск — другая метка, без правки шаблона.

Переменная «Значение атрибута» подставляется в контент и в URL. Значение атрибута можно выбрать в шаблонах Viber, WhatsApp, Notify и MAX. Подробнее о переменной — в статье Настройки атрибутов.

к сведению

Атрибут хранит одно значение на сущность — оно одинаково для всех получателей рассылки. Такой механизм подходит для контента, общего для всей кампании (ссылки, UTM-метки, промо-идентификаторы), и не подходит для персональных данных: уникальный промокод, имя подписчика или его баланс подставляются из полей профиля, данных Маркета или программы лояльности.

Интеграция с внешними системами

Задача. Внешняя система (CRM, BI) передаёт в платформу маркировку сущностей и получает значения атрибутов обратно — для отчётности или автоматизации.

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

Например, чтобы получить список рассылок с определённым значением атрибута, отправьте POST-запрос на https://example.com/api/v1.1/campaigns/list:

{
  "attributes": {
    "communication_type": {
      "options": ["Таргетирование"]
    }
  }
}

В ответе платформа вернёт рассылки, у которых атрибут communication_type равен Таргетирование:

{
  "data": [
    {
      "id": 125,
      "name": "Скидка 20% на годовую подписку",
      "type": "broadcast",
      "is_active": false,
      "attributes": {
        "communication_type": "Таргетирование"
      }
    },
    {
      "id": 127,
      "name": "Осенние скидки",
      "type": "broadcast",
      "is_active": false,
      "attributes": {
        "communication_type": "Таргетирование"
      }
    }
  ],
  "error": 0,
  "error_text": "Successful operation",
  "total_count": 2
}

Полное описание параметров запроса и ответа — в документации разработчика.

В пайплайнах пользовательских каналов значение атрибута сущности доступно через функцию $getAttributeValue(message_id, "attribute_id") — например, чтобы передать во внешний API параметр, заданный на уровне кампании или рассылки.

Атрибуты также можно обновлять у уже завершённых рассылок — маркировка не «застывает» после окончания рассылки и доступна для доработки.