set

Изменяет значения коэффициентов в корректировках ставок.

  1. Запрос
  2. Ответ

Запрос

Структура запроса в формате JSON:

{
  "method": "set",
  "params": { /* params */
    "BidModifiers": [{  /* BidModifierSetItem */
      "Id": (long), /* required */
      "BidModifier": (int) /* required */
    }, ... ] /* required */
  }
}
Параметр Тип Описание Обяза-тельный
Структура params (для JSON) / SetRequest (для SOAP)
BidModifiers array of BidSetItem Значения коэффициентов. Не более 1000 элементов в массиве. Да
Структура BidModifierSetItem
Id long Идентификатор корректировки. Да
BidModifier int

Значение коэффициента.

Указывается в процентах:

  • От 0 до 1300 — для корректировок на мобильных (во всех типах кампаний и групп); на компьютерах, планшетах, Smart TV (во всех типах кампаний и групп); по полу и возрасту; для целевой аудитории.
  • От 1 до 1300 – для корректировок эксклюзивное размещение, платежеспособность, на группу.
  • От 10 до 1300 — для корректировок по региону показа.
  • От 20 до 1300 — для корректировок для смарт-баннеров.

Ставка умножается на значение BidModifier/100.

Да
Параметр Тип Описание Обяза-тельный
Структура params (для JSON) / SetRequest (для SOAP)
BidModifiers array of BidSetItem Значения коэффициентов. Не более 1000 элементов в массиве. Да
Структура BidModifierSetItem
Id long Идентификатор корректировки. Да
BidModifier int

Значение коэффициента.

Указывается в процентах:

  • От 0 до 1300 — для корректировок на мобильных (во всех типах кампаний и групп); на компьютерах, планшетах, Smart TV (во всех типах кампаний и групп); по полу и возрасту; для целевой аудитории.
  • От 1 до 1300 – для корректировок эксклюзивное размещение, платежеспособность, на группу.
  • От 10 до 1300 — для корректировок по региону показа.
  • От 20 до 1300 — для корректировок для смарт-баннеров.

Ставка умножается на значение BidModifier/100.

Да

Ответ

Структура ответа в формате JSON:

{
  "result": { /* result */
    "SetResults": [{  /* ActionResult */
      "Id": (long),
      "Warnings": [{  /* ExceptionNotification */
        "Code": (int), /* required */
        "Message": (string), /* required */
        "Details": (string)
      }, ... ],
      "Errors": [{  /* ExceptionNotification */
        "Code": (int), /* required */
        "Message": (string), /* required */
        "Details": (string)
      }, ... ]
    }, ... ]
  }
}
Параметр Тип Описание
Структура result (для JSON) / SetResponse (для SOAP)
SetResults array of ActionResult Результаты изменения коэффициентов.
Структура ActionResult
Id long Идентификатор корректировки. Возвращается в случае отсутствия ошибок, см. раздел Операции над массивом объектов.
Warnings array of ExceptionNotification

Предупреждения, возникшие при выполнении операции.

Errors array of ExceptionNotification

Ошибки, возникшие при выполнении операции.

Параметр Тип Описание
Структура result (для JSON) / SetResponse (для SOAP)
SetResults array of ActionResult Результаты изменения коэффициентов.
Структура ActionResult
Id long Идентификатор корректировки. Возвращается в случае отсутствия ошибок, см. раздел Операции над массивом объектов.
Warnings array of ExceptionNotification

Предупреждения, возникшие при выполнении операции.

Errors array of ExceptionNotification

Ошибки, возникшие при выполнении операции.