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-запроса как поле для записи соответствующих промокодов.

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

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

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

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

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

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')"
          }
     ]
}

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. Конец.

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

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