Email

Омніканальність

In-App
Рекомендації в мобільних додатках

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

Мультимовність

Документи

Відповідність GDPR

Інтеграція

Інтеграція з сайтом

Методи підстановки промокодів у повідомлення

Існує багато способів надіслати промокод у повідомленні. Виберіть із них найприйнятніший для вирішення вашого завдання.

7 методів підстановки промокодів:

Підстановка промокоду за допомогою персоналізації. Версія 2.0

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

Складається з таких етапів:

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

Створення файлу з промокодами

Перший крок — це створення файлу з контактами та промокодами. Фактично це звичайний excel-файл, в якому ви створюєте базу промокодів. Шаблон файлу можна переглянути в розділі Налаштування Промокоди → Приклад файлу:

Вікно налаштувань промокодів

Виглядає він так:

Файл з промокодами

  • code — власне промокод
  • expirationDate — дата завершення терміну дії промокоду (формати: yyyy-MM-dd, yyyy-MM-dd'T'HH:mm:ss, yyyy-MM-dd'T'HH:mm, yyyy.MM.dd)
  • discount — знижка
  • type — тип промокоду (використовуються літери або літери та цифри)

Важливо!

Якщо потрібно використовувати лише промокоди, без інших параметрів, можна завантажити файл тільки з колонкою code.

Завантаження файлу на сайт

Завантаження файлу здійснюється в розділі Налаштування Промокоди → Завантажити файл:

Завантаження файлу з промокодами

Якщо ви завантажуєте лише промокоди, то ставите галочку Завантажити тільки промокоди. У цьому випадку до системи буде завантажено файл із назвою General. Усі промокоди, завантажені в такий спосіб, завжди будуть оновлюватися в файлі General.

Завантаження промокодів

Якщо ви завантажуєте файл промокодів з параметрами:

  • тип,
  • розмір знижки,
  • дата та час закінчення дії коду,

при завантаженні такого файлу в системі ви бачитимете дві вкладки: перелік та історія завантажень. У розділі "Перелік" ви зможете відслідковувати кількість актуальних та використаних промокодів на момент обраної дати:
Перелік завантаженних промокодів

Щоб видалити перелік промокодів, перейдіть у вкладку "Історія завантажень" і натисніть "...", а потім "Видалити":
Видалення переліку завантажених раніше промокодів

Створення та відправлення листа

  • Якщо ви використовуєте тільки промокоди

У режимі створення листа ви вставляєте змінну туди, куди вважаєте за потрібне. Вона має такий вигляд: %PC_GENERAL%.

Промокод в листі

Тепер ви можете запускати розсилку, і до листа буде підставлено перший невикористаний промокод із файлу.

  • Якщо ви використовуєте розширені можливості

У режимі створення листа ви вставляєте змінну туди, куди вважаєте за потрібне. Вона має такий вигляд: %PC_TYPE_EXPARATIONDATE_DISCOUNT%. У більш розгорнутому вигляді:

% PC_TYPE (тип промокоду)_термін придатності промокоду (скільки днів промокод проживе)_знижка (відсоток знижки за акцією)%. У результаті ваша змінна в листі виглядатиме так: %PC_NewYear_1_7%.

Промокод з розгорнутими можливостями

Тепер ви можете запускати розсилку, і до листа буде підставлено промокод із типом NewYear, знижкою 7% і датою завершення дії промокоду через один день.

Статичний

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

Підстановка промокоду за допомогою персоналізації

Технічно це найпростіший метод підстановки персоналізованих промокодів у повідомлення. Промокод записується до властивостей контакту і звідти підставляється в повідомлення.

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

Підготовка розсилки складається з таких етапів:

  1. Створення додаткового поля в системі.
  2. Створення файлу з промокодами.
  3. Завантаження файлу на сайт.
  4. Створення та відправлення листа.

1. Створення додаткового поля в системі

У базі контактів потрібно створити додаткове поле для промокодів.

Для цього ви заходите розділі Налаштування  Додаткові поля  Нове поле:

