--- metadata: - name: generator content: Diplodoc Platform v5.52.0 alternate: - https://yandex.com/dev/direct/doc/en/audiencetargets/setBids.md - https://yandex.com/dev/direct/doc/ru/audiencetargets/setBids.md - href: ru/audiencetargets/setBids.md type: text/markdown title: Markdown version - href: ../llms.txt type: text/markdown title: llms.txt sourcePath: ru/ref-v5/audiencetargets/setBids.md --- > **Documentation Index:** Fetch the complete configuration index at https://yandex.com/dev/direct/doc/ru/llms.txt # setBids Назначает ставки и приоритеты для условий нацеливания на аудиторию. Ставку или приоритет можно назначить для отдельного условия нацеливания на аудиторию, для всех условий нацеливания на аудиторию в группе объявлений или для всех условий нацеливания на аудиторию в кампании. Ставка или приоритет используются в зависимости от того, какая стратегия выбрана в кампании: - Если в кампании настроена ручная стратегия, то используется параметр `ContextBid`. - Если в кампании настроена автоматическая стратегия, то используется параметр `StrategyPriority`: объявления по условиям нацеливания на аудиторию с более высоким приоритетом по возможности получают больший объем трафика, а при недостатке бюджета отключаются в последнюю очередь. В случае если не указан параметр, соответствующий стратегии, возвращается ошибка. В случае если указаны и ставка, и приоритет, значения будут сохранены: - Если стратегия ручная, а указан приоритет, то в дальнейшем в момент смены стратегии на автоматическую заданное значение приоритета будет применено. - Если стратегия автоматическая, а указана ставка, то это значение ставки **не будет применено**: в момент смены стратегии с автоматической на ручную будет задана ставка, подобранная автоматическим алгоритмом. {% 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/concepts/errors.html) ## Ограничения {#restrictions} В одном запросе можно назначить ставки только для однородных объектов — либо только для условий нацеливания на аудиторию, либо только для групп объявлений, либо только для кампаний. Количество объектов в одном вызове метода: - условий нацеливания на аудиторию — не более 10 000; - групп — не более 1000; - кампаний — не более 100. ## Запрос {#input} Структура запроса в формате JSON: ```javascript translate=no { "method": "setBids", "params": { /* params */ "Bids": [{ /* AudienceTargetSetBidsItem */ "Id": (long), "AdGroupId": (long), "CampaignId": (long), "ContextBid": (long), "StrategyPriority": ( "LOW" | "NORMAL" | "HIGH" ) }, ... ] /* required */ } } ``` #| || **Параметр** | **Тип** | **Описание** | **Обязательный** || || **Структура params (для JSON) / AddRequest (для SOAP)** | > | > | > || || `Bids` | array of AudienceTargetSetBidsItem | Условия нацеливания на аудиторию, которым требуется назначить ставку или приоритет. | Да || || **Структура AudienceTargetSetBidsItem** | > | > | > || || `Id` | long | Идентификатор условия нацеливания на аудиторию. Указывается, если требуется назначить ставку/приоритет для отдельного условия нацеливания на аудиторию. | Либо `Id`, либо `AdGroupId`, либо `CampaignId` || || `AdGroupId` | long | Идентификатор группы объявлений. Указывается, если требуется назначить единую ставку/приоритет для всех условий нацеливания на аудиторию в группе. | ^ || || `CampaignId` | long | Идентификатор кампании. Указывается, если требуется назначить единую ставку/приоритет для всех условий нацеливания на аудиторию в кампании. | ^ || || `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. Используется только для автоматической стратегии. Значение по умолчанию — NORMAL. | Для автоматической стратегии || |# {% note alert %} Параметры `Id`, `AdGroupId` и `CampaignId` являются взаимоисключающими. В одном запросе можно указывать только один из этих параметров. {% endnote %} ## Ответ {#output} Структура ответа в формате JSON: ```javascript translate=no { "result": { /* result */ "SetBidsResults": [{ /* SetBidsActionResult */ "Id": (long), "AdGroupId": (long), "CampaignId": (long), "Warnings": [{ /* ExceptionNotification */ "Code": (int), /* required */ "Message": (string), /* required */ "Details": (string) }, ... ], "Errors": [{ /* ExceptionNotification */ "Code": (int), /* required */ "Message": (string), /* required */ "Details": (string) }, ... ] }, ... ] /* required */ } } ``` #| || **Параметр** | **Тип** | **Описание** || || **Структура result (для JSON) / SetBidsResponse (для SOAP)** | > | > || || `SetBidsResults` | array of SetBidsActionResult | Результаты назначения ставок и/или приоритетов. || || **Структура SetBidsActionResult** | > | > || || `Id` | 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). || || `CampaignId` | long | Идентификатор кампании. Возвращается в случае отсутствия ошибок (если был указан в запросе), см. раздел [Операции над массивом объектов](https://yandex.ru/dev/direct/doc/dg/best-practice/modify.html). || || `Warnings` | array of ExceptionNotification | Предупреждения, возникшие при выполнении операции. || || `Errors` | array of ExceptionNotification | Ошибки, возникшие при выполнении операции. || |#