Шаблоны Liquid

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

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

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

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

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

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

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

Hi {{Name}}! We're glad you're back!

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

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

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

Вывод (fr): Salut!

Вывод (es): Hello!

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

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

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

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

Чтобы добавить шаблон Liquid в ваше сообщение, вставьте его в тело сообщения. Вы можете сделать это при работе с элементами push или 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 в Journey

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

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

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

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

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

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

1. В редакторе push-контента или редакторе email-контента вставьте синтаксис связанного контента в поле сообщения.

Пример

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

Разбор синтаксиса

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

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

{% 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. Затем добавьте текст сообщения, включив в него полученные данные, вот так:

Hey, {{userid}}, grab your personal promo code - {{result.code}}

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

Отправьте сообщение с этим пресетом, используя форму разового push-уведомления, форму отправки email или customer journey.