--- 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/en/llms.txt # API version 5. History **March 20, 2026** Added a new [ad type](https://yandex.ru/dev/direct/doc/en/objects/ad): combinatorial ad. The [Ads](https://yandex.ru/dev/direct/doc/en/ads/ads) service provides a description of the methods for managing it. **November 13, 2025** The toggle method of the [BidModifiers](https://yandex.ru/dev/direct/doc/ru/bidmodifiers/bidmodifiers.html) service is now obsolete and no longer supported. **October 26, 2025** Added a new adjustment `SmartTvAdjustment` to the [BidModifiers](https://yandex.ru/dev/direct/doc/ru/bidmodifiers/bidmodifiers.html) service. **September 16, 2025**   New `MAX_PROFIT` strategy added to the [Campaigns](https://yandex.ru/dev/direct/doc/ru/campaigns/campaigns) and [Strategies](https://yandex.ru/dev/direct/doc/ru/strategies/strategies) services for "Text & Image Ads" and "UPC" campaigns. **June 19, 2025** Added the [addPassportOrganizationMember](https://yandex.ru/dev/direct/doc/ru/agencyclients/agencyclients) method to the [AgencyClients](https://yandex.ru/dev/direct/doc/ru/agencyclients/addPassportOrganizationMember) service. **June 16, 2025** The [AgencyClients](https://yandex.ru/dev/direct/doc/ru/agencyclients/agencyclients.html) service no longer supports the [add](https://yandex.ru/dev/direct/doc/ru/agencyclients/add.html) method. Use the [addPassportOrganization](https://yandex.ru/dev/direct/doc/ru/agencyclients/addPassportOrganization.html) method instead. **June 6, 2025**   New strategies added to the [Campaigns](https://yandex.ru/dev/direct/doc/ru/campaigns/campaigns) and [Strategies](https://yandex.ru/dev/direct/doc/ru/strategies/strategies) services for "Text & Image Ads" and "UPC" campaigns: - `AVERAGE_CPA_MULTIPLE_GOALS` - `PAY_FOR_CONVERSION_MULTIPLE_GOALS` **June 2, 2025**   Updated settings requirements for apps being registered. To manage organizations in Yandex ID, add the passport:business permission in your [app settings](https://oauth.yandex.ru/client/edit/). **May 19, 2025** Added the [addPassportOrganization](https://yandex.ru/dev/direct/doc/ru/agencyclients/agencyclients) method to the [AgencyClients](https://yandex.ru/dev/direct/doc/ru/agencyclients/addPassportOrganization) service.   **March 14, 2025**   Added the `DynamicPlaces` field to the [Campaigns](https://yandex.ru/dev/direct/doc/ru/campaigns/campaigns.html) service's methods. **February 18, 2025**   Added the `CommonMinusWords` field to the [CreateNewForecast](https://yandex.ru/dev/direct/doc/dg-v4/ru/live/CreateNewForecast.html) and [GetForecast](https://yandex.ru/dev/direct/doc/dg-v4/ru/live/GetForecast) methods. **November 12, 2024**   Added the `ALTERNATIVE_TEXTS_ENABLED` setting to the [Campaigns](https://yandex.ru/dev/direct/doc/ru/campaigns/campaigns.html) service's methods for unified performance campaigns. **August 1, 2024**   Added the `Maps` and `SearchOrganizationList` fields to methods of the [Campaigns](https://yandex.ru/dev/direct/doc/ru/campaigns/campaigns.html) service for unified performance campaigns. **July 1, 2024**   Disabled manual bid management in the Yandex Advertising Network. **April 24, 2024**   Added [instructions](../unified-campaign-update.html) on upgrading to a unified performance campaign. **March 22, 2024**   Added the `ListingAd` structure to the [Ads](https://yandex.ru/dev/direct/doc/ru/ads/ads.html) service. Added the `CustomPeriodBudget` structure to the methods of the [Campaigns](https://yandex.ru/dev/direct/doc/ru/campaigns/campaigns.html) and [Strategies](https://yandex.ru/dev/direct/doc/ru/strategies/strategies.html) services. **December 26, 2023**   Added the `NegativeKeywordSharedSetIds` structure to the [Campaigns](https://yandex.ru/dev/direct/doc/ru/campaigns/campaigns.html) service. **November 27, 2023**   Added support for [unified performance campaigns](https://yandex.ru/support/direct/en/unified-performance-campaign/about): - Added the `UnifiedCampaign` structure to the [Campaigns](https://yandex.ru/dev/direct/doc/ru/campaigns/campaigns.html) service. - Added the `UnifiedAdGroup` structure to the [AdGroups](https://yandex.ru/dev/direct/doc/ru/adgroups/adgroups.html) service. - Added the `ShoppingAd` structure to the [Ads](https://yandex.ru/dev/direct/doc/ru/ads/ads.html) service. - Added a new adjusment `AD_GROUP_ADJUSTMENT` to the [BidModifiers](https://yandex.ru/dev/direct/doc/ru/bidmodifiers/bidmodifiers.html) service (a group-level adjustment available for a unified performance group). - New parameters added to the [Reports](https://yandex.ru/dev/direct/doc/ru/reports.html) service: - Added `UNIFIED_CAMPAIGN` to the `CampaignType` field. - Added `OFFER_RETARGETING` to the `CriterionType` field. **November 21, 2023**   Added the `AutotargetingSettings` structure to the [Keywords](https://yandex.ru/dev/direct/doc/ru/keywords/keywords.html) service. Updated the autotargeting workflow diagram. **October 2, 2023**   Added the [getGeoRegions](https://yandex.ru/dev/direct/doc/ru/dictionaries/getGeoRegions.html) method to the [Dictionaries](https://yandex.ru/dev/direct/doc/ru/dictionaries/dictionaries.html) service. **September 19, 2023**   Added the `ExplorationBudget` structure to methods of the [Campaigns](https://yandex.ru/dev/direct/doc/ru/campaigns/campaigns.html) and [Strategies](https://yandex.ru/dev/direct/doc/ru/strategies/strategies.html) services. **September 11, 2023**   Added the `AutotargetingSearchBidIsAuto` field to the methods of the [Bids](https://yandex.ru/dev/direct/doc/ru/bids/bids.html), [KeywordBids](https://yandex.ru/dev/direct/doc/ru/keywordbids/keywordbids.html), and [Keywords](https://yandex.ru/dev/direct/doc/ru/keywords/keywords.html) services. This field indicates whether [automatic bids](https://yandex.ru/support/direct/en/impression-criteria/autotargeting#autotargeting__auto-bids) are enabled. **August 2, 2023**   Added the [Strategies](https://yandex.ru/dev/direct/doc/ru/strategies/strategies.html) service for working with portfolio strategies. **July 4, 2023**   Added the `GetRegionNames` structure to the [get](https://yandex.ru/dev/direct/doc/ru/dictionaries/get.html) method for the [AdImages](https://yandex.ru/dev/direct/doc/ru/dictionaries/dictionaries.html) service. **April 13, 2023**   Added the `Type` field to the [add](https://yandex.ru/dev/direct/doc/ru/ad_assets/add.html) method for the [AdImages](https://yandex.ru/dev/direct/doc/ru/ad_assets/adimages.html) service. **March 24, 2023**   Added the `ForbiddenPlatform` and `AvailableCampaignTypes` fields to the methods for the [AgencyClients](https://yandex.ru/dev/direct/doc/ru/agencyclients/agencyclients.html) and [Clients](https://yandex.ru/dev/direct/doc/ru/clients/clients.html) services. **September 6, 2022**   Added the `TrackingParams` field to [Campaigns](https://yandex.ru/dev/direct/doc/ru/campaigns/campaigns.html) methods (for "Text & Image ads", "Dynamic ads", and "Smart banners" campaigns). **August 15, 2022**   Added `TinInfo` and `ErirAttributes` structures to methods of the [Agencyclients](https://yandex.ru/dev/direct/doc/ru/agencyclients/agencyclients.html) and [Clients](https://yandex.ru/dev/direct/doc/ru/clients/clients.html) services. **July 19, 2022**   Added new `Subtype` parameter values to the [AdImages](https://yandex.ru/dev/direct/doc/ru/ad_assets/adimages.html) service. **July 13, 2022**   Added a new role for the [Direct advertiser](https://yandex.ru/dev/direct/doc/ru/objects/roles.html) and [Advertiser — agency client](https://yandex.ru/dev/direct/doc/ru/objects/roles.html) users: [Representative (read only)](*Представитель-(только-чтение)).   Added a new value for the `Role` parameter in the [Clients](https://yandex.ru/dev/direct/doc/ru/clients/get.html) and [AgencyClients](https://yandex.ru/dev/direct/doc/ru/agencyclients/get.html) services. **April 29, 2022**   Added the `CampaignUrlPath` field to the [Reports](https://yandex.ru/dev/direct/doc/ru/reports.html) service. **April 18, 2022**   Added to the [Reports](https://yandex.ru/dev/direct/doc/ru/reports.html) service: - `ClientLogin` field. - Added the `Offset` field to the `Page` structure. **April 13, 2022**   For [Dynamic ads](https://yandex.ru/dev/direct/doc/ru/campaigns/campaigns.html) "campaigns", now you can select a targeting category (the `AutotargetingCategories` structure). **March 29, 2022**   Added the `IsMetrikaSourceOfValue` field to the `PriorityGoals` structure of the [Campaigns](https://yandex.ru/dev/direct/doc/ru/campaigns/campaigns.html) service — for campaigns with the `AVERAGE_CRR` strategy. **March 25, 2022**   Added new adjustment types to the [BidModifiers](https://yandex.ru/dev/direct/doc/ru/bidmodifiers/bidmodifiers.html) service: - TABLET_ADJUSTMENT: Adjustment on tablets. - DESKTOPS_ONLY_ADJUSTMENT: Adjustment only on desktops. **January 26, 2022**   Added the [AdVideos](https://yandex.ru/dev/direct/doc/ru/advideos/advideos.html) service. **January 14, 2022**   The `NETWORK_DEFAULT` and `MAINTAIN_NETWORK_CPC` parameters will soon be discontinued in [Campaigns](https://yandex.ru/dev/direct/doc/ru/campaigns/campaigns.html). Please update your applications before the end of January 2022. **November 22, 2021**   The [Campaigns](https://yandex.ru/dev/direct/doc/ru/campaigns/campaigns.html) service now supports the `PlacementTypes` setting (ad placements in search results) for campaigns with the "Dynamic ads" type. **November 19, 2021**   New parameters added to the [Reports](https://yandex.ru/dev/direct/doc/ru/reports.html) service: - PRODUCT_EXTENSIONS, MARKET: To the `ClickType` field. - PRODUCT_GALLERY: To the `Slot` field. **November 12, 2021**   [Reports](https://yandex.ru/dev/direct/doc/ru/reports.html) are now also available for campaigns created in the Campaign Wizard. **November 1, 2021**   Added a new type of adjustment to the [BidModifiers](https://yandex.ru/dev/direct/doc/ru/bidmodifiers/bidmodifiers.html) service: - INCOME_GRADE_ADJUSTMENT: Adjustment for income. **October 25, 2021**   Added the `VideoTarget` parameter to [Campaigns](https://yandex.ru/dev/direct/doc/ru/campaigns/campaigns.html) methods (for campaigns with the "Display campaign" type). **October 20, 2021**   In the [AdGroups](https://yandex.ru/dev/direct/doc/ru/adgroups/adgroups.html) service, you can now create a group of Text & Image ads based on a feed: - Added the `TextAdGroupFeedParams` structure to the [add](https://yandex.ru/dev/direct/doc/ru/adgroups/add.html) method. - Added the `TextAdGroupFeedParamsFieldNames` parameter to the [get](https://yandex.ru/dev/direct/doc/ru/adgroups/add.html) method. - Added the `TextAdGroupFeedParamsUpdate` structure to the [update](https://yandex.ru/dev/direct/doc/ru/adgroups/add.html) method. **October 14, 2021**   Added a new type of adjustment to the [BidModifiers](https://yandex.ru/dev/direct/doc/ru/bidmodifiers/bidmodifiers.html) service: - SERP_LAYOUT_ADJUSTMENT: Adjustment for exclusive placement. **October 7, 2021**   Disabled support for the `WEEKLY_CLICK_PACKAGE` option in [Campaigns](https://yandex.ru/dev/direct/doc/ru/campaigns/campaigns.html). **September 3, 2021**   In the [Keywords](https://yandex.ru/dev/direct/doc/ru/keywords/keywords.html) service, you can now select the targeting category (the `AutotargetingCategories` structure). The `TargetingCategory` field was added to the [Reports](https://yandex.ru/dev/direct/doc/ru/reports.html) service. **August 2, 2021**   In the [Ads](https://yandex.ru/dev/direct/doc/ru/ads/ads.html) service, you can now add a [video extension](https://yandex.ru/support/direct/features/video-extension.html)[video extension](https://yandex.com/support/direct/features/video-extension.html) to [ads](https://yandex.ru/dev/direct/doc/ru/objects/ad.html) with the MOBILE_APP_AD type: - The `VideoExtension` structure was added to the [add](https://yandex.ru/dev/direct/doc/ru/ads/add.html), [get](https://yandex.ru/dev/direct/doc/ru/ads/get.html), and [update](https://yandex.ru/dev/direct/doc/ru/ads/update.html) methods. **July 13, 2021**   In the [Campaigns](https://yandex.ru/dev/direct/doc/ru/campaigns/campaigns.html) service, you now have a new strategy `PAY_FOR_CONVERSION_CRR` for campaigns with the "Text & Image Ads", "Dynamic ads", and "Smart banners" type. The strategy will bring you conversions at a cost equal to the specified percentage of the revenue transferred for the goal. **June 23, 2021**   Added the [DynamicFeedAdTargets](https://yandex.ru/dev/direct/doc/ru/dynamicfeedadtargets/dynamicfeedadtargets.html) service for managing dynamic feed ad targets. **June 2, 2021**   New strategy in the [Campaigns](https://yandex.ru/dev/direct/doc/ru/campaigns/campaigns.html) service: - `AVERAGE_CRR` for "Text & Image Ads", "Dynamic ads" and "Smart banners" campaigns. You can use this strategy to get the maximum number of conversions for the selected goal, while maintaining the specified cost revenue ratio. **May 28, 2021**   Added the `FilterSchema` parameter to the [Feeds](https://yandex.ru/dev/direct/doc/ru/feeds/feeds.html) service. This parameter specifies the name of the schema for filter creation. **May 24, 2021**   In the [AdGroups](https://yandex.ru/dev/direct/doc/ru/adgroups/adgroups.html) service, you can now create a group of dynamic ads with the FEED subtype using the API: - Added the `DynamicTextFeedAdGroupAdd` structure with the `FeedId` field to the [add](https://yandex.ru/dev/direct/doc/ru/adgroups/add.html) method. - Added the `FeedId` field to the `DynamicTextFeedAdGroupFieldNames` parameter of the [get](https://yandex.ru/dev/direct/doc/ru/adgroups/add.html) method. **May 13, 2021**   Added the `IsAdaptive` parameter to the [Creatives](https://yandex.ru/dev/direct/doc/ru/creatives/creatives.html) service methods. **April 13, 2021**   New strategies added to the [Campaigns](https://yandex.ru/dev/direct/doc/ru/campaigns/campaigns.html) service for "Display campaigns": - `CP_AVERAGE_CPV` - `WB_AVERAGE_CPV` Strategies let you get the maximum number of video views over a given period within a given budget. **April 8, 2021**   New strategy in the [Campaigns](https://yandex.ru/dev/direct/doc/ru/campaigns/campaigns.html) service: - `PAY_FOR_CONVERSION_PER_FILTER`: For "Smart banner" campaigns. The strategy will bring you conversions at the CPA specified on strategy setup. **March 31, 2021**   Added information about bonuses to be credited (the `Bonuses` parameter) to the [AgencyClients](https://yandex.ru/dev/direct/doc/ru/agencyclients/agencyclients.html) and [Clients](https://yandex.ru/dev/direct/doc/ru/clients/clients.html) services. **March 26, 2021**   Support for the ENABLE_EXTENDED_AD_TITLE option was disabled in the [Campaigns](https://yandex.ru/dev/direct/doc/ru/campaigns/campaigns.html) service. This option will be ignored in all API requests. **March 16, 2021**   Added the campaign setting CAMPAIGN_EXACT_PHRASE_MATCHING_ENABLED to the [Campaigns](https://yandex.ru/dev/direct/doc/ru/campaigns/campaigns.html) service methods (for the following campaign types: "Text & Image ads", "Dynamic ads", and "Ads for mobile apps"). **March 3, 2021**   New strategy in the [Campaigns](https://yandex.ru/dev/direct/doc/ru/campaigns/campaigns.html) service: - `PAY_FOR_INSTALL`: For "Ads for mobile apps" campaigns. The strategy lets you get conversions at a fixed price per app install. **February 8, 2021**   Added support for video ads in "Ads for mobile apps" campaigns: - The [Ads](https://yandex.ru/dev/direct/doc/ru/ads/ads.html) service now supports ads with the MOBILE_APP_CPC_VIDEO_AD_BUILDER_AD subtype. **February 2, 2021**   The [Reports](https://yandex.ru/dev/direct/doc/ru/reports.html) service now has the `AvgEffectiveBid` field. **December 4, 2020**   Added the KEYWORD value for the `MatchType` field in [Reports](https://yandex.ru/dev/direct/doc/ru/reports.html). **September 28, 2020**   In the [TurboPages](https://yandex.ru/dev/direct/doc/ru/turbopages/turbopages.html) service, you can now search for Turbo pages using the link associated with them. Added new parameters: `BoundWithHref`, `TurboSiteHref`. **August 26, 2020**   In the [Campaigns](https://yandex.ru/dev/direct/doc/ru/campaigns/campaigns.html) service in the strategies `AVERAGE_CPA_PER_CAMPAIGN` and `AVERAGE_CPA_PER_FILTER`, the parameter `AverageCpa` (for `AVERAGE_CPA_PER_CAMPAIGN`)/`FilterAverageCpa` (for `AVERAGE_CPA_PER_FILTER`) is mandatory. The `AverageCpc`/`FilterAverageCpc` parameter is no longer used. **July 17, 2020**   In the [Campaigns](https://yandex.ru/dev/direct/doc/ru/campaigns/campaigns.html) service, you can't optimize for all goals in the strategies `WB_MAXIMUM_CONVERSION_RATE`, `AVERAGE_ROI`, and `AVERAGE_CPA`. Use the `GoalId` parameter for these strategies to pass the ID of a specific Yandex Metrica goal. **July 16, 2020**   In the [Campaigns](https://yandex.ru/dev/direct/doc/ru/campaigns/campaigns.html) service, you can now optimize for all priority goals in the `WB_MAXIMUM_CONVERSION_RATE` strategy (the `GoalId:13` parameter). **June 29, 2020**   Added the PHONE value for the `ClickType` field in the [Reports](https://yandex.ru/dev/direct/doc/ru/reports.html) service. **June 8, 2020**   The [Campaigns](https://yandex.ru/dev/direct/doc/ru/campaigns/campaigns.html) service has new strategies: - `PAY_FOR_CONVERSION`: For "Text & Image ads" and "Dynamic ads" campaigns. - `PAY_FOR_CONVERSION_PER_CAMPAIGN`: For "Smart banner" campaigns. These strategies will produce conversions for the price specified when setting up the strategy. **June 2, 2020**   Changed the value of the bid coefficient for ads on mobile devices (`BidModifier` parameter). **March 26, 2020**   For all advertising campaigns other than "Smart banner" campaigns, there is no longer a limit on the number of linked tags (the `CounterIds` parameter for the [Campaigns](https://yandex.ru/dev/direct/doc/ru/campaigns/campaigns.html) service). **March 25, 2020**   Added support for business profiles from [Yandex Business](https://yandex.ru/sprav/)[Yandex Business](https://yandex.com/sprav/): - Added the [Businesses](https://yandex.ru/dev/direct/doc/ru/businesses/businesses.html) service for getting the profiles of an advertiser's businesses. - Methods for the [Ads](https://yandex.ru/dev/direct/doc/ru/ads/ads.html) service now have the `BusinessId` parameter for Text & Image ads. **March 16, 2020**   Added support for smart banners: - Added the [Feeds](https://yandex.ru/dev/direct/doc/ru/feeds/feeds.html) service for managing files with product offers. - Added the [SmartAdTargets](https://yandex.ru/dev/direct/doc/ru/smartadtargets/smartadtargets.html) service for managing filters to select targeting criteria for smart banners. - The [AdGroups](https://yandex.ru/dev/direct/doc/ru/adgroups/adgroups.html) service now supports ad groups with the SMART_AD_GROUP type. - The [Creatives](https://yandex.ru/dev/direct/doc/ru/creatives/creatives.html) service now supports the creatives with the SMART_CREATIVE type. - The [Ads](https://yandex.ru/dev/direct/doc/ru/ads/ads.html) service now supports ads with the SMART_AD type. - The [BidModifiers](https://yandex.ru/dev/direct/doc/ru/bidmodifiers/bidmodifiers.html) service now supports for bid adjustments with the SMART_AD_ADJUSTMENT type. [Learn more about managing smart banners](https://yandex.ru/dev/direct/doc/ru/best-practice/smart-ads.html) **February 25, 2020**   All API services now support the `Accept-Encoding: gzip` header. **February 25, 2020**   The [Reports](https://yandex.ru/dev/direct/doc/ru/reports.html) service has the new SMART_TILE value for the `AdFormat` field. **February 6, 2020**   The [AgencyClients](https://yandex.ru/dev/direct/doc/ru/agencyclients/agencyclients.html).[get](https://yandex.ru/dev/direct/doc/ru/agencyclients/get.html) and [Clients](https://yandex.ru/dev/direct/doc/ru/clients/clients.html).[get](https://yandex.ru/dev/direct/doc/ru/clients/get.html) methods have new values for the `Element` parameter: GENERAL_DOMAIN_BLACKLIST_SIZE and VIDEO_DOMAIN_BLACKLIST_SIZE. **January 15, 2020**   The [Reports](https://yandex.ru/dev/direct/doc/ru/reports.html) service has the new ADAPTIVE_IMAGE value for the `AdFormat` field. **December 19, 2019**   Added targeting by user interests for Text & Image ads: - For a TEXT_AD_GROUP group, you can add an audience target with a retargeting list that has the AUDIENCE type and contains only audience segments based on short-term interests. - The response for the [RetargetingLists](https://yandex.ru/dev/direct/doc/ru/retargetinglists/retargetinglists.html).[get](https://yandex.ru/dev/direct/doc/ru/retargetinglists/get.html) method now includes the `AvailableForTargetsInAdGroupTypes` parameter. For details, see [RetargetingLists](https://yandex.ru/dev/direct/doc/ru/objects/retargeting-list.html). **December 2, 2019**   In the [Reports](https://yandex.ru/dev/direct/doc/ru/reports.html) service, the "Smart banners" campaign type was changed to SMART_CAMPAIGN in the `CampaignType` field. **November 22, 2019**   The `AVERAGE_ROI` strategy now provides optimization for priority goals. The `GoalId` parameter in the `AverageRoi` structure accepts the new value 13. **November 11, 2019**   The [Dictionaries](https://yandex.ru/dev/direct/doc/ru/dictionaries/dictionaries.html).[get](https://yandex.ru/dev/direct/doc/ru/dictionaries/get.html) rmethod returns the new parameter `MinimumAccountDailyBudget` (the minimum daily budget of the shared account) in the `Currencies` reference list. The `MinimumPayment` currency parameter, which previously combined both the minimum payment (without VAT) and the minimum daily budget of the shared account, should now be used only for the minimum payment amount. **October 1, 2019**   Changes in the [Campaigns](https://yandex.ru/dev/direct/doc/ru/campaigns/campaigns.html).[get](https://yandex.ru/dev/direct/doc/ru/campaigns/get.html) method: values of the return parameters `SharedAccountFunds`.`Spend` and `CampaignFunds`.`Sum` now include VAT. **September 25, 2019**   In the [Campaigns](https://yandex.ru/dev/direct/doc/ru/campaigns/campaigns.html) service, the default value for `ADD_METRICA_TAG` in the `Settings` structure has changed from NO to YES. **September 17, 2019**   Attribution models available in the API: - Methods of the [Campaigns](https://yandex.ru/dev/direct/doc/ru/campaigns/campaigns.html) service now have the `AttributionModel` parameter for "Text & Image Ads" and "Dynamic ads" campaigns. - The [Reports](https://yandex.ru/dev/direct/doc/ru/reports.html) service for the `AttributionModels` input parameter has the new LYDC value: "Last click from Yandex Direct". Statistics for the new attribution model are available starting from July 30, 2019. **September 9, 2019**   Changes in the [Sitelinks](https://yandex.ru/dev/direct/doc/ru/sitelinks/sitelinks.html) service: now each set of sitelinks can contain up to 8 sitelinks. **August 28, 2019**   The [Campaigns](https://yandex.ru/dev/direct/doc/ru/campaigns/campaigns.html) service now supports priority goals for "Dynamic ads" campaigns. The `PriorityGoals` structure has been added to the `DynamicTextCampaign` structure. **August 22, 2019**   The [Campaigns](https://yandex.ru/dev/direct/doc/ru/campaigns/campaigns.html) service has new settings for strategies: - The `BidPercent` parameter was removed from the `NetworkDefault` structure. The [add](https://yandex.ru/dev/direct/doc/ru/campaigns/add.html) and [update](https://yandex.ru/dev/direct/doc/ru/campaigns/update.html) methods return an error when trying to set it, and the [get](https://yandex.ru/dev/direct/doc/ru/campaigns/get.html) method no longer returns it. - The `LimitPercent` parameter in the `NetworkDefault` structure is used only when the search strategy is set to HIGHEST_POSITION. If an automatic strategy is selected for search: - The [add](https://yandex.ru/dev/direct/doc/ru/campaigns/add.html) and [update](https://yandex.ru/dev/direct/doc/ru/campaigns/update.html) methods ignore the passed value and issue a warning. To enable the strategy in NETWORK_DEFAULT networks, you need to pass an empty `NetworkDefault` structure. - The [get](https://yandex.ru/dev/direct/doc/ru/campaigns/get.html) method doesn't return the `NetworkDefault` structure. - The `MAINTAIN_NETWORK_CPC` setting in the `Settings` structure is used only when the search strategy is set to HIGHEST_POSITION and the strategy for ad networks is NETWORK_DEFAULT. In all other cases, the [add](https://yandex.ru/dev/direct/doc/ru/campaigns/add.html) and [update](https://yandex.ru/dev/direct/doc/ru/campaigns/update.html) methods ignore the passed value and show a warning, and the [get](https://yandex.ru/dev/direct/doc/ru/campaigns/get.html) method doesn't return `MAINTAIN_NETWORK_CPC`. To learn how the API strategies correspond to the updated strategies in the web interface, see [Strategies](https://yandex.ru/dev/direct/doc/ru/annex/strategies.html). **July 23, 2019**   Image ads: Uzbekistan som. Methods of the [Ads](https://yandex.ru/dev/direct/doc/ru/ads/ads.html) service now accept the value UZS for the `PriceCurrency` parameter. **July 11, 2019**   Support for sets of negative keywords: - New [NegativeKeywordSharedSets](https://yandex.ru/dev/direct/doc/ru/negativekeywordsharedsets/negativekeywordsharedsets.html) service for managing sets of negative keywords. - Methods of the [AdGroups](https://yandex.ru/dev/direct/doc/ru/adgroups/adgroups.html) service have the new `NegativeKeywordSharedSetIds` parameter. The [AdGroups](https://yandex.ru/dev/direct/doc/ru/adgroups/adgroups.html).[get](https://yandex.ru/dev/direct/doc/ru/adgroups/add.html) method now allows you to filter ad groups that use specific sets of negative keywords. **June 24, 2019**   Video ads are now supported in display campaigns: - The [AdGroups](https://yandex.ru/dev/direct/doc/ru/adgroups/adgroups.html) service now supports ad groups with the CPM_VIDEO_AD_GROUP type. {% note alert %} The **Gather audience by completion rate** setting is currently not supported in the API. {% endnote %} - The [Ads](https://yandex.ru/dev/direct/doc/ru/ads/ads.html) service now supports ads with the CPM_VIDEO_AD type. **June 3, 2019**   Changes to the [RetargetingLists](https://yandex.ru/dev/direct/doc/ru/retargetinglists/retargetinglists.html) service: - Lifted restrictions on retargeting lists that consist exclusively of rules with the NONE operator. Now these retargeting lists can use both Yandex Metrica goals and segments, as well as Yandex Audience segments. - The `MembershipLifeSpan` parameter is now used only for Yandex Metrica goals. For segments from Yandex Metrica and Yandex Audience, the [add](https://yandex.ru/dev/direct/doc/ru/retargetinglists/add.html) and [update](https://yandex.ru/dev/direct/doc/ru/retargetinglists/update.html) methods ignore the passed value. - The maximum number of days in the `MembershipLifeSpan` parameter increased to 540. **May 16, 2019**   The [Creatives](https://yandex.ru/dev/direct/doc/ru/creatives/creatives.html) service now supports creatives with the type CPM_VIDEO_CREATIVE. **May 15, 2019**   Support for Turbo pages: - New [TurboPages](https://yandex.ru/dev/direct/doc/ru/turbopages/turbopages.html) service for getting Turbo pages that were created in the Turbo Page Builder. - Methods of the [Ads](https://yandex.ru/dev/direct/doc/ru/ads/ads.html) service now have the `TurboPageId` parameter. The response to the [Ads](https://yandex.ru/dev/direct/doc/ru/ads/ads.html).[get](https://yandex.ru/dev/direct/doc/ru/ads/get.html) method also has the `TurboPageModeration` parameter. The `Href` parameter in the `TextImageAd`, `TextAdBuilderAd`, `CpcVideoAdBuilderAd`, and `CpmBannerAdBuilderAd` structures is now nillable in the [Ads](https://yandex.ru/dev/direct/doc/ru/ads/ads.html).[update](https://yandex.ru/dev/direct/doc/ru/ads/update.html) and [Ads](https://yandex.ru/dev/direct/doc/ru/ads/ads.html).[get](https://yandex.ru/dev/direct/doc/ru/ads/get.html) methods. - Methods of the [Sitelinks](https://yandex.ru/dev/direct/doc/ru/sitelinks/sitelinks.html) service now have the `TurboPageId` parameter. The `Href` and `Description` parameters are now nillable in the [Sitelinks](https://yandex.ru/dev/direct/doc/ru/sitelinks/sitelinks.html).[get](https://yandex.ru/dev/direct/doc/ru/sitelinks/get.html) method. The [Sitelinks](https://yandex.ru/dev/direct/doc/ru/sitelinks/sitelinks.html).[get](https://yandex.ru/dev/direct/doc/ru/sitelinks/get.html) method has the new `SitelinkFieldNames` input parameter. [Learn more about Turbo pages](https://yandex.ru/dev/direct/doc/ru/objects/turbo-page.html) **April 8, 2019**   The [Reports](https://yandex.ru/dev/direct/doc/ru/reports.html) service supports priority goals: - Added the `Profit` field. - The values of `Revenue`, `Profit`, and `GoalsRoi` for priority goals are based on the conversion values specified in the campaign settings. [Learn more about priority goals](https://yandex.ru/support/direct/impressions/automatic-bid-adjustment-in-yan.html#automatic-bid-adjustment-in-yan__priority-goals)[Learn more about priority goals](https://yandex.com/support/direct/impressions/automatic-bid-adjustment-in-yan.html#automatic-bid-adjustment-in-yan__priority-goals) **March 27, 2019**   Prices can now be configured for text and image ads: methods in the [Ads](https://yandex.ru/dev/direct/doc/ru/ads/ads.html) service now have the `PriceExtension` structure. **March 11, 2019**   The [Campaigns](https://yandex.ru/dev/direct/doc/ru/campaigns/campaigns.html) service has new settings for conversion strategies. If one of the following strategies is selected for search: - AVERAGE_CPA, AVERAGE_ROI, or WB_MAXIMUM_CONVERSION_RATE for a "Text & Image ads" campaign. - AVERAGE_CPI or WB_MAXIMUM_APP_INSTALLS for an "Ads for mobile apps" campaign. then there is no support for the `NetworkDefault`.`BidPercent` and `NetworkDefault`.`LimitPercent` parameters in ad networks, or for the `MAINTAIN_NETWORK_CPC` option in the `Settings` structure. The [add](https://yandex.ru/dev/direct/doc/ru/campaigns/add.html) and [update](https://yandex.ru/dev/direct/doc/ru/campaigns/update.html) methods ignore the passed values and return a warning. To enable the strategy in NETWORK_DEFAULT networks, you need to pass an empty `NetworkDefault` structure. The [get](https://yandex.ru/dev/direct/doc/ru/campaigns/get.html) method doesn't return the `NetworkDefault` structure or the `MAINTAIN_NETWORK_CPC` option. **February 4, 2019**   The [Campaigns](https://yandex.ru/dev/direct/doc/ru/campaigns/campaigns.html) service now supports priority goals for campaigns with the "Text & Image Ads" type. The `add`, `update`, and `get` methods now have the `PriorityGoals` structure. **January 9, 2019**   Changes to the [Reports](https://yandex.ru/dev/direct/doc/ru/reports.html) service for smart banners: - For campaigns with the SMART_BANNER_CAMPAIGN type, if at least one of the `Criterion`, `CriterionId`, `Criteria`, or `CriteriaId` fields is specified, or data is filtered by the `SmartBannerFilterId` field, or the CRITERIA_PERFORMANCE_REPORT type is selected, a dash will be shown in the `Impressions` and `Ctr` fields. - The `ImpressionShare` field can be specified in conjunction with `TargetingLocationId` and `TargetingLocationName`. **December 25, 2018**   The [BidModifiers](https://yandex.ru/dev/direct/doc/ru/bidmodifiers/bidmodifiers.html) service supports bid adjustments based on the device type for groups of display ads. [More about bid adjustments](https://yandex.ru/dev/direct/doc/ru/objects/bidmodifier.html) **December 10, 2018**   Changes in the reference list of regions: the parent region of the Zabaykalsky Krai administrative area and the Republic of Buryatia is now the Far Eastern Federal District (Dalny Vostok), instead of Siberia. We recommend calling the [Dictionaries](https://yandex.ru/dev/direct/doc/ru/dictionaries/dictionaries.html).[get](https://yandex.ru/dev/direct/doc/ru/dictionaries/get.html) method to get an updated list of regions. **December 6, 2018**   The [Dictionaries](https://yandex.ru/dev/direct/doc/ru/dictionaries/dictionaries.html).[get](https://yandex.ru/dev/direct/doc/ru/dictionaries/get.html) method no longer supports units. - The YND_FIXED currency has been removed from the `Currencies` list. - For other currencies, the `Rate` and `RateWithVAT` parameters are no longer returned. **December 4, 2018**   There are upcoming changes in the reference list of regions: the parent region of the Zabaykalsky administrative area and the Republic of Buryatia will be the Far Eastern Federal District (Dalny Vostok), instead of Siberia. After the reference list is updated, we recommend calling the [Dictionaries](https://yandex.ru/dev/direct/doc/ru/dictionaries/dictionaries.html).[get](https://yandex.ru/dev/direct/doc/ru/dictionaries/get.html) method to request the new list. **November 26, 2018**   The [KeywordsResearch](https://yandex.ru/dev/direct/doc/ru/keywordsresearch/keywordsresearch.html).[deduplicate](https://yandex.ru/dev/direct/doc/ru/keywordsresearch/deduplicate.html) method has a new `Operation` input parameter. Now you can remove duplicates and overlapping keywords at the same time or in separate operations. **November 12, 2018**   The currency reference now shows the minimum and maximum CPM bids for display ads. To get the reference list, use the [Dictionaries](https://yandex.ru/dev/direct/doc/ru/dictionaries/dictionaries.html).[get](https://yandex.ru/dev/direct/doc/ru/dictionaries/get.html) method and specify the `Currencies` dictionary name in the request. **November 2, 2018**   Crypta segments are available for behavioral targeting of display advertising: - The [RetargetingLists](https://yandex.ru/dev/direct/doc/ru/retargetinglists/retargetinglists.html) service supports using behavioral segments in audience targets based on user profiles. - The [Dictionaries](https://yandex.ru/dev/direct/doc/ru/dictionaries/dictionaries.html).[get](https://yandex.ru/dev/direct/doc/ru/dictionaries/get.html) method returns behavioral characteristics in the `AudienceCriteriaTypes` reference list and behavioral segments in the `AudienceDemographicProfiles` reference list. **November 1, 2018**   Added a restriction: in an "Ads for mobile apps" campaign, all ad groups must have the same app link. **October 3, 2018**   Added the [Creatives](https://yandex.ru/dev/direct/doc/ru/creatives/creatives.html) service to get creatives designed in the Ad Builder that are available to the advertiser. **October 3, 2018**   Added support for video ads in the [Ads](https://yandex.ru/dev/direct/doc/ru/ads/ads.html) service. [Learn more about ad types](https://yandex.ru/dev/direct/doc/ru/objects/ad.html) **October 1, 2018**   Added the [KeywordsResearch](https://yandex.ru/dev/direct/doc/ru/keywordsresearch/keywordsresearch.html).[deduplicate](https://yandex.ru/dev/direct/doc/ru/keywordsresearch/deduplicate.html) method, which detects overlapping and duplicated terms in an array of keywords. **September 26, 2018**   The following is now available for display campaigns in the API: - The [Campaigns](https://yandex.ru/dev/direct/doc/ru/campaigns/campaigns.html) service now supports campaigns with the CPM_BANNER_CAMPAIGN type. - The [AdGroups](https://yandex.ru/dev/direct/doc/ru/adgroups/adgroups.html) service now supports ad groups with the CPM_BANNER_AD_GROUP type. - The [Ads](https://yandex.ru/dev/direct/doc/ru/ads/ads.html) service now supports ads with the CPM_BANNER_AD type. - Added user profile support to the [retargetinglists](https://yandex.ru/dev/direct/doc/ru/retargetinglists/retargetinglists.html) service, see [this section](https://yandex.ru/dev/direct/doc/ru/objects/retargeting-list.html). - Now you can use the [Dictionaries](https://yandex.ru/dev/direct/doc/ru/dictionaries/dictionaries.html).[get](https://yandex.ru/dev/direct/doc/ru/dictionaries/get.html) method to obtain reference lists of Crypta segments: - list of demographic segments: gender, age, income, family status and profession - list of demographic characteristics - list of user interest segments [Learn more about managing display campaigns](https://yandex.ru/dev/direct/doc/ru/best-practice/cpm-banner.html) **August 27, 2018**   Changed restrictions: the maximum number of gender and age adjustments per campaign or ad group has been increased to 12. **August 21, 2018**   The [BidModifiers](https://yandex.ru/dev/direct/doc/ru/bidmodifiers/bidmodifiers.html) and [Reports](https://yandex.ru/dev/direct/doc/ru/reports.html) services now support the age groups AGE_45_54 and AGE_55. **August 8, 2018**   The [Reports](https://yandex.ru/dev/direct/doc/ru/reports.html) service has the new fields `AvgTrafficVolume`, `WeightedCtr`, and `WeightedImpressions`. **June 8, 2018**   The [Reports](https://yandex.ru/dev/direct/doc/ru/reports.html) service has the new input parameters `Goals` and `AttributionModels`. Changed how the value of the `ConversionRate` field is calculated: the number of converted sessions is now divided by the number of clicks instead of the total number of sessions. **May 30, 2018**   The new [KeywordBids](https://yandex.ru/dev/direct/doc/ru/keywordbids/keywordbids.html).[setAuto](https://yandex.ru/dev/direct/doc/ru/keywordbids/setAuto.html) method allows you to set bids for keywords on search depending on the desired traffic volume. **May 3, 2018**   The [Reports](https://yandex.ru/dev/direct/doc/ru/reports.html) service now returns statistics for "Display campaigns": - Added the value CPM_BANNER_CAMPAIGN for the `CampaignType` field. - Added the new report type REACH_AND_FREQUENCY_PERFORMANCE_REPORT, which shows the new fields `AvgCpm`, `AvgImpressionFrequency` and `ImpressionReach`. **April 10, 2018**   Added the [KeywordBids](https://yandex.ru/dev/direct/doc/ru/keywordbids/keywordbids.html) service for managing bids and priorities of keywords and autotargetings. **April 9, 2018**   The [Keywords](https://yandex.ru/dev/direct/doc/ru/keywords/keywords.html).[get](https://yandex.ru/dev/direct/doc/ru/keywords/get.html) method no longer allows getting the `Productivity` parameter: it always returns null (nil). The [Dictionaries](https://yandex.ru/dev/direct/doc/ru/dictionaries/dictionaries.html).[get](https://yandex.ru/dev/direct/doc/ru/dictionaries/get.html) method no longer allows getting the list of recommendations for improving productivity: the `ProductivityAssertions` array is not returned. **March 29, 2018**   Disabled support for the IMPRESSIONS_BELOW_SEARCH strategy (for all types of campaigns) in the [Campaigns](https://yandex.ru/dev/direct/doc/ru/campaigns/campaigns.html) service. If you pass this value in the [BiddingStrategyType](*BiddingStrategyType-) parameter for the `Search` structure, an error is returned. **March 19, 2018**   Added the [Leads](https://yandex.ru/dev/direct/doc/ru/leads/leads.html) service for getting data that users enter in forms on turbo pages. **February 26, 2018**   The [BidModifiers](https://yandex.ru/dev/direct/doc/ru/bidmodifiers/bidmodifiers.html) service now supports video bid adjustments. [More about bid adjustments](https://yandex.ru/dev/direct/doc/ru/objects/bidmodifier.html) **February 8, 2018**   In the [Reports](https://yandex.ru/dev/direct/doc/ru/reports.html) service, added the values SMART_MULTIPLE and SMART_SINGLE for the `AdFormat` field. **January 29, 2018**   Added the `CriterionType` field in the [Reports](https://yandex.ru/dev/direct/doc/ru/reports.html) service. **January 10, 2018**   The [Clients](https://yandex.ru/dev/direct/doc/ru/clients/clients.html).[get](https://yandex.ru/dev/direct/doc/ru/clients/get.html) method now allows you to get agency parameters and user settings for the agency's representative. **December 13, 2017**   The [Ads](https://yandex.ru/dev/direct/doc/ru/ads/ads.html) service now supports image ads that use creatives created in the Ad Builder. [Learn more about ad types](https://yandex.ru/dev/direct/doc/ru/objects/ad.html) **November 27, 2017**   Changed the amount of points deducted for calling the [bids](https://yandex.ru/dev/direct/doc/ru/bids/bids.html).[get](https://yandex.ru/dev/direct/doc/ru/bids/get.html) and [Keywords](https://yandex.ru/dev/direct/doc/ru/keywords/keywords.html).[get](https://yandex.ru/dev/direct/doc/ru/keywords/get.html) methods. [Learn more about points](https://yandex.ru/dev/direct/doc/ru/concepts/units.html#spend) **November 13, 2017**   Changed the errors that are returned when the request can't be processed. Instead of error code [53](https://yandex.ru/dev/direct/doc/ru/concepts/errors-list.html#e53), the following error codes are returned: - If the OAuth token is omitted in the request or has an invalid format (for example, it contains invalid characters), error code [8000](https://yandex.ru/dev/direct/doc/ru/concepts/errors-list.html#e8000) is returned. {% note info %} If the OAuth token is invalid, it returns error code [53](https://yandex.ru/dev/direct/doc/ru/concepts/errors-list.html#e53) as previously. {% endnote %} - If a request on behalf of an agency representative omits the advertiser's username, error code [8000](https://yandex.ru/dev/direct/doc/ru/concepts/errors-list.html#e8000) is returned. - If the `Client-Login` header specifies a non-existing username or a username for an advertiser that doesn't belong to this agency, error code [8800](https://yandex.ru/dev/direct/doc/ru/concepts/errors-list.html#e8800) is returned. - If the user doesn't have access to the Yandex Direct API, error code [3000](https://yandex.ru/dev/direct/doc/ru/concepts/errors-list.html#e3000) is returned. **October 17, 2017**   Added support for autotargeting in the [Bids](https://yandex.ru/dev/direct/doc/ru/bids/bids.html), [Keywords](https://yandex.ru/dev/direct/doc/ru/keywords/keywords.html) and [Reports](https://yandex.ru/dev/direct/doc/ru/reports.html) services. [Learn more](https://yandex.ru/dev/direct/doc/ru/best-practice/auto-targeting.html). **September 27, 2017**   The [Reports](https://yandex.ru/dev/direct/doc/ru/reports.html) service now has the `reportsInQueue` response header and filtration by the `CampaignType` field. **September 19, 2017**   Added the campaign setting ENABLE_COMPANY_INFO to methods for the [Campaigns](https://yandex.ru/dev/direct/doc/ru/campaigns/campaigns.html) service (for "Text & Image Ads" and "Dynamic ads" campaigns). **September 11, 2017**   The [Campaigns](https://yandex.ru/dev/direct/doc/ru/campaigns/campaigns.html) service has disabled support for the ENABLE_BEHAVIORAL_TARGETING setting in the `Settings` structure. **August 29, 2017**   Added support for JSON requests in the [Reports](https://yandex.ru/dev/direct/doc/ru/reports.html) service. **August 29, 2017**   Added the [AgencyClients](https://yandex.ru/dev/direct/doc/ru/agencyclients/agencyclients.html).[add](https://yandex.ru/dev/direct/doc/ru/agencyclients/add.html) method for registering new agency clients and the [AgencyClients](https://yandex.ru/dev/direct/doc/ru/agencyclients/agencyclients.html).[update](https://yandex.ru/dev/direct/doc/ru/agencyclients/update.html) method for editing parameters of agency clients. Added the [Clients](https://yandex.ru/dev/direct/doc/ru/clients/clients.html).[update](https://yandex.ru/dev/direct/doc/ru/clients/update.html) method for editing advertiser parameters and user settings for an advertiser's representative. **August 15, 2017**   In the [Ads](https://yandex.ru/dev/direct/doc/ru/ads/ads.html) service, added the `Title2` parameter for text and image ads. Changed the restrictions on the number of characters in the `Title` and `Text` fields for text and image ads, and in the `Text` field for dynamic ads. Changes in the reference list of restrictions. We recommend getting the updated list by calling the [Dictionaries](https://yandex.ru/dev/direct/doc/ru/dictionaries/dictionaries.html).[get](https://yandex.ru/dev/direct/doc/ru/dictionaries/get.html) method with the `Constants` reference list specified in the request. **August 7, 2017**   A report with the SEARCH_QUERY_PERFORMANCE_REPORT type now contains statistics on search queries not only in Yandex search, but also in search engines in the Yandex Advertising Network. They also support the [Placement](https://yandex.ru/dev/direct/doc/ru/report-format.html#Placement) field now. **August 7, 2017**   The [Campaigns](https://yandex.ru/dev/direct/doc/ru/campaigns/campaigns.html) service has disabled support for the ENABLE_AUTOFOCUS setting in the `Settings` structure. **July 4, 2017**   Video extensions now supported for Text & Image ads: - Added the `VideoExtension` structure to methods for the [Ads](https://yandex.ru/dev/direct/doc/ru/ads/ads.html) service. - In the [Reports](https://yandex.ru/dev/direct/doc/ru/reports.html) service, added the VIDEO value for the `AdFormat` field. For more information about how to assign and unassign video extensions, see [launch-campaign](https://yandex.ru/dev/direct/doc/ru/best-practice/launch-campaign.html). **June 28, 2017**   Disabled support for the LOWEST_COST, LOWEST_COST_GUARANTEE, and LOWEST_COST_PREMIUM strategies in the [Campaigns](https://yandex.ru/dev/direct/doc/ru/campaigns/campaigns.html) service (for all types of campaigns). If you pass one of these values in the `BiddingStrategyType` parameter for the `Search` structure, an error is returned. **June 22, 2017**   Changes to settings in the [Campaigns](https://yandex.ru/dev/direct/doc/ru/campaigns/campaigns.html) service for impressions for related keywords in "Text & Image Ads" campaigns: - The `BudgetPercent` parameter in the `RelevantKeywords` structure supports any integer values from 1 to 100. - The `Mode` parameter in the `RelevantKeywords` structure is not supported and its value is ignored. - The ENABLE_RELATED_KEYWORDS setting in the `Settings` structure is not supported. The [Reports](https://yandex.ru/dev/direct/doc/ru/reports.html) service has the new fields `MatchedKeyword`, `Criterion`, and `CriterionId`. **June 20, 2017**   Support for the 4th position in premium placement has been added to the [Bids](https://yandex.ru/dev/direct/doc/ru/bids/bids.html) service: the P14 value in the `Position` parameter of the `AuctionBids` array, returned via the [Bids](https://yandex.ru/dev/direct/doc/ru/bids/bids.html).[get](https://yandex.ru/dev/direct/doc/ru/bids/get.html) method, as well as the query parameter `Position` of the [Bids](https://yandex.ru/dev/direct/doc/ru/bids/bids.html).[setAuto](https://yandex.ru/dev/direct/doc/ru/bids/setAuto.html) method. **May 3, 2017**   The [BidModifiers](https://yandex.ru/dev/direct/doc/ru/bidmodifiers/bidmodifiers.html) service now supports regional bid adjustments. [More about bid adjustments](https://yandex.ru/dev/direct/doc/ru/objects/bidmodifier.html) **April 17, 2017**   Added the [KeywordsResearch](https://yandex.ru/dev/direct/doc/ru/keywordsresearch/keywordsresearch.html) service for getting a forecast of impressions for keywords. **April 17, 2017**   Added the `RestrictedRegionIds` response parameter to the [AdGroups](https://yandex.ru/dev/direct/doc/ru/adgroups/adgroups.html).[get](https://yandex.ru/dev/direct/doc/ru/adgroups/add.html) method. **March 21, 2017**   Added the [Reports](https://yandex.ru/dev/direct/doc/ru/reports.html) service for getting statistics. **March 6, 2017**   Added the [AgencyClients](https://yandex.ru/dev/direct/doc/ru/agencyclients/agencyclients.html) service for managing agency clients. **February 28, 2017**   You can now target mobile app ads by user interests (see [audience-target](https://yandex.ru/dev/direct/doc/ru/objects/audience-target.html)): - Methods of the [AudienceTargets](https://yandex.ru/dev/direct/doc/ru/audiencetargets/audiencetargets.html) service now have the `InterestId` parameter. - The [Dictionaries](https://yandex.ru/dev/direct/doc/ru/dictionaries/dictionaries.html).[get](https://yandex.ru/dev/direct/doc/ru/dictionaries/get.html) method returns a reference list of mobile app categories to use as interests. - Added the `InterestsChanged` response parameter to the [changes](https://yandex.ru/dev/direct/doc/ru/changes/changes.html).[checkDictionaries](https://yandex.ru/dev/direct/doc/ru/changes/checkDictionaries.html) method. **February 14, 2017**   Added support for negative keywords containing up to 7 words: - In the [AdGroups](https://yandex.ru/dev/direct/doc/ru/adgroups/adgroups.html) service — in the `NegativeKeywords` ad group parameter. - In the [Campaigns](https://yandex.ru/dev/direct/doc/ru/campaigns/campaigns.html) service — in the `NegativeKeywords` campaign parameter. **January 25, 2017**   - Added support for the "[rarely served](https://yandex.ru/dev/direct/doc/ru/objects/adgroup.html)" status: the methods [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) and [Bids](https://yandex.ru/dev/direct/doc/ru/bids/bids.html).[get](https://yandex.ru/dev/direct/doc/ru/bids/get.html) now have the request parameter `ServingStatuses` and the response parameter `ServingStatus`. - The following keyword data is unavailable in groups with the "rarely served" status: - `StatisticsSearch` and `StatisticsNetwork` in the [Keywords](https://yandex.ru/dev/direct/doc/ru/keywords/keywords.html).[get](https://yandex.ru/dev/direct/doc/ru/keywords/get.html) method. - `CompetitorsBids`, `SearchPrices`, `ContextCoverage`, `AuctionBids`, `MinSearchPrice`, and `CurrentSearchPrice` in the [bids](https://yandex.ru/dev/direct/doc/ru/bids/bids.html).[get](https://yandex.ru/dev/direct/doc/ru/bids/get.html) method. **December 26, 2016**   The `ContextCoverage` array in the [bids](https://yandex.ru/dev/direct/doc/ru/bids/bids.html).[get](https://yandex.ru/dev/direct/doc/ru/bids/get.html) method is now unavailable for campaigns with the `SERVING_OFF` or `NETWORK_DEFAULT` display strategy. **November 9, 2016**   Added the [Clients](https://yandex.ru/dev/direct/doc/ru/clients/clients.html) service for getting client information. **November 1, 2016**   Added support for a new currency: the Belarusian ruble (BYN). **October 17, 2016**   {% note alert %} Account access may be suspended for advertisers using Yandex units who haven't made payments for over a year. In this case, calling API methods results in the error [54](https://yandex.ru/dev/direct/doc/ru/concepts/errors-list.html#e54), and the web interface doesn't allow access to any operations except switching to a currency. To continue using the API, you need to switch your account to a payment currency. To do this, click **Switch now** in the Yandex Direct web interface. For more information about switching to a currency, see Yandex Direct Help: [Russian rubles](https://yandex.ru/support/direct-tooltips/conversion-rur.html)[Russian rubles](https://yandex.com/support/direct-tooltips/conversion-rur.html) or [other currency](https://yandex.ru/support/direct-tooltips/conversion-currency.html)[other currency](https://yandex.com/support/direct-tooltips/conversion-currency.html). {% endnote %} **October 13, 2016**   The methods for the [Ads](https://yandex.ru/dev/direct/doc/ru/ads/ads.html) service have an extended set of possible values for the `Action` parameter (for mobile app ads). **October 13, 2016**   Changes in the reference list of regions. We recommend calling the [Dictionaries](https://yandex.ru/dev/direct/doc/ru/dictionaries/dictionaries.html).[get](https://yandex.ru/dev/direct/doc/ru/dictionaries/get.html) method to get an updated list of regions. In particular, the regions listed below have been removed from the list: - These regions can no longer be used when creating or editing ad groups. - In groups that used these regions, they have been automatically replaced with lower-level regions. - Statistics for these regions have been moved to higher-level regions. {% cut "List of deleted regions" %} #| || **Deleted region** | **Replaced by regions in the group settings** | **Statistics is now attributed to the region** || || 20524 | West/Ukraine/CIS (excluding Russia) | 20529, 20530, 20531, 20532, 20533, 20534, 20535, 20550 | 187 || || 20525 | East/Ukraine/CIS (excluding Russia) | 20536, 20537, 20538, 20539, 20540 | 187 || || 20526 | South/Ukraine/CIS (excluding Russia) | 20541, 20542, 20543 | 187 || || 20527 | Central/Ukraine/CIS (excluding Russia) | 20544, 20545, 20546, 20547, 20548, 20549 | 187 || || 20528 | North/Ukraine/CIS (excluding Russia) | 20551, 20552 | 187 || || 980 | Baltic States/Europe | 117, 179, 206 | 111 || || 1004 | Middle East/Asia | 181, 210, 1056 | 183 || |# {% endcut %} **October 12, 2016**   Added a restriction for keywords: the maximum length of each word or negative keyword in a keyword is 35 characters. **September 28, 2016**   Added the [AudienceTargets](https://yandex.ru/dev/direct/doc/ru/audiencetargets/audiencetargets.html) service for managing audience targets, and the [RetargetingLists](https://yandex.ru/dev/direct/doc/ru/retargetinglists/retargetinglists.html) service for managing retargeting lists. [Learn more about audience targeting](https://yandex.ru/dev/direct/doc/ru/objects/audience-target.html) **September 20, 2016**   Changes will be made to the regions reference list in approximately two to three weeks. After the reference list is updated, we recommend calling the [Dictionaries](https://yandex.ru/dev/direct/doc/ru/dictionaries/dictionaries.html).[get](https://yandex.ru/dev/direct/doc/ru/dictionaries/get.html) method to request the new list. In particular, the regions listed below will be removed from the list: - You won't be able to specify these regions when creating or editing ad groups. - In groups that use these regions, they will be automatically replaced with lower-level regions. - Statistics for these regions will be moved to higher-level regions. {% cut "List of regions planned for deletion" %} #| || **Region to be deleted** | **To be replaced by regions in the group settings** | **Statistics will be attributed to the region** || || 20524 | West/Ukraine/CIS (excluding Russia) | 20529, 20530, 20531, 20532, 20533, 20534, 20535, 20550 | 187 || || 20525 | East/Ukraine/CIS (excluding Russia) | 20536, 20537, 20538, 20539, 20540 | 187 || || 20526 | South/Ukraine/CIS (excluding Russia) | 20541, 20542, 20543 | 187 || || 20527 | Central/Ukraine/CIS (excluding Russia) | 20544, 20545, 20546, 20547, 20548, 20549 | 187 || || 20528 | North/Ukraine/CIS (excluding Russia) | 20551, 20552 | 187 || || 980 | Baltic States/Europe | 117, 179, 206 | 111 || || 1004 | Middle East/Asia | 181, 210, 1056 | 183 || |# {% endcut %} **September 8, 2016**   In the [Ads](https://yandex.ru/dev/direct/doc/ru/ads/ads.html).[get](https://yandex.ru/dev/direct/doc/ru/ads/get.html) method, added the PROJECT_DECLARATION value for the `AdCategories` parameter. **September 6, 2016**   For the [AdGroups](https://yandex.ru/dev/direct/doc/ru/adgroups/adgroups.html).[get](https://yandex.ru/dev/direct/doc/ru/adgroups/add.html) method, you can now get the parameters of a group of dynamic ads that has a feed as the data source. **August 22, 2016**   Added support for image ads in the [Ads](https://yandex.ru/dev/direct/doc/ru/ads/ads.html) service. [Learn more about ad types](https://yandex.ru/dev/direct/doc/ru/objects/ad.html) Added the [AdImages](https://yandex.ru/dev/direct/doc/ru/ad_assets/adimages.html) service for managing images. This service supports image sizes for use in image ads. [Learn more about images](https://yandex.ru/dev/direct/doc/ru/objects/adimage.html) **August 11, 2016**   Added the `ModifiedSince` request parameter to the [Keywords](https://yandex.ru/dev/direct/doc/ru/keywords/keywords.html).[get](https://yandex.ru/dev/direct/doc/ru/keywords/get.html) method. **June 2, 2016**   In the [BidModifiers](https://yandex.ru/dev/direct/doc/ru/bidmodifiers/bidmodifiers.html) service, changed the acceptable coefficient values in bid adjustments for gender, age, and website users. **May 23, 2016**   Now you can spend the agency's points instead of the advertiser's points for making requests from an agency representative. [Learn more about points](https://yandex.ru/dev/direct/doc/ru/concepts/units.html) **May 10, 2016**   For the [adextensions](https://yandex.ru/dev/direct/doc/ru/adextensions/adextensions.html).[get](https://yandex.ru/dev/direct/doc/ru/adextensions/get.html) method, added the request parameters `States` and `ModifiedSince` and the response parameters `State` and `Associated`. **April 18, 2016**   Added the `DisplayUrlPath` parameter to the methods for the [Ads](https://yandex.ru/dev/direct/doc/ru/ads/ads.html) service, along with the `DisplayUrlPathModeration` parameter in the response of the [Ads](https://yandex.ru/dev/direct/doc/ru/ads/ads.html).[get](https://yandex.ru/dev/direct/doc/ru/ads/get.html) method for text and image ads. **April 14, 2016**   The [Dictionaries](https://yandex.ru/dev/direct/doc/ru/dictionaries/dictionaries.html).[get](https://yandex.ru/dev/direct/doc/ru/dictionaries/get.html) method now provides names of ad exchanges (SSPs). **March 30, 2016**   The `ExcludedSites` campaign parameter now supports ad exchanges (SSPs). **March 29, 2016**   - Added the [AdExtensions](https://yandex.ru/dev/direct/doc/ru/adextensions/adextensions.html) service for managing ad extensions. Only one type of extension, the callout, is available at this time. [More about callouts](https://yandex.ru/dev/direct/doc/ru/objects/adextension.html) The [Ads](https://yandex.ru/dev/direct/doc/ru/ads/ads.html) service now supports callouts for text and image ads and dynamic text ads. [More about ads](https://yandex.ru/dev/direct/doc/ru/objects/ad.html) - The [Ads](https://yandex.ru/dev/direct/doc/ru/ads/ads.html) service now supports images for ads with the "Ads for mobile apps" type. - Added the [Dictionaries](https://yandex.ru/dev/direct/doc/ru/dictionaries/dictionaries.html) service for getting reference data: regions, time zones, exchange rates, metro stations, restrictions on parameter values, and other information. **March 14, 2016**   The `BudgetPercent` campaign parameter no longer supports the value –1. To allow unlimited spending on related keywords (within the campaign budget), use the value 100. **February 25, 2016**   Added the campaign setting `ENABLE_AREA_OF_INTEREST_TARGETING` to the methods for the [Campaigns](https://yandex.ru/dev/direct/doc/ru/campaigns/campaigns.html) service (for all types of campaigns). **February 16, 2016**   Added the `OptimizeGoalId` campaign parameter to the methods of the [Campaigns](https://yandex.ru/dev/direct/doc/ru/campaigns/campaigns.html) service (for "Text & Image Ads" campaigns). **February 9, 2016**   Changed the restrictions for keywords. Now an ad group can contain a maximum of 200 keywords, and the maximum length of each keyword is 4096 characters. **January 13, 2016**   Added the `DomainUrlProcessingStatus` parameter to the [AdGroups](https://yandex.ru/dev/direct/doc/ru/adgroups/adgroups.html).[get](https://yandex.ru/dev/direct/doc/ru/adgroups/add.html) method. **January 11, 2016**   In the [BidModifiers](https://yandex.ru/dev/direct/doc/ru/bidmodifiers/bidmodifiers.html) service, changed the acceptable coefficient values in bid adjustments for gender, age, and website users. **December 15, 2015**   Added the [DynamicTextAdTargets](https://yandex.ru/dev/direct/doc/ru/dynamictextadtargets/dynamictextadtargets.html) service for managing targeting conditions for dynamic text ads. [Learn more](https://yandex.ru/dev/direct/doc/ru/objects/dynamictextadtarget.html). In the [Campaigns](https://yandex.ru/dev/direct/doc/ru/campaigns/campaigns.html) service, added campaign support for dynamic text ads. [Learn more about campaigns](https://yandex.ru/dev/direct/doc/ru/objects/campaign.html) In the [AdGroups](https://yandex.ru/dev/direct/doc/ru/adgroups/adgroups.html) service, added group support for dynamic text ads. [Learn more about ad groups](https://yandex.ru/dev/direct/doc/ru/objects/adgroup.html) In the [Ads](https://yandex.ru/dev/direct/doc/ru/ads/ads.html) service, added support for dynamic text ads. [More about ads](https://yandex.ru/dev/direct/doc/ru/objects/ad.html) Added pagination to the [Bids](https://yandex.ru/dev/direct/doc/ru/bids/bids.html).[get](https://yandex.ru/dev/direct/doc/ru/bids/get.html) method, enabling paginated data outputs. **November 9, 2015**   The [Keywords](https://yandex.ru/dev/direct/doc/ru/keywords/keywords.html).[get](https://yandex.ru/dev/direct/doc/ru/keywords/get.html) method has the added ability to get the number of impressions and keys for a keyword over 28 days. The [Keywords](https://yandex.ru/dev/direct/doc/ru/keywords/keywords.html).[add](https://yandex.ru/dev/direct/doc/ru/keywords/add.html) method now allows setting the bid or priority for the keyword being created. **October 26, 2015**   - Added the [Campaigns](https://yandex.ru/dev/direct/doc/ru/campaigns/campaigns.html) service for campaign management. The service supports campaigns for mobile app advertising. [Learn more about campaigns](https://yandex.ru/dev/direct/doc/ru/objects/campaign.html) The [AdGroups](https://yandex.ru/dev/direct/doc/ru/adgroups/adgroups.html) service now supports groups for mobile app advertising. [Learn more about ad groups](https://yandex.ru/dev/direct/doc/ru/objects/adgroup.html) The [Ads](https://yandex.ru/dev/direct/doc/ru/ads/ads.html) service now supports ads for mobile app advertising. [More about ads](https://yandex.ru/dev/direct/doc/ru/objects/ad.html) - Added the `Description` parameter to the [Sitelinks](https://yandex.ru/dev/direct/doc/ru/sitelinks/sitelinks.html).[add](https://yandex.ru/dev/direct/doc/ru/sitelinks/add.html) and [Sitelinks](https://yandex.ru/dev/direct/doc/ru/sitelinks/sitelinks.html).[get](https://yandex.ru/dev/direct/doc/ru/sitelinks/get.html) methods. **September 30, 2015**   The [Bids](https://yandex.ru/dev/direct/doc/ru/bids/bids.html).[setAuto](https://yandex.ru/dev/direct/doc/ru/bids/setAuto.html) method now allows calculating bids for search based on the minimum bid for second position in Premium Placement. **September 8, 2015**   Added the [BidModifiers](https://yandex.ru/dev/direct/doc/ru/bidmodifiers/bidmodifiers.html) service for managing bid adjustments. [More about bid adjustments](https://yandex.ru/dev/direct/doc/ru/objects/bidmodifier.html) **September 1, 2015**   The [Bids](https://yandex.ru/dev/direct/doc/ru/bids/bids.html).[get](https://yandex.ru/dev/direct/doc/ru/bids/get.html) method now allows you to get bidding results of a new auction: the minimum bid and the actual CPC for each position. If the `FieldsNames` input parameter has the AuctionBids value, the method returns the `AuctionBids` array. **June 26, 2015** Launched.