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

4. Створення повідомлення

Ця функціональність працює в кожному з каналів, доступних в eSputnik. Ми продемонструємо її налаштування на прикладі мобільного пуш-повідомлення.

1. Вкажіть довільну назву повідомлення.

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

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

#set($url=$!data.get('назва створеного вами джерела даних'))
JSON
COPY

У тому місці повідомлення, де має бути промокод, вкажіть змінну в такому вигляді:

$!data.get('promocode')
JSON
COPY

Контакти, які отримають повідомлення, побачать його таким (залежно від ОС мобільного пристрою):

5. Створення сценарію

У сценарії має бути 5 необхідних блоків:

1. Старт.

2. Задача “Отримати контакт” — блок витягує контактні дані з бази даних eSputnik, у т.ч. токен контакту, на який буде відправлений пуш.

3. Задача "Отримати промокод" — блок витягує промокод із завантаженого раніше списку для підстановки повідомлення. У цій задачі повинні бути вказані 3 обов'язкові параметри:

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

4. Блок із підготовленим вами повідомленням.

5. Кінець.

Докладніше про налаштування блоків сценаріїв >

Налаштуйте умови запуску сценарію та активуйте його. Кожен промокод, отриманий у повідомленні за цим сценарієм, записуватиметься до картки відповідного контакту.