запрос (HTTP) для передачи промокода из сообщения в карточку контакта

Пользовательские данные

Email

Омниканальность

Автоматизация

Отслеживание событий и поведения

HTTP-запрос для передачи промокода из сообщения в карточку контакта

Источник данных “HTTP-запрос” позволяет передавать уникальный промокод из триггерного сообщения и записывать его в карту контакта или отправлять на ваш сервер. Таким образом вы сможете автоматически фиксировать, какой именно промокод получил тот или иной ваш подписчик.

Процесс настройки:

  1. Сгенерировать и загрузить в аккаунт eSputnik файл с промокодами.
  2. Создать дополнительное поле для карточек контактов, в которое будет записываться промокод.
  3. Подключить источник данных “HTTP-запрос” в аккаунте eSputnik.
  4. Подготовить сообщение с velocity-переменными для передачи промокодов.
  5. Создать сценарий, по которому будет отправляться сообщение и передаваться промокод.

1. Загрузка файла с промокодами в eSputnik

Подготовьте список промокодов в таком формате:

Пример таблицы с промокодами

Обязательные поля таблицы с промокодами:

  • “code” — промокод в произвольном формате;
  • “expirationDate” — дата и время истечения действия промокода в формате 2017-12-31T23:59;
  • “discount” — значение промокода от 0 до 99;
  • “type” — произвольное название типа промокода;
  • “inUse” — флаг, обозначающий, использован промокод или нет (true / false).

Подробнее о загрузке промокодов >>

2. Добавление дополнительного поля “Промокод” в карточки контактов

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

ID доп. поля

3. Подключение HTTP-запроса

1. Перейдите в настройки вашего аккаунта -> “Источники данных” -> “Новый источник” -> “Внешние источники”.

Создание нового источника

2. Выберите источник внешних данных “HTTP запрос”.

HTTP запрос

3. Дайте источнику произвольное название.

4. Выберите тип протокола “POST” и укажите протокол https://esputnik.com/api/v1/contact. Этот API-ресурс обновит в eSputnik данные контактов, участвующих в рассылке, добавив к ним полученные в данной рассылке промокоды. Если нужно обновить контактные данные в вашей системе, укажите соответствующий протокол.

POST

5. Активируйте свитчер “Передавать JSON в теле запроса” и введите в соответствующее поле тело запроса такого типа:

{
     "channels": [
          {
               "type": "contact unique identifier: email, sms or mobilepush",
               "value": "$data.get('contact_unique_identifier')"
          }
     ],
     "fields": [
          {
               "id": "ID of the contact card field created at the previous stage, where the promo code will be recorded",
               "value": "$data.get('promocode')"
          }
     ]
}

JSON в теле запроса

4. Создание сообщения

Данная функциональность работает в каждом из каналов, доступных в eSputnik. Мы продемонстрируем ее настройку на примере мобильного пуш-уведомления.

1. Задайте произвольное название сообщения.

2. Наполните сообщение необходимым контентом. Добавьте в него velocity-переменную, которая обеспечит обмен данными с внешним источником данных “HTTP-запрос”.

Синтакис конструкции:

#set($url=$!data.get('Название созданного вами источника данных'))

В том месте сообщения, где должен подставиться промокод, укажите переменную в таком виде:

$!data.get('promocode')

Переменные в сообщении

Получившие сообщение контакты увидят его таким (в зависимости от ОС мобильного устройства):

Отображение сообщения

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

В сценарии должно быть 5 необходимых блоков:

Схема сценария

1. Старт.

2. Задача “Получить контакт” — блок извлекает контактные данные из базы данных eSputnik, в т.ч. токен контакта, на который будет отправлен пуш.

3. Задача “Получить промокод” — блок извлекает промокод из загруженного ранее списка для подстановки в сообщение. У этой задачи должны быть указаны 3 обязательных параметра:

  • days — количество дней, на протяжении которого должен действовать промокод;
  • type — заданный тип промокода из загруженного ранее списка;
  • discount — размер скидки.

4. Блок с подготовленным вами сообщением.

5. Конец.

Подробнее о настройках блоков сценариев ->

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

Промокоды в карточке контакта

Остались вопросы?
Специалисты обязательно ответят и помогут решить вашу проблему!
Обратный звонок
Оставьте заявку – и наш специалист свяжется с вами в рабочее время.
Отправить заявку
Консультация в чате
Готовы к вашим вопросам!
Написать в чат
Электронная почта
Напишите в службу поддержки eSputnik.
Отправить email