Переменные и функции Altcraft
Данные профиля
Данные профиля
Описание | Переменная |
---|---|
Email-адрес | {lead.email} |
Список телефонов | {lead.phones} |
Имя | {lead._fname} |
Фамилия | {lead._lname} |
Дата рождения | {lead._bdate} |
Пол | {lead._sex} |
Дата регистрации | {lead._regdate} |
IP-адрес регистрации | {lead._regip} |
Город регистрации | {lead._regcity} |
Страна регистрации | {lead._regcountry} |
URL-адрес регистрации | {lead._regurl} |
IP-адрес | {lead._ip} |
Город | {lead._city} |
Страна | {lead._country} |
Регион | {lead._region} |
Индекс | {lead._postal_code} |
Временная зона | {lead._tz} |
Поставщик | {lead._vendor} |
Идентификатор профиля | {lead._id} |
XXM-хеш | {lead._xxm} |
XX-хеш | {lead._xxh} |
MD5-хеш | {lead._md5} |
* Дополнительное поле | {lead.название_поля} |
Подписки
Подписки профиля
Описание | Переменная |
---|---|
Email-адрес подписки | {subscription.email} |
Домен email-адреса | {subscription.email_domain} |
Список email-адресов подписки | {subscription.emails} |
Телефон подписки | {subscription.phone} |
Список телефонов подписки | {subscription.phones} |
Список push-подписок | {subscription.pushes} |
MD5-хеш email-адреса | {subscription.email_md5} |
MD5-хеш телефона | {subscription.phone_md5} |
Hash подписки | {subscription.hash_id} |
Основное поле подписки | {subscription_field("channel" "field_name" resource_id)} channel — строка с указанием на канал ("email") field_name — имя поля для вставки ("domain") resource — идентификатор ресурса (10) |
Функция subscription_field
позволяет вставлять поля из подписок, независимо от того, какой канал используется в текущем сообщении. Например, если у профиля есть SMS подписка, вы можете подставить его телефон в email версию сообщения:
{subscription_field("sms" "phone")}
Если под условия подходят несколько подписок, выбирается подписка с самым высоким приоритетом.
Доступные поля для подстановки:
Канал | Поле | Описание |
---|---|---|
Email-адрес подписки | ||
domain | Домен email-адреса подписки | |
domain_group | Доменная группа | |
md5 | MD5-хеш email-адреса | |
sms | phone | Телефон подписки |
md5 | MD5-хеш телефона | |
push | subscription_id | Идентификатор push-подписки |
bundle_id | Идентификатор приложения для iOS APNs | |
provider | Push провайдер |
Аналогично в шаблон можно подставлять данные из подписок пользовательских каналов. Поля основных каналов соответствуют sid полей, которые вы указываете при создании канала.
UTM
Переменные UTM
Если у профиля в его карточке есть UTM, то их можно подставить в шаблон сообщения.
Описание | Переменная |
---|---|
UTM-метка о кампании | {lead._utm_campaign} |
UMT-метка об источнике трафика | {lead._utm_source} |
UMT-метка о типе контента | {lead._utm_medium} |
UMT-метка о содержании контента | {lead._utm_content} |
UMT-метка о ключевых словах | {lead._utm_term} |
Внешний JSON
Внешний JSON-контент
Внешний JSON-контент — это один из способов создавать динамические сообщения и автоматизировать работу. С его помощью в сообщение добавляется информация, генерируемая на вашем сервере точно в момент отправки каждого сообщения.
Подробнее о том, как работает внешний JSON можно прочесть в статье "Использование JSON-контента в сообщениях".
В тексте сообщения JSON-контент представлен переменными типа {json.variable}
. Типы данных list
и 'object' поддерживают циклы, для типа object
также доступно обращение к элементам по ключу {json.object.key_name}
.
Маркет
Использование переменных маркета
Чтобы использовать информацию о заказах и товарах в рассылках, вы можете добавить переменные маркета в шаблон сообщения. Более подробно использование таких переменных описано в статье "Использование переменных маркета в сообщениях".
Дата и время
Переменные даты и времени
Описание | Переменная | Пример |
---|---|---|
Форматированная дата | {format} | {format datenow "%Y-%m-%D %H:%M:%S timezone, %I am"} 2018-12-25 18:56:10 +03:00, 6 pm |
Неформатированная дата | {datenow} | 2018-12-25T18:56:10+0300 |
Смещение даты | {adddate()} | {adddate(datenow 0 0 3)} 2018-12-27T18:56:10+0300 |
Полный год | {yearlong} | 2018 |
Год | {year} | 18 |
Месяц | {month} | 12 |
День | {day} | 10 |
Часы в 24-часовом формате | {hours} | 18 |
Часы в 12-часовом формате | {hours12} | 06 |
«До полудня», «После полудня» | {ampm} | PM |
Минуты | {minutes} | 56 |
Секунды | {seconds} | 10 |
Функции вывода
Функции вывода
Описание | Переменная | Пример |
---|---|---|
Форматирование | format | {format 1000000000 ","} 1,000,000,000 |
Длина переменной | length | {length("abc")} 3 |
Массив значений | array | {array[1 "2" 3.3]} [1 2 3.3] |
Случайный элемент массива | randomize | {randomize(array[1 2 3])} 1 Пример: в дополнительном поле профиля Favourite_genres хранится массив ["Детектив", "Юмор", "Фантастика"] , выражение {randomize(lead.Favourite_genres)} выведет один случайный элемент, например "Детектив" .Работает с полями Телефоны, Теги и Массив объектов, а также с массивами API-контента и внешнего JSON-контента. |
Лимит массива | limit | {limit(array[1 2 3] 2)} [1 2] |
Чётность числа | iseven | {iseven(2)} => true{iseven(3)} => false |
Кодирование URL-адреса | urlencode | {urlencode(lead._regurl)} http:%2F%2Ftest.testdomain.com%2Fsomething Используется для кодирования недопустимых символов в URL параметрах. |
Декодирование URL-адреса | urldecode | {urldecode(lead._regurl)} http://test.testdomain.com/something |
Верхний регистр | uppercase | {uppercase("text")} TEXT |
Первый символ в верхнем регистре | uppercasefirst | {uppercasefirst("john")} John |
Шифрование
Шифрование и хэширование
Шифрование переменных шаблона применяется когда необходимо передать данные вместе с кликом по URL на целевой сайт, но при этом данные не должны отражаться в журналах веб серверов или каким-то образом у пользователя. Например, в некоторых случаях данные предзаполнения форм достаточно закодировать в base58, чтобы на стороне сайта их раскодировать и подставить в форму.
Чтобы передавать контент шаблона и переменные в зашифрованном или хeшированном виде, в редакторе шаблонов предусмотрена функция crypt
. Чтобы получить доступ к ней, нажмите на кнопку </>
в редакторе шаблонов и выберите Шифрование.
{crypt(алгоритм поле ключ)}