--- metadata: - name: generator content: Diplodoc Platform v5.50.2 alternate: - https://yandex.com/dev/direct/doc/dg-v4/en/live/UpdatePrices.md - https://yandex.com/dev/direct/doc/dg-v4/ru/live/UpdatePrices.md --- > **Documentation Index:** Fetch the complete configuration index at https://yandex.com/dev/direct/doc/dg-v4/ru/llms.txt # UpdatePrices (Live) Задает ставки и/или приоритеты для указанных фраз. Изменения ставок вступают в силу спустя некоторое время, см. [правила показа](https://yandex.ru/legal/direct_display_rules/)[правила показа](https://yandex.com/legal/direct_display_rules/). ## Ограничения Не более 3000 вызовов метода для одной кампании в сутки. За один вызов можно установить цены не более чем для 1000 фраз. {% note alert %} Метод поддерживает только кампании с типом “Текстово-графические объявления”“Text & Image Ads”. Для назначения ставок в кампаниях всех типов используйте сервис [Bids](https://yandex.ru/dev/direct/doc/ru/bids/bids) API версии 5. {% endnote %} ## Новое в версии Live 4 Добавлен входной параметр Currency. {% note alert %} Параметр CampaignID стал обязательным. {% endnote %} ## Входные данные {#input} Ниже показана структура входных данных в формате JSON. ```javascript { "method": "UpdatePrices", "param": [ { /* PhrasePriceInfo */ "CampaignID": (int), "PhraseID": (long), "Price": (float), "ContextPrice": (float), "AutoBroker": (string), "AutoBudgetPriority": (string), "Currency": (string) } ... ] } ``` Параметр `param` содержит массив объектов `PhrasePriceInfo` (не более 1000 объектов), каждый из которых устанавливает цены для одной фразы. Ниже приведено описание параметров. #| || **Параметр** | **Описание** | **Требуется** || || **Объект PhrasePriceInfo** || || `CampaignID` | Идентификатор кампании. | Да || || `PhraseID` | Идентификатор фразы. | Да || || `Price` | Ставка на поиске Яндекса (в валюте, указанной в параметре `Currency`). Используется, только если для кампании выбрана [|| `StrategyName` | [Стратегия](https://yandex.com/dev/direct/doc/dg-v4/ru/concepts/strategy.md) на поиске. Ниже перечислены возможные значения. - ShowsDisabled — выключить показ объявлений на поиске. Это необходимо для использования автоматической стратегии в Рекламной сети Яндекса. Показ на поиске невозможно выключить, если для Рекламной сети применяется стратегия Default. Стратегии с ручным управлением ставками на поиске: - HighestPosition — стратегия “Наивысшая доступная позиция”“Highest available position”; - LowestCost — стратегия “Показ в блоке по минимальной цене”“Cheapest position in ad block”; - LowestCostPremium — стратегия “Показ в блоке по минимальной цене”“Cheapest position in ad block”, но объявления показываются только в спецразмещении; - LowestCostGuarantee — стратегия “Показ под результатами поиска”“Impressions below search results” (в нижнем блоке по наименьшей цене); - RightBlockHighest — стратегия “Показ под результатами поиска”“Impressions below search results” (в нижнем блоке на наивысшей позиции, доступной при указанной ставке). Автоматические стратегии на поиске: - WeeklyBudget — стратегия “Недельный бюджет: максимум кликов”“Weekly budget: maximum clicks” (обязательный параметр `WeeklySumLimit`, дополнительный `MaxPrice`); - CPAOptimizer — стратегия “Недельный бюджет: максимальная конверсия”“Weekly budget: maximum conversion rate” (обязательные параметры `WeeklySumLimit` и `GoalID`, дополнительный `MaxPrice`); см. [условия подключения стратегии](https://yandex.ru/support/direct/strategies/weekly-budget.xml)[условия подключения стратегии](https://yandex.com/support/direct/strategies/weekly-budget.xml) в помощи Директа; - AverageClickPrice — стратегия “Средняя цена клика”“Average CPC” (обязательный параметр `AveragePrice`, дополнительный `WeeklySumLimit`); - WeeklyPacketOfClicks — стратегия “Недельный пакет кликов”“Weekly click package” (обязательный параметр `ClicksPerWeek`, дополнительные `MaxPrice` или `AveragePrice`); - AverageCPAOptimization — стратегия “Средняя цена конверсии”“Average CPA” (обязательные параметры `AverageCPA` и `GoalID`, дополнительные `WeeklySumLimit` и `MaxPrice`); см. [условия подключения стратегии](https://yandex.ru/support/direct/strategies/average-cpa.xml)[условия подключения стратегии](https://yandex.com/support/direct/strategies/average-cpa.xml) в помощи Директа; - ROIOptimization — стратегия “Средняя рентабельность инвестиций”“Average ROI” (обязательные параметры `ReserveReturn`, `ROICoef`, `GoalID`, дополнительные `Profitability`, `WeeklySumLimit` и `MaxPrice`); см. [условия подключения стратегии](https://yandex.ru/support/direct/strategies/average-roi.xml)[условия подключения стратегии](https://yandex.com/support/direct/strategies/average-roi.xml) в помощи Директа. | Да ||](*||-`StrategyName`-|-[Стратегия](https://yandex.com/dev/direct/doc/dg-v4/ru/concepts/strategy.md)-на-поиске.-Ниже-перечислены-возможные-значения.----ShowsDisabled-—-выключить-показ-объявлений-на-поиске.-Это-необходимо-для-использования-автоматической-стратегии-в-Рекламной-сети-Яндекса.-Показ-на-поиске-невозможно-выключить,-если-для-Рекламной-сети-применяется-стратегия-Default.--Стратегии-с-ручным-управлением-ставками-на-поиске:----HighestPosition-—-стратегия-“Наивысшая-доступная-позиция”“Highest-available-position”;---LowestCost-—-стратегия-“Показ-в-блоке-по-минимальной-цене”“Cheapest-position-in-ad-block”;---LowestCostPremium-—-стратегия-“Показ-в-блоке-по-минимальной-цене”“Cheapest-position-in-ad-block”,-но-объявления-показываются-только-в-спецразмещении;---LowestCostGuarantee-—-стратегия-“Показ-под-результатами-поиска”“Impressions-below-search-results”-(в-нижнем-блоке-по-наименьшей-цене);---RightBlockHighest-—-стратегия-“Показ-под-результатами-поиска”“Impressions-below-search-results”-(в-нижнем-блоке-на-наивысшей-позиции,-доступной-при-указанной-ставке).--Автоматические-стратегии-на-поиске:----WeeklyBudget-—-стратегия-“Недельный-бюджет:-максимум-кликов”“Weekly-budget:-maximum-clicks”-(обязательный-параметр-`WeeklySumLimit`,-дополнительный-`MaxPrice`);---CPAOptimizer-—-стратегия-“Недельный-бюджет:-максимальная-конверсия”“Weekly-budget:-maximum-conversion-rate”-(обязательные-параметры-`WeeklySumLimit`-и-`GoalID`,-дополнительный-`MaxPrice`);-см.-[условия-подключения-стратегии](https://yandex.ru/support/direct/strategies/weekly-budget.xml)[условия-подключения-стратегии](https://yandex.com/support/direct/strategies/weekly-budget.xml)-в-помощи-Директа;---AverageClickPrice-—-стратегия-“Средняя-цена-клика”“Average-CPC”-(обязательный-параметр-`AveragePrice`,-дополнительный-`WeeklySumLimit`);---WeeklyPacketOfClicks-—-стратегия-“Недельный-пакет-кликов”“Weekly-click-package”-(обязательный-параметр-`ClicksPerWeek`,-дополнительные-`MaxPrice`-или-`AveragePrice`);---AverageCPAOptimization-—-стратегия-“Средняя-цена-конверсии”“Average-CPA”-(обязательные-параметры-`AverageCPA`-и-`GoalID`,-дополнительные-`WeeklySumLimit`-и-`MaxPrice`);-см.-[условия-подключения-стратегии](https://yandex.ru/support/direct/strategies/average-cpa.xml)[условия-подключения-стратегии](https://yandex.com/support/direct/strategies/average-cpa.xml)-в-помощи-Директа;---ROIOptimization-—-стратегия-“Средняя-рентабельность-инвестиций”“Average-ROI”-(обязательные-параметры-`ReserveReturn`,-`ROICoef`,-`GoalID`,-дополнительные-`Profitability`,-`WeeklySumLimit`-и-`MaxPrice`);-см.-[условия-подключения-стратегии](https://yandex.ru/support/direct/strategies/average-roi.xml)[условия-подключения-стратегии](https://yandex.com/support/direct/strategies/average-roi.xml)-в-помощи-Директа.-|-Да-||) с ручным управлением ставками. Максимальное и минимальное значения представлены в таблице. Если значение перед сохранением конвертируется из у. е. в валюту кампании, то оно округляется вверх с точностью до [шага торгов](https://yandex.com/dev/direct/doc/dg-v4/ru/concepts/multicurrency_const.md#increment) в этой валюте. Если после конвертации в валюту кампании значение оказалось меньше минимальной или больше максимальной ставки в этой валюте, оно устанавливается равным минимальной или, соответственно, максимальной ставке. | Хотя бы один из параметров: `Price`, `AutoBudgetPriority`, `ContextPrice`. Значения неуказанных параметров не изменяются. || || `ContextPrice` | Ставка в Рекламной сети Яндекса (в валюте, указанной в параметре `Currency`). Параметр доступен для изменения в следующих случаях: 1. Для Рекламной сети выбрана стратегия MaximumCoverage. 1. Для Рекламной сети выбрана стратегия Default и фраза отключена на поиске за низкий CTR. Для новых фраз данное условие не актуально, поскольку фразы больше не отключаются за низкий CTR. Максимальное и минимальное значения представлены в таблице. Если значение перед сохранением конвертируется из у. е. в валюту кампании, то оно округляется вверх с точностью до [шага торгов](https://yandex.com/dev/direct/doc/dg-v4/ru/concepts/multicurrency_const.md#increment) в этой валюте. Если после конвертации в валюту кампании значение оказалось меньше минимальной или больше максимальной ставки в этой валюте, оно устанавливается равным минимальной или, соответственно, максимальной ставке. || || `AutoBudgetPriority` | Приоритет фразы при использовании автоматических стратегий. Возможные значения: - Low — низкий приоритет; - Medium — средний приоритет; - High — высокий приоритет. || || `AutoBroker` | Включить/выключить автоброкер. Параметр не используется, переданное значение игнорируется. | Нет || || `Currency` | Валюта, в которой указаны ставки. Возможные значения: RUB, CHF, EUR, KZT, TRY, UAH, USD, BYN. Значение должно совпадать с валютой кампании. Если параметр отсутствует или равен NULL, подразумеваются условные единицы (у. е.). В этом случае, если кампания ведется в реальной валюте, переданные приложением ставки перед сохранением конвертируются в реальную валюту. Если значение отлично от NULL и не совпадает с валютой кампании (одной из кампаний), возвращается ошибка с кодом [245](https://yandex.com/dev/direct/doc/dg-v4/ru/reference/ErrorCodes.md#BadCurrency). | Нет || |# ## Результирующие данные {#output} При успешном выполнении метод возвращает значение 1, как показано в следующем примере. ```javascript { "data": 1 } ``` ## Примеры входных данных {#example} ## Python ```python [ { 'CampaignID': 3665578, 'PhraseID': 199381759, 'Price': 6.5, 'AutoBudgetPriority': 'Medium', 'ContextPrice': 3.2 } ] ``` ## PHP ```php array( array( 'CampaignID' => 3665578, 'PhraseID' => 199381759, 'Price' => 6.5, 'AutoBudgetPriority' => 'Medium', 'ContextPrice' =3.2 ) ) ``` ## Perl ```perl [ { 'CampaignID' => 3665578, 'PhraseID' => 199381759, 'Price' => 6.5, 'AutoBudgetPriority' => 'Medium', 'ContextPrice' =3.2 } ] ```