set

Changes the coefficient values in bid adjustments.

  1. Request
  2. Response

Request

Request structure in JSON format:

{
  "method": "set",
  "params": { /* params */
    "BidModifiers": [{  /* BidModifierSetItem */
      "Id": (long), /* required */
      "BidModifier": (int) /* required */
    }, ... ] /* required */
  }
}
ParameterTypeDescriptionRequired
Params structure (for JSON) / SetRequest structure (for SOAP)
BidModifiersarray of BidSetItemCoefficient values. Maximum of 1000 items in the array.Yes
BidModifierSetItem structure
IdlongBid adjustment ID.Yes
BidModifierint

Coefficient value.

Specified as a percent:

  • From 50 to 1300 for mobile adjustments (except adjustments in groups of display ads) and video extension adjustments.
  • From 0 to 1300 for mobile adjustments (in groups of display ads), as well as adjustments on computers and tablets, by gender and age, and for a target audience.
  • From 10 to 1300 for regional adjustments.

The bid is multiplied by the value of BidModifier/100.

Yes

Response

Response structure in JSON format:

{
  "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)
      }, ... ]
    }, ... ]
  }
}
ParameterTypeDescription
Result structure (for JSON) / SetResponse structure (for SOAP)
SetResultsarray of ActionResultResults of changing coefficients.
ActionResult structure
IdlongBid adjustment ID. Returned if there aren't any errors. See the section Operations on object arrays.
Warningsarray of ExceptionNotification

Warnings that occurred during the operation.

Errorsarray of ExceptionNotification

Errors that occurred during the operation.