setBids

Назначает ставки и приоритеты для условий нацеливания для динамических объявлений.

  1. Ограничения
  2. Запрос
  3. Ответ

Ставку или приоритет можно назначить для отдельного условия нацеливания для динамических объявлений, для всех условий нацеливания в группе объявлений или для всех условий нацеливания в кампании.

Ставка или приоритет используются в зависимости от того, какая стратегия показа выбрана в кампании:

  • Если в кампании настроена автоматическая стратегия, то используется параметр StrategyPriority: объявления по условиям нацеливания для динамических объявлений с более высоким приоритетом по возможности получают больший объем трафика, а при недостатке бюджета отключаются в последнюю очередь.

  • Если в кампании настроена ручная стратегия, то используется параметр Bid.

Параметр ContextBid в настоящее время не используется.

В случае если элемент входного массива содержит параметры, не соответствующие стратегии, то значения этих параметров будут сохранены и будет выдано предупреждение.

  • Если в кампании настроена автоматическая стратегия, а для условия нацеливания для динамических объявлений задан параметр Bid, то это значение ставки не будет применено: в момент смены стратегии с автоматической на ручную будет задана ставка, подобранная автоматическим алгоритмом.

  • Если в кампании настроена ручная стратегия, а для условия нацеливания для динамических объявлений задан параметр StrategyPriority, то в дальнейшем в момент смены стратегии на автоматическую заданное значение приоритета будет применено.

Внимание.
  • Ставки и цены передаются через API Директа в виде целых чисел. Передаваемое значение представляет собой ставку или цену, умноженную на 1 000 000.

  • Все ставки и цены указываются в валюте рекламодателя.

Ограничения

В одном запросе можно назначить ставки только для однородных объектов — либо только для кампаний, либо только для групп, либо только для условий нацеливания для динамических объявлений.

Количество объектов в одном вызове метода:

  • кампаний — не более 10;
  • групп — не более 1000;
  • условий нацеливания для динамических объявлений — не более 10 000.

Запрос

Структура запроса в формате JSON:

{
  "method": "setBids",
  "params": {  /* params */
    "Bids": [{  /* SetBidsItem */
      "CampaignId": (long),
      "AdGroupId": (long),
      "Id": (long),
      "Bid": (long),
      "ContextBid": (long),
      "StrategyPriority": ( "LOW" | "NORMAL" | "HIGH" )
    }, ... ] /* required */
  }
}
Параметр Тип Описание Обяза-тельный
Структура params (для JSON) / SetRequest (для SOAP)
Bids array of SetBidsItem Ставки и/или приоритеты. Да
Структура SetBidsItem
CampaignId long Идентификатор кампании. Указывается, если требуется назначить единую ставку/приоритет для всех условий нацеливания для динамических объявлений в кампании. Либо CampaignId, либо AdGroupId, либо Id
AdGroupId long Идентификатор группы объявлений. Указывается, если требуется назначить единую ставку/приоритет для всех условий нацеливания для динамических объявлений в группе.
Id long Идентификатор условия нацеливания для динамических объявлений. Указывается, если требуется назначить ставку/приоритет для отдельного условия нацеливания.
Bid long

Ставка на поиске, умноженная на 1 000 000. Целое число. Используется только для ручной стратегии.

Указывается в валюте рекламодателя. Ограничения представлены в справочнике валют, который можно получить с помощью метода Dictionaries.get, указав в запросе имя справочника Currencies.

Хотя бы один из параметров Bid и StrategyPriority (могут присутствовать оба)
StrategyPriority PriorityEnum

Приоритет условия нацеливания для динамических объявлений: LOW, NORMAL или HIGH. Используется только для автоматической стратегии.

ContextBid long Параметр зарезервирован для будущего использования. Нет
Параметр Тип Описание Обяза-тельный
Структура params (для JSON) / SetRequest (для SOAP)
Bids array of SetBidsItem Ставки и/или приоритеты. Да
Структура SetBidsItem
CampaignId long Идентификатор кампании. Указывается, если требуется назначить единую ставку/приоритет для всех условий нацеливания для динамических объявлений в кампании. Либо CampaignId, либо AdGroupId, либо Id
AdGroupId long Идентификатор группы объявлений. Указывается, если требуется назначить единую ставку/приоритет для всех условий нацеливания для динамических объявлений в группе.
Id long Идентификатор условия нацеливания для динамических объявлений. Указывается, если требуется назначить ставку/приоритет для отдельного условия нацеливания.
Bid long

Ставка на поиске, умноженная на 1 000 000. Целое число. Используется только для ручной стратегии.

Указывается в валюте рекламодателя. Ограничения представлены в справочнике валют, который можно получить с помощью метода Dictionaries.get, указав в запросе имя справочника Currencies.

Хотя бы один из параметров Bid и StrategyPriority (могут присутствовать оба)
StrategyPriority PriorityEnum

Приоритет условия нацеливания для динамических объявлений: LOW, NORMAL или HIGH. Используется только для автоматической стратегии.

ContextBid long Параметр зарезервирован для будущего использования. Нет
Внимание. Параметры CampaignId, AdGroupId и Id являются взаимоисключающими. В одном запросе можно указывать только один из этих параметров.

Ответ

Структура ответа в формате JSON:

{
  "result": {  /* result */
    "SetBidsResults": [{  /* SetBidsActionResult */
      "CampaignId": (long),
      "AdGroupId": (long),
      "Id": (long),
      "Warnings": [{  /* ExceptionNotification */
        "Code": (int), /* required */
        "Message": (string), /* required */
        "Details": (string)
      }, ... ],
      "Errors": [{  /* ExceptionNotification */
        "Code": (int), /* required */
        "Message": (string), /* required */
        "Details": (string)
      }, ... ]
    }, ... ]
  }
}
Параметр Тип Описание
Структура result (для JSON) / SetResponse (для SOAP)
SetBidsResults array of SetBidActionResult Результаты назначения ставок и/или приоритетов.
Структура SetBidActionResult
CampaignId long Идентификатор кампании. Возвращается в случае отсутствия ошибок (если был указан в запросе).
AdGroupId long Идентификатор группы объявлений. Возвращается в случае отсутствия ошибок (если был указан в запросе).
Id long Идентификатор условия нацеливания для динамических объявлений. Возвращается в случае отсутствия ошибок (если был указан в запросе).
Warnings array of ExceptionNotification

Предупреждения, возникшие при выполнении операции.

Errors array of ExceptionNotification

Ошибки, возникшие при выполнении операции.

Параметр Тип Описание
Структура result (для JSON) / SetResponse (для SOAP)
SetBidsResults array of SetBidActionResult Результаты назначения ставок и/или приоритетов.
Структура SetBidActionResult
CampaignId long Идентификатор кампании. Возвращается в случае отсутствия ошибок (если был указан в запросе).
AdGroupId long Идентификатор группы объявлений. Возвращается в случае отсутствия ошибок (если был указан в запросе).
Id long Идентификатор условия нацеливания для динамических объявлений. Возвращается в случае отсутствия ошибок (если был указан в запросе).
Warnings array of ExceptionNotification

Предупреждения, возникшие при выполнении операции.

Errors array of ExceptionNotification

Ошибки, возникшие при выполнении операции.