Описание блоков (группа Общие)

Группа Общие состоит из блоков:

Блок Начало

Обязательный блок, который всегда ставится в начале сценария. Без этого блока сценарий не начнет работать. В одном сценарии может быть только один блок старта.

 

Блок Конец

Обязательный блок, может использоваться несколько раз. Без этого блока сценарий не сработает. Блок означает окончание (завершение) сценария.

Настройка блоков в сценарии

Блок Таймер

Блок используется для отложенного запуска сценария. Это по сути пауза, после которой сценарий продолжается.

Ставится перед тем блоком, перед которым нужна пауза.

Блок Таймер в сценарии

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

У данного блока есть 3 параметра:

  • подождать
  • отправить
  • время отправки

Для работы блока Таймер необходимо выбрать хотя бы один параметр.
 
Параметр Подождать

Параметры блока "Таймер"
В этом параметре можно выбрать сколько необходимо подождать, чтобы сценарий пошел дальше. Это могут быть минуты, часы, дни, месяцы. Соответственно задаем количество минут, часов, дней, месяцев.

 


Важный момент! Если вы выбираете подождать 1 (2,3) день, это значит, что сценарий пойдет дальше через 24 (48, 72) часа с момента срабатывания сценария. Если клиент подписался на вашу рассылку в 15:00, то письмо он получит в 15:00 следующего дня.
 

Параметр Отправить.

Настройка блока "Таймер"Параметр в котором выбирается день отправки. Это хороший вариант для запуска регулярных автоматических рассылок.


Важный момент! Если сегодня среда, а вы выбрали отправить в понедельник - письмо будет отправлено в следующий понедельник (то есть через несколько дней). Если сегодня понедельник - клиент получит письмо сегодня.
 


 

 

 

 

Параметр Время отправки

Параметр Время отправки
Работает по принципу параметра Отправить. Если вы выставили время отправки 8:45, а сценарий запустился в 15:00, то клиент получит письмо в 8:45 на следующий день.

Вы можете выбрать один или несколько параметров для настройки блока Таймер.

Важный момент! Обратите внимание на логику работы данного блока.
Например, вы выбрали такие параметры:

  • подождать 1 день
  • отправить в понедельник
  • время отправки 7:45.

 

Сценарий запустился в воскресенье в 15:00. Система ждет 1 день (24 часа). Наступает понедельник. Время окончания работы параметра “Подождать 1 день” в нашем примере 15:00 в понедельник. Система проверяет параметр “Отправить”. У нас выбран понедельник и сегодня понедельник. Пока все хорошо. Система проверяет параметр “Время отправки”. Условиями задано 7:45, а сейчас 15:00. Условия не сработали. Это значит, что клиент получит не в этот понедельник письмо, а только в следующий в 7:45.

Внимательно выставляйте параметры!

Блок Задача

Цель этого блока - решить определенную задачу.

Всего в системе на данный момент есть 14 задач:

Подтвердить контакт

Цель задачи - подтвердить контакт подписчика и сделать его активным в системе.

Например, когда человек заполняет форму подписки - контакт попадает в eSputnik, а подписчику на почту приходит уведомление с просьбой подтвердить подписку. Пока человек не перейдёт по ссылке подтверждения, контакт будет оставаться в системе неподтвержденным и получать рассылки не будет. Когда человек подтверждает подписку - запускается сценарий подтверждения. Срабатывает задача Подтвердить контакт, и контакт становиться в системе активным.

Вот так выглядит самый простой сценарий подтверждения контакта.

Сценарий подтверждения контакта

У данной задачи 2 параметра:

  • Email контакта
  • ID контакта

Они используются для выбора способа идентификации контакта, соответственно по email или id контакта.

По умолчанию контакт идентифицируется по email. В этом поле уже прописано название переменной, которая содержит email человека. Вы меняете ее только если создаете свою переменную в которой содержится email человека.

Если вы хотите подтвердить контакт не по email, а по его id в системе - прописываете название переменной, в которой содержится id контакта. По умолчанию в системе она называется ${Contactid}.

Создать контакт

Задача используется для создания контакта в системе. Это актуально если данные в систему передаются через API. Дело в том, что с помощью API данные в систему передаются, но контакт при этом автоматически не создается. Чтобы вытянуть поступившие данные и создать контакт - нужно задать такой сценарий.

