Запрос на обновление кампании
Клиенты имеют возможность обновлять кампании для своих клиентов в системе Call-Tracking. Клиентам разрешено обновлять все аттрибуты кампании, за исключением ранее подключенных номеров. Изменения вступят в силу только после подтверждения от администратора системы Call-Tracking.
Обновить кампанию можно следующим образом:
URL: PUT(или POST) app.call-tracking.by/crm_api/v1/campaigns/:id.json
Обязательные параметры:
- user_token - Секретный ключ пользователя.
- sources - Источники трафика пользователя. Строка. Источники перечислены через запятую. Пример:
'tut.by,google.by,google.com'. Для офлайн кампании это может быть строка вида 'радио'.
ВНИМАНИЕ: источники кампании не должны пересекаться (один включать в себя другой). Например utm_source=KREDIT_ONLINE и utm_source=KREDIT не верны т.к первый включает в себя второй
Необязательные параметры:
- name - Название кампании. Строка.
- start_date - Дата начала кампании. Строка формата '13-01-2016'.
- end_date - Дата окончания кампании. Строка формата '13-01-2016'.
- online - Онлайн или Офлайн кампания. Строка. Возможные значения 'true' или 'false'.
- site_urls - Сайты для которых будет применяться кампания. Строка. Сайты перечислены через запятую. Пример: 'test.com,test,by'
- activation_url - Строка. После одобрения кампаний на этот урл будет отправлен запрос от системы Call-Tracking. Запрос должен вернуть статус 200. Урл должен начинаться с http://.
- mobile - Применима ли кампания только для мобильных устройств. По умолчанию значение 'false' (т.е кампания применима для мобильных и не мобильных устройств). Строка. Возможные значения 'true' или 'false'.
Пример успешного ответа:
{
"success"=>true,
"code"=>13,
"message"=>"Campaign was successfully updated.",
"id"=>"1345"
}
Пример неуспешного ответа:
{
"success"=>false,
"code"=>32001,
"message"=>["name can't be blank"]
}
Параметры ответа:
- success - успех запроса.
- code - код ответа.
- message - сообщение системы.
- id - уникальный идентификатор кампании
Валидационные сообщения:
- Changing numbers is not allowed.
- Campaign sources are invalid
- name can't be blank
- start_date can't be blank
- end_date can't be blank
- end_date should be greater than start_date.