Подстановка промокодов в письма, методы, примеры файлов

Существуют следующие методы подстановки промокодов в письма:


Статический

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

Выглядеть это может так:

 

Подстановка промокода с помощью персонализации

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

Состоит из таких этапов:

  • создание файла с промокодами
  • создание дополнительного поля в системе
  • загрузка файла на сайт
  • создание и отправка письма

Создание файла с промокодами

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

Создание дополнительного поля в системе

Перед загрузкой файла в систему необходимо создать дополнительное поле для контакта.

Для этого заходите в НастройкиДополнительные поля




Нажимаете на Добавить поле и в открывшемся окне заполняете данные



Загрузка файла на сайт

Через импорт контактов загружаете файл с контактами и промокодами. В настройке соответствия полей выбираете созданное поле Промокод для столбца с промокодами.
Система обновит контакты и добавит промокоды к соответствующим контактам.



Создание и отправка письма

В режиме создания письма вставляете переменную %PERSONAL.PROMOCODE|%



Для этого нажмите на блок Другое, выберите и нажмите на Промокод. Система сама подставит нужную переменную.

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


Подстановка промокода с использованием API

Отправлять письма с промокодом можно с использованием API.

Есть 2 способа как это сделать:

С использованием сценария

Напрямую (без использования сценария)

Метод /v1/event

С помощью данного метода вы можете создать и передать в систему какое-то свое событие. В этом событии вы можете прописать параметры, в которых будет содержаться промокод.



Вот так выглядят переданные параметры. Для промокода это может быть:

  • name - promocode
  • value - 123-abc (сам промокод)

Процесс выглядит следующим образом:

  • передача данных в систему с помощью метода /v1/event (при этом создается событие)
  • создание письма для отправки
  • создание сценария

Передача данных в систему с помощью метода /v1/event.

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

Создание письма для отправки

В письмо необходимо вставить название переменной, которая содержит промокод.
Если вы назвали переменную promocode, то в письмо вставляете $!data.get(‘promocode’)


Создание сценария

Сценарий в таком случае будет выглядеть следующим образом:



В параметрах выбираете сообщение, которое вы хотите отправить. Больше ничего настраивать не нужно.
 

/v1/message/{id}/smartsend

С помощью этого метода можно отправить письмо с промокодом напрямую, без создания сценария. Метод позволяет отправить промокод одному или множеству контактов, но не позволяет отправить на группу контактов.

Для каждого контакта можно передать отдельный промокод.


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

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

В запросе вместо id вставляете id письма, которое вы хотите отправить.


 

/v1/message/{id}/send

С помощью данного метода можно отправить письмо с промокодом напрямую, без создания сценария. Метод позволяет отправить промокод на группу контактов, одному или множеству контактов.

Данный метод не позволяет отправить уникальный промокод каждому получателю. У вас есть промокод и вы его отправляете на группу, одному или нескольким контактам.


На скриншоте выделен диапазон куда заносится данные о промокоде.

groupId - указываете id группы, которой вы хотите отправить письмо
recipients - можно перечислить все email, которым вы хотите отправить письмо.
key - название переменной (например, promocode)
value - значение промокода (например, ABC-123)

Для отправки письма таким методом вы должны предварительно создать письмо. В письме обязательно должна быть переменная, которая подставит промокод.
Выглядит она следующим образом %TEMPLATE.имя_ключа_для_замены%.

Пример вставки переменной промокода.

В запросе вместо id вставляете id письма, которое вы хотите отправить.

Загрузка промокодов через API для использования в сценарии


С помощью API вы можете загрузить данные о промокодах и передать к нам систему

Методы API для загрузки промокодов:

Подстановка промокодов с помощью /v1/promocodes (метод POST). Загрузка из CSV файла

Процесс отправки письма с промокодом выглядит следующим образом:

  • создать файл с промокодом и передать данные через API
  • создать письмо
  • настроить сценарий

Создать файл с промокодом и передать данные через API

Используем метод /v1/promocodes (метод POST). Загрузка из CSV файла.

Данный метод используется если вы загружаете промокоды с помощью CSV файла.

В CSV файле должны быть следующие колонки:

code - значение промокода
expirationDate - дата завершения действия промокода. Формат даты записывается в таком виде 2016-02-23T23:59
discount - скидка. Задаете значение от 0 до 99
type - тип промокода. Указываете любое значение. Например, Black Friday, Christmas и т.д.
inUse - использованный промокод или нет.

inUse

У данного параметра могут быть 2 значения: false или true. False означает, что код используется (активный). True означает, что код уже использован.

В процессе использования система сама будет менять статусы с false на true.

Создать письмо

