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