Шаблоны Liquid

Шаблоны Liquid значительно расширяют возможности персонализации в Pushwoosh, позволяя использовать сложную логику в дополнение к обычному динамическому контенту.

Персонализация сообщений в Pushwoosh основана на тегах (данных пользователя). Pushwoosh предлагает множество тегов по умолчанию и пользовательских тегов. С их помощью вы можете указать имя пользователя, город, историю покупок и т. д., чтобы отправить более персонализированное сообщение. Например: «Здравствуйте, {First_name}, спасибо за заказ {item}».

Шаблоны Liquid добавляют в динамический контент больше логики. Например, если тег подписки пользователя содержит значение «free», вы можете отправить ему сообщение: «Получите скидку 10 %».

Изменение контента сообщения в зависимости от ID, поведения и предпочтений пользователей — это самый эффективный способ повысить релевантность и добиться более впечатляющих результатов от ваших маркетинговых кампаний.

Шаблоны контента, основанные на Liquid от Shopify, используют комбинацию тегов, объектов и фильтров для загрузки динамического контента. Шаблоны контента позволяют получать доступ к определенным переменным из шаблона и выводить их данные, не требуя информации о самих данных.

объекты определяют контент, который будет отображаться пользователю. объекты должны быть заключены в двойные фигурные скобки: {{ }}

Например, при персонализации сообщения отправьте {{Name}} в его теле, чтобы добавить имена пользователей в контент сообщения. Имя пользователя (значение тега Name) заменит объект Liquid в сообщении, которое увидит пользователь.

Привет, {{Name}}! Мы рады, что вы вернулись!

теги создают логику и управляют потоком выполнения для шаблонов. Разделители в виде фигурных скобок и знаков процента {% и %} и текст, который они окружают, не создают видимого вывода при рендеринге шаблона. Это позволяет вам присваивать переменные и создавать условия или циклы, не показывая пользователю логику Liquid.

Например, с помощью тега if вы можете изменять язык сообщения в зависимости от того, какой язык установлен на устройстве пользователя:

{% if Language == 'fr' %}
Salut!
{% else %}
Hello!
{% endif %}

Вывод (fr): Salut!

Вывод (es): Hello!

фильтры изменяют вывод объекта или переменной Liquid. Они используются внутри двойных фигурных скобок {{ }} и при присваивании переменных и разделяются символом вертикальной черты |. К одному выводу можно применить несколько фильтров, они применяются слева направо.

Шаблоны Liquid доступны как для сообщений, отправляемых из Панели управления (Control Panel), так и для API-запросов.

В Pushwoosh шаблоны Liquid применимы ко всем полям контента любого сообщения канала:

• Пуш-уведомления
• Email-сообщения

Чтобы добавить шаблон Liquid в ваше сообщение, вставьте его в тело сообщения. Вы можете сделать это при работе с элементами пуш-уведомлений или email прямо в интерфейсе Customer Journey Builder.

Перейдите в Customer Journey Builder > Create Campaign > Перетащите на холст следующие элементы: Audience-based Entry, Push (или Email) и Exit. Соедините элементы. Затем нажмите на иконку Push, выберите Custom content и вставьте свой текст.

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

{% if TagName == 'value' %}
  Content to send in this scenario
{% else %}
  Content to send otherwise
{% endif %}

Затем нажмите Apply.

Переменные шаблона (теги Pushwoosh) не должны содержать пробелов и должны состоять только из буквенно-цифровых символов и знаков подчеркивания, например my_tag или myTag вместо My Tag.

Узнайте больше о шаблонах Liquid в journeys

Связанный контент (Connected content) — это функция в шаблонах Liquid, которая позволяет динамически извлекать и использовать данные из внешнего источника, например веб-сервиса, прямо в ваших email-сообщениях или пуш-уведомлениях. Эта функция обеспечивает персонализацию в реальном времени, извлекая JSON-данные по указанному URL-адресу и сохраняя их в переменную, которую можно использовать в вашем контенте.

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

• Промокоды: вставляйте уникальные промокоды, сгенерированные бэкенд-сервисом.

• Для использования связанного контента (Connected Content) у вас должен быть собственный бэкенд-сервис, который генерирует и предоставляет необходимые данные (например, промокоды, товарные рекомендации) на основе User ID, HWID или пользовательских тегов. Pushwoosh затем извлекает эти данные перед отправкой сообщения.

Бэкенд-сервис должен:

• Принимать запрос, содержащий параметры конкретного пользователя (например, userId). Связанный контент (Connected Content) поддерживает UserID, HWID или любые пользовательские теги, которые вы настроили в своем проекте.
• Возвращать JSON-ответ с требуемыми данными. Этот контент затем можно динамически вставлять в сообщения.

1. В редакторе контента пуш-уведомлений или email-сообщений вставьте синтаксис связанного контента (Connected Content) в поле сообщения.

Пример

{% connected_content http://your-backend-url.com?userId={{ ${userid} }} :save result %}

Синтаксис

Аутентификация (необязательно)

Если ваш бэкенд-сервис требует аутентификации, вы можете включить API-ключ или токен в запрос связанного контента (Connected Content) для обеспечения безопасного доступа.

{% connected_content http://your-backend-url.com?userId={{ ${userid} }}&auth=YOUR_API_KEY :save result %}

Использование тегов в связанном контенте

Чтобы включить пользовательские теги, вставьте их в качестве параметров запроса в запрос Connected Content ({{ tag_name }}).

{% connected_content http://your-backend-url.com?userId={{ ${userid} }}{{ Language }} :save result %}

2. Далее добавьте текст сообщения, включающий полученные данные, например так:

Привет, {{userid}}, вот твой персональный промокод - {{result.code}}

3. После завершения работы с контентом сообщения и настройки параметров шаблона (preset) сохраните его для повторного использования в кампаниях.

Отправьте сообщение с этим шаблоном (preset) с помощью формы разового пуша, формы email-рассылки или через customer journey.