Liquid templates

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

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

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

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

Синтаксис

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

Note

Чтобы узнать больше о синтаксисе, обратитесь к документации Liquid.

Объекты (objects)

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

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

Ввод

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

Вывод

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

Теги (tags)

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

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

Ввод:

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

Вывод (fr): Salut!

Вывод (es): Hello!

Операторы тегов

Оператор	Описание
==	равно
!=	не равно
>	больше чем
<	меньше чем
>=	больше или равно
<=	меньше или равно
or	логическое или
and	логическое и
contains	проверяет наличие подстроки в строке или массиве строк

Note

В тегах с более чем одним оператором and или or операторы проверяются в порядке справа налево. Нельзя изменять порядок операций с помощью скобок — круглые скобки являются недопустимыми символами в Liquid и помешают работе ваших тегов.

Фильтры (filters)

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

Ввод	Вывод
{{ Name | capitalize | prepend:"Hello " }}	Hello Anna

Использование Liquid templates

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

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

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

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

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

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

{% if TagName == 'value' %}
  Контент для отправки в этом случае
{% else %}
  Контент для отправки в противном случае
{% endif %}

Затем нажмите Применить.

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

Узнайте больше о Liquid templates в Journey

Tip

Вы также можете использовать синтаксис Liquid в запросах /createMessage для реализации Liquid templates. Для этого вам понадобится помощь вашей команды разработки. Поделитесь с ними руководством по Liquid templates для получения подробных инструкций.

Связанный контент

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

Ключевые сценарии использования

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

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

Предварительные требования

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

Пошаговое руководство по внедрению

Требуется помощь разработчика

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

Шаг 1. Настройка бэкенд-сервиса

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

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

Как это работает

Бэкенд-сервис действует как поставщик данных, отвечая на HTTP-запросы с информацией о конкретном пользователе.

1. Wavesend отправляет запрос на ваш бэкенд, передавая идентификаторы пользователя в качестве параметров запроса.
2. Ваш бэкенд обрабатывает запрос и извлекает запрашиваемые данные.
3. Ваш бэкенд возвращает JSON-ответ.
4. Перед отправкой сообщения Wavesend извлекает JSON-ответ от бэкенд-сервиса и динамически использует возвращенные значения (например, code) в контенте сообщения.

Пример ответа

{ "code": "SPECIALOFFERFORUSER12345" }

Шаг 2. Создайте Preset со связанным контентом в Wavesend

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

Пример

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

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

connected_content	Извлекает JSON-данные с указанного URL бэкенда.
http://your-backend-url.com	Эндпоинт бэкенда, который возвращает необходимые данные в формате JSON.
userId={{ ${userid} }}	Динамический параметр запроса, который передает ID пользователя на бэкенд.
:save result	Сохраняет полученный JSON-ответ в переменной result для использования в Liquid templates

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

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

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

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

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

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

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

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

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

Шаг 3. Отправьте сообщение, используя настроенный Preset

Отправьте сообщение с этим Preset, используя разовую отправку push-уведомлений или форму отправки email, или Customer Journey.

Важно

Если сервис возвращает статус, отличный от HTTP 200 OK, email-сообщение или push-уведомление не будет отправлено. Это гарантирует, что ваше сообщение будет отправлено только в том случае, если необходимые данные будут успешно получены.