Как сгенерировать уникальный промокод

После заполнения формы подписки на сайте, часто нужно подставить уникальный промокод в контент автоматической рассылки. Если в вашей CMS не реализован такой модуль, воспользуйтесь инструкцией ниже.

Пример сценария подробно описан в статье Кампания "Grow Your Mailing List".

Важно! Все настройки должен выполнять компетентный специалист, поскольку есть вероятность нарушения работоспособности вашего сайта вследствие некорректных изменений.

Логика работы

На сайте размещается код, который генерирует новый промокод при каждом обращении к этому скрипту. В кнопку отправки виджета вставляется код, который делает обращение к этому скрипту и получает с сайта новый промокод. Далее отправляет его в Сonvead и данные подставляются в рассылку.

Настройка генерации уникального промокода

Если в вашей CMS нет встроенного модуля генерации промокодов, есть несколько вариантов:

Реализовать модуль самостоятельно
Найти сторонний модуль и реализовать скрипт на нём

Как реализовать запрос промокода в Convead

Создать в Сonvead 2 пользовательских события с ключами: request_promo_code и response_promo_code.
Создать в Сonvead 1 индивидуальное поле для хранения промо-кода с ключом code.
Создать в Сonvead виджет и в кнопку виджета вставить код события для запроса промокода:

convead('event', 'custom', {key: 'request_promo_code'});

Сonvead API нужно создать вебхук с топиком events/custom, который будет обращаться к скрипту на вашем сайте.
Создать скрипт на вашем сайте, который будет принимать вебхук, валидировать его (проверять, что он пришел с IP-адреса Сonvead, а не с адреса ddos серверов). Проверять, что вебхук вызван именно событием "request_promo_code" (которое отправлено из виджета пользователем). Если все условия выполнены, то нужно сгенерировать новый промокод, получить из вебхука uid пользователя и отправить в Сonvead другое пользовательское событие с ключом "response_promo_code" от имени этого пользователя. В контактных данных подставить промокод.
В Сonvead нужно создать автоматическую рассылку, которая будет отправляться по событию "response_promo_code" . В контент письма добавить подстановку %{code}. Чтобы промокод вставлялся в письмо автоматически.

Ссылки на библиотеки

Для работы с Сonvead API можно использовать php или ruby библиотеки.
Для работы с Сonvead EVENT можно использовать php или ruby библиотеки.
В readme есть примеры использования кода. Если ваша платформа использует другой язык и эти библиотеки вам не подходят, то вы можете написать свою. События отправляются обычным post запросом (структуру можно посмотреть по коду этих библиотек). Api запросы отправляются с помощью протокола RESTfull.