UpdatePrices

Sets bids and/or priorities for the specified keywords.

Attention.

Disabled method. Use version 5 of the API.

For information about the compatibility of methods between versions 4 and 5, see the Migration guide.

The UpdatePrices (Live) version also exists for this method.

Bid changes take effect after some time. See the Ad Serving Rules.

Restrictions

No more than 3000 method calls per campaign per day. You can set prices for a maximum of 1000 keywords in a single request.

Attention. This method only supports campaigns with the “Text & Image Ads” type. For setting bids in all types of campaigns, use the Bids service in version 5 of the API.

Input data

The input data structure in JSON is shown below.

{
   "method": "UpdatePrices",
   "param": [
      {  /* PhrasePriceInfo */
         "CampaignID": (int),
         "PhraseID": (long),
         "Price": (float),
         "AutoBroker": (string),
         "AutoBudgetPriority": (string),
         "ContextPrice": (float)
      }
      ...
   ]
}

The param parameter contains an array of PhrasePriceInfo objects (no more than 1000 objects), each of which sets prices for a single keyword. Parameters are described below.

Parameter Description Required
PhrasePriceInfo object
CampaignID The campaign ID. Yes
PhraseID The keyword ID. Yes
Price Bids on Yandex search. At least one of the parameters: Price, AutoBudgetPriority, ContextPrice. Values of omitted parameters are not changed.
ContextPrice

Bid in the Yandex Advertising Network (in Yandex units). The bid can be set in the following cases:

  1. The IndependentControl strategy is used on search. This strategy can only be selected via the Yandex Direct web interface.
  2. A manual strategy is used on search and the keyword is disabled for a low CTR.

    For new keywords this condition is irrelevant, since keywords are no longer disabled for a low CTR.

AutoBudgetPriority

Priority of the keyword when using automatic strategies. Possible values:

  • Low — Low priority.
  • Medium — Average priority.
  • High — High priority.
AutoBroker Enable/disable AutoBroker. This parameter is not used, and the passed value is ignored. No
Parameter Description Required
PhrasePriceInfo object
CampaignID The campaign ID. Yes
PhraseID The keyword ID. Yes
Price Bids on Yandex search. At least one of the parameters: Price, AutoBudgetPriority, ContextPrice. Values of omitted parameters are not changed.
ContextPrice

Bid in the Yandex Advertising Network (in Yandex units). The bid can be set in the following cases:

  1. The IndependentControl strategy is used on search. This strategy can only be selected via the Yandex Direct web interface.
  2. A manual strategy is used on search and the keyword is disabled for a low CTR.

    For new keywords this condition is irrelevant, since keywords are no longer disabled for a low CTR.

AutoBudgetPriority

Priority of the keyword when using automatic strategies. Possible values:

  • Low — Low priority.
  • Medium — Average priority.
  • High — High priority.
AutoBroker Enable/disable AutoBroker. This parameter is not used, and the passed value is ignored. No

Output data

Returns 1 when executed successfully, as shown in the following example.

{
   "data": 1
}

Examples of input data

Python

[
   {
      'CampaignID': 3665578,
      'PhraseID': 199381759,
      'Price': 6.5,
      'AutoBudgetPriority': 'Medium',
      'ContextPrice': 3.2
   }
]

PHP

array(
   array(
      'CampaignID' => 3665578,
      'PhraseID' => 199381759,
      'Price' => 6.5,
      'AutoBudgetPriority' => 'Medium',
      'ContextPrice' => 3.2
   )
)

Perl

[
   {
      'CampaignID' => 3665578,
      'PhraseID' => 199381759,
      'Price' => 6.5,
      'AutoBudgetPriority' => 'Medium',
      'ContextPrice' => 3.2
   }
]