Редактирование рекламной кампании
| Метод | update.campaigns |
|---|---|
| Описание | Редактирование рекламной кампании. Можно редактировать только рекламную кампания с типом 'basic'. |
| Кому доступен | Агент, Клиент |
Возможно частичное обновление. Если обновляется массив данных, то переданный массив будет полностью заменять существующий.
Для системных рекламных кампаний (сid = -1) и интегрированных кампании можно редактировать только поляsite_blocksиdynamic_call_tracking
Параметры запроса
| Название | Тип | Обязательный | Допустимые значения | Описание |
|---|---|---|---|---|
access_token |
string | да | Ключ сессии аутентификации | |
user_id |
number | нет |
Уникальный идентификатор пользователя клиента агента от имени которого делается запрос Является обязательным для агентаДля получения списка пользователей клиента необходимо использовать метод "get.customer_users" |
|
id |
number | да | Уникальный идентификатор рекламной кампании | |
name |
string | нет | Название рекламной кампании | |
description |
string | нет | Максимум 255 символов | Описание рекламной кампании |
status |
enum | нет |
|
Статус рекламной кампании
Если рекламную кампанияю с настроенными блоками перевели в статус "inactive", то все настройки блоков сбрасываются. |
site_id |
number | да | Уникальный идентификатор сайта
Обновить
|
|
campaign_conditions |
object | нет | Условия рекламной кампании. | |
| Настройки привязки номера к блоку на сайте | ||||
site_blocks |
array | нет |
Настройки привязки номера к блоку на сайте
Если в списке отсутствует настроенный блок, то в случае обновления рекламной кампании, его настройки сбрасываются
Если рекламная кампания отключена (
|
|
site_block_id |
number | да | Уникальный идентификатор блока номеров | |
phone_number_id |
number | да |
Уникальный идентификатор виртуального номера. Чтобы получить список доступных виртуальных номеров необходимо использовать метод get.campaign_available_phone_numbers
Если указан
Номер с
|
|
redirection_phone_number_id |
number | нет |
Уникальный идентификатор номера переадресации. Номер переадресации используется только в том случае, если параметр phone_number_id имеет тип `call_tracking`. Список доступных номеров можно получить методом get.campaign_available_redirection_phone_numbers.
Обязателен для заполнения, если в параметре
Если параметр задан и в
В параметре могут быть указаны только номера переадресации, которые возвращаются методом get.campaign_available_redirection_phone_numbers. Если это не так, то будет возвращаться ошибка с мнемоникой "invalid_parameter_value" Доступен, если подключен компонент "va". Если параметр будет заполнен и у вас отсутствует компонент "va", то будет возвращена ошибка с мнемоникой "parameter_component_disabled" |
|
dynamic_call_tracking_enabled |
boolean | нет | true, false |
Активация динамического коллтрекинг. В пул динамического коллтрекинга можно подключить только свободные номера без флага "Использовать в ВАТС"
в том же коде, что и номер блока рекламной кампании по умолчанию. При отсутствии необходимого количества номеров они будут автоматически куплены.
Звонки на номера из пула динамического коллтрекинга будут обрабатываться по правилам обработки звонков на номер блока рекламной кампании по умолчанию.
Может принимать значение "true", если параметр
Если Вы используете этот параметр, но у вас не подключен компонент "dynamic_call_tracking", то вам вернется ошибка с мнемоникой "parameter_component_disabled"
Если задан одновременно
Если параметр |
cost_ratio |
number | минимальное значение 1 | Коэфициент, который влияет на значение параметра `costs` | |
cost_ratio_operator |
enum |
|
Оператор, который используется при расчете `costs` с учетом `cost_ratio` | |
| Динамический коллтрекинг | ||||
dynamic_call_tracking |
object | нет |
Настройка динамический коллтрекинг.
Обязателен к заполнению, если параметр
Если Вы используете этот параметр, но у вас не подключен компонент "dynamic_call_tracking", то вам вернется ошибка с мнемоникой "parameter_component_disabled" |
|
reservation_time |
enum | нет |
|
Период, на который номер закрепляется за посетителем сайта. По истечении указанного времени номер закрепляется за новым посетителем (или остается за текущим в случае наличия свободных номеров коллтрекинга). |
count_virtual_numbers |
number | да | минимальное значение 1 | Количество номеров необходимое для работы динамического коллтрекинга в одном блоке. Указанное количество номеров будет куплено. |
count_visits |
number | да | минимальное значение 1 | Количество посещений по рекламной кампании в сутки |
| Настройки групп условий | ||||
group_conditions |
array | да | Максимальное количество групп 30 | Группа условий рекламной кампании |
| Настройки условий | ||||
conditions |
array | да | Максимальное количество условий для группы 50 | Условия рекламной кампании в группе условий |
type |
enum | да |
|
Условия рекламной кампании в группе условий
|
campaign_parameter |
enum | да | Список допустимых значений и возможных операторов см. в таблице "Список параметров и их операторов" | |
value |
string | да |
Значение. Для некоторых campaign_parameter может быть свой список допустимых значений см. в таблице "Список параметров и их операторов"
|
|
operator |
enum | да | =, sub, ~ |
Оператор в условии. Зависит от используемого параметра campaign_parameter см. в таблице "Список параметров и их операторов"
|
JSON структура запроса
Копировать
{
"jsonrpc": "2.0",
"id": "number",
"method": "update.campaigns",
"params": {
"access_token": "string",
"user_id": "number",
"description": "string",
"name": "string",
"status": "enum",
"cost_ratio": "number",
"cost_ratio_operator": "enum",
"id": "number",
"site_id": "number",
"site_blocks": [
{
"site_block_id": "number",
"phone_number_id": "number",
"redirection_phone_number_id": "number",
"dynamic_call_tracking_enabled": "boolean"
}
],
"dynamic_call_tracking": {
"reservation_time": "enum",
"count_virtual_numbers": "number",
"count_visits": "number"
},
"campaign_conditions": {
"group_conditions": [
{
"conditions": [
{
"type": "enum",
"campaign_parameter": "enum",
"operator": "enum",
"value": "string"
}
]
}
]
}
}
}
JSON структура ответа
Копировать
{
"jsonrpc": "2.0",
"id": "number",
"result": {
"data": {
},
"metadata": {
}
}
}
Список возвращаемых ошибок
Смотрим раздел "Список ошибок для методов с глаголом update"