Методи підстановки купонів у лист, Підтримка eSputnik
Існує багато способів надіслати промокод у повідомленні. Виберіть той, який найкраще підходить для вирішення вашого завдання.
7 методів підстановки промокодів:
Підстановка промокоду за допомогою персоналізації. Версія 2.0
Це новий метод встановлення промокоду з csv файлу. У цьому методі не потрібно завантажувати базу контактів із присвоєними ним промокодами. Ви тільки завантажуєте базу промокодів, вказуєте змінну і лист підставиться потрібний промокод. Підходить як для одиночних, так і для масових розсилок.
Складається з таких етапів:
- створення файлу з промокодами
- завантаження файлу в систему
- створення та надсилання листа
Створення файлу з промокодами
Перший крок - це створення файлу з контактами та промокодами. По суті, це звичайний excel файл, де ви створюєте базу промокодів. Шаблон файлу можна переглянути вНалаштування - Промокоди


code - сам промокод expirationDate - дата закінчення промокоду (варіанти дати прописані в шаблоні) discount - знижка type - тип промокоду (використовуються літери або літери та цифри)
Важливо! Якщо потрібно використовувати тільки промокод, без інших параметрів - можна завантажити файл тільки з колонкою code.
Завантаження файлу на сайт
Завантаження файлу відбувається в Налаштування - Промокоди - кнопка Вибрати

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

Створення тавідправка листа
Якщо використовуєте тільки промокод
У режимі створення листа вставляєте змінну туди, куди вважаєте за потрібне. У загальному вигляді вона виглядає так%PC_GENERAL%.

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

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

Підстановка промокоду за допомогою персоналізації
Технічно - найпростіший метод для встановлення персоналізованих промокодів в повідомлення. Промокод записується у властивості контакту та звідти підставляється у повідомлення.
Зручний для масових розсилок, коли необхідно кожному одержувачу відправити його унікальний промокод.
Підготовка розсилки складається з таких етапів:
- Створення додаткового поля у системі.
- Створення файлу із промокодами.
- Завантаження файлу на сайт.
- Створення та надсилання листа.
1. Створення додаткового поля у системі
В базі контактів необхідно створити додаткове поле для промокодів.
Для цього заходьте доУстановки →Додаткові поля.

Натискаєте на Додати поле і у вікні заповнюєте дані

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

В результаті імпорту буде створено групу контактів. По ній і треба буде зробити розсилку.
4. Створення та надсилання повідомлення
У режимі редагування повідомлення вставляєте змінну%PERSONAL.PROMOCODE% у місце, де має бути промокод.

Для цього можете поставити курсив у потрібне місце повідомлення, натиснутиІнше, потім наПромокод. Система сама підставить необхідну змінну.
Після завершення налаштувань робіть звичайну розсилку повідомлення на групу конатктів. Так кожен одержувач отримає повідомлення з тим промокодом, який був призначений для нього.
Підстановка промокоду за допомогою API
Цим способом можна відправляти промокоди в тригерних листах.
Є 2 загальні способи надсилання листів по API:
З використанням сценарію
Безпосередньо (без використання сценарію)
Метод /v1/event
За допомогою даного методу ви можете створити та передати в систему якусь свою подію. Подія запустить сценарій, який виконає запрограмовані в ньому дії, наприклад, надішле листа або SMS.
Процес виглядає так:
- Передача даних у систему з допомогою методу /v1/event (у своїй створюється подія).
- Створення повідомлення для надсилання.
- Створення сценарію.
1. Передача подій у систему за допомогою методу /v1/event
У події можна прописати параметр, в якому буде міститися промокод. Так можуть виглядати параметри переданої вами події:

За промокод відповідають такі елементи:
- name - promocode
- value - ABC-123 (сам промокод)
2. Створення повідомлення для надсилання
У повідомлення необхідно вставити назву змінної, яка містить промокод. Якщо ви назвали зміннуpromocode, то в лист вставляєте$!data.get('promocode').
3. Створення сценарію
Сценарій у такому разі виглядатиме так:

