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

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

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

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

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

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

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

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

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

Налаштування — Промокоди

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

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

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

Важливо!

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

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

Завантаження файлу здійснюється в Налаштування — Promocodes — кнопка Select

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

Якщо ви завантажуєте тільки промокоди, то ви ставите галочку Тільки промокоди і завантажуєте файл. У цьому випадку до системи буде завантажено файл із назвою 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:

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

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

Метод /v1/event

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

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

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

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

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

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

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

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

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

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

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

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

Змінна promocode

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

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

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

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

/v1/message/{id}/smartsend

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

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

Вам треба налаштувати передачу запитів за методом API /v1/message/{id}/smartsend. Формат тіла запиту для цього методу:

{
 "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 для завантаження промокодів:

  • /v1/promocodes - Завантаження из CSV файла
  • /v1/promocodes - Завантаження из 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