Промокод з розгорнутими можливостями

Натискаєте "Додати поле" та заповнюєте дані у вікні, що відкриється:

Додавання поля з промокодом

2. Створення файлу з промокодами

Далі потрібно створити файл із контактами та відповідними промокодами. Фактично це звичайний excel- або csv-файл, що містить колонки з email-адресами або номерами телефонів та відповідними промокодами.

3. Завантаження файлу на сайт

Через імпорт контактів ви завантажуєте файл із контактами та промокодами. У налаштуванні відповідності полів вибираєте створене поле Промокод для стовпчика з промокодами. Система оновить контакти й додасть промокоди до відповідних контактів.

Налаштуванні відповідності полів промокодів

У результаті імпорту буде створено групу контактів. Власне за нею потрібно буде здійснити розсилку.

4. Створення та відправлення листа

У режимі редагування повідомлення ви вставляєте змінну %PERSONAL.PROMOCODE|% туди, де має бути промокод.

Створення повідомлення з промокодом

Для цього ви можете навести курсив у потрібне місце повідомлення, натиснути пункт "Персоналізація" в меню, після чого вибрати поле з промокодом. Система сама підставить потрібну змінну.

Після завершення налаштувань здійснюйте звичайну розсилку повідомлення за групою контактів. Таким чином кожен одержувач отримає повідомлення з промокодом, що був призначений саме для нього.

Просте додавання промокодів

Підстановка промокоду з використанням API

У такий спосіб можна надсилати промокоди в тригерних листах.

Є два основних способи відправлення листів через API:

Із використанням сценарію

Напряму (без використання сценарію)

Метод Generate event

За допомогою цього методу ви можете створити й передати до системи якусь власну подію. Подія запустить сценарій, що виконає запрограмовані в ньому дії, наприклад надішле листа або SMS.

Процес має такий вигляд:

  1. Передавання даних до системи за допомогою методу /v1/event (при цьому створюється подія).
  2. Створення повідомлення для відправлення.
  3. Створення сценарію.

1. Передавання подій до системи за допомогою методу /v1/event

Вам потрібно налаштувати відправлення запитів Generate event через API до eSputnik. У параметрах кожної події слід передавати як мінімум email або номер телефону (для SMS) та промокод. Приклад.

У події ви можете прописати параметр, який міститиме промокод. Приклад того, як виглядатимуть параметри переданої вами події:

Параметри події

За промокод відповідають такі елементи:

  • name — promocode
  • value — ABC-123 (власне промокод)

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

У повідомлення потрібно вставити назву змінної, яка містить промокод.

Якщо ви назвали змінну promocode, то в лист вставляєте $!data.get('promocode').

Змінна promocode

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

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

Створення сценарію з промокодом

У параметрах ви вибираєте повідомлення, яке бажаєте відправити. Також потрібно вказати параметр із події, яка містить email-адресу. Більше нічого налаштовувати не потрібно. У цьому прикладі використовується блок Email. Якщо  бажаєте надіслати SMS? використовуйте блок SMS і вказуйте в налаштуваннях параметр, що містить номер телефону.

Send prepared message

За допомогою цього методу можна відправити повідомлення з промокодом напряму, без створення сценарію. Метод дозволяє надіслати промокод одному або безлічі перерахованих у запиті контактів, але не дозволяє відправлення групі контактів.

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

Вам потрібно налаштувати передавання запитів за методом API Send prepared message. Формат тіла запиту для цього методу:

{
 "recipients": [{
        "locator": "mail@example.com",
        "jsonParam": "{\"promocode\":\"ABC-123\"}"
    }],
    "email": true
}

Тут recipients — масив із одержувачами. У кожному його елементі є параметр jsonParam. Його можна використовувати для передавання будь-яких даних (наприклад, промокоду) в повідомлення. У цьому параметрі дані для повідомлення мають бути в форматі JSON, але перетворені на рядок.

