Персонализация с помощью Jinja

Полезные примеры персонализации сообщений

Jinja позволяет вам персонализировать сообщения разных типов (чат, письма, поп-апы, Telegram, Webhook) и сообщения чат-ботов, используя свойства пользователей и атрибуты событий. Также используя синтаксис Jinja можно задать более сложные условия для фильтров вашей аудитории в Триггерных сообщениях и Цепочках.


Синтаксис

Наиболее часто используются выражения Jinja, которые вызываются с помощью тегов {{ ... }}, и операторы, которые вызываются с помощью тегов {% ... %} .

Подробнее о синтаксисе Jinja.


Доступные выражения в Carrot quest

Для персонализации текстов сообщений и фильтров аудитории

{{ user['$название свойства'] }}  — системное свойство пользователя. Например, имя пользователя.

{{ user['название свойства'] }}  — ваши собственные свойства пользователя, которые вы создали вручную или автоматически передаёте в Carrot quest.

{{ event['название атрибута'] }}  — атрибут события, которое выступило триггером сообщения.

get_last_events('название события')[0]  —  функция, которая используется для получения хронологического списка определенного события. Когда мы добавляем [0]  в конце, это означает, что мы берём самое последнее (или недавнее) событие. Если мы используем, например, [2] , это значит, что мы выбираем третье событие с конца. Таким образом, число в квадратных скобках указывает, насколько далеко назад по списку событий мы заглядываем.
Если у пользователя нет такого события, функция вернёт пустой список, и [0] даст ошибку. Перед обращением к событию проверяйте, что список не пустой. Пример в разделах ниже.

{{ current_date() }}  — автоматически подставляет актуальную дату в текст сообщения. Формат отображения даты соответствует привычному виду: [18 сентября 2025].

Дополнительно для вебхуков

{{ event.as_json }}  — полное событие (все атрибуты), которое стриггерило вебхук

{{ user.as_json }}  —  все данные пользователя из его карточки (все записанные свойства и события)


Примеры применения Jinja-кода

Персонализация сообщения на основе атрибутов выполненного события

{% set events = get_last_events('Название события') %}
{% if events %}
{% set lastEvent = events[0] %}
{% set name = lastEvent.props['название атрибута 1'] %}
{% set site = lastEvent.props['название атрибута 2'] %}
Здравствуйте, {{ name }}! Вы оставили заявку на аудит сайта {{ site }}. Мы
позвоним.
{% else %}
Здравствуйте! Спасибо за заявку, мы позвоним.
{% endif %}

Этот пример кода на Jinja выполняет следующие действия:

    1. Получение списка событий

{% set events = get_last_events('Название события') %}

Функция get_last_events возвращает список событий с этим названием. Если у пользователя такого события нет, список пустой.

    2. Проверка, что событие есть:

{% if events %}

Если список не пустой, events[0] берёт последнее событие и сохраняет его в переменную lastEvent. lastEvent — объект, содержащий информацию о последнем событии.

    3. Извлечение атрибутов из события: из объекта lastEvent извлекаются значения двух атрибутов и сохраняются в переменные name и site. Атрибуты «название атрибута 1» и «название атрибута 2» замените на фактические названия, которые записываются для вашего события.

    4. Формирование текста сообщения: в строку подставляются переменные name и site. Пользователь видит приветствие по имени и сайт, на аудит которого он оставил заявку.

    5. Альтернативный текст: {% else %} . Если у пользователя нет события, он получит сообщение без подстановки атрибутов.

Подобная статья о персонализации с использованием атрибутов событий


Текст сообщения с условиями

{% if user['$name'] is defined %}
    Здравствуйте, {{ user['$name'] }}! Спасибо за вашу заявку.
{% else %}
    Спасибо за вашу заявку.
{% endif %}

Этот пример кода на Jinja выполняет следующие действия:

    1. Проверка наличия имени пользователя:

{% if user['$name'] is defined %}

Здесь проверяется, определено ли свойство '$name' в объекте user.  Это означает, что код проверяет, существует ли ключ '$name' и имеет ли он значение.

    2. Формирование персонализированного текста:

Здравствуйте, {{ user['$name'] }}! Спасибо за вашу заявку.

Если '$name' существует и имеет значение, то выводится персонализированное приветствие, где {{ user['$name'] }} заменяется на фактическое имя пользователя. Например, если '$name' равно "Иван", то сообщение будет: "Здравствуйте, Иван! Спасибо за вашу заявку."

    3. Альтернативный текст:

{% else %}
    Спасибо за вашу заявку.
{% endif %}

Если '$name' не определено или не имеет значения, выводится общее сообщение: "Спасибо за вашу заявку."


Как работает тест персонализации в письмах

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

Возможны два варианта:

  • Ошибка в коде: синтаксис, неизвестный фильтр. Тест не запустится. Исправьте код по тексту ошибки и запустите тест снова.
  • Коду не хватило данных. Например, код берёт последнее событие через get_last_events('...')[0], а у пустого пользователя событий нет. Появится предупреждение: "Код использует события или свойства, которые нельзя протестировать без данных лида. Выберите в списке ниже, на ком проверить письмо". Выберите лида, у которого есть нужное событие.

Такое же предупреждение появится, если в имени переменной опечатка, например usr вместо user. Если тест на лиде тоже завершился ошибкой, смотрите строку "Текст ошибки": в ней настоящая причина.

Что значит предупреждение. У части получателей события из кода может не быть. Добавьте проверку, чтобы код работал и для них, — см. пример "Персонализация сообщения на основе атрибутов выполненного события" выше.

Если у получателя нет свойства из кода ( user['название свойства'] ), на его месте будет пустота. Чтобы подставить другой текст, используйте проверку is defined — см. пример "Текст сообщения с условиями".


Другие статьи про Jinja:

Базовый синтаксис Jinja
Структура данных в Jinja
Фильтры в Jinja
Полезные заготовки Jinja-кода

Работает на