UpdatePrices
Sets bids and/or priorities for the specified keywords.
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.
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:
| |
AutoBudgetPriority | Priority of the keyword when using automatic strategies. Possible values:
| |
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:
| |
AutoBudgetPriority | Priority of the keyword when using automatic strategies. Possible values:
| |
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
}
]