Создать контакт

У задачи есть 2 параметра:

  • email
  • json

Email

Email - обязательное поле для задачи. По умолчанию там уже прописана переменная $EmailAddress, которая вытягивает значение email c поступивших данных через API. Ее не видно, но по умолчанию она там присутствует. То есть этот блок можно оставить пустым, прописывать что-то в этом блоке не обязательно.

Json

В поле можно прописать, какие данные кроме email мы еще хотим получить. Например, номер телефона, пол, сумма покупки, категория товара и т.д. То есть если вы через API передаете в систему данные о сумме покупки и категории товаров - эти данные можно дополнительно добавить к контакту. В этом случае у нас создатся контакт с полями email, сумма покупки, категория товаров.

В поле json записывается код с параметрами данных, которые мы хотим извлечь и присвоить контакту.

Важно! Перед использованием этой задачи необходимо предварительно создать дополнительные поля в контактах. Например, создать дополнительные поля Категория товаров, Сумма заказа.   

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

Обязательный email

Цель задачи - отправить письмо контакту несмотря на его статус в системе. То есть вы сможете отправить письмо всем (подтвержденным, неподтвержденным, в спаме), кроме контактов из черного списка.

Задача Обязательный емейл

У блока есть 4 параметра:

  • Сообщение
  • Email контакта
  • ID Контакта
  • JSON

Обязательным является параметр Сообщение. Остальные параметры заполняются в зависимости от задач.

В параметре Сообщение выбирается письмо, которое будет отправлено. Нужно заранее создать письмо, которое вы бы хотели отправить, а затем выбрать его при настройке сценария.

Email контакта
По умолчанию контакт идентифицируется по email. В этом поле по умолчанию уже прописано название переменной, которая содержит email человека. Вы меняете ее только если создаете свою переменную в которой содержится email человека.

ID Контакта
Если вы хотите идентифицировать человека не по email, а по id в системе - прописываете название переменной, в которой содержится id контакта. По умолчанию в системе она называется ${Contactid}. Данные в поле Email контакта удаляете.

JSON
В поле записываются данные, которые мы хотим использовать в письме. Более подробно механизм работы параметра будет описан на примере.


Обновить контакт

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

Задача актуальна если данные в систему передаются через API. В таком случае данные в систему поступают, но контакт при этом автоматически не создается. Чтобы вытянуть поступившие данные и создать контакт нужна следующая задача.

Задача Обновить контакт

У задачи есть 2 параметра:

  • email
  • json

Email

Email - обязательное поле для этой задачи. По умолчанию там уже прописана переменная $EmailAddress, которая вытягивает значение email c поступивших данных через API. Ее не видно, но по умолчанию она там присутствует. То есть этот блок можно оставить пустым, прописывать что-то в этом блоке не обязательно.

Json

В поле можно прописать, какие данные кроме email мы еще хотим обновить. Это может быть, например, номер телефона, пол, сумма покупки, категория товара и т.д. То есть если вы через API передаете нам в систему данные о сумме покупки и категории товаров - эти данные можно дополнительно обновить.

В поле json записывается код с параметрами данных, которые мы хотим извлечь и присвоить контакту.

Важный момент! Перед использованием данной задачи необходимо предварительно создать дополнительные поля в контактах. Например, создать дополнительные поля Категория товаров, Сумма заказа.   

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

Получить промокод

Цель задачи - передать промокод в письмо, которое идет следующее по цепочке.

Параметры блока Задача

У задачи есть только один обязательный параметр - days.

Работает это так:

  • в eSputnik загружается файл с промокодами и датой их окончания
  • в параметре days вы ставите цифру. Например, 5.
  • система ищет промокоды, срок действия которых еще не менее 5 дней. Вытягивает один из них и передает данные в письмо, следующее в цепочке
  • промокод может использоваться в письме только 1 раз и помечается как использованный. 

Важный момент! В тексте письма (в которое передаются данные промокода) обязательно должна стоять переменная $promocode, чтобы вытянутый промокод подставился в письмо

Получить Промокод (с большой буквы)

Цель задачи - взять промокод и передать его в письмо, которое идет следующее по цепочке. Работает по принципу задачи Получить промокод, но более гибкая в настройке. Данные о промокодах в систему eSputnik передаются через API.