В письмо необходимо вставить название переменной, которая содержит промокод.
Если вы назвали переменную promocode, то в письмо вставляете $!data.get(‘promocode’)


Настроить сценарий

Самый простой сценарий для данного метода будет иметь такой вид:



В сценарии будут использоваться блоки Задача и Email

Блок Задача

В списке задач можно выбрать:

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

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

Для данной задачи сценарий будет выглядеть следующим образом:



У данной задачи будет один параметр - days (время до окончания действия промокода)

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

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

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

Сценарий будет выглядеть следующим образом:



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

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

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

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

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

Блок Email

В блоке Email выбираете предварительно созданное письмо

Подстановка промокодов с помощью /v1/promocodes (метод POST). Загрузка из JSON

Процесс отправки письма с промокодом выглядит следующим образом:

  • создать файл с промокодом и передать данные через API
  • создать письмо
  • настроить сценарий

Создать файл с промокодом и передать данные через API

Используем метод /v1/promocodes (метод POST). Загрузка из JSON.

Этот метод используется если вы передаете данные о промокодах с помощью JSON.



У данного метода используются следующие параметры:

promocodes. Указываете перечень промокодов
type - тип промокода. Указываете любое значение. Например, Black Friday, Christmas и т.д.
expirationDate - дата завершения действия промокода. Формат даты записывается в таком виде 2016-02-23T23:59
discount - скидка. Задаете значение от 0 до 99
inUse - использованный промокод или нет.

inUse

У этого параметра могут быть 2 значения: false или true. False означает, что код используется (активный). True означает, что код уже использован.

В процессе использования система сама будет менять статусы с false на true.

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

Создать письмо

В письмо необходимо вставить название переменной, которая содержит промокод.
Если вы назвали переменную promocode, то в письмо вставляете $!data.get(‘promocode’)



Настроить сценарий

Самый простой сценарий для данного метода будет иметь такой вид:



В сценарии будут использоваться блоки Задача и Email

Блок Задача

В списке задач можно выбрать:

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

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

Сценарий будет выглядеть следующим образом:



У данной задачи будет один параметр - days (время до окончания действия промокода)

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

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

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

Сценарий будет выглядеть следующим образом:



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

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

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

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

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

Блок Email

В блоке Email выбираете предварительно созданное письмо


Отправка промокода с помощью препроцессора

Что такое препроцессор описано здесь

Процесс отправки письма с промокодом выглядит следующим образом:

  • создать файл с промокодами
  • загрузить данные в систему
  • создать письмо
  • сделать рассылку

Создать файл с промокодами

Чтобы отправлять письма с помощью препроцессора, необходимо создать файл определенного формата.

Пример файла выглядит так:




Больше информации по формату файла здесь

Загрузить данные в систему

Как загрузить данные в систему описано здесь

Создать письмо

Чтобы отправлять письма с использованием препроцессора, необходимо сформировать письмо по определенным требованиям.

Пример сосставления письма с помощью препроцессора

Пример переменной, которую необходимо вставить в письмо



Создать и запустить рассылку

Отправка промокодов таким методом осуществляется как обычная рассылка.


Генерация промокодов в сценарии

Можно сформировать промокод прямо в сценарии и отправить пользователю

Процесс выглядит следующим образом:

  • создаете ключ для шифрования промокода
  • создаете письмо
  • настраиваете сценарий
  • расшифровуете промокод

Создание ключа

Чтобы сформировать промокод - его необходимо зашифровать. Для этого необходимо сформировать ключ в формате eSSuperKeyXXXXXXXXXXXXXX. Далее вы его сообщаете нам и мы вносим его в систему

Создание письма для отправки

В письмо необходимо вставить название переменной, которая содержит промокод.
Называется она promocode. В письмо вставляете $!data.get(‘promocode’)



Настройка сценария

Сценарий в данном случае будет выглядеть следующим образом



В сценарии будут использоваться блоки Задача и Email

Блок Задача

В списке задач необходимо выбрать:

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

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

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

Блок Email

В блоке Email выбираете предварительно созданное письмо

Как будет выглядеть промокод

Незашифрованный промокод будет иметь следующий вид:

161229970N. Где 161229 - дата окончания промокода, 9 - тип промокода, 70 - скидка, N - контрольная сумма.

Клиент же получит промокод следующего вида CRRH-ASDF-HGVB-MNCA

Расшифровка промокода

Чтобы проверить подлинность промокода, а также срок его действия на вашей стороне необходимо установить скрипт расшифровки промокода. Суть его в том, что промокод вида CRRH-ASDF-HGVB-MNCA обратно превращается в 161229970N и по этим данным происходит анализ промокода.

Для всех клиентов мы предоставляем инструкцию для внедрения данного метода.