Версия Live 4 (deprecated)
Развиваемая версия на основе стабильной версии 4. Выпущена в январе 2012 г.
Использование версии Live 4 ограничено.
Следующие методы версии Live 4 отключены:
Информацию о соответствии методов в версиях Live 4 и 5 см. в Руководстве по переходу.
Адрес для запросов в формате JSON:
https://api.direct.yandex.ru/live/v4/json/
Адрес WSDL (для взаимодействия по протоколу SOAP):
https://api.direct.yandex.ru/live/v4/wsdl/
Адрес для SOAP-запросов:
https://api.direct.yandex.ru/live/v4/soap/
Новое в версии Live 4
- 10 декабря 2018 г.
-
Внесены изменения в справочник регионов: у Забайкальского края и Республики Бурятии родительским регионом стал Дальний Восток (вместо Сибири).
Рекомендуем получить обновленный справочник с помощью метода GetRegions (Live).
- 4 декабря 2018 г.
-
В ближайшее время будут внесены изменения в справочник регионов: у Забайкальского края и Республики Бурятии родительским регионом станет Дальний Восток (вместо Сибири).
После обновления справочника рекомендуем получить его заново с помощью метода GetRegions (Live).
- 3 декабря 2018 г.
-
Отключена возможность передавать через API денежные значения в у. е. для кампаний и рекламодателей, работающих в реальной валюте.
Входной параметр Currency стал обязательным в следующих методах:
Входной параметр Currency стал обязательным для получения статистики кампаний, работающих в реальной валюте, в следующих методах:
Значение параметра Currency должно совпадать с валютой кампании или рекламодателя для всех методов, кроме CreateNewForecast (Live) и GetEventsLog (Live).
Для метода GetSummaryStat (Live) вводится дополнительное ограничение: все кампании, указанные в одном вызове метода, должны быть в одной валюте.
- 17 октября 2017 г.
-
В методы CreateNewReport (Live) и GetBannersStat (Live) добавлена возможность получать в отчете данные о показах по автотаргетингу.
- В метод AccountManagement (Live) добавлена поддержка дневного ограничения на общий счет: входные параметры AccountDayBudget, PausedByDayBudgetSms (вложен в SmsNotification), PausedByDayBudget (вложен в EmailNotification) операции Update и аналогичные результирующие параметры операции Get.
- 4 июля 2017 г.
-
В методы CreateNewReport (Live) и GetBannersStat (Live) добавлена возможность получать в отчете данные о показе объявлений с видео.
- 22 марта 2017 г.
-
Изменена минимальная сумма платежа и минимальная сумма перевода между кампаниями.
- 14 февраля 2017 г.
-
В методы CreateNewWordstatReport и CreateNewForecast (Live) добавлена поддержка минус-фраз, содержащих до 7 слов, в параметре Phrases.
- 1 ноября 2016 г.
-
Добавлена поддержка новой валюты: белорусские рубли (BYN).
- 17 октября 2016 г.
- Внимание.
Для рекламодателей, работающих в у. е. и не осуществлявших оплату более года, доступ к аккаунту может быть приостановлен. В этом случае при попытке вызова методов API выдается ошибка 54, а в веб-интерфейсе недоступны никакие операции, кроме перевода в валюту.
Чтобы возобновить работу, переведите аккаунт в валюту оплаты. Для этого нажмите кнопку Перевести сейчас в веб-интерфейсе Директа. Подробнее о процедуре перевода читайте в помощи Директа: российские рубли, другая валюта.
- 13 октября 2016 г.
-
Внесены изменения в справочник регионов. Рекомендуем получить обновленный справочник с помощью метода GetRegions (Live).
В частности, из справочника удалены регионы, перечисленные ниже:эти регионы больше нельзя указывать при создании и редактировании групп объявлений;
в группах, где были указаны эти регионы, они автоматически заменены набором нижестоящих регионов;
статистика по этим регионам отнесена к вышестоящим регионам.
Список регионов, которые были удаленыУдален регион В настройках групп заменен набором регионов Статистика отнесена к региону Идентификатор Название региона (с вышестоящими) 20524 Запад/Украина/СНГ (исключая Россию) 20529, 20530, 20531, 20532, 20533, 20534, 20535, 20550 187 20525 Восток/Украина/СНГ (исключая Россию) 20536, 20537, 20538, 20539, 20540 187 20526 Юг/Украина/СНГ (исключая Россию) 20541, 20542, 20543 187 20527 Центр/Украина/СНГ (исключая Россию) 20544, 20545, 20546, 20547, 20548, 20549 187 20528 Север/Украина/СНГ (исключая Россию) 20551, 20552 187 980 Страны Балтии/Европа 117, 179, 206 111 1004 Ближний Восток/Азия 181, 210, 1056 183 Удален регион В настройках групп заменен набором регионов Статистика отнесена к региону Идентификатор Название региона (с вышестоящими) 20524 Запад/Украина/СНГ (исключая Россию) 20529, 20530, 20531, 20532, 20533, 20534, 20535, 20550 187 20525 Восток/Украина/СНГ (исключая Россию) 20536, 20537, 20538, 20539, 20540 187 20526 Юг/Украина/СНГ (исключая Россию) 20541, 20542, 20543 187 20527 Центр/Украина/СНГ (исключая Россию) 20544, 20545, 20546, 20547, 20548, 20549 187 20528 Север/Украина/СНГ (исключая Россию) 20551, 20552 187 980 Страны Балтии/Европа 117, 179, 206 111 1004 Ближний Восток/Азия 181, 210, 1056 183 - 12 октября 2016 г.
-
Добавлено ограничение для ключевых фраз: длина каждого слова и минус-слова в ключевой фразе — не более 35 символов.
- 10 октября 2016 г.
- Внимание. С 10 октября 2016 г. рекламные агентства могут регистрировать только клиентов, работающих в реальной валюте. Возможность регистрации новых клиентов, работающих в у. е., отключена. В связи с этим изменена логика работы метода CreateNewSubclient (Live). Подробнее...
- 3 октября 2016 г.
-
В статистике, предоставляемой методами GetBannersStat (Live) и CreateNewReport (Live), изменился период, за который доступны данные по средней позиции объявления и типу устройства. Теперь данные доступны начиная с 01.11.2014.
- 21 сентября 2016 г.
- Внимание. Через неделю произойдет изменение диапазона дат, за которые доступны данные по средней позиции объявления в статистике, формируемой методом CreateNewReport (Live). А именно, данные по средней позиции будут доступны только начиная с 01.11.2014. В настоящее время доступны данные начиная с 01.07.2014. Если вам необходима статистика по средней позиции за период с 01.07.2014 по 31.10.2014, рекомендуем запросить ее в ближайшие дни.
- 20 сентября 2016 г.
-
Ориентировочно через две-три недели будут внесены изменения в справочник регионов. После обновления справочника рекомендуем получить его заново с помощью метода GetRegions (Live).
В частности, из справочника будут удалены регионы, перечисленные ниже:эти регионы нельзя будет указывать при создании и редактировании групп объявлений;
в группах, где указаны эти регионы, они будут автоматически заменены набором нижестоящих регионов;
статистика по этим регионам будет отнесена к вышестоящим регионам.
Список регионов, которые будут удаленыУдаляемый регион В настройках групп будет заменен набором регионов Статистика будет отнесена к региону Идентификатор Название региона (с вышестоящими) 20524 Запад/Украина/СНГ (исключая Россию) 20529, 20530, 20531, 20532, 20533, 20534, 20535, 20550 187 20525 Восток/Украина/СНГ (исключая Россию) 20536, 20537, 20538, 20539, 20540 187 20526 Юг/Украина/СНГ (исключая Россию) 20541, 20542, 20543 187 20527 Центр/Украина/СНГ (исключая Россию) 20544, 20545, 20546, 20547, 20548, 20549 187 20528 Север/Украина/СНГ (исключая Россию) 20551, 20552 187 980 Страны Балтии/Европа 117, 179, 206 111 1004 Ближний Восток/Азия 181, 210, 1056 183 Удаляемый регион В настройках групп будет заменен набором регионов Статистика будет отнесена к региону Идентификатор Название региона (с вышестоящими) 20524 Запад/Украина/СНГ (исключая Россию) 20529, 20530, 20531, 20532, 20533, 20534, 20535, 20550 187 20525 Восток/Украина/СНГ (исключая Россию) 20536, 20537, 20538, 20539, 20540 187 20526 Юг/Украина/СНГ (исключая Россию) 20541, 20542, 20543 187 20527 Центр/Украина/СНГ (исключая Россию) 20544, 20545, 20546, 20547, 20548, 20549 187 20528 Север/Украина/СНГ (исключая Россию) 20551, 20552 187 980 Страны Балтии/Европа 117, 179, 206 111 1004 Ближний Восток/Азия 181, 210, 1056 183 - 8 сентября 2016 г.
-
В метод CreateNewReport (Live) добавлена возможность получать в отчете данные по условию ретаргетинга, в соответствии с которым применена корректировка ставок для посетивших сайт (см. раздел Корректировки (BidModifier) документации API версии 5).
- 8 сентября 2016 г.
-
В метод GetBanners (Live) добавлено значение project_declaration результирующего параметра AdWarnings.
- 30 августа 2016 г.
- Внимание. Статистика, предоставляемая методами GetSummaryStat (Live), GetBannersStat (Live), CreateNewReport (Live), доступна за последние три года от текущего месяца: например, 15 сентября 2016 года можно получить данные начиная с 1 сентября 2013 года.
- 29 августа 2016 г.
-
Настройка дневного бюджета доступна всем клиентам с правом редактирования кампаний.
- 29 июня 2016 г.
-
Методы RetargetingCondition (Live) и GetRetargetingGoals (Live) теперь поддерживают сегменты Яндекс Аудиторий. В метод GetRetargetingGoals (Live) добавлено значение audience_segment результирующего параметра Type.
- 23 июня 2016 г.
-
В метод RetargetingCondition (Live) добавлена возможность работать с условиями ретаргетинга, состоящими только из групп целей с типом not. Такие условия ретаргетинга можно использовать только в корректировках ставок (см. раздел Корректировки (BidModifier) документации API версии 5). Создание ретаргетингов с такими условиями не допускается.
- 26 апреля 2016 г.
-
Параметр условия ретаргетинга Time теперь поддерживает значения от 1 до 90.
- 25 апреля 2016 г.
- Внимание.
Внесены изменения в структуры данных: изменились типы параметров BannerID, BannerIDS, Banner, Banners, AdID, AdIDS, AdGroupID. Подробнее...
- 14 апреля 2016 г.
-
Отключена возможность загрузки изображений размера 150 пикселей по минимальной стороне и привязки таких изображений к объявлениям.
- 30 марта 2016 г.
-
Параметр кампании DisabledDomains теперь поддерживает внешние сети (SSP).
- 24 марта 2016 г.
-
В метод GetWordstatReportList добавлено значение Failed результирующего параметра StatusReport.
В метод GetForecastList добавлено значение Failed результирующего параметра StatusForecast.
- 14 марта 2016 г.
-
Параметр кампании RelevantPhrasesBudgetLimit больше не поддерживает значение –1. Чтобы расход по дополнительным релевантным фразам был неограничен (в рамках бюджета кампании), используйте значение 100.
- 29 февраля 2016 г.
- Изменены требования к размеру изображений в объявлениях:
при соотношении сторон от 1:1 до 3:4/4:3 — от 450 до 5000 пикселей по каждой стороне;
при соотношении сторон 16:9 — от 1080 × 607 до 5000 × 2812 пикселей.
Внимание. Загрузка изображений прежнего размера — 150 пикселей по минимальной стороне — будет поддерживаться в течение месяца. - 9 февраля 2016 г.
-
Изменены ограничения для ключевых фраз. Теперь группа объявлений может содержать не более 200 фраз, длина каждой фразы — не более 4096 символов.
- 15 декабря 2015 г.
-
Добавлена возможность получения статистики по динамическим текстовым объявлениям (см. раздел Динамические объявления помощи Директа):
Добавлены методы CreateOfflineReport (Live), DeleteOfflineReport (Live) и GetOfflineReportList (Live) для получения отчетов о динамических текстовых объявлениях.
В методы CreateNewReport (Live) и GetBannersStat (Live) добавлена возможность получать в отчете данные по условиям нацеливания для динамических текстовых объявлений.
- 9 ноября 2015 г.
-
Методы GetBanners (Live), GetBannerPhrases (Live), GetBannerPhrasesFilter (Live) возвращают ограничения на получение результатов торгов. Подробнее...
В метод CreateNewReport (Live) добавлена возможность получать в отчете данные по типу операционной системы и типу связи (только для рекламы мобильных приложений).
- 22 октября 2015 г.
- Внимание.
С 22 октября 2015 г. создание новых SSL-сертификатов недоступно. Ранее созданные сертификаты можно использовать до окончания срока их действия.
- 30 сентября 2015 г.
- В метод SetAutoPrice (Live) добавлена возможность рассчитывать ставки на поиске на основе минимальной ставки за второе место в спецразмещении.
- 8 сентября 2015 г.
-
В метод CreateNewReport (Live) добавлена возможность получать в отчете возрастную группу и пол пользователя.
Исправлено поведение по умолчанию для методов CreateNewReport (Live), GetBannersStat (Live) и GetSummaryStat (Live): если клиент работает в реальной валюте, а входной параметр Currency не передан, в отчете будет приведена стоимость кликов до применения скидки, пересчитанная из валюты в у. е.
- 1 сентября 2015 г.
-
Добавлена возможность получать результаты торгов нового аукциона: минимальную ставку за каждую позицию и списываемую цену на каждой позиции.
В метод GetBanners (Live) добавлен входной параметр AuctionBids. Если в параметре указано значение Yes, метод возвращает массив AuctionBids.
GetBannerPhrasesFilter (Live) возвращает массив AuctionBids, если во входном параметре FieldsNames указано значение AuctionBids.
В метод CreateNewForecast (Live) добавлен входной параметр AuctionBids. Если в параметре указано значение Yes, то отчет, возвращаемый методом GetForecast (Live), будет содержать массив AuctionBids.
- Добавлен параметр кампании MaintainNetworkCPC в методы