Настройка персонализации

О том, как добавить данные о пользователе и его действиях на вашем сайте в сообщение

Персонализировать сообщения можно на основе свойств пользователя и свойств события. Подробнее про эти два параметра мы рассказываем в этой статье.

💡Персонализация на основе свойств пользователя

Чтобы сделать сообщения более личными, можно вставлять в текст свойства пользователей: имя, город и т.п.

В нашей системе выделены два типа свойств: системные и пользовательские. Весь список системных свойств можно посмотреть здесь. Если какого-либо свойства, которое записывается в вашем приложении, нет в этом списке, оно является пользовательским

В некоторых видах сообщений (ручных и автоматических) можно добавить персонализацию по имени, емейлу и телефону при помощи кнопки в настройке содержания.

К таким видам сообщений относятся: сообщение в чат, поп-ап и email (стандартный редактор).

Кликните по кнопке с иконкой персонализации и выберете нужный параметр:

В теле сообщения появится код, который добавит выбранное свойство из карточки пользователя.

❗Важно: имя Иван в превью сообщения выводится для примера. В сообщении имя Иван будет добавлено только тем пользователям, у которых в карточке имя действительно записано как Иван.

Персонализация на основе свойств пользователя при помощи кода

❗Важно: для персонализации по системным свойствам может потребоваться сбор данных. В первую очередь это касается таких свойств, как "Корзина', "Сумма в корзине" и т.п. Убедитесь, что все необходимые данные записываются в карточки пользователей перед использованием их в персонализации.

❗Важно: Персонализация возможна только с использованием фиксированных (статических) свойств, использовать динамические свойства не получится.

Чтобы добавить любое свойство в тело сообщения, используйте эту конструкцию:

{{ user['Название свойства'] }}

Вместо 'Название свойства' укажите любое свойство, которое вы хотите отобразить в сообщении. Если свойство системное, выберете его из этого списка. Если пользовательское - добавьте название так, как вы его записываете.

Пример:

Сумма Вашего заказа {{ user['$cart_amount'] }} рублей. Хотите оформить заказ?

$cart_amount - cсистемное свойство, которое отображает сумму в корзине.

Если сумма заказа равна 1000, то пользователь увидит следующее сообщение: "Сумма Вашего заказа 1000 рублей. Хотите оформить заказ?"

Если значение свойства у пользователя не определено, то вместо него можно подставлять другой текст. Для этого существует конструкция:

{{ user['Название свойства'] | default('Текст подстановки') }}

В данном примере вместо 'Название свойства' можно подставить любое свойство (системное или пользовательское), а вместо 'Текст подстановки' - то, что будет видеть пользователь в случае, если изначальное свойство у него не определено. 

Самый распространённый пример:

{{ user['$name'] | default('Уважаемый пользователь') }}

При добавлении этой конструкции в сообщение пользователи, у которых определено имя, увидят обращение по имени. Если имя не определено, пользователь увидит текст подстановки: уважаемый пользователь. Текст подстановки указан в качестве примера и может быть изменён в зависимости от ваших предпочтений.

В случае, если вы хотите отобразить только приветствие (без добавления имени), если имя пользователя не записано в карточку, используйте следующую конструкцию:

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

Если знаем имя пользователя, будет такой текст: "Привет, Иван!"
Если не знаем имя пользователя, будет такой текст: "Привет!"

Чтобы выводить имя пользователя, если оно есть в карточке, и выводить шаблонное обращение, если в карточке имени нет, вы можете использовать следующую конструкцию:

{% if user['$name'] is defined %}, {{user['$name']}}{% else %}, друг{% endif %}!

Если знаем имя пользователя, будет такой текст: "Привет, Иван!"
Если не знаем имя пользователя, будет такой текст: "Привет, друг!"

💡Персонализация на основе свойств события

Вы можете персонализировать сообщения на основе свойств события, которое служит триггером для отправки этого сообщения.

Например, мы настроили сообщение по триггеру "Зашёл на сайт". У этого события есть стандартные свойства:

Чтобы подставить какое-то из этих свойств в сообщение, используйте конструкцию:

{{event['Название свойства события']}}

Например, если вы напишите "Скачайте приложение для {{event['$os']}}", то пользователь увидит "Скачайте приложение для Windows 10".

Список всех системных свойств и их событий можно найти здесь.

Чтобы собирать свойства события, выберите "Добавить дополнительные свойства" при настройке события в мастере сбора данных (при этом надо прописать селекторы или текстовые поля, откуда будут подставляться данные) или передавайте события со свойствами через JavaScript API или Web API.

Работает на