/v1/message//smartsend
За допомогою цього методу можна надіслати повідомлення з промокодом без створення сценарію. Метод дозволяє відправити промокод одному або безлічі перелічених у запиті контактів, але не дозволяє надіслати групу контактів.
Для кожного контакту можна надіслати окремий промокод.
Вам потрібно налаштувати передачу запитів за допомогою API /v1/message//smartsend. Формат тіла запиту для цього методу:
Щоб надіслати повідомлення таким методом, ви повинні попередньо його створити. У ньому обов'язково має бути змінна, яка підставить промокод. Для цього це$!data.get('promocode').
У запиті замість вставляєте id повідомлення, яке ви бажаєте надіслати.
/v1/message//send
За допомогою цього методу можна надіслати повідомлення з промокодомбез створення сценарію. Метод дозволяє відправити промокод на групу контактів, одному чи безлічі контактів. Зручний для розсилок на групу, коли в одному розсиланні треба всім відправити один промокод. Надсилати кожному одержувачу унікальний промокод за допомогою цього методу неможливо.
params - масив із параметрами для підстановки в лист. У ньому є один елемент, що містить промокод.
key - назва параметра (наприклад, promocode) value - значення параметра (наприклад, ABC-123)
У цьому прикладі надсилання на групу. Якщо хочете надіслати на один або кілька контактів, замість group >"recipients": [ "[email protected]", "[email protected]" ] .
Щоб надіслати повідомлення таким методом, ви повинні попередньо його створити. У ньому має бути змінна, яка підставить промокод. Формат підстановки змінних наступний:%TEMPLATE.ім'я_ключа_для_заміни%. Для цього прикладу вийде%TEMPLATE.promocode%.
Приклад вставки змінної промокода.

Завантаження промокодів для використання у сценарії
Для тригерних повідомлень, що надсилаються зі сценаріїв, є можливість завантажити в систему список промокодів. У момент надсилання повідомлення сценарій отримуватиме черговий промокод із цього списку. Система гарантує, що один промокод буде використано лише один раз.
Методи API для завантаження промокодів:
- /v1/promocodes - Завантаження із CSV файлу
- /v1/promocodes - Завантаження із JSON
Процес налаштування виглядає так:
- Згенерувати промокоди і передати їх нам через API.
- Створити повідомлення.
- Налаштувати сценарій.
1. Генерація промокодів та передача їх за API
Вам треба згенерувати достатню кількість промокодів. Краще з великим запасом, щоб вони не закінчилися.
Промокоди завантажте в нашу систему за API зручним вам методом. Можливе завантаження з файлу CSV або JSON.
У CSV-файлі або JSON передаються такі характеристики промокодів:
code - значення промокодуexpirationDate - дата завершення дії промокоду. Формат дат наступний:2017-12-31T23:59discount - знижка. Задаєте значення від 0 до 99.type - тип промокоду. Вказуєте будь-яке значення. Наприклад, birthday, blackfriday, christmas і т.д.inUse - прапор використаний промокод чи ні.
discount і type створено сегментації промокодів в базі. Технічно будь-яка зазначена знижка. Реальна знижка у покупця буде така, яку ви надасте йому на своєму сайті.
Видалити завантажений, але невикористаний промокод не можна. Тому якщо раптом якісь промокоди втратили актуальність, оновіть їх, встановивши прапорinUse значенняtrue. У процесі використання система сама змінюватиме статуси використання промокодів з false на true.
2. Створення повідомлення
У повідомлення на місце промокоду треба вставити змінну$!data.get('promocode').
3. Налаштування сценарію
У сценарії необхідно вставити мінімум 2 блоки: Завдання - Отримати Промокод та Email (або SMS).
Блок Завдання - Отримати Промокод
Сценарій може виглядати так:

Ця задача має 3 параметри. Усі обов'язкові.
days - кількість днів, які має діяти промокодtype - заданий вами тип промокодуdiscount -розмір знижки
Принцип роботи розглянемо з прикладу. У параметрах вкажемо такі дані:
days - 10type - birthdaydiscount - 20
Це означає, що завдання витягне промокод зі знижкою 20%, якому присвоєно тип birthday і який діятиме не менше 10 днів з моменту спрацювання блоку в сценарії. Система витягне промокод, що підпадає під задані умови, передасть його в повідомлення і помітить як використаний.
Блок Email
Звичайно, аналогічно можна зробити відправлення SMS за допомогою блокуSMS.
Надсилання промокоду за допомогою препроцесора
Препроцесор створений для надсилання масових розсилок, але з унікальним контентом для кожного передплатника. Вам потрібно спочатку згенерувати файл з даними у певному форматі та завантажити його в eSputnik. У процесі розсилки система братиме дані з цього файлу і підставлятиме у повідомлення. Зазвичай це використовується для відправки розсилки з персональними товарними рекомендаціями, але замість набору товарів можна передавати будь-які дані, наприклад, промокод.
Процес відправки розсилки з використанням препроцесора виглядає так:
- Створити файл для препроцесора із промокодами.
- Завантажити цей файл у систему.
- Створити лист.
- Зробити розсилку.
1. Створення файлу для препроцесора з промокодами