Для відправлення повідомлення в такий спосіб вам потрібно його попередньо створити. Воно має обов'язково містити змінну, яка підставить промокод. Для поданого прикладу це $!data.get('promocode').

У запиті замість {id} ви вставляєте id повідомлення, яке бажаєте відправити.

/v1/message/{id}/smartsend

Завантаження промокодів для використання в сценарії

Для тригерних повідомлень, що відправляються зі сценаріїв, є можливість попередньо завантажити до системи список промокодів. У момент відправлення повідомлення сценарій буде отримувати наступний промокод із цього списку. Система гарантує, що один промокод буде використаний лише одного разу.

Промокоди можна завантажити через налаштування акаунту з файлу CSV або за допомогою спеціальних методів API.

Метод API для завантаження промокодів:

  • Upload promotional codes from a CSV file − завантаження з CSV або JSON файлу

Процес налаштування має такий вигляд:

  1. Згенерувати промокоди й передати їх нам через API.
  2. Створити повідомлення.
  3. Налаштувати сценарій.

1. Генерація та передавання промокодів через API

Вам потрібно згенерувати достатню кількість промокодів. Краще з великим запасом, щоб вони раптово не закінчилися.

Завантажте промокоди до нашої системи за допомогою API у зручний для вас спосіб. Можливе завантаження з CSV або JSON файлу.

У CSV-файлі або JSON передаються такі характеристики промокодів:

code — значення промокоду

expirationDate — дата завершення терміну дії промокоду. Формат дат є таким: 2017-12-31T23:59.

discount — знижка. Ви встановлюєте значення від 0 до 99.

type — тип промокоду. Ви вказуєте будь-яке значення. Наприклад, birthday, blackfriday, christmas тощо.

inUse — прапорець-позначка, використаний промокод чи ні.

discount і type призначені для сегментації промокодів у базі. Технічно не є важливим, яку знижку вказано. Реальна знижка у покупця буде такою, яку ви надасте йому на своєму сайті.

Видалити завантажений, але невикористаний промокод неможливо. Тож якщо раптом якісь промокоди втратили актуальність, оновіть їх, установивши для прапорця inUse значення true. У процесі використання система буде сама змінювати статуси використання промокодів з false на true.

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

У повідомлення потрібно вставити на місце промокоду змінну $!data.get('promocode').

Змінна $!data.get('promocode')

3. Налаштування сценарію

У сценарії потрібно вставити мінімум два блоки: Завдання — Отримати промокод та Email (або SMS).

Блок "Завдання — Отримати Промокод"

Сценарій може мати такий вигляд:

Блок Завдання — Отримати промокод

У цього завдання три параметри. Всі є обов'язковими:

days — кількість днів, протягом яких має діяти промокод

type — встановлений вами тип промокоду

discount — розмір знижки

Принцип роботи розглянемо на прикладі. У параметрах вкажемо такі дані:

days — 10

type — birthday

discount — 20

Це означає, що завдання витягне промокод зі знижкою 20%, якому надано тип birthday і який діятиме не менш ніж 10 днів із моменту спрацювання блоку в сценарії. Система витягне промокод, що відповідає заданим умовам, передасть його до повідомлення і позначить як використаний.

Блок Email

У блоці Email ви вибираєте заздалегідь створений лист і вказуєте параметр з події, що містить email-адресу.

Ясна річ, аналогічним чином можна здійснити відправлення SMS, використовуючи блок SMS.

Відправлення промокоду за допомогою передпроцесора

Передпроцесор створений для відправлення масових розсилок, але з унікальним контентом для кожного підписника. Вам потрібно спочатку згенерувати файл із даними в певному форматі та завантажити його до eSputnik. У процесі розсилання система братиме дані з цього файлу та підставлятиме в повідомлення. Зазвичай це використовується для відправлення розсилки з персональними товарними рекомендаціями, але можна замість набору товарів передавати будь-які дані, наприклад промокод.

Детальніше про перепдроцесори читайте тут.

