Документация для разработчиков

Документация API версии 1.21

« Назад на Обзор Документации

campaigns.create

campaigns.create (serialized array list_id, string name, string subject, string from_name, string from_email, string personalizeToEmail, string to_email, string track_opens, string track_clicks, string plain_clicks, string no_images_add, string analytics, string analytics_tag, string html, string plain_text, serialized array esegment)

Создаем рассылку.

Категория метода
Campaigns
Параметры
list_id serialized array индексный массив адресных баз, по которым будет создана рассылка. Структура: порядковый номер (от нуля) => id базы. Массив можно передавать в сериализованном виде или в формате json.
name string опционально - название рассылки
subject string опционально - заголовок письма [должно соответствовать содержанию письма и не отталкивать]
from_name string опционально - от кого письмо? [используйте что-нибудь запоминающееся, например, название вашей компании]
from_email string опционально - обратный адрес [ответы ваших подписчиков будут приходить на этот адрес]
personalizeToEmail string опционально - {on/off} - включить/выключить персонализацию в поле "Кому:" [default: off]
to_email string опционально - персонализация в поле "Кому:" [можно использовать %ТЭГИ% из дополнительных полей базы, например %EMAIL%]
track_opens string опционально - {Y,N} - следить за открыванием [default: Y]
track_clicks string опционально - {Y,N} - отслеживать клики [default: Y]
plain_clicks string опционально - {Y,N} - отслеживать клики в текстовой версии [default: N]
no_images_add string опционально - {0,1} - не прикладывать картинки к письму. [default: 0] - по умолчанию прикладываются. помогает проходить спам-фильтры и отображает картинки даже у тех получателей, у кого они по умолчанию отключены
analytics string опционально - {google,N} - добавить Google Analytics™ для отслеживания всех URLs [default: N]
analytics_tag string опционально - текстовый тег, как рассылка будет отображаться в Google Analytics™, например: Рассылка_9_17_2011
html string опционально - код html-версии письма. Либо id сохраненного html-шаблона. Либо сохраненный шаблон из ЛК (из раздела Шаблоны) в формате tmpl1234, где 1234 это id шаблона
plain_text string опционально - текстовая версия письма
esegment serialized array опционально - сегменты баз для рассылки. Структура массива: id базы => массив сегмента. Структура массивов сегмента: [match] = {any|all} - должны выполняться все или любые из условия. [c] - массив условий. Содержит поля: [field] - тип поля (email, merge_{1..10}), [op] - условие {is, is not, contains, notcontain, starts, ends, greater, less}, [value] - значение поля. Например: array['match']='any';array['c'][0]['field']='email';array['c'][0]['op']='is';array['c'][0]['value']='support@dashamail.ru'; Массив можно передавать в сериализованном виде или в формате json.
Возвращаемые значения (значения data)
campaign_id id созданной рассылки