--- metadata: - name: generator content: Diplodoc Platform v5.50.6 alternate: - https://yandex.ru/dev/direct/doc/en/bids/set.md - https://yandex.ru/dev/direct/doc/ru/bids/set.md sourcePath: ru/ref-v5/bids/set.md --- > **Documentation Index:** Fetch the complete configuration index at https://yandex.ru/dev/direct/doc/ru/llms.txt # set Назначает фиксированные ставки для ключевых фраз и автотаргетингов. Ставку можно назначить: - для отдельной ключевой фразы или автотаргетинга; - для всех ключевых фраз и автотаргетинга в группе объявлений; - для всех ключевых фраз и автотаргетингов в кампании. Ставку можно назначить в зависимости от того, какая [стратегия показа](https://yandex.ru/dev/direct/doc/dg/objects/campaign-strategies.html) выбрана в кампании: - Если выбрана стратегия показа на поиске HIGHEST_POSITION, то можно указать параметр `SearchBid`. - Если выбрана стратегия показа в сетях MAXIMUM_COVERAGE или MANUAL_CPM, то можно указать параметр `NetworkBid`. В случае если элемент входного массива содержит параметры, не соответствующие стратегии, то значения этих параметров изменены не будут. - Если элемент входного массива содержит одновременно и параметры, соответствующие стратегии, и параметры, не соответствующие стратегии, то в результате операции будут изменены значения только параметров, соответствующих стратегии, и выдано предупреждение. - Если элемент входного массива содержит только параметры, не соответствующие стратегии, то операция не будет выполнена и будет возвращена ошибка. {% note alert %} - Ставки и цены передаются через API Директа в виде **целых чисел**. Передаваемое значение представляет собой ставку или цену, **умноженную на 1 000 000**. - Все ставки и цены указываются в валюте пользователя. {% endnote %} ## Узнайте больше - [Операции над массивом объектов](https://yandex.ru/dev/direct/doc/dg/best-practice/modify.html) - [Автотаргетинг](https://yandex.ru/dev/direct/doc/dg/best-practice/auto-targeting.html) ## Ограничения {#restrictions} В одном запросе можно назначить ставки только для однородных объектов — либо только для кампаний, либо только для групп, либо только для ключевых фраз и автотаргетингов. Количество объектов в одном вызове метода: - кампаний — не более 10; - групп — не более 1000; - ключевых фраз и автотаргетингов — не более 10 000. ## Запрос {#input} Структура запроса в формате JSON: ```javascript translate=no { "method": "set", "params": { /* params */ "Bids": [{ /* BidSetItem */ "CampaignId": (long), "AdGroupId": (long), "KeywordId": (long), "Bid": (long), "AutotargetingSearchBidIsAuto" : ("YES"|"NO"), "ContextBid": (long), "StrategyPriority": ( "LOW" | "NORMAL" | "HIGH" ) }, ... ] /* required */ } } ``` #| || **Параметр** | **Тип** | **Описание** | **Обязательный** || || **Структура params (для JSON) / SetRequest (для SOAP)** | > | > | > || || `Bids` | array of BidSetItem | Ставки. | Да || || **Структура BidSetItem** | > | > | > || || `CampaignId` | long | Идентификатор кампании. Указывается, если требуется назначить единую ставку для всех ключевых фраз и автотаргетингов в кампании. | Либо `CampaignId`, либо `AdGroupId`, либо `KeywordId` || || `AdGroupId` | long | Идентификатор группы объявлений. Указывается, если требуется назначить единую ставку для всех ключевых фраз и автотаргетингов в группе. | ^ || || `KeywordId` | long | Идентификатор фразы. Указывается, если требуется назначить ставку для отдельной ключевой фразы или автотаргетинга. | ^ || || `Bid` | long | Ставка на поиске, умноженная на 1 000 000. Целое число. Только для ручной стратегии. Указывается в валюте пользователя. Ограничения представлены в справочнике валют, который можно получить с помощью метода [Dictionaries](https://yandex.ru/dev/direct/doc/ru/dictionaries/dictionaries).[get](https://yandex.ru/dev/direct/doc/ru/dictionaries/get), указав в запросе имя справочника `Currencies`. | Хотя бы один из параметров `Bid`, `ContextBid`, `StrategyPriority`, `AutotargetingSearchBidIsAuto` || || `AutotargetingSearchBidIsAuto` | YesNoEnum | Признак включения опции [автоматической ставки](https://yandex.ru/support/direct/impression-criteria/autotargeting.html#autotargeting__auto-bids). Можно одновременно указать ручную ставку (`Bid`) и включить автоставку (`AutotargetingSearchBidIsAuto`). В этом случае будет работать автоставка, а ручная будет использоваться в случае отключения автоматической. Если указана ручная ставка `Bid`: значение автоматической ставки (`AutotargetingSearchBidIsAuto`) будет выставлено NO, если в явном виде не прислано иное значение автоставки. Если не указана ручная ставка `Bid`: значение автоматической ставки (`AutotargetingSearchBidIsAuto`) будет выставлено YES, если в явном виде не прислано иное значение автоставки. | ^ || || `ContextBid` | long | Ставка в сетях, умноженная на 1 000 000. Целое число. Только для ручной стратегии с независимым управлением ставками в сетях. Указывается в валюте пользователя. Ограничения представлены в справочнике валют, который можно получить с помощью метода [Dictionaries](https://yandex.ru/dev/direct/doc/ru/dictionaries/dictionaries).[get](https://yandex.ru/dev/direct/doc/ru/dictionaries/get), указав в запросе имя справочника `Currencies`. {% note alert %} Показ графического объявления возможен только при условии, что ставка не ниже минимальной ставки для объявления с включенным в него изображением. {% endnote %} | ^ || || `StrategyPriority` | PriorityEnum | Приоритет фразы: LOW, NORMAL или HIGH. Только для автоматической стратегии. {% note alert %} Параметр не используется, переданное значение игнорируется. {% endnote %} | ^ || |# {% note alert %} Параметры `CampaignId`, `AdGroupId` и `KeywordId` являются взаимоисключающими. В одном запросе можно указывать только один из этих параметров. {% endnote %} ## Ответ {#output} Структура ответа в формате JSON: ```javascript translate=no { "result": { /* result */ "SetResults": [{ /* BidActionResult */ "Warnings": [{ /* ExceptionNotification */ "Code": (int), /* required */ "Message": (string), /* required */ "Details": (string) }, ... ], "Errors": [{ /* ExceptionNotification */ "Code": (int), /* required */ "Message": (string), /* required */ "Details": (string) }, ... ], "CampaignId": (long), "AdGroupId": (long), "KeywordId": (long) }, ... ] } } ``` #| || **Параметр** | **Тип** | **Описание** || || **Структура result (для JSON) / SetResponse (для SOAP)** | > | > || || `SetResults` | array of BidActionResult | Результаты назначения ставок. || || **Структура BidActionResult** | > | > || || `CampaignId` | long | Идентификатор кампании. Возвращается в случае отсутствия ошибок, см. раздел [Операции над массивом объектов](https://yandex.ru/dev/direct/doc/dg/best-practice/modify.html) (если был указан в запросе). || || `AdGroupId` | long | Идентификатор группы объявлений. Возвращается в случае отсутствия ошибок, см. раздел [Операции над массивом объектов](https://yandex.ru/dev/direct/doc/dg/best-practice/modify.html) (если был указан в запросе). || || `KeywordId` | long | Идентификатор ключевой фразы или автотаргетинга. Возвращается в случае отсутствия ошибок, см. раздел [Операции над массивом объектов](https://yandex.ru/dev/direct/doc/dg/best-practice/modify.html) (если был указан в запросе). || || `Warnings` | array of ExceptionNotification | Предупреждения, возникшие при выполнении операции. || || `Errors` | array of ExceptionNotification | Ошибки, возникшие при выполнении операции. || |# ## Примеры {#samples} **Пример запроса**   ```javascript translate=no { "method" : "set", "params" : { "Bids" : [ { "StrategyPriority" : "HIGH", "CampaignId" : 4193065 }, { "Bid" : 14000, "CampaignId" : 7273721 } ] } } ``` **Пример ответа**   ```javascript translate=no { "result" : { "SetResults" : [ { "CampaignId" : 4193065 }, { "CampaignId" : 7273721 } ] } } ```