Получить промокод
 

У задачи 3 параметра:

  • days - количество дней. Обязательный параметр.
  • type - название группы промокодов
  • discount - размер скидки

Принцип работы рассмотрим на примере. В параметрах укажем следующие данные:

  • days - 10
  • type - Новый год
  • discount - 25

Это значит, что сценарий вытянет промокод со скидкой 25%, который находится в группе Новый год и срок действия которого не меньше 10 дней. Если под данный критерий попадает несколько промокодов - система сама выберет один из них.

Важный момент! В тексте письма (в которое мы передаем данные промокода) обязательно должна стоять переменная $promocode, чтобы вытянутый промокод подставился в письмо

Создать промокод

Цель задачи - создать (сгенерировать) промокод и передать его в письмо, которое идет следующее по цепочке. В таком случае промокод сгенерирует система eSputnik и передаст данные в письмо.

Параметры блока Задача
 

У задачи 4 параметра:

  • days - указывается количество дней до окончания действия промокода.
  • type - указывается число от 0 до 9.
  • discount - размер скидки. Если вы хотите сгенерировать промокод по которому вы дарите подарок клиенту - в поле discount ставите 0.
  • key - можно не менять и оставить по умолчанию.

Все параметры обязательны для заполнения.

Важный момент! Для использования этой задачи у вас на сайте предварительно необходимо разработать и установить дополнение, которое будет проверять подлинность созданного промокода. Смысл в том, что мало создать промокод, его еще надо проверить (ведь клиент может ввести любую комбинацию букв и цифр). Если у вас нет возможности проверить подлинность промокода и его условия (размер скидки, срок действия) - то эту задачу лучше не использовать.

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

В тексте письма (в которое мы передаем данные промокода) обязательно должна стоять переменная $promocode, чтобы вытянутый промокод подставился в письмо.

Получить заказ

Цель задачи - вытянуть данные о заказе и передать их в письмо. Задача актуальна только в случае, когда вы передаете данные о заказах в eSputnik методом API.

Получить заказ

Задача может использоваться в сценариях уведомления клиента о заказах, доставки и т.д. То есть везде, где необходимы данные о заказе.

Задача работает так:

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

Важный момент! Задача вытягивает все данные о заказе, которые передаются по API. В текст письма необходимо вставить переменные только тех параметров, которые вы хотите отправить клиенту.

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


Брошенные просмотры по email

Цель задачи - вытянуть данные о просмотренных товарах и передать их в письмо. Задача актуальна только если вы передаете данные о брошенных просмотрах в eSputnik через систему SoftCube.

Брошенные просмотры

Работает по принципу задачи Получить заказ.

Задача работает следующим образом:

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

У задачи есть 4 обязательных параметра:

  • tenantId
  • apiKey
  • blockId
  • email

Значения для этих параметров необходимо запрашивать у компании SoftCube.

Брошенные корзины по email

Цель задачи - вытянуть данные о незавершенном заказе и передать их в письмо. Задача актуальна только если вы передаете данные о брошенных корзинах в eSputnik через систему SoftCube.

Брошенные корзины

Работает аналогично задачи Брошенные просмотры по email:

  • в систему поступают данные о незавершенном заказе
  • блок вытягивает все данные, которые передаются с незавершенным заказом.
  • полученные данные передаются в письмо.

У задачи есть 4 обязательных параметра:

  • tenantId
  • apiKey
  • blockId
  • email

Значения для этих параметров необходимо запрашивать у компании SoftCube.

Рекомендации по email

Цель задачи - передать данные с рекомендациями в письмо.

Задача работает по то тому же принципу, что и Брошенные просмотры по email и Брошенные корзины по email. Только вместо информации о просмотренных страницах или незаконченном заказе вытягивается информация с рекомендациями.

Рекомендации по емейл

У задачи есть 4 обязательных параметра:

  • tenantId
  • apiKey
  • blockId
  • email

Значения для этих параметров необходимо запрашивать у компании SoftCube.

Получить контакт

Цель задачи - вытянуть данные о контакте и передать их в письмо. Например, мы хотим каждый раз получать письмо-уведомление с контактными данными, когда у нас появляется новый подписчик. Второй вариант - мы хотим после регистрации прислать клиенту его регистрационные данные.

