--- metadata: - name: generator content: Diplodoc Platform v5.50.6 alternate: - https://yandex.ru/dev/direct/doc/en/changelog.md - https://yandex.ru/dev/direct/doc/ru/changelog.md --- > **Documentation Index:** Fetch the complete configuration index at https://yandex.ru/dev/direct/doc/ru/llms.txt # API версии 5. История изменений **20 марта 2026 г.** Добавлен новый [тип объявления](https://yandex.ru/dev/direct/doc/ru/objects/ad) — комбинаторный, в сервисе [Ad](https://yandex.ru/dev/direct/doc/ru/ads/ads) описаны методы для работы с ним. **13 ноября 2025 г.** Метод toggle сервиса [BidModifiers](https://yandex.ru/dev/direct/doc/ru/bidmodifiers/bidmodifiers.html) устарел и перестал поддерживаться. **26 октября 2025 г.** В сервис [BidModifiers](https://yandex.ru/dev/direct/doc/ru/bidmodifiers/bidmodifiers.html) добавлена новая корректировка `SmartTvAdjustment`, которая отвечает за за корректировку на Smart TV. **16 сентября 2025 г.**   В сервисы [Campaigns](https://yandex.ru/dev/direct/doc/ru/campaigns/campaigns) и [Strategies](https://yandex.ru/dev/direct/doc/ru/strategies/strategies) для кампаний с типом «Текстово-графические объявления» и «Единая перфоманс кампания» добавлена новая стратегия `MAX_PROFIT`. **19 июня 2025 г.** В сервис [AgencyClients](https://yandex.ru/dev/direct/doc/ru/agencyclients/agencyclients) добавлен метод [addPassportOrganizationMember](https://yandex.ru/dev/direct/doc/ru/agencyclients/addPassportOrganizationMember). **16 июня 2025 г.** В сервисе [AgencyClients](https://yandex.ru/dev/direct/doc/ru/agencyclients/agencyclients.html) метод [add](https://yandex.ru/dev/direct/doc/ru/agencyclients/add.html) больше не поддерживается. Вместо него используется метод [addPassportOrganization](https://yandex.ru/dev/direct/doc/ru/agencyclients/addPassportOrganization.html). **6 июня 2025 г.**   В сервисы [Campaigns](https://yandex.ru/dev/direct/doc/ru/campaigns/campaigns) и [Strategies](https://yandex.ru/dev/direct/doc/ru/strategies/strategies) для кампаний с типом «Текстово-графические объявления» и «Единая перфоманс кампания» добавлены новые стратегии: - `AVERAGE_CPA_MULTIPLE_GOALS`; - `PAY_FOR_CONVERSION_MULTIPLE_GOALS` **2 июня 2025 г.**   Обновлены требования к настройкам регистрируемых приложений: добавьте доступ passport:business в [настройках приложения](https://oauth.yandex.ru/client/edit/) для работы с организациями в Яндекс ID. **19 мая 2025 г.** В сервис [AgencyClients](https://yandex.ru/dev/direct/doc/ru/agencyclients/agencyclients) добавлен метод [addPassportOrganization](https://yandex.ru/dev/direct/doc/ru/agencyclients/addPassportOrganization).   **14 марта 2025 г.**   В методы сервисов [Campaigns](https://yandex.ru/dev/direct/doc/ru/campaigns/campaigns.html) добавлено поле `DynamicPlaces`. **18 февраля 2025 г.**   В методы [CreateNewForecast](https://yandex.ru/dev/direct/doc/dg-v4/ru/live/CreateNewForecast.html) и [GetForecast](https://yandex.ru/dev/direct/doc/dg-v4/ru/live/GetForecast) добавлено поле `CommonMinusWords`. **12 ноября 2024 г.**   В методы сервисов [Campaigns](https://yandex.ru/dev/direct/doc/ru/campaigns/campaigns.html) добавлена настройка `ALTERNATIVE_TEXTS_ENABLED` для Единой перфоманс-кампании. **1 августа 2024 г.**   В методы сервисов [Campaigns](https://yandex.ru/dev/direct/doc/ru/campaigns/campaigns.html) добавлены поля `Maps` и `SearchOrganizationList` для Единой перфоманс-кампании. **1 июля 2024 г.**   Отключено ручное управление ставками в Рекламной сети Яндекса. **24 апреля 2024 г.**   Добавлена [инструкция](../unified-campaign-update.html) по обновлению до Единой перфоманс-кампании. **22 марта 2024 г.**   В сервис [Ads](https://yandex.ru/dev/direct/doc/ru/ads/ads.html) добавлена структура `ListingAd`. В методы сервисов [Campaigns](https://yandex.ru/dev/direct/doc/ru/campaigns/campaigns.html) и [Strategies](https://yandex.ru/dev/direct/doc/ru/strategies/strategies.html) добавлена структура `CustomPeriodBudget`. **26 декабря 2023 г.**   В сервис [Campaigns](https://yandex.ru/dev/direct/doc/ru/campaigns/campaigns.html) добавлена структура `NegativeKeywordSharedSetIds`. **27 ноября 2023 г.**   Добавлена поддержка [единых перфоманс кампаний](https://yandex.ru/support/direct/unified-performance-campaign/about.html): - В сервис [Campaigns](https://yandex.ru/dev/direct/doc/ru/campaigns/campaigns.html) добавлена структура `UnifiedCampaign`. - В сервис [AdGroups](https://yandex.ru/dev/direct/doc/ru/adgroups/adgroups.html) добавлена структура `UnifiedAdGroup`. - В серсис [Ads](https://yandex.ru/dev/direct/doc/ru/ads/ads.html) добавлена структура `ShoppingAd`. - В сервис [BidModifiers](https://yandex.ru/dev/direct/doc/ru/bidmodifiers/bidmodifiers.html) добавлена новая корректировка `AD_GROUP_ADJUSTMENT` (корректировка на группу, доступная для единой перфоманс группы). - В сервис [Reports](https://yandex.ru/dev/direct/doc/ru/reports.html) добавлены новые параметры: - `UNIFIED_CAMPAIGN` в поле `CampaignType`; - `OFFER_RETARGETING` в поле `CriterionType`. **21 ноября 2023 г.**   В сервис [Keywords](https://yandex.ru/dev/direct/doc/ru/keywords/keywords.html) добавлена структура `AutotargetingSettings`. Обновлена схема работы автотаргетинга. **2 октября 2023 г.**   В сервис [Dictionaries](https://yandex.ru/dev/direct/doc/ru/dictionaries/dictionaries.html) добавлен метод [getGeoRegions](https://yandex.ru/dev/direct/doc/ru/dictionaries/getGeoRegions.html). **19 сентября 2023 г.**   В методы сервисов [Campaigns](https://yandex.ru/dev/direct/doc/ru/campaigns/campaigns.html) и [Strategies](https://yandex.ru/dev/direct/doc/ru/strategies/strategies.html) добавлена структура `ExplorationBudget`. **11 сентября 2023 г.**   В методы сервисов [Bids](https://yandex.ru/dev/direct/doc/ru/bids/bids.html), [KeywordBids](https://yandex.ru/dev/direct/doc/ru/keywordbids/keywordbids.html) и [Keywords](https://yandex.ru/dev/direct/doc/ru/keywords/keywords.html) добавлено поле `AutotargetingSearchBidIsAuto` – признак включения [автоматической ставки](https://yandex.ru/support/direct/impression-criteria/autotargeting.html#autotargeting__auto-bids). **2 августа 2023 г.**   Добавлен сервис [Strategies](https://yandex.ru/dev/direct/doc/ru/strategies/strategies.html) для работы с пакетными стратегиями. **4 июля 2023 г.**   В метод [get](https://yandex.ru/dev/direct/doc/ru/dictionaries/get.html) сервиса [AdImages](https://yandex.ru/dev/direct/doc/ru/dictionaries/dictionaries.html) добавлена структура `GetRegionNames`. **13 апреля 2023 г.**   В метод [add](https://yandex.ru/dev/direct/doc/ru/ad_assets/add.html) сервиса [AdImages](https://yandex.ru/dev/direct/doc/ru/ad_assets/adimages.html) добавлено поле `Type`. **24 марта 2023 г.**   В методы сервисов [AgencyClients](https://yandex.ru/dev/direct/doc/ru/agencyclients/agencyclients.html) и [Clients](https://yandex.ru/dev/direct/doc/ru/clients/clients.html) добавлены поля `ForbiddenPlatform` и `AvailableCampaignTypes`. **6 сентября 2022 г.**   В методы сервиса [Campaigns](https://yandex.ru/dev/direct/doc/ru/campaigns/campaigns.html) добавлено поле `TrackingParams` (для кампаний с типом «Текстово-графические объявления», «Динамические объявления», «Смарт-баннеры»). **15 августа 2022 г.**   В методы сервисов [AgencyClients](https://yandex.ru/dev/direct/doc/ru/agencyclients/agencyclients.html) и [Clients](https://yandex.ru/dev/direct/doc/ru/clients/clients.html) добавлены структуры `TinInfo` и `ErirAttributes`. **19 июля 2022 г.**   В сервис [AdImages](https://yandex.ru/dev/direct/doc/ru/ad_assets/adimages.html) добавлены новые значения параметра `Subtype`. **13 июля 2022 г.**   Для пользователей [Прямой рекламодатель](https://yandex.ru/dev/direct/doc/ru/objects/roles.html) и [Рекламодатель — клиент агентства](https://yandex.ru/dev/direct/doc/ru/objects/roles.html) добавлена новая роль [Представитель (только чтение)](*Представитель-(только-чтение)).   В сервисы [Clients](https://yandex.ru/dev/direct/doc/ru/clients/get.html) и [AgencyClients](https://yandex.ru/dev/direct/doc/ru/agencyclients/get.html) добавлено новое значение параметра `Role`. **29 апреля 2022 г.**   В сервис [Reports](https://yandex.ru/dev/direct/doc/ru/reports.html) добавлено поле `CampaignUrlPath`. **18 апреля 2022 г.**   В сервис [Reports](https://yandex.ru/dev/direct/doc/ru/reports.html) добавлены: - Поле `ClientLogin`. - В структуру `Page` добавлено поле `Offset`. **13 апреля 2022 г.**   Для [кампаний](https://yandex.ru/dev/direct/doc/ru/campaigns/campaigns.html) с типом «Динамические объявления» появилась возможность выбора категории таргетинга (структура `AutotargetingCategories`). **29 марта 2022 г.**   В сервис [Сampaigns](https://yandex.ru/dev/direct/doc/ru/campaigns/campaigns.html) в структуру `PriorityGoals` добавлено новое поле `IsMetrikaSourceOfValue` — для кампаний со стратегией `AVERAGE_CRR`. **25 марта 2022 г.**   В сервисе [Bidmodifiers](https://yandex.ru/dev/direct/doc/ru/bidmodifiers/bidmodifiers.html) появились новые типы корректировок: - TABLET_ADJUSTMENT — корректировка на планшетах. - DESKTOP_ONLY_ADJUSTMENT — корректировка только на компьютерах. **26 января 2022 г.**   Добавлен сервис [AdVideos](https://yandex.ru/dev/direct/doc/ru/advideos/advideos.html). **14 января 2022 г.**   Параметры `NETWORK_DEFAULT` и `MAINTAIN_NETWORK_CPC` скоро перестанут поддерживаться в сервисе [Сampaigns](https://yandex.ru/dev/direct/doc/ru/campaigns/campaigns.html). Пожалуйста, обновите свои приложения до конца января 2022. **22 ноября 2021 г.**   В сервис [Campaigns](https://yandex.ru/dev/direct/doc/ru/campaigns/campaigns.html) для кампаний с типом «Динамические объявления» добавлена настройка `PlacementTypes` — места показа объявлений на поиске. **19 ноября 2021 г.**   В сервис [Reports](https://yandex.ru/dev/direct/doc/ru/reports.html) добавлены новые параметры: - PRODUCT_EXTENSIONS, MARKET — в поле `ClickType`; - PRODUCT_GALLERY — в поле `Slot`. **12 ноября 2021 г.**   [Отчеты](https://yandex.ru/dev/direct/doc/ru/reports.html) теперь доступны и по кампаниям, созданным в Мастере кампаний. **1 ноября 2021 г.**   В сервисе [Bidmodifiers](https://yandex.ru/dev/direct/doc/ru/bidmodifiers/bidmodifiers.html) появился новый тип корректировки: - INCOME_GRADE_ADJUSTMENT — корректировка на платежеспособность. **25 октября 2021 г.**   Добавлен параметр `VideoTarget` в методы сервиса [Campaigns](https://yandex.ru/dev/direct/doc/ru/campaigns/campaigns.html) (для кампаний с типом «Медийная кампания»). **20 октября 2021 г.**   В сервисе [Adgroups](https://yandex.ru/dev/direct/doc/ru/adgroups/adgroups.html) появилась возможность создания группы текстово-графических объявлений на основе фида: - В метод [add](https://yandex.ru/dev/direct/doc/ru/adgroups/add.html) добавлена структура `TextAdGroupFeedParams`; - В метод [get](https://yandex.ru/dev/direct/doc/ru/adgroups/add.html) добавлен параметр `TextAdGroupFeedParamsFieldNames`; - В метод [update](https://yandex.ru/dev/direct/doc/ru/adgroups/add.html) добавлена структура `TextAdGroupFeedParamsUpdate`. **14 октября 2021 г.**   В сервисе [Bidmodifiers](https://yandex.ru/dev/direct/doc/ru/bidmodifiers/bidmodifiers.html) появился новый тип корректировки: - SERP_LAYOUT_ADJUSTMENT — корректировка на эксклюзивное размещение. **7 октября 2021 г.**   В сервисе [Campaigns](https://yandex.ru/dev/direct/doc/ru/campaigns/campaigns.html) отключена поддержка опции `WEEKLY_CLICK_PACKAGE`. **3 сентября 2021 г.**   В сервисе [Keywords](https://yandex.ru/dev/direct/doc/ru/keywords/keywords.html) появилась возможность выбора категории таргетинга (структура `AutotargetingCategories`). В сервис [Reports](https://yandex.ru/dev/direct/doc/ru/reports.html) добавлено поле `TargetingCategory`. **2 августа 2021 г.**   В сервисе [Ads](https://yandex.ru/dev/direct/doc/ru/ads/ads.html) для [объявлений](https://yandex.ru/dev/direct/doc/ru/objects/ad.html) с типом MOBILE_APP_AD появилась возможность прикрепления [видеодополнения](https://yandex.ru/support/direct/features/video-extension.html): - В методы [add](https://yandex.ru/dev/direct/doc/ru/ads/add.html), [get](https://yandex.ru/dev/direct/doc/ru/ads/get.html) и [update](https://yandex.ru/dev/direct/doc/ru/ads/update.html) добавлена структура `VideoExtension`. **13 июля 2021 г.**   В сервисе [Campaigns](https://yandex.ru/dev/direct/doc/ru/campaigns/campaigns.html) появилась новая стратегия `PAY_FOR_CONVERSION_CRR` для кампаний с типом «Текстово-графические объявления», «Динамические объявления» и «Смарт-баннеры». Стратегия принесет конверсии по цене, равной указанному проценту от передаваемого по цели дохода. **23 июня 2021 г.**   Добавлен сервис [DynamicFeddAdTargets](https://yandex.ru/dev/direct/doc/ru/dynamicfeedadtargets/dynamicfeedadtargets.html) для управления условиями нацеливания по фидам для динамических текстовых объявлений. **2 июня 2021 г.**   В сервисе [Campaigns](https://yandex.ru/dev/direct/doc/ru/campaigns/campaigns.html) появилась новая стратегия: - `AVERAGE_CRR` — для кампаний с типом «Текстово-графические объявления», «Динамические объявления» и «Смарт-баннеры». Стратегия позволяет получить максимальное количество конверсий по выбранной цели, придерживаясь при этом заданной доли рекламных расходов. **28 мая 2021 г.**   В сервисе [Feeds](https://yandex.ru/dev/direct/doc/ru/feeds/feeds.html) добавлен параметр `FilterSchema`, в котором указывается название схемы для создания фильтров. **24 мая 2021 г.**   В сервисе [Adgroups](https://yandex.ru/dev/direct/doc/ru/adgroups/adgroups.html) появилась возможность создания группы динамических объявлений с подтипом FEED через API: - В метод [add](https://yandex.ru/dev/direct/doc/ru/adgroups/add.html) добавлена структура `DynamicTextFeedAdGroupAdd` c полем `FeedId`; - В метод [get](https://yandex.ru/dev/direct/doc/ru/adgroups/add.html) в параметр `DynamicTextFeedAdGroupFieldNames` добавлено поле `FeedId`. **13 мая 2021 г.**   В методы сервиса [Creatives](https://yandex.ru/dev/direct/doc/ru/creatives/creatives.html) добавлен параметр `IsAdaptive`. **13 апреля 2021 г.**   В сервисе [Campaigns](https://yandex.ru/dev/direct/doc/ru/campaigns/campaigns.html) для кампаний с типом «Медийная кампания» появились новые стратегии: - `CP_AVERAGE_CPV` - `WB_AVERAGE_CPV` Стратегии позволяют получить максимальное количество просмотров видео за определенный период в рамках заданного бюджета. **8 апреля 2021 г.**   В сервисе [Campaigns](https://yandex.ru/dev/direct/doc/ru/campaigns/campaigns.html) появилась новая стратегия: - `PAY_FOR_CONVERSION_PER_FILTER` — для кампаний с типом «Смарт-баннеры». Стратегия принесет конверсии по цене, указанной при настройке стратегии. **31 марта 2021 г.**   В сервисы [AgencyClients](https://yandex.ru/dev/direct/doc/ru/agencyclients/agencyclients.html) и [Clients](https://yandex.ru/dev/direct/doc/ru/clients/clients.html) добавлена информация о бонусах, которые ожидают начисления (параметр `Bonuses`). **26 марта 2021 г.**   В сервисе [Campaigns](https://yandex.ru/dev/direct/doc/ru/campaigns/campaigns.html) отключена поддержка опции ENABLE_EXTENDED_AD_TITLE. Опция будет игнорироваться во всех запросах к API. **16 марта 2021 г.**   Добавлена настройка кампании CAMPAIGN_EXACT_PHRASE_MATCHING_ENABLED в методы сервиса [Campaigns](https://yandex.ru/dev/direct/doc/ru/campaigns/campaigns.html) (для кампаний с типом «Текстово-графические объявления», «Динамические объявления» и «Реклама мобильных приложений»). **3 марта 2021 г.**   В сервисе [Campaigns](https://yandex.ru/dev/direct/doc/ru/campaigns/campaigns.html) появилась новая стратегия: - `PAY_FOR_INSTALL` — для кампаний с типом «Реклама мобильных приложений». Стратегия позволяет получать конверсии по фиксированной цене за установку приложения. **8 февраля 2021 г.**   Появилась поддержка видеообъявлений в кампаниях с типом «Реклама мобильных приложений»: - В сервис [Ads](https://yandex.ru/dev/direct/doc/ru/ads/ads.html) добавлена поддержка объявлений с подтипом MOBILE_APP_CPC_VIDEO_AD_BUILDER_AD. **2 февраля 2021 г.**   В сервис [Reports](https://yandex.ru/dev/direct/doc/ru/reports.html) добавлено поле `AvgEffectiveBid`. **4 декабря 2020 г.**   В сервис [Reports](https://yandex.ru/dev/direct/doc/ru/reports.html) добавлено значение KEYWORD поля `MatchType`. **28 сентября 2020 г.**   В сервисе [TurboPages](https://yandex.ru/dev/direct/doc/ru/turbopages/turbopages.html) появилась возможность поиска турбо-страниц по связанной с ними ссылке. Добавлены новые параметры: `BoundWithHref`, `TurboSiteHref`. **26 августа 2020 г.**   В сервисе [Campaigns](https://yandex.ru/dev/direct/doc/ru/campaigns/campaigns.html) в стратегиях `AVERAGE_CPA_PER_CAMPAIGN` и `AVERAGE_CPA_PER_FILTER` параметр `AverageCpa` (для `AVERAGE_CPA_PER_CAMPAIGN`) / `FilterAverageCpa` (для `AVERAGE_CPA_PER_FILTER`) является обязательным. Параметр `AverageCpc` / `FilterAverageCpc` больше не используется. **17 июля 2020 г.**   В сервисе [Campaigns](https://yandex.ru/dev/direct/doc/ru/campaigns/campaigns.html), в стратегиях `WB_MAXIMUM_CONVERSION_RATE`, `AVERAGE_ROI` и `AVERAGE_CPA` ограничена возможность оптимизации по всем целям. Теперь в параметре `GoalId` для этих стратегий необходимо передавать идентификатор конкретной цели Яндекс Метрики. **16 июля 2020 г.**   В сервисе [Campaigns](https://yandex.ru/dev/direct/doc/ru/campaigns/campaigns.html), в стратегии `WB_MAXIMUM_CONVERSION_RATE` появилась возможность оптимизации по всем ключевым целям (параметр `GoalId:13`). **29 июня 2020 г.**   В сервис [Reports](https://yandex.ru/dev/direct/doc/ru/reports.html) добавлено значение PHONE поля `ClickType`. **8 июня 2020 г.**   В сервисе [Campaigns](https://yandex.ru/dev/direct/doc/ru/campaigns/campaigns.html) появились новые стратегии: - `PAY_FOR_CONVERSION` — для кампаний с типом «Текстово-графические объявления» и «Динамические объявления»; - `PAY_FOR_CONVERSION_PER_CAMPAIGN` — для кампаний с типом «Смарт-баннеры». Стратегии принесут конверсии по цене, указанной при настройке стратегии. **2 июня 2020 г.**   Изменилось значение коэффициента к ставке для показа объявлений на мобильных телефонах (параметр `BidModifier`). **26 марта 2020 г.**   Для всех рекламных кампаний, исключая кампании с типом «Смарт-баннеры», снято ограничение на количество прикрепленных счетчиков (параметр `CounterIds` сервиса [Campaigns](https://yandex.ru/dev/direct/doc/ru/campaigns/campaigns.html)). **25 марта 2020 г.**   Появилась поддержка профилей организаций из [Яндекс Справочника](https://yandex.ru/sprav/)[Яндекс Справочника](https://yandex.com/sprav/): - Добавлен сервис [Businesses](https://yandex.ru/dev/direct/doc/ru/businesses/businesses.html) для получения профилей организаций рекламодателя. - В методы сервиса [Ads](https://yandex.ru/dev/direct/doc/ru/ads/ads.html) добавлен параметр `BusinessId` для текстово-графических объявлений. **16 марта 2020 г.**   Добавлена поддержка смарт-баннеров: - Добавлен сервис [Feeds](https://yandex.ru/dev/direct/doc/ru/feeds/feeds.html) для управления фидами — файлами с товарными предложениями. - Добавлен сервис [SmartAdTargets](https://yandex.ru/dev/direct/doc/ru/smartadtargets/smartadtargets.html) для управления фильтрами — условиями нацеливания для смарт-баннеров. - В сервис [Adgroups](https://yandex.ru/dev/direct/doc/ru/adgroups/adgroups.html) добавлена поддержка групп объявлений с типом SMART_AD_GROUP. - В сервис [Creatives](https://yandex.ru/dev/direct/doc/ru/creatives/creatives.html) добавлена поддержка креативов с типом SMART_CREATIVE. - В сервис [Ads](https://yandex.ru/dev/direct/doc/ru/ads/ads.html) добавлена поддержка объявлений с типом SMART_AD. - В сервис [Bidmodifiers](https://yandex.ru/dev/direct/doc/ru/bidmodifiers/bidmodifiers.html) добавлена поддержка корректировок с типом SMART_AD_ADJUSTMENT. [Подробнее об управлении смарт-баннерами](https://yandex.ru/dev/direct/doc/ru/best-practice/smart-ads.html) **25 февраля 2020 г.**   Во всех сервисах API добавлена поддержка передачи заголовка `Accept-Encoding: gzip`. **25 февраля 2020 г.**   В сервис [Reports](https://yandex.ru/dev/direct/doc/ru/reports.html) добавлено значение SMART_TILE поля `AdFormat`. **6 февраля 2020 г.**   В методы [AgencyClients](https://yandex.ru/dev/direct/doc/ru/agencyclients/agencyclients.html).[get](https://yandex.ru/dev/direct/doc/ru/agencyclients/get.html), [Clients](https://yandex.ru/dev/direct/doc/ru/clients/clients.html).[get](https://yandex.ru/dev/direct/doc/ru/clients/get.html) для параметра `Element` добавлены новые значения GENERAL_DOMAIN_BLACKLIST_SIZE и VIDEO_DOMAIN_BLACKLIST_SIZE. **15 января 2020 г.**   В сервис [Reports](https://yandex.ru/dev/direct/doc/ru/reports.html) добавлено значение ADAPTIVE_IMAGE поля `AdFormat`. **19 декабря 2019 г.**   Добавлен таргетинг по интересам для текстово-графических объявлений: - В группу с типом TEXT_AD_GROUP можно добавить условие нацеливания на аудиторию, в котором условие ретаргетинга и подбора аудитории имеет тип AUDIENCE и содержит только сегменты по краткосрочным интересам. - В ответ метода [RetargetingLists](https://yandex.ru/dev/direct/doc/ru/retargetinglists/retargetinglists.html).[get](https://yandex.ru/dev/direct/doc/ru/retargetinglists/get.html) добавлен параметр `AvailableForTargetsInAdGroupTypes`. Подробнее читайте в разделе [RetargetingLists](https://yandex.ru/dev/direct/doc/ru/objects/retargeting-list.html). **2 декабря 2019 г.**   В сервисе [Reports](https://yandex.ru/dev/direct/doc/ru/reports.html) обозначение типа кампании «Смарт-баннеры» в поле `CampaignType` изменено на SMART_CAMPAIGN. **22 ноября 2019 г.**   В стратегии `AVERAGE_ROI` появилась возможность оптимизации по ключевым целям: для параметра `GoalId` в структуре `AverageRoi` добавлено значение 13. **11 ноября 2019 г.**   Метод [Dictionaries](https://yandex.ru/dev/direct/doc/ru/dictionaries/dictionaries.html).[get](https://yandex.ru/dev/direct/doc/ru/dictionaries/get.html) возвращает в справочнике `Currencies` новый параметр `MinimumAccountDailyBudget` — минимальный дневной бюджет общего счета. Валютный параметр `MinimumPayment`, который ранее совмещал два значения — минимальный платеж (без учета НДС) и минимальный дневной бюджет общего счета, используйте только в качестве ограничения минимального платежа. **1 октября 2019 г.**   Изменения в методе [Campaigns](https://yandex.ru/dev/direct/doc/ru/campaigns/campaigns.html).[get](https://yandex.ru/dev/direct/doc/ru/campaigns/get.html): значения возвращаемых параметров `SharedAccountFunds`.`Spend` и `CampaignFunds`.`Sum` теперь включают НДС. **25 сентября 2019 г.**   В сервисе [Campaigns](https://yandex.ru/dev/direct/doc/ru/campaigns/campaigns.html) для настройки `ADD_METRICA_TAG` в структуре `Settings` значение по умолчанию изменено с NO на YES. **17 сентября 2019 г.**   Модели атрибуции в API: - В методы сервиса [Campaigns](https://yandex.ru/dev/direct/doc/ru/campaigns/campaigns.html) добавлен параметр `AttributionModel` для кампаний с типом «Текстово-графические объявления» и «Динамические объявления». - В сервисе [Reports](https://yandex.ru/dev/direct/doc/ru/reports.html) для входного параметра `AttributionModels` добавлено значение LYDC — «Последний переход из Яндекс Директа». Статистика по новой модели атрибуции доступна за период начиная с 30 июля 2019 г. **9 сентября 2019 г.**   Изменения в сервисе [Sitelinks](https://yandex.ru/dev/direct/doc/ru/sitelinks/sitelinks.html): теперь один набор может содержать до 8 быстрых ссылок. **28 августа 2019 г.**   Сервис [Campaigns](https://yandex.ru/dev/direct/doc/ru/campaigns/campaigns.html) теперь поддерживает ключевые цели для кампаний с типом «Динамические объявления»: структура `PriorityGoals` добавлена в структуру `DynamicTextCampaign`. **22 августа 2019 г.**   В сервисе [Campaigns](https://yandex.ru/dev/direct/doc/ru/campaigns/campaigns.html) изменены настройки стратегий: - Из структуры `NetworkDefault` исключен параметр `BidPercent`. Методы [add](https://yandex.ru/dev/direct/doc/ru/campaigns/add.html) и [update](https://yandex.ru/dev/direct/doc/ru/campaigns/update.html) выдают ошибку при попытке задать его, а метод [get](https://yandex.ru/dev/direct/doc/ru/campaigns/get.html) не возвращает. - Параметр `LimitPercent` в структуре `NetworkDefault` используется только в случае, если стратегия на поиске — HIGHEST_POSITION. Если на поиске автоматическая стратегия: - Методы [add](https://yandex.ru/dev/direct/doc/ru/campaigns/add.html) и [update](https://yandex.ru/dev/direct/doc/ru/campaigns/update.html) игнорируют переданное значение и выдают предупреждение. Чтобы включить стратегию в сетях NETWORK_DEFAULT, необходимо передать пустую структуру `NetworkDefault`. - Метод [get](https://yandex.ru/dev/direct/doc/ru/campaigns/get.html) не возвращает структуру `NetworkDefault`. - Настройка `MAINTAIN_NETWORK_CPC` в структуре `Settings` используется только в случае, если стратегия на поиске — HIGHEST_POSITION, а стратегия в сетях — NETWORK_DEFAULT. В остальных случаях методы [add](https://yandex.ru/dev/direct/doc/ru/campaigns/add.html) и [update](https://yandex.ru/dev/direct/doc/ru/campaigns/update.html) игнорируют переданное значение и выдают предупреждение, а метод [get](https://yandex.ru/dev/direct/doc/ru/campaigns/get.html) не возвращает настройку `MAINTAIN_NETWORK_CPC`. Посмотреть соответствие стратегий в API обновленным стратегиям в веб-интерфейсе можно в разделе [strategies](https://yandex.ru/dev/direct/doc/ru/annex/strategies.html). **23 июля 2019 г.**   Для цены в текстово-графических объявлениях появилась новая валюта: узбекские сумы. В методы сервиса [Ads](https://yandex.ru/dev/direct/doc/ru/ads/ads.html) добавлено значение UZS параметра `PriceCurrency`. **11 июля 2019 г.**   Появилась поддержка наборов минус-фраз: - Добавлен сервис [NegativeKeywordSharedSets](https://yandex.ru/dev/direct/doc/ru/negativekeywordsharedsets/negativekeywordsharedsets.html) для управления наборами минус-фраз. - В методы сервиса [Adgroups](https://yandex.ru/dev/direct/doc/ru/adgroups/adgroups.html) добавлен параметр `NegativeKeywordSharedSetIds`. В метод [Adgroups](https://yandex.ru/dev/direct/doc/ru/adgroups/adgroups.html).[get](https://yandex.ru/dev/direct/doc/ru/adgroups/add.html) также добавлена возможность отбирать группы объявлений, в которых используются заданные наборы минус-фраз. **24 июня 2019 г.**   Появилась поддержка видеообъявлений в медийных кампаниях: - В сервис [Adgroups](https://yandex.ru/dev/direct/doc/ru/adgroups/adgroups.html) добавлена поддержка групп объявлений с типом CPM_VIDEO_AD_GROUP. {% note alert %} Настройка **Сбор аудитории видео** в настоящее время не поддерживается в API. {% endnote %} - В сервис [Ads](https://yandex.ru/dev/direct/doc/ru/ads/ads.html) добавлена поддержка объявлений с типом CPM_VIDEO_AD. **3 июня 2019 г.**   Изменения в сервисе [RetargetingLists](https://yandex.ru/dev/direct/doc/ru/retargetinglists/retargetinglists.html): - Отменено ограничение на условия ретаргетинга и подбора аудитории, состоящие только из правил с оператором NONE. Теперь в таких условиях можно использовать не только цели Яндекс Метрики, но и сегменты Яндекс Метрики, и сегменты Яндекс Аудиторий. - Параметр `MembershipLifeSpan` теперь используется только для целей Яндекс Метрики. Для сегментов Яндекс Метрики и сегментов Яндекс Аудиторий методы [add](https://yandex.ru/dev/direct/doc/ru/retargetinglists/add.html) и [update](https://yandex.ru/dev/direct/doc/ru/retargetinglists/update.html) игнорируют переданное значение. - Максимальное количество дней в параметре `MembershipLifeSpan` увеличено до 540. **16 мая 2019 г.**   В сервис [Creatives](https://yandex.ru/dev/direct/doc/ru/creatives/creatives.html) добавлена поддержка креативов с типом CPM_VIDEO_CREATIVE. **15 мая 2019 г.**   Появилась поддержка Турбо-страниц: - Добавлен сервис [TurboPages](https://yandex.ru/dev/direct/doc/ru/turbopages/turbopages.html) для получения Турбо-страниц, созданных в конструкторе. - В методы сервиса [Ads](https://yandex.ru/dev/direct/doc/ru/ads/ads.html) добавлен параметр `TurboPageId`. В ответ метода [Ads](https://yandex.ru/dev/direct/doc/ru/ads/ads.html).[get](https://yandex.ru/dev/direct/doc/ru/ads/get.html) также добавлен параметр `TurboPageModeration`. Параметр `Href` в структурах `TextImageAd`, `TextAdBuilderAd`, `CpcVideoAdBuilderAd`, `CpmBannerAdBuilderAd` стал nillable в методах [Ads](https://yandex.ru/dev/direct/doc/ru/ads/ads.html).[update](https://yandex.ru/dev/direct/doc/ru/ads/update.html) и [Ads](https://yandex.ru/dev/direct/doc/ru/ads/ads.html).[get](https://yandex.ru/dev/direct/doc/ru/ads/get.html). - В методы сервиса [Sitelinks](https://yandex.ru/dev/direct/doc/ru/sitelinks/sitelinks.html) добавлен параметр `TurboPageId`. Параметры `Href` и `Description` стали nillable в методе [Sitelinks](https://yandex.ru/dev/direct/doc/ru/sitelinks/sitelinks.html).[get](https://yandex.ru/dev/direct/doc/ru/sitelinks/get.html). В метод [Sitelinks](https://yandex.ru/dev/direct/doc/ru/sitelinks/sitelinks.html).[get](https://yandex.ru/dev/direct/doc/ru/sitelinks/get.html) добавлен входной параметр `SitelinkFieldNames`. [Подробнее о Турбо-страницах](https://yandex.ru/dev/direct/doc/ru/objects/turbo-page.html) **8 апреля 2019 г.**   Cервис [Reports](https://yandex.ru/dev/direct/doc/ru/reports.html) поддерживает ключевые цели: - Добавлено поле `Profit`. - Значения полей `Revenue`, `Profit` и `GoalsRoi` для ключевых целей рассчитываются исходя из ценностей конверсий, указанных в настройках кампании. [Подробнее о ключевых целях](https://yandex.ru/support/direct/impressions/automatic-bid-adjustment-in-yan.html#automatic-bid-adjustment-in-yan__priority-goals) **27 марта 2019 г.**   Доступна настройка цены в текстово-графических объявлениях: в методы сервиса [Ads](https://yandex.ru/dev/direct/doc/ru/ads/ads.html) добавлена структура `PriceExtension`. **11 марта 2019 г.**   В сервисе [Campaigns](https://yandex.ru/dev/direct/doc/ru/campaigns/campaigns.html) изменены настройки конверсионных стратегий. Если на поиске выбрана одна из следующих стратегий: - AVERAGE_CPA, AVERAGE_ROI или WB_MAXIMUM_CONVERSION_RATE для кампании с типом «Текстово-графические объявления»; - AVERAGE_CPI или WB_MAXIMUM_APP_INSTALLS для кампании с типом «Реклама мобильных приложений», то параметры стратегии в сетях `NetworkDefault`.`BidPercent` и `NetworkDefault`.`LimitPercent`, а также опция `MAINTAIN_NETWORK_CPC` в структуре `Settings` не поддерживаются. Методы [add](https://yandex.ru/dev/direct/doc/ru/campaigns/add.html) и [update](https://yandex.ru/dev/direct/doc/ru/campaigns/update.html) игнорируют переданные значения и выдают предупреждение. Чтобы включить стратегию в сетях NETWORK_DEFAULT, необходимо передать пустую структуру `NetworkDefault`. Метод [get](https://yandex.ru/dev/direct/doc/ru/campaigns/get.html) не возвращает структуру `NetworkDefault` и опцию `MAINTAIN_NETWORK_CPC`. **4 февраля 2019 г.**   Сервис [Campaigns](https://yandex.ru/dev/direct/doc/ru/campaigns/campaigns.html) теперь поддерживает ключевые цели для кампаний с типом «Текстово-графические объявления»: в методы `add`, `update` и `get` добавлена структура `PriorityGoals`. **9 января 2019 г.**   Изменения в сервисе [Reports](https://yandex.ru/dev/direct/doc/ru/reports.html) для смарт-баннеров: - Для кампаний с типом SMART_BANNER_CAMPAIGN, если указано хотя бы одно из полей `Criterion`, `CriterionId`, `Criteria`, `CriteriaId`, или используется отбор данных по полю `SmartBannerFilterId`, или выбран тип отчета CRITERIA_PERFORMANCE_REPORT, то в полях `Impressions` и `Ctr` будет указан прочерк. - Поле `ImpressionShare` можно указывать вместе с `TargetingLocationId` и `TargetingLocationName`. **25 декабря 2018 г.**   Сервис [Bidmodifiers](https://yandex.ru/dev/direct/doc/ru/bidmodifiers/bidmodifiers.html) поддерживает корректировки ставок в зависимости от типа устройства для групп медийных объявлений. [Подробнее о корректировках](https://yandex.ru/dev/direct/doc/ru/objects/bidmodifier.html) **10 декабря 2018 г.**   Внесены изменения в справочник регионов: у Забайкальского края и Республики Бурятии родительским регионом стал Дальний Восток (вместо Сибири). Рекомендуем получить обновленный справочник с помощью метода [Dictionaries](https://yandex.ru/dev/direct/doc/ru/dictionaries/dictionaries.html).[get](https://yandex.ru/dev/direct/doc/ru/dictionaries/get.html). **6 декабря 2018 г.**   Метод [Dictionaries](https://yandex.ru/dev/direct/doc/ru/dictionaries/dictionaries.html).[get](https://yandex.ru/dev/direct/doc/ru/dictionaries/get.html) больше не поддерживает у. е.: - из справочника `Currencies` исключена валюта YND_FIXED; - для остальных валют не возвращаются параметры `Rate` и `RateWithVAT`. **4 декабря 2018 г.**   В ближайшее время будут внесены изменения в справочник регионов: у Забайкальского края и Республики Бурятии родительским регионом станет Дальний Восток (вместо Сибири). После обновления справочника рекомендуем получить его заново с помощью метода [Dictionaries](https://yandex.ru/dev/direct/doc/ru/dictionaries/dictionaries.html).[get](https://yandex.ru/dev/direct/doc/ru/dictionaries/get.html). **26 ноября 2018 г.**   В метод [keywordsresearch](https://yandex.ru/dev/direct/doc/ru/keywordsresearch/keywordsresearch.html).[deduplicate](https://yandex.ru/dev/direct/doc/ru/keywordsresearch/deduplicate.html) добавлен входной параметр `Operation`: теперь склейку дублей и кросс-минусовку можно выполнять как вместе, так и по отдельности. **12 ноября 2018 г.**   В справочник валют добавлены минимальная и максимальная ставка или цена за тысячу показов для медийной рекламы. Получить справочник можно с помощью метода [Dictionaries](https://yandex.ru/dev/direct/doc/ru/dictionaries/dictionaries.html).[get](https://yandex.ru/dev/direct/doc/ru/dictionaries/get.html), указав в запросе имя справочника `Currencies`. **2 ноября 2018 г.**   Для нацеливания медийной рекламы доступны сегменты Крипты по поведенческим признакам: - Сервис [retargetinglists](https://yandex.ru/dev/direct/doc/ru/retargetinglists/retargetinglists.html) поддерживает использование сегментов по поведенческим признакам в условии нацеливания по профилю пользователей. - Метод [Dictionaries](https://yandex.ru/dev/direct/doc/ru/dictionaries/dictionaries.html).[get](https://yandex.ru/dev/direct/doc/ru/dictionaries/get.html) возвращает поведенческие признаки в справочнике `AudienceCriteriaTypes` и сегменты по поведенческим признакам в справочнике `AudienceDemographicProfiles`. **1 ноября 2018 г.**   Добавлено ограничение: в кампании с типом «Реклама мобильных приложений» во всех группах объявлений должна быть указана одинаковая ссылка на приложение. **3 октября 2018 г.**   Добавлен сервис [Creatives](https://yandex.ru/dev/direct/doc/ru/creatives/creatives.html) для получения доступных рекламодателю креативов, созданных в конструкторе. **3 октября 2018 г.**   В сервис [Ads](https://yandex.ru/dev/direct/doc/ru/ads/ads.html) добавлена поддержка видеообъявлений. [Подробнее о типах объявлений](https://yandex.ru/dev/direct/doc/ru/objects/ad.html) **1 октября 2018 г.**   Добавлен метод [keywordsresearch](https://yandex.ru/dev/direct/doc/ru/keywordsresearch/keywordsresearch.html).[deduplicate](https://yandex.ru/dev/direct/doc/ru/keywordsresearch/deduplicate.html), выполняющий кросс-минусовку и склейку дублей в массиве ключевых фраз. **26 сентября 2018 г.**   Для медийных кампаний появилась поддержка в API: - В сервис [Campaigns](https://yandex.ru/dev/direct/doc/ru/campaigns/campaigns.html) добавлена поддержка кампаний с типом CPM_BANNER_CAMPAIGN. - В сервис [Adgroups](https://yandex.ru/dev/direct/doc/ru/adgroups/adgroups.html) добавлена поддержка групп объявлений с типом CPM_BANNER_AD_GROUP. - В сервис [Ads](https://yandex.ru/dev/direct/doc/ru/ads/ads.html) добавлена поддержка объявлений с типом CPM_BANNER_AD. - В сервис [retargetinglists](https://yandex.ru/dev/direct/doc/ru/retargetinglists/retargetinglists.html) добавлена поддержка профилей пользователя, см. [раздел](https://yandex.ru/dev/direct/doc/ru/objects/retargeting-list.html). - В метод [Dictionaries](https://yandex.ru/dev/direct/doc/ru/dictionaries/dictionaries.html).[get](https://yandex.ru/dev/direct/doc/ru/dictionaries/get.html) добавлена возможность получать справочники сегментов Крипты: - справочник сегментов по социально-демографическим характеристикам: полу, возрасту, доходу, семье и профессии; - справочник социально-демографических характеристик; - справочник сегментов по интересам пользователя. [Подробнее об управлении медийными кампаниями](https://yandex.ru/dev/direct/doc/ru/best-practice/cpm-banner.html) **27 августа 2018 г.**   Изменено ограничение: максимальное количество корректировок по полу и возрасту для одной кампании или группы объявлений увеличено до 12. **21 августа 2018 г.**   В сервисы [Bidmodifiers](https://yandex.ru/dev/direct/doc/ru/bidmodifiers/bidmodifiers.html) и [Reports](https://yandex.ru/dev/direct/doc/ru/reports.html) добавлена поддержка возрастных групп AGE_45_54 и AGE_55. **8 августа 2018 г.**   В сервис [Reports](https://yandex.ru/dev/direct/doc/ru/reports.html) добавлены поля `AvgTrafficVolume`, `WeightedCtr`, `WeightedImpressions`. **8 июня 2018 г.**   В сервис [Reports](https://yandex.ru/dev/direct/doc/ru/reports.html) добавлены входные параметры `Goals` и `AttributionModels`. Изменен способ расчета значения поля `ConversionRate`: теперь количество целевых визитов делится не на общее количество визитов, а на количество кликов. **30 мая 2018 г.**   Добавлен метод [keywordbids](https://yandex.ru/dev/direct/doc/ru/keywordbids/keywordbids.html).[setAuto](https://yandex.ru/dev/direct/doc/ru/keywordbids/setAuto.html), позволяющий назначить для фраз ставки на поиске в зависимости от желаемого объема трафика. **3 мая 2018 г.**   В сервис [Reports](https://yandex.ru/dev/direct/doc/ru/reports.html) добавлена возможность получать статистику кампаний с типом «Медийная кампания»: - Для поля `CampaignType` добавлено значение CPM_BANNER_CAMPAIGN. - Добавлен новый тип отчета REACH_AND_FREQUENCY_PERFORMANCE_REPORT, в котором доступны новые поля `AvgCpm`, `AvgImpressionFrequency` и `ImpressionReach`. **10 апреля 2018 г.**   Добавлен сервис [keywordbids](https://yandex.ru/dev/direct/doc/ru/keywordbids/keywordbids.html) для управления ставками и приоритетами ключевых фраз и автотаргетингов. **9 апреля 2018 г.**   В методе [Keywords](https://yandex.ru/dev/direct/doc/ru/keywords/keywords.html).[get](https://yandex.ru/dev/direct/doc/ru/keywords/get.html) отключена возможность получать параметр `Productivity`: всегда возвращается null (nil). В методе [Dictionaries](https://yandex.ru/dev/direct/doc/ru/dictionaries/dictionaries.html).[get](https://yandex.ru/dev/direct/doc/ru/dictionaries/get.html) отключена возможность получать справочник рекомендаций по повышению продуктивности: массив `ProductivityAssertions` не возвращается. **29 марта 2018 г.**   В сервисе [Campaigns](https://yandex.ru/dev/direct/doc/ru/campaigns/campaigns.html) отключена поддержка стратегии IMPRESSIONS_BELOW_SEARCH (для всех типов кампаний). Если передать это значение в параметре [BiddingStrategyType ](*BiddingStrategyType-)структуры `Search`, возвращается ошибка. **19 марта 2018 г.**   Добавлен сервис [Leads](https://yandex.ru/dev/direct/doc/ru/leads/leads.html) для получения данных, введенных пользователями в формы на Турбо-страницах. **26 февраля 2018 г.**   В сервис [Bidmodifiers](https://yandex.ru/dev/direct/doc/ru/bidmodifiers/bidmodifiers.html) добавлена поддержка корректировок ставок по видео. [Подробнее о корректировках](https://yandex.ru/dev/direct/doc/ru/objects/bidmodifier.html) **8 февраля 2018 г.**   В сервис [Reports](https://yandex.ru/dev/direct/doc/ru/reports.html) добавлены значения SMART_MULTIPLE и SMART_SINGLE поля `AdFormat`. **29 января 2018 г.**   В сервис [Reports](https://yandex.ru/dev/direct/doc/ru/reports.html) добавлено поле `CriterionType`. **10 января 2018 г.**   Метод [Clients](https://yandex.ru/dev/direct/doc/ru/clients/clients.html).[get](https://yandex.ru/dev/direct/doc/ru/clients/get.html) теперь позволяет получить параметры агентства и настройки пользователя — представителя агентства. **13 декабря 2017 г.**   В сервис [Ads](https://yandex.ru/dev/direct/doc/ru/ads/ads.html) добавлена поддержка графических объявлений на основе креативов, созданных в конструкторе креативов. [Подробнее о типах объявлений](https://yandex.ru/dev/direct/doc/ru/objects/ad.html) **27 ноября 2017 г.**   Изменено количество баллов, списываемых за вызов методов [bids](https://yandex.ru/dev/direct/doc/ru/bids/bids.html).[get](https://yandex.ru/dev/direct/doc/ru/bids/get.html) и [Keywords](https://yandex.ru/dev/direct/doc/ru/keywords/keywords.html).[get](https://yandex.ru/dev/direct/doc/ru/keywords/get.html). [Подробнее о баллах](https://yandex.ru/dev/direct/doc/ru/concepts/units.html#spend) **13 ноября 2017 г.**   Изменены ошибки, возвращаемые при невозможности выполнения запроса. Вместо ошибки [53](https://yandex.ru/dev/direct/doc/ru/concepts/errors-list.html#e53) возвращаются следующие ошибки: - Если OAuth-токен не указан в запросе или имеет неверный формат (например, содержит недопустимые символы), возвращается ошибка [8000](https://yandex.ru/dev/direct/doc/ru/concepts/errors-list.html#e8000). {% note info %} Если OAuth-токен недействителен, возвращается, как и раньше, ошибка [53](https://yandex.ru/dev/direct/doc/ru/concepts/errors-list.html#e53). {% endnote %} - Если в запросе от имени представителя агентства не указан логин рекламодателя, возвращается ошибка [8000](https://yandex.ru/dev/direct/doc/ru/concepts/errors-list.html#e8000). - Если в заголовке `Client-Login` указан несуществующий логин или логин рекламодателя, не принадлежащего агентству, возвращается ошибка [8800](https://yandex.ru/dev/direct/doc/ru/concepts/errors-list.html#e8800). - Если у пользователя нет доступа к API Директа, возвращается ошибка [3000](https://yandex.ru/dev/direct/doc/ru/concepts/errors-list.html#e3000). **17 октября 2017 г.**   В сервисы [bids](https://yandex.ru/dev/direct/doc/ru/bids/bids.html), [Keywords](https://yandex.ru/dev/direct/doc/ru/keywords/keywords.html) и [Reports](https://yandex.ru/dev/direct/doc/ru/reports.html) добавлена поддержка автотаргетинга. [Подробнее](https://yandex.ru/dev/direct/doc/ru/best-practice/auto-targeting.html) **27 сентября 2017 г.**   В сервис [Reports](https://yandex.ru/dev/direct/doc/ru/reports.html) добавлен заголовок ответа `reportsInQueue` и возможность фильтрации по полю `CampaignType`. **19 сентября 2017 г.**   Добавлена настройка кампании ENABLE_COMPANY_INFO в методы сервиса [Campaigns](https://yandex.ru/dev/direct/doc/ru/campaigns/campaigns.html) (для кампаний с типом «Текстово-графические объявления» и «Динамические объявления»). **11 сентября 2017 г.**   В сервисе [Campaigns](https://yandex.ru/dev/direct/doc/ru/campaigns/campaigns.html) отключена поддержка настройки ENABLE_BEHAVIORAL_TARGETING в структуре `Settings`. **29 августа 2017 г.**   В сервис [Reports](https://yandex.ru/dev/direct/doc/ru/reports.html) добавлена поддержка запросов в формате JSON. **29 августа 2017 г.**   Добавлен метод [AgencyClients](https://yandex.ru/dev/direct/doc/ru/agencyclients/agencyclients.html).[add](https://yandex.ru/dev/direct/doc/ru/agencyclients/add.html) для регистрации новых клиентов агентства и метод [AgencyClients](https://yandex.ru/dev/direct/doc/ru/agencyclients/agencyclients.html).[update](https://yandex.ru/dev/direct/doc/ru/agencyclients/update.html) для редактирования параметров клиентов агентства. Добавлен метод [Clients](https://yandex.ru/dev/direct/doc/ru/clients/clients.html).[update](https://yandex.ru/dev/direct/doc/ru/clients/update.html) для редактирования параметров рекламодателя и настроек пользователя — представителя рекламодателя. **15 августа 2017 г.**   В методы сервиса [Ads](https://yandex.ru/dev/direct/doc/ru/ads/ads.html) добавлен параметр `Title2` для текстово-графических объявлений. Изменены ограничения на количество символов в полях `Title`, `Text` для текстово-графических объявлений, в поле `Text` для динамических объявлений. Внесены изменения в справочник ограничений. Рекомендуем получить обновленный справочник с помощью метода [Dictionaries](https://yandex.ru/dev/direct/doc/ru/dictionaries/dictionaries.html).[get](https://yandex.ru/dev/direct/doc/ru/dictionaries/get.html), указав в запросе имя справочника `Constants`. **7 августа 2017 г.**   Отчет с типом SEARCH_QUERY_PERFORMANCE_REPORT теперь содержит статистику по запросам не только на поиске Яндекса, но и на поисковых площадках РСЯ. Для данного типа отчета также добавлена поддержка поля [Placement](https://yandex.ru/dev/direct/doc/ru/report-format.html#Placement). **7 августа 2017 г.**   В сервисе [Campaigns](https://yandex.ru/dev/direct/doc/ru/campaigns/campaigns.html) отключена поддержка настройки ENABLE_AUTOFOCUS в структуре `Settings`. **4 июля 2017 г.**   Появилась поддержка видеодополнений для текстово-графических объявлений: - В методы сервиса [Ads](https://yandex.ru/dev/direct/doc/ru/ads/ads.html) добавлена структура `VideoExtension`. - В сервис [Reports](https://yandex.ru/dev/direct/doc/ru/reports.html) добавлено значение VIDEO поля `AdFormat`. Подробнее о том, как привязать и отвязать видеодополнение, см. в разделе [launch-campaign](https://yandex.ru/dev/direct/doc/ru/best-practice/launch-campaign.html). **28 июня 2017 г.**   В сервисе [Campaigns](https://yandex.ru/dev/direct/doc/ru/campaigns/campaigns.html) отключена поддержка стратегий LOWEST_COST, LOWEST_COST_GUARANTEE, LOWEST_COST_PREMIUM (для всех типов кампаний). Если одно из этих значений передать в параметре `BiddingStrategyType` структуры `Search`, возвращается ошибка. **22 июня 2017 г.**   В сервисе [Campaigns](https://yandex.ru/dev/direct/doc/ru/campaigns/campaigns.html) изменены настройки показов по дополнительным релевантным фразам для кампаний с типом «Текстово-графические объявления»: - Параметр `BudgetPercent` структуры `RelevantKeywords` поддерживает любые целочисленные значения от 1 до 100. - Параметр `Mode` структуры `RelevantKeywords` не поддерживается, переданное значение игнорируется. - Настройка ENABLE_RELATED_KEYWORDS в структуре `Settings` не поддерживается. В сервис [Reports](https://yandex.ru/dev/direct/doc/ru/reports.html) добавлены поля `MatchedKeyword`, `Criterion`, `CriterionId`. **20 июня 2017 г.**   В сервис [bids](https://yandex.ru/dev/direct/doc/ru/bids/bids.html) добавлена поддержка 4-й позиции в спецразмещении: значение P14 в параметре `Position` массива `AuctionBids`, возвращаемого методом [bids](https://yandex.ru/dev/direct/doc/ru/bids/bids.html).[get](https://yandex.ru/dev/direct/doc/ru/bids/get.html), а также в параметре запроса `Position` метода [bids](https://yandex.ru/dev/direct/doc/ru/bids/bids.html).[setAuto](https://yandex.ru/dev/direct/doc/ru/bids/setAuto.html). **3 мая 2017 г.**   В сервис [Bidmodifiers](https://yandex.ru/dev/direct/doc/ru/bidmodifiers/bidmodifiers.html) добавлена поддержка корректировок ставок по региону показа. [Подробнее о корректировках](https://yandex.ru/dev/direct/doc/ru/objects/bidmodifier.html) **17 апреля 2017 г.**   Добавлен сервис [keywordsresearch](https://yandex.ru/dev/direct/doc/ru/keywordsresearch/keywordsresearch.html) для получения прогноза наличия показов по ключевым фразам. **17 апреля 2017 г.**   В метод [Adgroups](https://yandex.ru/dev/direct/doc/ru/adgroups/adgroups.html).[get](https://yandex.ru/dev/direct/doc/ru/adgroups/add.html) добавлен параметр ответа `RestrictedRegionIds`. **21 марта 2017 г.**   Добавлен сервис [Reports](https://yandex.ru/dev/direct/doc/ru/reports.html) для получения статистики. **6 марта 2017 г.**   Добавлен сервис [AgencyClients](https://yandex.ru/dev/direct/doc/ru/agencyclients/agencyclients.html) для управления клиентами агентства. **28 февраля 2017 г.**   Появилась возможность таргетинга по интересам для рекламы мобильных приложений (см. раздел [audience-target](https://yandex.ru/dev/direct/doc/ru/objects/audience-target.html)): - В методы сервиса [audiencetargets](https://yandex.ru/dev/direct/doc/ru/audiencetargets/audiencetargets.html) добавлен параметр `InterestId`. - В метод [Dictionaries](https://yandex.ru/dev/direct/doc/ru/dictionaries/dictionaries.html).[get](https://yandex.ru/dev/direct/doc/ru/dictionaries/get.html) добавлена возможность получать справочник интересов к категориям мобильных приложений. - В метод [changes](https://yandex.ru/dev/direct/doc/ru/changes/changes.html).[checkDictionaries](https://yandex.ru/dev/direct/doc/ru/changes/checkDictionaries.html) добавлен параметр ответа `InterestsChanged`. **14 февраля 2017 г.**   Добавлена поддержка минус-фраз, содержащих до 7 слов: - в сервисе [Adgroups](https://yandex.ru/dev/direct/doc/ru/adgroups/adgroups.html) — в параметре группы объявлений `NegativeKeywords`; - в сервисе [Campaigns](https://yandex.ru/dev/direct/doc/ru/campaigns/campaigns.html) — в параметре кампании `NegativeKeywords`. **25 января 2017 г.**   - Добавлена поддержка статуса «[Мало показов](https://yandex.ru/dev/direct/doc/ru/objects/adgroup.html)»: в методы [Adgroups](https://yandex.ru/dev/direct/doc/ru/adgroups/adgroups.html).[get](https://yandex.ru/dev/direct/doc/ru/adgroups/add.html), [Keywords](https://yandex.ru/dev/direct/doc/ru/keywords/keywords.html).[get](https://yandex.ru/dev/direct/doc/ru/keywords/get.html) и [bids](https://yandex.ru/dev/direct/doc/ru/bids/bids.html).[get](https://yandex.ru/dev/direct/doc/ru/bids/get.html) добавлен параметр запроса `ServingStatuses` и параметр ответа `ServingStatus`. - В группах со статусом «Мало показов» отключена возможность получать следующие данные по ключевым фразам: - `StatisticsSearch` и `StatisticsNetwork` в методе [Keywords](https://yandex.ru/dev/direct/doc/ru/keywords/keywords.html).[get](https://yandex.ru/dev/direct/doc/ru/keywords/get.html); - `CompetitorsBids`, `SearchPrices`, `ContextCoverage`, `AuctionBids`, `MinSearchPrice`, `CurrentSearchPrice` в методе [bids](https://yandex.ru/dev/direct/doc/ru/bids/bids.html).[get](https://yandex.ru/dev/direct/doc/ru/bids/get.html). **26 декабря 2016 г.**   В кампаниях со стратегией показа в сетях `SERVING_OFF` или `NETWORK_DEFAULT` отключена возможность получать массив `ContextCoverage` в методе [bids](https://yandex.ru/dev/direct/doc/ru/bids/bids.html).[get](https://yandex.ru/dev/direct/doc/ru/bids/get.html). **9 ноября 2016 г.**   Добавлен сервис [Clients](https://yandex.ru/dev/direct/doc/ru/clients/clients.html) для получения сведений о клиентах. **1 ноября 2016 г.**   Добавлена поддержка новой валюты: белорусские рубли (BYN). **17 октября 2016 г.**   {% note alert %} Для рекламодателей, работающих в у. е. и не осуществлявших оплату более года, доступ к аккаунту может быть приостановлен. В этом случае при попытке вызова методов API выдается ошибка [54](https://yandex.ru/dev/direct/doc/ru/concepts/errors-list.html#e54), а в веб-интерфейсе недоступны никакие операции, кроме перевода в валюту. Чтобы возобновить работу, переведите аккаунт в валюту оплаты. Для этого нажмите кнопку **Перевести сейчас** в веб-интерфейсе Директа. Подробнее о процедуре перевода читайте в Справке Директа: [российские рубли](https://yandex.ru/support/direct-tooltips/conversion-rur.html)[российские рубли](https://yandex.com/support/direct-tooltips/conversion-rur.html), [другая валюта](https://yandex.ru/support/direct-tooltips/conversion-currency.html)[другая валюта](https://yandex.com/support/direct-tooltips/conversion-currency.html). {% endnote %} **13 октября 2016 г.**   В методах сервиса [Ads](https://yandex.ru/dev/direct/doc/ru/ads/ads.html) расширен набор возможных значений параметра `Action` (для рекламы мобильных приложений). **13 октября 2016 г.**   Внесены изменения в справочник регионов. Рекомендуем получить обновленный справочник с помощью метода [Dictionaries](https://yandex.ru/dev/direct/doc/ru/dictionaries/dictionaries.html).[get](https://yandex.ru/dev/direct/doc/ru/dictionaries/get.html). В частности, из справочника удалены регионы, перечисленные ниже: - эти регионы больше нельзя указывать при создании и редактировании групп объявлений; - в группах, где были указаны эти регионы, они автоматически заменены набором нижестоящих регионов; - статистика по этим регионам отнесена к вышестоящим регионам. {% cut "Список регионов, которые были удалены" %} #| || **Удален регион** | **В настройках групп заменен набором регионов** | **Статистика отнесена к региону** || || 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 || |# {% endcut %} **12 октября 2016 г. **   Добавлено ограничение для ключевых фраз: длина каждого слова и минус-слова в ключевой фразе — не более 35 символов. **28 сентября 2016 г.**   Добавлен сервис [audiencetargets](https://yandex.ru/dev/direct/doc/ru/audiencetargets/audiencetargets.html) для управления условиями нацеливания на аудиторию и сервис [retargetinglists](https://yandex.ru/dev/direct/doc/ru/retargetinglists/retargetinglists.html) для управления условиями подбора аудитории. [Подробнее о нацеливании на аудиторию](https://yandex.ru/dev/direct/doc/ru/objects/audience-target.html) **20 сентября 2016 г.**   Ориентировочно через две-три недели будут внесены изменения в справочник регионов. После обновления справочника рекомендуем получить его заново с помощью метода [Dictionaries](https://yandex.ru/dev/direct/doc/ru/dictionaries/dictionaries.html).[get](https://yandex.ru/dev/direct/doc/ru/dictionaries/get.html). В частности, из справочника будут удалены регионы, перечисленные ниже: - эти регионы нельзя будет указывать при создании и редактировании групп объявлений; - в группах, где указаны эти регионы, они будут автоматически заменены набором нижестоящих регионов; - статистика по этим регионам будет отнесена к вышестоящим регионам. {% cut "Список регионов, которые будут удалены" %} #| || **Удаляемый регион** | **В настройках групп будет заменен набором регионов** | **Статистика будет отнесена к региону** || || 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 || |# {% endcut %} **8 сентября 2016 г.**   В метод [Ads](https://yandex.ru/dev/direct/doc/ru/ads/ads.html).[get](https://yandex.ru/dev/direct/doc/ru/ads/get.html) добавлено значение PROJECT_DECLARATION параметра `AdCategories`. **6 сентября 2016 г.**   В метод [Adgroups](https://yandex.ru/dev/direct/doc/ru/adgroups/adgroups.html).[get](https://yandex.ru/dev/direct/doc/ru/adgroups/add.html) добавлена возможность получать параметры групп динамических объявлений, для которых источником данных является фид. **22 августа 2016 г.**   В сервис [Ads](https://yandex.ru/dev/direct/doc/ru/ads/ads.html) добавлена поддержка графических объявлений. [Подробнее о типах объявлений](https://yandex.ru/dev/direct/doc/ru/objects/ad.html) Добавлен сервис [adimages](https://yandex.ru/dev/direct/doc/ru/ad_assets/adimages.html) для управления изображениями. Сервис поддерживает размеры изображений для использования в графических объявлениях. [Подробнее об изображениях](https://yandex.ru/dev/direct/doc/ru/objects/adimage.html) **11 августа 2016 г.**   В метод [Keywords](https://yandex.ru/dev/direct/doc/ru/keywords/keywords.html).[get](https://yandex.ru/dev/direct/doc/ru/keywords/get.html) добавлен параметр запроса `ModifiedSince`. **2 июня 2016 г. **   В сервисе [Bidmodifiers](https://yandex.ru/dev/direct/doc/ru/bidmodifiers/bidmodifiers.html) изменены допустимые значения коэффициентов в корректировках ставок по полу и возрасту и для посетивших сайт. **23 мая 2016 г.**   Появилась возможность расходовать баллы агентства, а не рекламодателя при выполнении запроса от имени представителя агентства. [Подробнее о баллах](https://yandex.ru/dev/direct/doc/ru/concepts/units.html) **10 мая 2016 г.**   В метод [adextensions](https://yandex.ru/dev/direct/doc/ru/adextensions/adextensions.html).[get](https://yandex.ru/dev/direct/doc/ru/adextensions/get.html) добавлены параметры запроса `States` и `ModifiedSince` и параметры ответа `State` и `Associated`. **18 апреля 2016 г.**   Добавлен параметр `DisplayUrlPath` в методы сервиса [Ads](https://yandex.ru/dev/direct/doc/ru/ads/ads.html), а также параметр `DisplayUrlPathModeration` в ответ метода [Ads](https://yandex.ru/dev/direct/doc/ru/ads/ads.html).[get](https://yandex.ru/dev/direct/doc/ru/ads/get.html) для текстово-графических объявлений. **14 апреля 2016 г.**   В метод [Dictionaries](https://yandex.ru/dev/direct/doc/ru/dictionaries/dictionaries.html).[get](https://yandex.ru/dev/direct/doc/ru/dictionaries/get.html) добавлена возможность получать наименования внешних сетей (SSP). **30 марта 2016 г.**   Параметр кампании `ExcludedSites` теперь поддерживает внешние сети (SSP). **29 марта 2016 г.**   - Добавлен сервис [adextensions](https://yandex.ru/dev/direct/doc/ru/adextensions/adextensions.html) для управления расширениями к объявлениям. В настоящее время доступен один тип расширения — уточнение. [Подробнее об уточнениях](https://yandex.ru/dev/direct/doc/ru/objects/adextension.html) В сервис [Ads](https://yandex.ru/dev/direct/doc/ru/ads/ads.html) добавлена поддержка уточнений для текстово-графических объявлений и динамических текстовых объявлений. [Подробнее об объявлениях](https://yandex.ru/dev/direct/doc/ru/objects/ad.html) - В сервис [Ads](https://yandex.ru/dev/direct/doc/ru/ads/ads.html) добавлена поддержка изображений для объявлений с типом «Реклама мобильных приложений». - Добавлен сервис [Dictionaries](https://yandex.ru/dev/direct/doc/ru/dictionaries/dictionaries.html) для получения справочных данных: регионов, часовых поясов, курсов валют, станций метрополитена, ограничений на значения параметров и др. **14 марта 2016 г.**   Параметр кампании `BudgetPercent` больше не поддерживает значение –1. Чтобы расход по дополнительным релевантным фразам был неограничен (в рамках бюджета кампании), используйте значение 100. **25 февраля 2016 г.**   Добавлена настройка кампании `ENABLE_AREA_OF_INTEREST_TARGETING` в методы сервиса [Campaigns](https://yandex.ru/dev/direct/doc/ru/campaigns/campaigns.html) (для всех типов кампаний). **16 февраля 2016 г.**   Добавлен параметр кампании `OptimizeGoalId` в методы сервиса [Campaigns](https://yandex.ru/dev/direct/doc/ru/campaigns/campaigns.html) (для кампаний с типом «Текстово-графические объявления»). **9 февраля 2016 г.**   Изменены ограничения для ключевых фраз. Теперь группа объявлений может содержать не более 200 фраз, длина каждой фразы — не более 4096 символов. **13 января 2016 г.**   В метод [Adgroups](https://yandex.ru/dev/direct/doc/ru/adgroups/adgroups.html).[get](https://yandex.ru/dev/direct/doc/ru/adgroups/add.html) добавлен параметр `DomainUrlProcessingStatus`. **11 января 2016 г. **   В сервисе [Bidmodifiers](https://yandex.ru/dev/direct/doc/ru/bidmodifiers/bidmodifiers.html) изменены допустимые значения коэффициентов в корректировках ставок по полу и возрасту и для посетивших сайт. **15 декабря 2015 г.**   Добавлен сервис [dynamictextadtargets](https://yandex.ru/dev/direct/doc/ru/dynamictextadtargets/dynamictextadtargets.html) для управления условиями нацеливания для динамических текстовых объявлений. [Подробнее](https://yandex.ru/dev/direct/doc/ru/objects/dynamictextadtarget.html) В сервис [Campaigns](https://yandex.ru/dev/direct/doc/ru/campaigns/campaigns.html) добавлена поддержка кампаний для динамических текстовых объявлений. [Подробнее о кампаниях](https://yandex.ru/dev/direct/doc/ru/objects/campaign.html) В сервис [Adgroups](https://yandex.ru/dev/direct/doc/ru/adgroups/adgroups.html) добавлена поддержка групп для динамических текстовых объявлений. [Подробнее о группах](https://yandex.ru/dev/direct/doc/ru/objects/adgroup.html) В сервис [Ads](https://yandex.ru/dev/direct/doc/ru/ads/ads.html) добавлена поддержка динамических текстовых объявлений. [Подробнее об объявлениях](https://yandex.ru/dev/direct/doc/ru/objects/ad.html) В метод [bids](https://yandex.ru/dev/direct/doc/ru/bids/bids.html).[get](https://yandex.ru/dev/direct/doc/ru/bids/get.html) добавлена возможность постраничной выборки данных. **9 ноября 2015 г.**   В метод [Keywords](https://yandex.ru/dev/direct/doc/ru/keywords/keywords.html).[get](https://yandex.ru/dev/direct/doc/ru/keywords/get.html) добавлена возможность получать количество показов и кликов по ключевой фразе за 28 дней. В метод [Keywords](https://yandex.ru/dev/direct/doc/ru/keywords/keywords.html).[add](https://yandex.ru/dev/direct/doc/ru/keywords/add.html) добавлена возможность назначать ставку или приоритет для создаваемой ключевой фразы. **26 октября 2015 г.**   - Добавлен сервис [Campaigns](https://yandex.ru/dev/direct/doc/ru/campaigns/campaigns.html) для управления кампаниями. Сервис поддерживает кампании для рекламы мобильных приложений. [Подробнее о кампаниях](https://yandex.ru/dev/direct/doc/ru/objects/campaign.html) В сервис [Adgroups](https://yandex.ru/dev/direct/doc/ru/adgroups/adgroups.html) добавлена поддержка групп для рекламы мобильных приложений. [Подробнее о группах](https://yandex.ru/dev/direct/doc/ru/objects/adgroup.html) В сервис [Ads](https://yandex.ru/dev/direct/doc/ru/ads/ads.html) добавлена поддержка объявлений для рекламы мобильных приложений. [Подробнее об объявлениях](https://yandex.ru/dev/direct/doc/ru/objects/ad.html) - В методы [Sitelinks](https://yandex.ru/dev/direct/doc/ru/sitelinks/sitelinks.html).[add](https://yandex.ru/dev/direct/doc/ru/sitelinks/add.html) и [Sitelinks](https://yandex.ru/dev/direct/doc/ru/sitelinks/sitelinks.html).[get](https://yandex.ru/dev/direct/doc/ru/sitelinks/get.html) добавлен параметр `Description`. **30 сентября 2015 г.**   В метод [bids](https://yandex.ru/dev/direct/doc/ru/bids/bids.html).[setAuto](https://yandex.ru/dev/direct/doc/ru/bids/setAuto.html) добавлена возможность рассчитывать ставки на поиске на основе минимальной ставки за второе место в спецразмещении. **8 сентября 2015 г.**   Добавлен сервис [Bidmodifiers](https://yandex.ru/dev/direct/doc/ru/bidmodifiers/bidmodifiers.html) для управления корректировками ставок. [Подробнее о корректировках](https://yandex.ru/dev/direct/doc/ru/objects/bidmodifier.html) **1 сентября 2015 г.**   В метод [bids](https://yandex.ru/dev/direct/doc/ru/bids/bids.html).[get](https://yandex.ru/dev/direct/doc/ru/bids/get.html) добавлена возможность получать результаты торгов нового аукциона: минимальную ставку за каждую позицию и списываемую цену на каждой позиции. Если во входном параметре `FieldsNames` указано значение AuctionBids, метод будет возвращать массив `AuctionBids`. **26 июня 2015 г.** Старт!