Базовые команды PROScript

В этой статье собраны популярные команды PROScript, с помощью которых вы сможете:

• вставить ссылки и переменные в письмо,
• вывести в письме данные из формы,
• настроить отписку и подтверждение подписки,
• передать параметры через ссылку.

Эти команды можно использовать в email-рассылках (в конструкторе писем и HTML-редакторе), а часть из них и в других каналах — чтобы подставлять персональные данные или параметры в сообщения.

Популярные команды

Часто используемые параметры выпуска

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

Команда	Описание
[% param.issue_archive_url %]	Ссылка на веб-версию (архивную копию) письма
[% param.issue.channel %]	Канал выпуска
[% param.issue.date %]	Дата выпуска в формате YYYY-MM-DD
[% param.issue.name %]	Тема письма
[% param.issue.from.email %]	Адрес отправителя
[% param.issue.from.name %]	Имя отправителя
[% param.issue.reply.name %]	Имя для ответа
[% param.issue.reply.email %]	Адрес для ответа
[% param.draft.id %]	ID шаблона письма
[% param.draft.alias %]	Алиас шаблона
[% param.draft.name %]	Название шаблона

Ниже — более подробно про некоторые из них.

Ссылка на веб-версию письма

Веб-версия письма открывается в браузере как отдельная веб-страница и позволяет посмотреть контент рассылки полностью — например, если у получателей отключены картинки в почте. Чтобы добавить ссылку на веб-версию, используйте команду:

[% param.issue_archive_url %]

Пример использования:

<a href="[% param.issue_archive_url %]">Посмотреть веб-версию письма</a>

Дата и название выпуска

Добавьте в текст письма дату и название выпуска — так они останутся ясно видны, если подписчик перешлёт письмо. Ещё это удобно, если шаблон используется несколько раз — команды автоматически подставят актуальные данные.

Для того чтобы вывести в письме дату выпуска, добавьте команду:

[% param.issue.date %]

Чтобы добавить в тело письма название выпуска, используйте команду:

[% param.issue_name %]

Если вы работаете в HTML-редакторе, вставьте команду в код письма и оформите её тегами, например:

<p>[% param.issue.date %]</p>

Адрес отправителя

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

[% param.issue.from.email %]

Работая в HTML-редакторе, вставьте команду в код и оформите её тегами:

<p>[% param.issue.from.email %]</p>

Ссылки подтверждения и отписки

Подтверждение подписки

Подтверждение подписки позволяет перевести новые контакты в статус «Доступен для рассылки» — чтобы вы могли отправлять им письма.

Если подписчик попадает в базу через форму подписки, для подтверждения используйте команду:

[% confirm_url %]

Чтобы подтвердить контакты, которые были импортированы в систему, отправьте им письмо с командой:

[% param.url_confirm %]

Пример использования:

<a href="[% param.url_confirm %]">Пожалуйста, подтвердите вашу подписку</a>

Отписка от рассылки

Подписчик всегда должен иметь возможность отписаться от рассылки — для этого письма должны содержать ссылку отписки. При переходе по ссылке подписчик попадёт в стоп-лист:

[% param.url_unsub %]

Подписчик также может отказаться от писем конкретной тематики. Тематическая отписка даёт возможность не отписываться от рассылок полностью, а отключить только определённую категорию писем, сохранив остальные:

[% param.url_unsub_topic %]

Пример использования:

<a href="[% param.url_unsub %]">Отписаться</a>

Отмена отписки

Чтобы отменить отписку и вернуть подписчика из стоп-листа в список доступных для рассылки контактов, используйте команду отмены отписки.

Отмена глобальной отписки:

[% param.url_unsub_cancel %]

Отмена отписки по отправителю:

[% param.url_unsub_sender_cancel %]

Отмена тематической отписки:

[% param.url_unsub_topic_cancel %]

Пример использования:

<a href="[% param.url_unsub_cancel %]">Возобновить подписку на рассылку</a>

Если у подписчика сохранилось письмо с командой отмены подписки, он сможет восстановить подписку на вашу рассылку, перейдя по ссылке.

Работа с параметрами в ссылке

Параметры (или query-string) — это часть ссылки после знака ?, в которой передаётся дополнительная информация. Они используются для персонализации страниц (например, страниц отписки) или для аналитики.

Параметры в ссылке отписки

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

[% params.type %]

Например, чтобы показывать на странице отписки разный контент, добавьте параметр к ссылке отписки:

[% param.url_unsub %]?type=1

Также для персонализации страницы отписки допустимо использовать альтернативную команду:

[% params.label %]

Значение label сохраняется в статистике, и вы сможете увидеть, по ссылке с каким параметром перешёл подписчик. Например, это можно использовать для анализа тематических отписок: в параметрах ссылки передавать тематику, от которой отписывается пользователь.

Пример того, как команда может выглядеть в ссылке:

[% IF params.label == "survey_exit" %]Спасибо, что прошли опрос[% ELSE %]До встречи[% END %]

Работа с формами

Ссылка на форму

Используйте эту команду, чтобы отправить подписчику ссылку на форму, но при этом не передавать его email-адрес в URL. При переходе по такой ссылке email автоматически подставится в форму, и подписчику не придётся вводить его вручную:

[% form_url(id_формы) %]

Пример использования:

<a href="[% form_url(38) %]">текст</a>

Данные из формы

Эти команды помогут использовать в письме данные, которые подписчик ввёл в форму. Например: email, имя или выбранный город.

Email:

[% form_member.member.email %]

Используя комбинацию id формы и кода поля, можно добавить в письмо данные из любого поля:

[% form_member.id_формы.код_поля %]

Если вам нужно отправлять оповещение о заполнении подписчиком формы, добавьте в письмо команды для выведения даты, названия и темы выпуска.

Дата рассылки:

[% form_issue.dt %]

Название выпуска:

[% form_issue.draft.name %]

Тема выпуска:

[% form_issue.subject %]

Если вы работаете в HTML-редакторе, оформляйте команды в коде при помощи тегов, например:

<p>[% form_issue.dt %]</p>

Использование контента другого шаблона

Команда draft(id) позволяет вставить в письмо контент из другого шаблона. Это удобно, если нужно использовать один и тот же блок — например, стандартный футер — в нескольких шаблонах. Когда содержимое блока нужно обновить, достаточно будет изменить только шаблон-футер, и изменения автоматически появятся во всех письмах, где этот блок используется.

Чтобы вставить в письмо контент, используйте команду:

[% draft("id", "номер_шаблона") %]