Получить контакт

Задача работает следующим образом:

  • в системе создается (регистрируется) событие, которое содержит данные о контакте
  • блок вытягивает абсолютно все данные, которые передаются с событием.
  • полученные данные передаются в письмо.

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

У блока есть 3 параметра:

  • ContactID.
  • EmailAddress
  • Phone

Параметры Email контакта, ID контакта и Phone используются для выбора способа идентификации контакта. Одно из этих полей должно быть обязательно заполнено соответствующими данными.

Например, если вы хотите идентифицировать человека не по email, а по его id в системе - прописываете название переменной, в которой содержится id контакта. По умолчанию в системе она называется ${Contactid}.

Запустить событие

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

Запустить событие

У задачи есть 3 параметра:

  • eventTypeId. Обязательное поле. В нем необходимо выбрать событие, которое мы хотим запустить.
  • keyValue - ключ события, которое мы хотим запустить
  • params - параметры, которые мы хотим передать в запускаемое событие.

Параметры keyValue и params можно не заполнять. Более детально использование этих параметров будет показано на примерах.

Блок Условие

Цель блока - проверить выполняются определенные условия сценария или нет. В зависимости от этого дальнейший ход сценария разделяется на две ветки:

  • если да - сценарий выполняет одно действие
  • если нет - другое

Блок имеет один вход и 2 выхода (один - если Да, второй - если Нет).

У блока есть 5 задач:

Проверить событие

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

Проверка события

У задачи есть 2 параметра:

  • Ключ
  • Тип события. Выбираем из списка событие, выполнение которого мы хотим проверить.

Переменная соответствует регулярному выражению

Цель задачи - проверить определенную переменную или данные и в зависимости от этого скорректировать дальнейший ход сценария.

Например, мы можем проверить кто наш пользователь - мужчина или женщина и исходя из этого скорректировать ход сценария.

Переменная соответствия

У задачи есть 2 параметра:

  • name - название переменной, которую необходимо проверить
  • pattern - значение переменной, которое мы проверяем. Значение переменной записывается в формате Regular expressions.

Рассмотрим небольшой пример. Например, мы хотим проверить есть ли в нашем сценарии контакты с gmail.com. Если да - отправить их дальше по одной ветке сценария, а если нет - отправить по другой ветке. Для этого в поле name пишем переменную EmailAddress (без спецсимволов, только название), в поле pattern записываем выражение .*@gmail.com.

Задача сработает так:

  • сценарий дойдет до данного блока
  • найдет переменную EmailAddress в параметрах
  • проверит значение этой переменной
  • если в переменной находится адрес на gmail.com, система пропустит этот контакт и сценарий пойдет дальше по ветке Да.
  • если в переменной адрес содержит mail.ru, ukr.net и т.д., система не пропустит контакт и сценарий пойдет дальше по ветке Нет.

Контакт подтвержден

Цель задачи - проверить подтвержден контакт или нет и в зависимости от этого скорректировать дальнейший ход сценария.

Контакт подтверждён

Как работает данная задача

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

В этом случае:

  • контакт появляется в базе eSputnik, но находится в статусе неподтвержденный;
  • человеку отправляется письмо с просьбой подтвердить регистрацию;
  • задача проверяет подтвердил человек регистрацию или нет;
  • если подтвердил - сценарий идет по ветке Да и отправляется приветственное письмо;
  • если еще не подтвердил регистрацию - сценарий идет по ветке Нет.

У задачи есть 2 параметра:

  • EmailAddress
  • ContactId

По умолчанию система проверят подтвержден контакт или нет по email. Если вы хотите, чтобы идентификация шла по id контакта, необходимо в поле ContactId вписать переменную ${ContactId}.

Контакт существует

Цель задачи - проверить существует контакт или нет и в зависимости от этого скорректировать дальнейший ход сценария. Работает аналогично задаче Контакт подтвержден.

Контакт существует

У данной задачи есть 2 параметра:

  • EmailAddress
  • ContactId

По умолчанию система проверяет существует контакт или нет по email. Если вы хотите, чтобы идентификация шла по id контакта, необходимо в поле ContactId вписать переменную ${ContactId}.

Читать дальше

Часть 2. Описание блоков (группа Действия)

Часть 3. Описание блоков (группа Условия)