set

Changes the coefficient values in bid adjustments.

Request

Request structure in JSON format:

{
  "method": "set",
  "params": { /* params */
    "BidModifiers": [{  /* BidModifierSetItem */
      "Id": (long), /* required */
      "BidModifier": (int) /* required */
    }, ... ] /* required */
  }
}


Params structure (for JSON) / SetRequest structure (for SOAP)
Parameter	Type	Description	Required
`BidModifiers`	array of BidSetItem	Coefficient values. Maximum of 1000 items in the array.	Yes
BidModifierSetItem structure
`Id`	long	Bid adjustment ID.	Yes
`BidModifier`	int	Coefficient value. Specified as a percentage: From 0 to 1300 for adjustments on mobile devices (in all types of campaigns and ad groups), on computers, tablets, Smart TVs (in all types of campaigns and ad groups), for gender and age, and for target audience. From 1 to 1300 for adjustments for exclusive placement, income, and groups. From 10 to 1300 for regional adjustments. From 20 to 1300 for smart banner adjustments. The bid is multiplied by the value of BidModifier/100.	Yes


Params structure (for JSON) / SetRequest structure (for SOAP)
Parameter	Type	Description	Required
`BidModifiers`	array of BidSetItem	Coefficient values. Maximum of 1000 items in the array.	Yes
BidModifierSetItem structure
`Id`	long	Bid adjustment ID.	Yes
`BidModifier`	int	Coefficient value. Specified as a percentage: From 0 to 1300 for adjustments on mobile devices (in all types of campaigns and ad groups), on computers, tablets, Smart TVs (in all types of campaigns and ad groups), for gender and age, and for target audience. From 1 to 1300 for adjustments for exclusive placement, income, and groups. From 10 to 1300 for regional adjustments. From 20 to 1300 for smart banner 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)
      }, ... ]
    }, ... ]
  }
}


Result structure (for JSON) / SetResponse structure (for SOAP)
Parameter	Type	Description
`SetResults`	array of ActionResult	Results of changing coefficients.
ActionResult structure
`Id`	long	Bid adjustment ID. Returned if there are no errors, see Operations on object arrays.
`Warnings`	array of ExceptionNotification	Warnings that occurred during the operation.
`Errors`	array of ExceptionNotification	Errors that occurred during the operation.


Result structure (for JSON) / SetResponse structure (for SOAP)
Parameter	Type	Description
`SetResults`	array of ActionResult	Results of changing coefficients.
ActionResult structure
`Id`	long	Bid adjustment ID. Returned if there are no errors, see Operations on object arrays.
`Warnings`	array of ExceptionNotification	Warnings that occurred during the operation.
`Errors`	array of ExceptionNotification	Errors that occurred during the operation.