API генерации шаблонов писем

Введение

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

Учет заказов для начисления комиссии партнеру ведется по меткам в ссылках письма.

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

Генерация шаблона письма

Шаблон письма имеет 2 подвида: письмо про определенный город и письмо про определенную страну с несколькими ее городами. Такое разделение необходимо, если партнеру не известен точный город поездки его клиента, но он знает страну и общее письмо про нее повышает вероятность заинтересовать путешественника.

Примеры:

  1. Полная версия
    1. Для страны: https://experience.tripster.ru/partner/?partner=somepartner&template=mail_default&country=Italy&order=top&num=4&num_cities=3&label=somelabel
    2. Для города: https://experience.tripster.ru/partner/?partner=somepartner&template=mail_default&city=Rome&order=top&num=6&label=somelabel
  2. Урезанная версия
    1. Для страны: https://experience.tripster.ru/partner/?partner=somepartner&template=mail_experiences&country=Italy&order=top&num=4&num_cities=3&label=somelabel
      Для города: https://experience.tripster.ru/partner/?partner=somepartner&template=mail_experiences&city=Rome&order=top&num=6&label=somelabel


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

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

Наличие параметра exp_partner с персональным ID партнера обязательно для всех исходящих ссылок на Трипстер, только при его наличии в статистике переходов и заказов партнеру начисляется комиссия.

Общие параметры


ПараметрОписание
1partnerID партнера для учета заказов, выдается персонально по запросу
2templateНазвание партнерского шаблона с персонализированным оформлением, выдается по запросу. Общий базовый шаблон = mail_default
3

order

Сортировка списка экскурсий, всегда = top (по рейтингу)

Параметры письма про страну

Добавочные параметры для подвида шаблона "про страну".


ПараметрОписание
1country | country_codeИдентификатор страны: название латиницей как в URL | двухбуквенный код ISO-3166 alpha2 по базе geonames.org
2num

Максимальное количество экскурсий в письме для каждого отдельного города. Лимит 20 экскурсий.

3num_citiesМаксимальное количество городов запрошенной страны для отображения в письме

Параметры письма про город

Добавочные параметры для подвида шаблона "про город".


ПараметрОписание
1iata | city | geonames_idИдентификатор города: IATA-код | название латиницей как в URL | id по базе geonames.org
2numМаксимальное количество экскурсий в письме после которых ставится кнопка "Посмотреть все экскурсии". Если в городе опубликовано экскурсий меньше этого параметра, то выводится сколько есть. Лимит 20 экскурсий.

Обработка ошибок

Если город или страна не будут найдены или в городе или стране нет экскурсий — сервер отдаст пустую страницу.

Быстрый импорт шаблонов в сервис рассылок MailChimp

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

На этапе создания новой почтовой кампании на шаге выбора шаблона в разделе "Template":

  1. Выберите в меню "Code Your Own" и вариант "Import from URL".
  2. Скопируйте вставьте генерирующую письмо ссылку в поле "Campaign URL" и импортируйте свежие данные.
  3. Произведите остальные настройки рассылки на свое усмотрение и отправьте своим подписчикам предложения с экскурсиями.