Перейти к содержанию

Liquid в in-app

Используйте Liquid в контенте in-app, чтобы показать каждому пользователю его собственные данные: значения его тегов, атрибуты события, которое запустило in-app, и его User ID. Например, поприветствуйте пользователя по имени и покажите промокод, переданный в событии.

Где Liquid работает в in-app

Anchor link to

Liquid работает только в in-app, который джорни показывает с помощью элемента In-App. Работают оба режима Показ in-app: При следующем запуске и При событии.

Пишите Liquid в одном из этих мест:

  • Текст блока встроенного редактора, например блока HTML или блока Text. Работает текст на любом языке in-app.
  • Файл index.html загруженного HTML-архива.
  • Текстовое поле нативного in-app.

Добавление Liquid в in-app

Anchor link to

Чтобы добавить Liquid, напишите его в редакторе in-app, а затем выберите этот in-app в джорни.

  1. Откройте in-app во встроенном редакторе.

  2. Добавьте блок HTML или выберите существующий.

  3. В поле HTML введите код Liquid вручную.

    Настройки блока HTML в редакторе in-app с кодом Liquid, который приветствует пользователя по firstName, показывает тег loyalty_tier в верхнем регистре, атрибут события promo_code и условие if для уровня gold
  4. Нажмите Save.

  5. В элементе In-App вашего джорни выберите in-app в поле Media Source.

  6. Если in-app использует атрибуты события, выберите При событии в Показ in-app и укажите событие.

Предпросмотр в редакторе показывает код Liquid в исходном виде. Каждый пользователь видит свои собственные значения.

В этом примере firstName и loyalty_tier — теги, а promo_code — атрибут события, которое показывает in-app:

<h2>
Hi, {{ firstName | default: "there" }}!
</h2>
<p>
Your {{ loyalty_tier | upcase }} code:
<b>{{ promo_code }}</b>
</p>
{% if loyalty_tier == "gold" %}
<p>Shipping is on us today.</p>
{% endif %}

Доступные данные

Anchor link to

В Liquid для in-app доступны следующие значения:

ЗначениеЧто этоКак написать
ТегДанные пользователя, которые хранятся в Pushwoosh, например имя пользователя. In-app показывает значение, которое тег имеет в момент показа in-app.{{ loyalty_tier }}
Атрибут событияАтрибут события, выбранного в режиме При событии элемента In-App. Если имя атрибута совпадает с именем тега, используется значение атрибута.{{ promo_code }}
User IDID, который ваше приложение присваивает пользователю.{{ userid }}, строчными буквами
HWIDАппаратный ID устройства пользователя в Pushwoosh.{{ hwid }}, строчными буквами

Как писать имена переменных

Anchor link to

Соблюдайте эти правила, когда вводите имя переменной:

  • Вводите имя точно так, как оно записано в Pushwoosh, с учетом заглавных букв. Несовпадающее имя, например {{ firstname }} для тега firstName, выводится как пустой текст.
  • Пишите имена тегов и атрибутов без пробелов: {{ LoyaltyTier }} для тега с именем Loyalty Tier.
  • Чтобы вместо пустого текста показать запасное значение, добавьте фильтр default: {{ firstName | default: "there" }}.

Изменение вида значения

Anchor link to

Чтобы изменить вид значения, добавьте фильтр Liquid. Работают все стандартные фильтры, например upcase, capitalize, date и truncate, а также фильтр Pushwoosh timezone.

Ограничения Liquid в in-app

Anchor link to

В in-app у Liquid есть следующие ограничения:

  • Если вы отправляете in-app через Кампании > In-app коммуникации, Liquid не применяется, и пользователи видят код в исходном виде. Используйте вместо этого плейсхолдеры динамического контента.
  • {% include %} не поддерживается. Пишите весь код прямо в in-app.
  • Подключенный контент не поддерживается. Используйте вместо него значения из раздела Доступные данные.
  • Если архив in-app больше 1 МБ, Liquid не применяется, и пользователь видит код в исходном виде.
  • Если в коде Liquid есть ошибка, например незакрытый {% if %}, пользователь видит in-app с кодом в исходном виде. Проверьте in-app на своем устройстве перед запуском джорни.