Процес відправлення розсилки з використанням передпроцесора має такий вигляд:

  1. Створити файл для передпроцесора з промокодами.
  2. Завантажити цей файл до системи.
  3. Створити лист.
  4. Здійснити розсилку.

1. Створення файлу для передпроцесора з промокодами

Щоб відправляти повідомлення за допомогою передпроцесора, потрібно створити файл певного формату. Файл у форматі JSON має містити ключі (email-адреси або номери телефонів) і масив із даними для кожного ключа.

Приклад вмісту файлу:

{
    "mail1@example.com": [{
        "promocode": "001100"
    }],
    "mail2@example.com": [{
        "promocode": "001101"
    }],
    "mail3@example.com": [{
        "promocode": "001102"
    }]
}

Більше інформації щодо формату файлу ви знайдете тут.

2. Завантаження файлу до системи

Файли передпроцесора завантажуються в налаштуваннях акаунту в розділі "Передпроцесор". Детальніше тут.

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

У повідомлення на місце промокоду потрібно вставити змінну. Для цього прикладу змінна буде такою: $!data.get('recommendations').get(0).get('promocode').

Створення повідомлення для передпроцесора

Також потрібно підключити до цього повідомлення раніше завантажений файл передпроцесора.

Налаштування передпроцесора

4. Створити та запустити розсилку

Відправлення промокодів таким методом здійснюється як звичайна розсилка.

Генерація промокодів у сценарії

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

На своєму сайті ви зможете розшифрувати за допомогою зворотного алгоритму введений користувачем промокод і надати йому знижку або бонуси відповідно до умов вашої акції. Алгоритм шифрування/розшифрування промокоду описано у цьому документі.

Процес налаштування має такий вигляд:

  1. Ви створюєте ключ для шифрування промокоду.
  2. Створюєте лист.
  3. Налаштовуєте сценарій.
  4. Розшифровуєте промокод.

1. Створення ключа шифрування

Промокоди шифруються за допомогою ключа, який не повинні знати треті особи. Згенеруйте ключ у форматі eSSuperKeyXXXXXXXXXXXXXX, де XXXXXXXXXXXXXX — 14 будь-яких цифр. Ключ повідомте нам. Ми підключимо його до вашого акаунту.

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

У повідомлення потрібно вставити змінну $!data.get('promocode').

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

3. Налаштування сценарію

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

Сценарій для генерації промокодів

У сценарії використовуються блоки Завдання — Створити промокод та Email (або SMS).

Блок "Завдання — Створити промокод"

У цього завдання чотири параметри:

days — вказує кількість днів до завершення терміну дії промокоду. При спрацьовуванні цього блоку система додасть до поточної дати вказану кількість днів та зашифрує отриману дату завершення дії у промокод.

type — тип промокоду. Можна вказати тільки числа від 0 до 31. Значення буде зашифровано в промокод.

discount — розмір знижки від 0 до 99. Значення буде зашифровано в промокод.

key — Ключ шифрування. Залиште значення за замовчуванням.

Блок відправлення повідомлення (Email або SMS)

У блоці Email або SMS ви вибираєте заздалегідь створений лист і вказуєте змінну, що містить email або номер телефону.

4. Розшифрування промокоду

Одержувач отримає промокод такого формату: CRRH-ASDF-HGVB-MNCA.

На своєму сайті ви зможете розшифрувати цей промокод за допомогою алгоритму та ключа. Успішно розшифрувавши промокод, ви перш за все провалідуєте його; по-друге, отримаєте такі дані: дата закінчення терміну дії, знижка, тип промокоду. Алгоритм описано в інструкції.

Протестуйте на реальных розсилках

Залишилися питання?
Спеціалісти обов'язково нададуть відповідь та допоможуть вирішити вашу проблему!
Зворотний дзвінок
Залишіть заявку – і наш спеціаліст зв'яжеться з вами в робочий час.
Відправити заявку
Консультація в чаті
Готові до ваших запитань!
Написати в чат
Електронна пошта
Напишіть в службу підтримки eSputnik.
Надіслати email