UpdatePrices (Live)

Задает ставки и/или приоритеты для указанных фраз.

Внимание.

Метод отключен. Используйте API версии 5.

Информацию о соответствии методов в версиях Live 4 и 5 см. в Руководстве по переходу.

Изменения ставок вступают в силу спустя некоторое время, см. правила показа.

Ограничения

Не более 3000 вызовов метода для одной кампании в сутки. За один вызов можно установить цены не более чем для 1000 фраз.

Внимание. Метод поддерживает только кампании с типом «Текстово-графические объявления». Для назначения ставок в кампаниях всех типов используйте сервис Bids API версии 5.

Новое в версии Live 4

Добавлен входной параметр Currency (см. также раздел Реальные валюты вместо у. е.).

Внимание. Параметр CampaignID стал обязательным.

Входные данные

Ниже показана структура входных данных в формате JSON.

{
   "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). Используется, только если для кампании выбрана стратегия с ручным управлением ставками.

Максимальное и минимальное значения представлены в таблице ../concepts/multicurrency_const.html#multicurrency_const__limits.

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

 Хотя бы один из параметров: Price, AutoBudgetPriority, ContextPrice. Значения неуказанных параметров не изменяются.
ContextPrice

Ставка в Рекламной сети Яндекса (в валюте, указанной в параметре Currency).

Параметр доступен для изменения в следующих случаях:

  1. Для Рекламной сети выбрана стратегия MaximumCoverage.

  2. Для Рекламной сети выбрана стратегия Default и фраза отключена на поиске за низкий CTR.

    Для новых фраз данное условие не актуально, поскольку фразы больше не отключаются за низкий CTR.

Максимальное и минимальное значения представлены в таблице ../concepts/multicurrency_const.html#multicurrency_const__limits.

Если значение перед сохранением конвертируется из у. е. в валюту кампании, то оно округляется вверх с точностью до шага торгов в этой валюте (см. раздел Реальные валюты вместо у. е.). Если после конвертации в валюту кампании значение оказалось меньше минимальной или больше максимальной ставки в этой валюте, оно устанавливается равным минимальной или, соответственно, максимальной ставке.
AutoBudgetPriority

Приоритет фразы при использовании автоматических стратегий. Возможные значения:

  • Low — низкий приоритет;
  • Medium — средний приоритет;
  • High — высокий приоритет.
AutoBroker Включить/выключить автоброкер. Параметр не используется, переданное значение игнорируется. Нет
Currency

Валюта, в которой указаны ставки.

Возможные значения: RUB, CHF, EUR, KZT, TRY, UAH, USD, BYN. Значение должно совпадать с валютой кампании.

Если параметр отсутствует или равен NULL, подразумеваются условные единицы (у. е.). В этом случае, если кампания ведется в реальной валюте, переданные приложением ставки перед сохранением конвертируются в реальную валюту (см. раздел Реальные валюты вместо у. е.).

Если значение отлично от NULL и не совпадает с валютой кампании (одной из кампаний), возвращается ошибка с кодом 245.

 Нет
Параметр Описание Требуется
Объект PhrasePriceInfo
CampaignID Идентификатор кампании. Да
PhraseID Идентификатор фразы. Да
Price

Ставка на поиске Яндекса (в валюте, указанной в параметре Currency). Используется, только если для кампании выбрана стратегия с ручным управлением ставками.

Максимальное и минимальное значения представлены в таблице ../concepts/multicurrency_const.html#multicurrency_const__limits.

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

 Хотя бы один из параметров: Price, AutoBudgetPriority, ContextPrice. Значения неуказанных параметров не изменяются.
ContextPrice

Ставка в Рекламной сети Яндекса (в валюте, указанной в параметре Currency).

Параметр доступен для изменения в следующих случаях:

  1. Для Рекламной сети выбрана стратегия MaximumCoverage.

  2. Для Рекламной сети выбрана стратегия Default и фраза отключена на поиске за низкий CTR.

    Для новых фраз данное условие не актуально, поскольку фразы больше не отключаются за низкий CTR.

Максимальное и минимальное значения представлены в таблице ../concepts/multicurrency_const.html#multicurrency_const__limits.

Если значение перед сохранением конвертируется из у. е. в валюту кампании, то оно округляется вверх с точностью до шага торгов в этой валюте (см. раздел Реальные валюты вместо у. е.). Если после конвертации в валюту кампании значение оказалось меньше минимальной или больше максимальной ставки в этой валюте, оно устанавливается равным минимальной или, соответственно, максимальной ставке.
AutoBudgetPriority

Приоритет фразы при использовании автоматических стратегий. Возможные значения:

  • Low — низкий приоритет;
  • Medium — средний приоритет;
  • High — высокий приоритет.
AutoBroker Включить/выключить автоброкер. Параметр не используется, переданное значение игнорируется. Нет
Currency

Валюта, в которой указаны ставки.

Возможные значения: RUB, CHF, EUR, KZT, TRY, UAH, USD, BYN. Значение должно совпадать с валютой кампании.

Если параметр отсутствует или равен NULL, подразумеваются условные единицы (у. е.). В этом случае, если кампания ведется в реальной валюте, переданные приложением ставки перед сохранением конвертируются в реальную валюту (см. раздел Реальные валюты вместо у. е.).

Если значение отлично от NULL и не совпадает с валютой кампании (одной из кампаний), возвращается ошибка с кодом 245.

 Нет

Результирующие данные

При успешном выполнении метод возвращает значение 1, как показано в следующем примере.

{
   "data": 1
}

Примеры входных данных

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
   }
]