setBids

Sets bids and priorities for dynamic text ad targets for dynamic ads.

You can set a bid or priority for an individual dynamic text ad target, for all dynamic text ad targets in an ad group, or for all dynamic text ad targets in a campaign.

The bid or priority is used depending on which display strategy is selected in the campaign:

• If you've set up an automatic strategy for your campaign, the StrategyPriority parameter is used: ads for dynamic text ad targets with higher priority get more traffic if possible, and are paused last when the budget runs low.

• If you've set up a manual strategy for your campaign, the Bid parameter is used.

The ContextBid parameter isn't used at this time.

If an item in the input array contains parameters that are not appropriate for the strategy, the values of these parameters are saved and a warning is issued.

• If your campaign uses an automatic strategy, but the Bid parameter is set for a dynamic text ad target, this bid value won't be applied. When the strategy changes from automatic to manual, the bid will be selected by an automatic algorithm.

• If your campaign uses a manual strategy, but the StrategyPriority parameter is set for a dynamic text ad target, the set priority value will be applied later when the strategy changes to an automatic one.

Learn more

• Operations on object arrays
• How to handle errors

Restrictions

A single request can only set bids for the same type of objects — either for campaigns only, or for groups only, or for dynamic text ad targets only.

Maximum number of objects per method call:

• Campaigns: A maximum of campaign-ids-select
• Groups: A maximum of adgroup-ids-select
• Dynamic text ad targets: A maximum of ids-select

Request

Request structure in JSON format:

{
  "method": "setBids",
  "params": {  /* params */
    "Bids": [{  /* SetBidsItem */
      "CampaignId": (long),
      "AdGroupId": (long),
      "Id": (long),
      "Bid": (long),
      "ContextBid": (long)
    }, ...  ] /* required */
  }
}

Response

Response structure in JSON format:

{
  "result": {  /* result */
    "SetBidsResults": [{  /* SetBidsActionResult */
      "CampaignId": (long),
      "AdGroupId": (long),
      "Id": (long),
      "Warnings": [{  /* ExceptionNotification */
        "Code": (int), /* required */
        "Message": (string), /* required */
        "Details": (string)
      }, ...  ],
      "Errors": [{  /* ExceptionNotification */
        "Code": (int), /* required */
        "Message": (string), /* required */
        "Details": (string)
      }, ...  ]
    }, ...  ]
  }
}