2804
правки
Изменения
Перейти к навигации
Перейти к поиску
Новая страница: «Категория:Плагины (Авиабилеты) <!-- --> '''Программа лояльности''' — модуль системы {{NameSyst…»
[[Категория:Плагины (Авиабилеты)]]
<!-- -->
'''Программа лояльности''' — [[модуль]] системы {{NameSystem}} для проведения промоакций
== Назначение==
Предоставление скидки по промокоду на покупку авиабилета.
== Примеры использования ==
* Проведение акций, приуроченных к праздникам, например:
**скидка ко дню рождения,
**скидка к профессиональному празднику.
* Предоставление выгодных условий перелета для постоянных клиентов.
* Предоставление выгодных условий перелета на рейсы определенных авиакомпаний.
==Принцип работы==
# Cоздание промоакции.
# Настройка условий проведения промоакции.
# Установка скидки по промоакции в правилах ценообразования.
# Генерация промокодов.
# Информирование клиентов о скидках и рассылка промокоды.
Название, условия акции и скидки агентство устанавливает самостоятельно.
== Включение программы лояльности ==
Чтобы создавать, настраивать и использовать промоакции в {{NameSystem}}, у агентства должен быть подключен компонент '''Система лояльности'''. Включить компонент может только администратор {{NameSystem}} в разделе '''Для техподдержки''' → '''Компоненты'''.
Агентству станет доступен раздел '''Управление продажами''' → '''Модули''' → '''Программа лояльности''' для настройки промоакций.
== Настройка промоакций ==
=== Включение промоакции ===
Чтобы активировать промоакцию, нужно включить опцию '''Промоакции включены''' в разделе '''Управление продажами''' → '''Модули''' → '''Программа лояльности''' → '''Общие настройки'''.
===Параметры промоакции===
* '''Уникальный код акции''' (обязательное поле) — используется для внесения правил по акции в ценообразование и в общем случае не виден пользователю. Генерируется автоматически при создании промоакции, но может изменяться менеджером или администратором на более понятный и запоминающийся. <br />{{Attention|Не меняйте уникальный код акции после установки скидок в правилах ценообразования! Если изменить этот параметр, то связанные правила ценообразования не будут работать!}}
* '''Название акции''' — отображается в окне '''Информация о промокоде''' и используется как переменная для вставки промокода в шаблонах электронных писем.
* '''Краткое описание''' — краткая информация об акции, которая отображается в окне '''Информация о промокоде'''. Рекомендуется использовать не более 1-2 предложений.
* '''Полное описание''' — подробное описание условий акции, которое отображается в окне по ссылке '''Подробная информация о промоакции'''. Полное описание содержит подробную информацию об организаторе акции, сроках и правилах проведения. Для ввода описания используется WYSIWYG-редактор с поддержкой HTML.
Для промоакций, ограниченных во времени, используются параметры начала и завершения:
* '''Дата начала''' — дата начала промоакции. Формат: ДД.ММ.ГГГГ.
* '''Время начала''' — время начала промоакции (по умолчанию 00:00). Формат: ЧЧ:ММ.
* '''Дата завершения''' — дата завершения промоакции. Формат: ДД.ММ.ГГГГ.
* '''Время завершения''' — время завершения промоакции (по умолчанию 23:59). Формат: ЧЧ:ММ.
Промоакция начнет действовать/будет остановлена автоматически в указанные день и время.
{{Attention|Если не указаны дата начала и завершения, то промоакция является бессрочной.}} <!--Если указана дата начала, но нет даты завершения...-->
* '''Акция активна''' — включает промоакцию в работу. Если акция выключена, то промокоды не будут срабатывать.
* '''Многоразовый код''' — включает режим многоразового использования промокодов для акции. Пользователь может вписать в качестве промокода '''Уникальный код акции''', тогда система автоматически генерирует уникальный промокод для заказа.
* '''API включен''' — включает возможность использования JSON API для работы с промокодами (вкладка '''Управление промокодами''').
* '''Ограничение на количество промокодов''' — максимальное количество заказов по промокодам для данной акции.
=== Создание промоакции ===
В разделе '''Управление продажами''' → '''Модули''' → '''Программа лояльности''' → '''Промоакции и промокоды''' создаются новые и редактируются существующие промоакции.
Чтобы создать промоакцию:
# Нажмите кнопку '''Создать новую промоакцию'''.
# Введите в поле '''Уникальный код акции''' название, которое будет использоваться для связи промоакции с ценовыми правилами (пример: supersale).
# Заполните поля '''Название акции''', '''Краткое описание''' и '''Полное описание'''. Эта информация будет отображена покупателю при вводе промокода.
# Задайте дату начала акции в поле '''Дата начала'''.
# Задайте дату завершения акции в поле '''Дата завершения'''.
# Ограничьте количество промокодов, которое можно использовать в рамках промоакции.
# Включите промоакцию с помощью опции '''Акция активна'''.
# Нажмите на кнопку '''Сохранить'''.
Созданные промоакции отображаются в таблице в разделе '''Управление продажами''' → '''Модули''' → '''Программа лояльности''' → '''Промоакции и промокоды'''.
{| class="wikitable"
|-
|[[Файл:Таблица_промоакций.png]]
|-
|Таблица созданных промоакций
|}
===Редактирование промоакции===
Изменить параметры промоакции можно во вкладке «Редактировать».
{| class="wikitable"
|-
|[[Файл:promocode_main_edit.png|780px]]
|-
|Форма редактирования параметров промоакции
|}
=== Установка скидки по промоакции в правилах ценообразования ===
Чтобы установить скидку для акции, нужно обязательно внести условия предоставления скидки в правила ценообразования.
# Откройте промоакцию.
# Перейдите во вкладку «Правила ценообразования».
# Перейдите по ссылке «Вставить в ценовые правила авиабилетов» в раздел '''Управление продажами''' → '''Авиабилеты''' → '''Ценообразование''' → '''Импорт/экспорт Excel'''.
# Выгрузите Excel-файл для редактирования.
# Чтобы не изменять заданные правила ценообразования, лучше добавить одно или несколько новых правил для указания скидки по промоакции. В новом правиле:
#* Укажите в столбце '''Код акции''' ''уникальный код акции'', по которой устанавливается скидка.
#* Укажите в столбце '''Сбор агентства''' скидку по промоакции в формате {{Syntax|code=-X%}} (например, {{Syntax|code=-10%}}).
#* Обязательно укажите в столбце '''Признак дополнительного сбора''' значение {{Syntax|code=2}} — обязательный сбор, чтобы скидка применилась вне зависимости от других ценовых правил и их приоритета.
# Импортируйте отредактированный Excel-файл для обновления правил ценообразования.
{| class="wikitable"
|-
|[[Файл:promocode_price_formation.png]]
|-
|Параметры ценообразования по промоакции
|}
== Создание промокодов ==
===Автоматическое создание промокодов===
Промокод создается автоматически, когда пользователь указывает в качестве промокода '''Уникальный код акции'''.
Чтобы покупатель мог воспользоваться уникальным кодом, нужно в настройке промоакции включить опцию '''Многоразовый код'''.
=== Создание промокодов вручную ===
Чтобы вручную создать промокоды:
# Перейдите на вкладку '''Управление промокодами'''.
# Укажите количество промокодов для создания (не более 1000).
# Нажмите '''Создать уникальные промокоды'''.
{| class="wikitable"
|-
|[[Файл:Создание_промокодов_вручную.png]]
|-
|Создание промокодов вручную
|}
Сгенерированные промокоды отображаются в таблице.
{| class="wikitable"
|-
|[[Файл:Таблица_промокодов,_созданных_вручную.png]]
|-
|Промокоды, созданные вручную
|}
=== Создание промокодов через API ===
<!--Промокоды создаются приложением для генерации набора промокодов в системе {{NameSystem}}. Для этого в удаленной системе задается секретный код доступа.-->
Промокоды можно создать с помощью API-запроса:
{{SyntaxBox|code=
http://DOMAIN/loyalty__api?id=174&secret=6c3ef0970b3138214ab35c11df3efcec&action=createCodes&count=2
}}
В ответ система вернёт список созданных промокодов в формате JSON:
{{SyntaxBox|code=
{"success":true,"message":"","result":[{"code":"WYDJZFGY5"},{"code":"6FJU2GIWZ"}]}
}}
Созданные через API промокоды отображаются в таблице.
{| class="wikitable"
|-
|[[Файл:Таблица_промокодов,_созданных_через_API.png]]
|-
|Промокоды, созданные через API
|}
===Создание промокодов через нотификации===
Для каждой активной промоакции существует шаблонная переменная в разделе '''Настройки системы''' → '''Нотификации''' → '''Шаблоны электронных писем''' (доступно для всех видов нотификаций).
{| class="wikitable"
|-
|[[Файл:Шаблонные_переменные_для_генерации_и_вставки_промокода_в_уведомление.png]]
|-
|Шаблонные переменные для генерации и вставки промокода в уведомление
|}
В таблице описано назначение каждого элемента шаблонной переменной.
{| style="width: 680px" class="wikitable"
|-
! %PROMO(174)% TEXT [UNICODE] %PROMO% || Промоакция "supersale"
|-
| %PROMO(174)% || Открывающая часть переменной, где "174" — номер промоакции в системе.
|-
| TEXT || Любой текст, который укажет составитель письма.
|-
| [UNICODE] || Промокод, который автоматически сгенерируется и подстваится перед отправкой письма.
|-
| %PROMO% || Закрывающая часть переменной.
|}
Промокод генерируется и подставляется вместо переменной перед отправкой уведомления.
{| class="wikitable"
|-
|[[Файл:Таблица_промокодов,_созданных_через_нотификации.png]]
|-
|Таблица промокодов, созданных через нотификации
|}
=== Просмотр созданных промокодов ===
Информация по промокодам отображается во вкладке '''Управление промокодами''' в таблице ''Просмотр созданных кодов'':
*'''Промокод''' — уникальный промокод.
*'''Метод создания''' — возможные варианты: автоматический, вручную, через API, через нотификации.
*'''Дата создания''' — дата создания промокода.
*'''Получатель'''
*'''Статус''' — статус промокода:
** Примененный — промокод использован, билеты выписаны.
** Введенный — промокод введен, но билеты не выписаны.
** Отправленный — промокод отправлен пользователю через нотификации.
** Новый — промокод создан.
** '''Проблемный'''
*'''Лог''' — ссылка на логи по данному промокоду.
{| class="wikitable"
|-
|[[Файл:promocode_code_control.png]]
|-
|Созданные промокоды
|}
==Использование промокодов==
После включения промоакций на странице бронирования перелета под стоимостью билета появляется псевдоссылка '''У меня есть промокод'''. Щелчок по ссылке открывает всплывающее окно для ввода промокода.
{| class="wikitable"
|-
|[[Файл:Окно_для_ввода_промокода.png|300px]]
|-
|Окно для ввода промокода
|}
Если введен правильный код, то стоимость билета пересчитается, и в окошке появится информация о промоакции:
* название акции,
* сумма скидки,
* краткое описание,
* псевдоссылка на подробное описание.
{| class="wikitable"
|-
|[[Файл:promo_success.png|300px]]
|-
|Информация по промоакции
|}
Если введен неправильный код, появится сообщение об ошибке.
После ввода промокода цены на выдаче отобразятся с учетом скидки.
{{Attention|Промокод считается использованным только для выписанных и оплаченных билетов.}}
{{Attention|К одному заказу может быть применен только 1 промокод.}}
=== Отчет по заказам ===
Для просмотра информации об использовании промокодов откройте промоакцию.
Вкладка '''''Отчет по заказам''''' содержит информацию о том, сколько промокодов использовано по текущей акции и для каких заказов в таблице ''Просмотр заказов'':
* '''Промокод''' — использованный промокод.
* '''Дата ввода кода''' — дата ввода промокода для заказа.
* '''ID заказа ''' — номер заказа в системе {{NameSystem}}.
* '''Статус заказа''' — статус заказа с примененным промокодом.
* '''Код применен''':
**'''''да''''', если заказ выписан и оплачен,
**'''''нет''''' в других случаях.
* '''Дата применения''' — дата выписки заказа с использованием промокода.
* '''Рассчитанная скидка''' — сумма скидки, рассчитанной по промокоду для заказа. Подставляется в таблицу до оплаты заказа.
* '''Полученная скидка''' — фактическая сумма полученной скидки. Появляется в таблице после оплаты заказа.
{| class="wikitable"
|-
|[[Файл:promocode_book_report.png]]
|-
|Отчет по промокодам
|}
Информация об использовании промокодов при бронировании и выписке логируется.
=== Учет промокодов в личном кабинете ===
Информация о примененных промокодах отображается в столбце «Промокод» в таблице заказов [[Личный кабинет|личного кабинета]].
=== Учет промокодов в выгрузке заказов ===
Информация об использованных промокодах выгружается вместе с другими данными при [[Выгрузка|выгрузке заказов]] в формате Немо.
=== Экспорт промокодов ===
Экспорт неотправленных промокодов доступен во вкладке '''Управление промокодами''' в форматах TXT или XLS.
{| class="wikitable"
|-
|[[Файл:Экспорт_промокодов.png]]
|-
|Экспорт промокодов
|}
==API Программы лояльности==
===Включение API===
'''API''' становится доступен, если в настройке промоакции включена опция '''API включен'''.
===Методы API===
==== Создание промокодов ====
'''Запрос'''
<syntaxhighlight lang="text" enclose="div" style="font-size:9pt;background: #F9F9F9; border: 1px dashed #2F6FAB; padding: 10px 5px; margin: 10px 0;">
http://DOMAIN/loyalty__api?id=174&secret=b3e66b15890d862965aaae7175b2f4b3&action=createCodes&count=1
</syntaxhighlight>
* DOMAIN — адрес сайта агентства,
* id — номер промоакции,
* secret — автоматически сгенерированный секретный ключ,
* action — название метода «createCodes» для генерации промокодов,
* count — количество промокодов, которое нужно создать.
'''Ответ'''
В ответ система вернёт список созданных промокодов в формате JSON:
<syntaxhighlight lang="text" enclose="div" style="font-size:9pt;background: #F9F9F9; border: 1px dashed #2F6FAB; padding: 10px 5px; margin: 10px 0;">
{
"success":true,
"message":"",
"result":[
{ "code":"WYDJZFGY5" },
{ "code":"6FJU2GIWZ" }
]
}
</syntaxhighlight>
==== Выгрузка неотправленных промокодов ====
Получение промокодов, которые не отправлены клиентам.
'''Запрос'''
<syntaxhighlight lang="text" style="font-size:9pt;background: #F9F9F9; border: 1px dashed #2F6FAB; padding: 10px 5px; margin: 10px 0;">
http://DOMAIN/loyalty__api?id=174&secret=b3e66b15890d862965aaae7175b2f4b3&action=uploadCodes</syntaxhighlight>
* DOMAIN — адрес сайта агентства,
* id — номер промоакции,
* secret — автоматически сгенерированный секретный ключ,
* action — название метода «uploadCodes» для выгрузки неотправленных промокодов.
'''Ответ'''
<syntaxhighlight lang="text" enclose="div" style="font-size:9pt;background: #F9F9F9; border: 1px dashed #2F6FAB; padding: 10px 5px; margin: 10px 0;">
{
"success":true,
"message":"",
"result":[
{ "code":"WYDJZFGY5" },
{ "code":"6FJU2GIWZ" },
{ "code":"JDG65SZW5" },
{ "code":"IV4LJ9Q14" },
{ "code":"QDNW9R7ZF" },
]
}
</syntaxhighlight>
==== Изменение статуса промокода на «отправленный» ====
Изменение статуса промокода на «отправленный»
'''Запрос'''
<syntaxhighlight lang="text" style="font-size:9pt;background: #F9F9F9; border: 1px dashed #2F6FAB; padding: 10px 5px; margin: 10px 0;">
http://DOMAIN/loyalty__api?id=174&secret=b3e66b15890d862965aaae7175b2f4b3&action=setRecipient&promoCode=XXX&recipient=YYY
</syntaxhighlight>
* DOMAIN — адрес сайта агентства,
* id — номер промоакции,
* secret — автоматически сгенерированный секретный ключ,
* action — название метода «setRecipient для изменения статуса промокода на «отправленный».
* XXX — промокод,
* YYY — получатель.
'''Ответ'''
<syntaxhighlight lang="text" enclose="div" style="font-size:9pt;background: #F9F9F9; border: 1px dashed #2F6FAB; padding: 10px 5px; margin: 10px 0;">
{"success":true,"message":"done","result":null}
</syntaxhighlight>
== Настройка ввода промокода в CMS Немо Тревел==
По умолчанию псевдоссылка '''''У меня есть промокод''''' находится на странице бронирования перелета под стоимостью билета.
Чтобы изменить расположение псевдоссылки:
# Включите опцию '''Скрыть стандартную ссылку для ввода''' в разделе '''Управление продажами''' → '''Модули''' → '''Программа лояльности''' → '''Общие настройки'''. Параметр скрывает стандартную псевдоссылку '''У меня есть промокод'''.
# С помощью smarty-функции {{Syntax|code={promocode} }} вставьте псевдоссылку в нужное место в шаблоне CMS.
== См. также ==
* [[Ценообразование._Импорт_правил|Ценообразование]]
* [[Заказы]]
* [[Система управления порталом (ЦМС)]]
* [[Выгрузка|Выгрузка заказов]]
* [[Нотификация]]
* [[Агентсткий API|API]]
* [[Бронирование]]
<!-- -->
'''Программа лояльности''' — [[модуль]] системы {{NameSystem}} для проведения промоакций
== Назначение==
Предоставление скидки по промокоду на покупку авиабилета.
== Примеры использования ==
* Проведение акций, приуроченных к праздникам, например:
**скидка ко дню рождения,
**скидка к профессиональному празднику.
* Предоставление выгодных условий перелета для постоянных клиентов.
* Предоставление выгодных условий перелета на рейсы определенных авиакомпаний.
==Принцип работы==
# Cоздание промоакции.
# Настройка условий проведения промоакции.
# Установка скидки по промоакции в правилах ценообразования.
# Генерация промокодов.
# Информирование клиентов о скидках и рассылка промокоды.
Название, условия акции и скидки агентство устанавливает самостоятельно.
== Включение программы лояльности ==
Чтобы создавать, настраивать и использовать промоакции в {{NameSystem}}, у агентства должен быть подключен компонент '''Система лояльности'''. Включить компонент может только администратор {{NameSystem}} в разделе '''Для техподдержки''' → '''Компоненты'''.
Агентству станет доступен раздел '''Управление продажами''' → '''Модули''' → '''Программа лояльности''' для настройки промоакций.
== Настройка промоакций ==
=== Включение промоакции ===
Чтобы активировать промоакцию, нужно включить опцию '''Промоакции включены''' в разделе '''Управление продажами''' → '''Модули''' → '''Программа лояльности''' → '''Общие настройки'''.
===Параметры промоакции===
* '''Уникальный код акции''' (обязательное поле) — используется для внесения правил по акции в ценообразование и в общем случае не виден пользователю. Генерируется автоматически при создании промоакции, но может изменяться менеджером или администратором на более понятный и запоминающийся. <br />{{Attention|Не меняйте уникальный код акции после установки скидок в правилах ценообразования! Если изменить этот параметр, то связанные правила ценообразования не будут работать!}}
* '''Название акции''' — отображается в окне '''Информация о промокоде''' и используется как переменная для вставки промокода в шаблонах электронных писем.
* '''Краткое описание''' — краткая информация об акции, которая отображается в окне '''Информация о промокоде'''. Рекомендуется использовать не более 1-2 предложений.
* '''Полное описание''' — подробное описание условий акции, которое отображается в окне по ссылке '''Подробная информация о промоакции'''. Полное описание содержит подробную информацию об организаторе акции, сроках и правилах проведения. Для ввода описания используется WYSIWYG-редактор с поддержкой HTML.
Для промоакций, ограниченных во времени, используются параметры начала и завершения:
* '''Дата начала''' — дата начала промоакции. Формат: ДД.ММ.ГГГГ.
* '''Время начала''' — время начала промоакции (по умолчанию 00:00). Формат: ЧЧ:ММ.
* '''Дата завершения''' — дата завершения промоакции. Формат: ДД.ММ.ГГГГ.
* '''Время завершения''' — время завершения промоакции (по умолчанию 23:59). Формат: ЧЧ:ММ.
Промоакция начнет действовать/будет остановлена автоматически в указанные день и время.
{{Attention|Если не указаны дата начала и завершения, то промоакция является бессрочной.}} <!--Если указана дата начала, но нет даты завершения...-->
* '''Акция активна''' — включает промоакцию в работу. Если акция выключена, то промокоды не будут срабатывать.
* '''Многоразовый код''' — включает режим многоразового использования промокодов для акции. Пользователь может вписать в качестве промокода '''Уникальный код акции''', тогда система автоматически генерирует уникальный промокод для заказа.
* '''API включен''' — включает возможность использования JSON API для работы с промокодами (вкладка '''Управление промокодами''').
* '''Ограничение на количество промокодов''' — максимальное количество заказов по промокодам для данной акции.
=== Создание промоакции ===
В разделе '''Управление продажами''' → '''Модули''' → '''Программа лояльности''' → '''Промоакции и промокоды''' создаются новые и редактируются существующие промоакции.
Чтобы создать промоакцию:
# Нажмите кнопку '''Создать новую промоакцию'''.
# Введите в поле '''Уникальный код акции''' название, которое будет использоваться для связи промоакции с ценовыми правилами (пример: supersale).
# Заполните поля '''Название акции''', '''Краткое описание''' и '''Полное описание'''. Эта информация будет отображена покупателю при вводе промокода.
# Задайте дату начала акции в поле '''Дата начала'''.
# Задайте дату завершения акции в поле '''Дата завершения'''.
# Ограничьте количество промокодов, которое можно использовать в рамках промоакции.
# Включите промоакцию с помощью опции '''Акция активна'''.
# Нажмите на кнопку '''Сохранить'''.
Созданные промоакции отображаются в таблице в разделе '''Управление продажами''' → '''Модули''' → '''Программа лояльности''' → '''Промоакции и промокоды'''.
{| class="wikitable"
|-
|[[Файл:Таблица_промоакций.png]]
|-
|Таблица созданных промоакций
|}
===Редактирование промоакции===
Изменить параметры промоакции можно во вкладке «Редактировать».
{| class="wikitable"
|-
|[[Файл:promocode_main_edit.png|780px]]
|-
|Форма редактирования параметров промоакции
|}
=== Установка скидки по промоакции в правилах ценообразования ===
Чтобы установить скидку для акции, нужно обязательно внести условия предоставления скидки в правила ценообразования.
# Откройте промоакцию.
# Перейдите во вкладку «Правила ценообразования».
# Перейдите по ссылке «Вставить в ценовые правила авиабилетов» в раздел '''Управление продажами''' → '''Авиабилеты''' → '''Ценообразование''' → '''Импорт/экспорт Excel'''.
# Выгрузите Excel-файл для редактирования.
# Чтобы не изменять заданные правила ценообразования, лучше добавить одно или несколько новых правил для указания скидки по промоакции. В новом правиле:
#* Укажите в столбце '''Код акции''' ''уникальный код акции'', по которой устанавливается скидка.
#* Укажите в столбце '''Сбор агентства''' скидку по промоакции в формате {{Syntax|code=-X%}} (например, {{Syntax|code=-10%}}).
#* Обязательно укажите в столбце '''Признак дополнительного сбора''' значение {{Syntax|code=2}} — обязательный сбор, чтобы скидка применилась вне зависимости от других ценовых правил и их приоритета.
# Импортируйте отредактированный Excel-файл для обновления правил ценообразования.
{| class="wikitable"
|-
|[[Файл:promocode_price_formation.png]]
|-
|Параметры ценообразования по промоакции
|}
== Создание промокодов ==
===Автоматическое создание промокодов===
Промокод создается автоматически, когда пользователь указывает в качестве промокода '''Уникальный код акции'''.
Чтобы покупатель мог воспользоваться уникальным кодом, нужно в настройке промоакции включить опцию '''Многоразовый код'''.
=== Создание промокодов вручную ===
Чтобы вручную создать промокоды:
# Перейдите на вкладку '''Управление промокодами'''.
# Укажите количество промокодов для создания (не более 1000).
# Нажмите '''Создать уникальные промокоды'''.
{| class="wikitable"
|-
|[[Файл:Создание_промокодов_вручную.png]]
|-
|Создание промокодов вручную
|}
Сгенерированные промокоды отображаются в таблице.
{| class="wikitable"
|-
|[[Файл:Таблица_промокодов,_созданных_вручную.png]]
|-
|Промокоды, созданные вручную
|}
=== Создание промокодов через API ===
<!--Промокоды создаются приложением для генерации набора промокодов в системе {{NameSystem}}. Для этого в удаленной системе задается секретный код доступа.-->
Промокоды можно создать с помощью API-запроса:
{{SyntaxBox|code=
http://DOMAIN/loyalty__api?id=174&secret=6c3ef0970b3138214ab35c11df3efcec&action=createCodes&count=2
}}
В ответ система вернёт список созданных промокодов в формате JSON:
{{SyntaxBox|code=
{"success":true,"message":"","result":[{"code":"WYDJZFGY5"},{"code":"6FJU2GIWZ"}]}
}}
Созданные через API промокоды отображаются в таблице.
{| class="wikitable"
|-
|[[Файл:Таблица_промокодов,_созданных_через_API.png]]
|-
|Промокоды, созданные через API
|}
===Создание промокодов через нотификации===
Для каждой активной промоакции существует шаблонная переменная в разделе '''Настройки системы''' → '''Нотификации''' → '''Шаблоны электронных писем''' (доступно для всех видов нотификаций).
{| class="wikitable"
|-
|[[Файл:Шаблонные_переменные_для_генерации_и_вставки_промокода_в_уведомление.png]]
|-
|Шаблонные переменные для генерации и вставки промокода в уведомление
|}
В таблице описано назначение каждого элемента шаблонной переменной.
{| style="width: 680px" class="wikitable"
|-
! %PROMO(174)% TEXT [UNICODE] %PROMO% || Промоакция "supersale"
|-
| %PROMO(174)% || Открывающая часть переменной, где "174" — номер промоакции в системе.
|-
| TEXT || Любой текст, который укажет составитель письма.
|-
| [UNICODE] || Промокод, который автоматически сгенерируется и подстваится перед отправкой письма.
|-
| %PROMO% || Закрывающая часть переменной.
|}
Промокод генерируется и подставляется вместо переменной перед отправкой уведомления.
{| class="wikitable"
|-
|[[Файл:Таблица_промокодов,_созданных_через_нотификации.png]]
|-
|Таблица промокодов, созданных через нотификации
|}
=== Просмотр созданных промокодов ===
Информация по промокодам отображается во вкладке '''Управление промокодами''' в таблице ''Просмотр созданных кодов'':
*'''Промокод''' — уникальный промокод.
*'''Метод создания''' — возможные варианты: автоматический, вручную, через API, через нотификации.
*'''Дата создания''' — дата создания промокода.
*'''Получатель'''
*'''Статус''' — статус промокода:
** Примененный — промокод использован, билеты выписаны.
** Введенный — промокод введен, но билеты не выписаны.
** Отправленный — промокод отправлен пользователю через нотификации.
** Новый — промокод создан.
** '''Проблемный'''
*'''Лог''' — ссылка на логи по данному промокоду.
{| class="wikitable"
|-
|[[Файл:promocode_code_control.png]]
|-
|Созданные промокоды
|}
==Использование промокодов==
После включения промоакций на странице бронирования перелета под стоимостью билета появляется псевдоссылка '''У меня есть промокод'''. Щелчок по ссылке открывает всплывающее окно для ввода промокода.
{| class="wikitable"
|-
|[[Файл:Окно_для_ввода_промокода.png|300px]]
|-
|Окно для ввода промокода
|}
Если введен правильный код, то стоимость билета пересчитается, и в окошке появится информация о промоакции:
* название акции,
* сумма скидки,
* краткое описание,
* псевдоссылка на подробное описание.
{| class="wikitable"
|-
|[[Файл:promo_success.png|300px]]
|-
|Информация по промоакции
|}
Если введен неправильный код, появится сообщение об ошибке.
После ввода промокода цены на выдаче отобразятся с учетом скидки.
{{Attention|Промокод считается использованным только для выписанных и оплаченных билетов.}}
{{Attention|К одному заказу может быть применен только 1 промокод.}}
=== Отчет по заказам ===
Для просмотра информации об использовании промокодов откройте промоакцию.
Вкладка '''''Отчет по заказам''''' содержит информацию о том, сколько промокодов использовано по текущей акции и для каких заказов в таблице ''Просмотр заказов'':
* '''Промокод''' — использованный промокод.
* '''Дата ввода кода''' — дата ввода промокода для заказа.
* '''ID заказа ''' — номер заказа в системе {{NameSystem}}.
* '''Статус заказа''' — статус заказа с примененным промокодом.
* '''Код применен''':
**'''''да''''', если заказ выписан и оплачен,
**'''''нет''''' в других случаях.
* '''Дата применения''' — дата выписки заказа с использованием промокода.
* '''Рассчитанная скидка''' — сумма скидки, рассчитанной по промокоду для заказа. Подставляется в таблицу до оплаты заказа.
* '''Полученная скидка''' — фактическая сумма полученной скидки. Появляется в таблице после оплаты заказа.
{| class="wikitable"
|-
|[[Файл:promocode_book_report.png]]
|-
|Отчет по промокодам
|}
Информация об использовании промокодов при бронировании и выписке логируется.
=== Учет промокодов в личном кабинете ===
Информация о примененных промокодах отображается в столбце «Промокод» в таблице заказов [[Личный кабинет|личного кабинета]].
=== Учет промокодов в выгрузке заказов ===
Информация об использованных промокодах выгружается вместе с другими данными при [[Выгрузка|выгрузке заказов]] в формате Немо.
=== Экспорт промокодов ===
Экспорт неотправленных промокодов доступен во вкладке '''Управление промокодами''' в форматах TXT или XLS.
{| class="wikitable"
|-
|[[Файл:Экспорт_промокодов.png]]
|-
|Экспорт промокодов
|}
==API Программы лояльности==
===Включение API===
'''API''' становится доступен, если в настройке промоакции включена опция '''API включен'''.
===Методы API===
==== Создание промокодов ====
'''Запрос'''
<syntaxhighlight lang="text" enclose="div" style="font-size:9pt;background: #F9F9F9; border: 1px dashed #2F6FAB; padding: 10px 5px; margin: 10px 0;">
http://DOMAIN/loyalty__api?id=174&secret=b3e66b15890d862965aaae7175b2f4b3&action=createCodes&count=1
</syntaxhighlight>
* DOMAIN — адрес сайта агентства,
* id — номер промоакции,
* secret — автоматически сгенерированный секретный ключ,
* action — название метода «createCodes» для генерации промокодов,
* count — количество промокодов, которое нужно создать.
'''Ответ'''
В ответ система вернёт список созданных промокодов в формате JSON:
<syntaxhighlight lang="text" enclose="div" style="font-size:9pt;background: #F9F9F9; border: 1px dashed #2F6FAB; padding: 10px 5px; margin: 10px 0;">
{
"success":true,
"message":"",
"result":[
{ "code":"WYDJZFGY5" },
{ "code":"6FJU2GIWZ" }
]
}
</syntaxhighlight>
==== Выгрузка неотправленных промокодов ====
Получение промокодов, которые не отправлены клиентам.
'''Запрос'''
<syntaxhighlight lang="text" style="font-size:9pt;background: #F9F9F9; border: 1px dashed #2F6FAB; padding: 10px 5px; margin: 10px 0;">
http://DOMAIN/loyalty__api?id=174&secret=b3e66b15890d862965aaae7175b2f4b3&action=uploadCodes</syntaxhighlight>
* DOMAIN — адрес сайта агентства,
* id — номер промоакции,
* secret — автоматически сгенерированный секретный ключ,
* action — название метода «uploadCodes» для выгрузки неотправленных промокодов.
'''Ответ'''
<syntaxhighlight lang="text" enclose="div" style="font-size:9pt;background: #F9F9F9; border: 1px dashed #2F6FAB; padding: 10px 5px; margin: 10px 0;">
{
"success":true,
"message":"",
"result":[
{ "code":"WYDJZFGY5" },
{ "code":"6FJU2GIWZ" },
{ "code":"JDG65SZW5" },
{ "code":"IV4LJ9Q14" },
{ "code":"QDNW9R7ZF" },
]
}
</syntaxhighlight>
==== Изменение статуса промокода на «отправленный» ====
Изменение статуса промокода на «отправленный»
'''Запрос'''
<syntaxhighlight lang="text" style="font-size:9pt;background: #F9F9F9; border: 1px dashed #2F6FAB; padding: 10px 5px; margin: 10px 0;">
http://DOMAIN/loyalty__api?id=174&secret=b3e66b15890d862965aaae7175b2f4b3&action=setRecipient&promoCode=XXX&recipient=YYY
</syntaxhighlight>
* DOMAIN — адрес сайта агентства,
* id — номер промоакции,
* secret — автоматически сгенерированный секретный ключ,
* action — название метода «setRecipient для изменения статуса промокода на «отправленный».
* XXX — промокод,
* YYY — получатель.
'''Ответ'''
<syntaxhighlight lang="text" enclose="div" style="font-size:9pt;background: #F9F9F9; border: 1px dashed #2F6FAB; padding: 10px 5px; margin: 10px 0;">
{"success":true,"message":"done","result":null}
</syntaxhighlight>
== Настройка ввода промокода в CMS Немо Тревел==
По умолчанию псевдоссылка '''''У меня есть промокод''''' находится на странице бронирования перелета под стоимостью билета.
Чтобы изменить расположение псевдоссылки:
# Включите опцию '''Скрыть стандартную ссылку для ввода''' в разделе '''Управление продажами''' → '''Модули''' → '''Программа лояльности''' → '''Общие настройки'''. Параметр скрывает стандартную псевдоссылку '''У меня есть промокод'''.
# С помощью smarty-функции {{Syntax|code={promocode} }} вставьте псевдоссылку в нужное место в шаблоне CMS.
== См. также ==
* [[Ценообразование._Импорт_правил|Ценообразование]]
* [[Заказы]]
* [[Система управления порталом (ЦМС)]]
* [[Выгрузка|Выгрузка заказов]]
* [[Нотификация]]
* [[Агентсткий API|API]]
* [[Бронирование]]
