API version 5. History
- December 26, 2023
-
Added the NegativeKeywordSharedSetIds structure to the Campaigns service.
- November 27, 2023
-
Added support for unified performance campaigns:
Added the UnifiedCampaign structure to the Campaigns service.
Added the UnifiedAdGroup structure to the AdGroups service.
Added the ShoppingAd structure to the Ads service.
Added a new adjusment AD_GROUP_ADJUSTMENT to the BidModifiers service (a group-level adjustment available for a unified performance group).
New parameters added to the Reports 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 service. Updated the autotargeting workflow diagram.
- October 2, 2023
- Added the getGeoRegions method to the Dictionaries service.
- September 19, 2023
- Added the ExplorationBudget structure to methods of the Campaigns and Strategies services.
- September 11, 2023
- Added the AutotargetingSearchBidIsAuto field to methods of the Bids, KeywordBids, and Keywords services to indicate whether automatic bid is enabled.
- August 2, 2023
- Added the Strategies service for working with portfolio strategies.
- July 4, 2023
- Added the GetRegionNames structure to the get method for the AdImages service.
- April 13, 2023
- Added the Type field to the add method for the AdImages service.
- March 24, 2023
- Added the ForbiddenPlatform and AvailableCampaignTypes fields to methods for the AgencyClients and Clients services.
- September 6, 2022
-
Added the TrackingParams field to Campaigns methods (for “Text & Image ads”, “Dynamic ads”, and “Smart banners” campaigns) .
- August 15, 2022
- Added TinInfo and ErirAttributes structures to methods of the Agencyclients and Clients services.
- July 19, 2022
- Added new Subtype parameter values to the AdImages service.
- July 13, 2022
- Added a new role for the Direct advertiser and Advertiser — agency client users: Representative (read only).
- April 29, 2022
-
Added the CampaignUrlPath field to the Reports service.
- April 18, 2022
-
Added to the Reports service:
- ClientLogin field.
- April 13, 2022
-
For Dynamic ads “campaigns”, now you can select a targeting category (the AutotargetingCategories structure).
- March 29, 2022
-
Added the
IsMetrikaSourceOfValue
field to thePriorityGoals
structure of the Campaigns service — for campaigns with the AVERAGE_CRR strategy. - March 25, 2022
- New adjustment types added to the BidModifiers service:
- TABLET_ADJUSTMENT: Adjustment on tablets.
- DESKTOPS_ONLY_ADJUSTMENT: Adjustment only on desktops.
- January 26, 2022
-
Added the AdVideos service.
- January 14, 2022
-
The
NETWORK_DEFAULT
andMAINTAIN_NETWORK_CPC
parameters will soon be discontinued in Campaigns. Please update your applications before the end of January 2022. - November 22, 2021
- The Campaigns service now supports the PlacementTypes setting (ad placements in search results) for “Dynamic ads” campaigns.
- November 19, 2021
- New parameters added to the Reports service:
- November 12, 2021
-
Reports are now also available for campaigns created in the Campaign Wizard.
- November 1, 2021
- A new adjustment added to the BidModifiers service:
- INCOME_GRADE_ADJUSTMENT: Adjustment for income.
- October 25, 2021
-
Added the VideoTarget parameter to Campaigns methods (for campaigns with the “Display campaign” type).
- October 20, 2021
- In the AdGroups service, you can now create a group of Text & Image ads based on a feed:
- Added the TextAdGroupFeedParams structure to the add method.
- Added the TextAdGroupFeedParamsFieldNames parameter to the get method.
- Added the TextAdGroupFeedParamsUpdate structure to the update method.
- October 14, 2021
- A new adjustment added to the BidModifiers service:
- SERP_LAYOUT_ADJUSTMENT: Adjustment for exclusive placement.
- October 7, 2021
-
Disabled support for the WEEKLY_CLICK_PACKAGE parameter in the Campaigns service.
- September 3, 2021
-
In the Keywords service, you can now select the targeting category (the AutotargetingCategories structure).
The TargetingCategory field was added to the Reports service.
- August 2, 2021
- July 13, 2021
-
In the Campaigns service, you now have the new PAY_FOR_CONVERSION_CRR strategy 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 service for managing dynamic feed ad targets.
- June 2, 2021
- New strategy in the Campaigns service:
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 service. This parameters specifies the name of the schema for creating filters.
- May 24, 2021
- In the AdGroups service, you can now create a group of dynamic ads with the FEED subtype using the API:
- May 13, 2021
-
Added the IsAdaptive parameter to the Creatives service methods.
- April 13, 2021
-
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 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 and Clients services.
- March 26, 2021
-
Disabled support for the ENABLE_EXTENDED_AD_TITLE option in the Campaigns 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 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 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:
- Added support for ads of the MOBILE_APP_CPC_VIDEO_AD_BUILDER_AD subtype in the Ads service.
- February 2, 2021
-
The Reports service now has the AvgEffectiveBid field.
- December 4, 2020
- September 28, 2020
-
In the TurboPages service, you can now search for Turbo pages using their links. Added new parameters: BoundWithHref, TurboSiteHref.
- August 26, 2020
-
In the Campaigns service, the parameter AverageCpa (for AVERAGE_CPA_PER_CAMPAIGN) / FilterAverageCpa (for AVERAGE_CPA_PER_FILTER) is mandatory in AVERAGE_CPA_PER_CAMPAIGN and AVERAGE_CPA_PER_FILTER strategies. The AverageCpc/FilterAverageCpc parameter is no longer used.
- July 17, 2020
-
In the Campaigns service, you can't optimize for all goals in WB_MAXIMUM_CONVERSION_RATE, AVERAGE_ROI, and AVERAGE_CPA strategies. Use the GoalId parameter for these strategies to pass the ID of a specific Yandex Metrica goal.
- July 16, 2020
-
In the Campaigns 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 service.
- June 8, 2020
- New strategies added to the Campaigns service:
- 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, the limit on the number of linked tags (the CounterIds parameter for the Campaigns service) was removed.
- March 25, 2020
-
Added support for business profiles from Yandex Business:
Added the Businesses service for getting the profiles of an advertiser's businesses.
- Methods for the Ads service now have the BusinessId parameter for Text & Image ads.
- March 16, 2020
-
Added support for smart banners:
- Added the Feeds service for managing feeds (that is, files with product offers).
- Added the SmartAdTargets service for managing filters (used as targeting criteria for smart banners).
- The AdGroups service now supports ad groups with the SMART_AD_GROUP type.
- The Creatives service now supports creatives with the SMART_CREATIVE type.
- Ads with the SMART_AD type now supported in the Ads service.
- Bid adjustments of the SMART_AD_ADJUSTMENT type now supported in the BidModifiers service.
- February 25, 2020
- All API services now support the
Accept-Encoding: gzip
header. - February 25, 2020
- The Reports service has the new SMART_TILE value for the AdFormat field.
- February 6, 2020
-
The AgencyClients.get, Clients.get methods now have new values for the Element parameter: GENERAL_DOMAIN_BLACKLIST_SIZE and VIDEO_DOMAIN_BLACKLIST_SIZE.
- January 15, 2020
- The Reports 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 of the RetargetingLists.get method now includes the AvailableForTargetsInAdGroupTypes parameter.
For details, see Retargeting list (RetargetingList).
- December 2, 2019
-
In the Reports 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.get method now returns the new MinimumAccountDailyBudget parameter (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.get method: values of the return parameters SharedAccountFunds.Spend and CampaignFunds.Sum now include VAT.
- September 25, 2019
-
In the Campaigns service, the default value for ADD_METRICA_TAG in the Settings structure was changed from NO to YES.
- September 17, 2019
- Attribution models available in the API:
- The Campaigns service methods now have the AttributionModel parameter for “Text & Image ads” and “Dynamic ads” campaigns.
- The Reports 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 service: a set of sitelinks can now contain up to 8 links.
- August 28, 2019
-
The Campaigns service now supports priority goals for “Dynamic ads” campaigns: the PriorityGoals structure has been added to the DynamicTextCampaign structure.
- August 22, 2019
-
Strategy settings were changed in the Campaigns service:
- The BidPercent parameter was removed from the NetworkDefault structure. The add and update methods return an error when trying to set it, and the get 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 and update methods ignore the specified value and display a warning message. To enable the strategy in NETWORK_DEFAULT networks, you need to pass an empty NetworkDefault structure.
- The get 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 and update methods ignore the passed value and issue a warning, and the get method does not return MAINTAIN_NETWORK_CPC.
To learn how the strategies in the API correspond to the updated strategies in the web interface, see Types of strategies.
- July 23, 2019
-
Image ads: Uzbekistan som. The Ads service methods now accept the value UZS for the PriceCurrency parameter.
- July 11, 2019
- Support for sets of negative keywords:
- Added a new NegativeKeywordSharedSets service for managing sets of negative keywords.
- Added the NegativeKeywordSharedSetIds parameter to the AdGroups service methods. The AdGroups.get method can now filter ad groups that use specified sets of negative keywords.
- June 24, 2019
-
Video ads are now supported in display campaigns:
- June 3, 2019
- Changes to the RetargetingLists 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 and update methods ignore the specified value.
- The maximum number of days in the MembershipLifeSpan parameter increased to 540.
- May 16, 2019
- The Creatives service now supports creatives with the type CPM_VIDEO_CREATIVE.
- May 15, 2019
- Support for Turbo pages:
- Added the TurboPages service to get Turbo pages created in the Turbo Page Builder.
- The Ads service methods now have the TurboPageId parameter. The response of the Ads.get method now also includes the TurboPageModeration parameter.
The Href parameter in the TextImageAd, TextAdBuilderAd, CpcVideoAdBuilderAd, and CpmBannerAdBuilderAd structures is now nillable in the methods Ads.update and Ads.get.
- The Sitelinks service methods now have the TurboPageId parameter.
The Href and Description parameters are now nillable in the Sitelinks.get method.
The Sitelinks.get method now includes the SitelinkFieldNames input parameter.
- April 8, 2019
-
The Reports service supports priority goals:
- Added the Profit field.
- March 27, 2019
-
Prices can now be configured for Text & Image ads: methods in the Ads service now have the PriceExtension structure.
- March 11, 2019
-
The Campaigns 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 and update 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 method doesn't return the NetworkDefault structure or the MAINTAIN_NETWORK_CPC parameter.
- February 4, 2019
-
The Campaigns service now supports priority goals for campaigns with the “Text & Image Ads” type: the add, update, and get methods have the PriorityGoals structure.
- January 9, 2019
-
Changes to the Reports 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 service supports bid adjustments based on the device type for display ad groups. More about bid adjustments
- 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.get method to get an updated list of regions.
- December 6, 2018
- The Dictionaries.get method no longer supports Yandex 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.get method to request the new list.
- November 26, 2018
- The KeywordsResearch.deduplicate method now has a new Operation input parameter to allow merging duplicates and eliminating overlaps both separately and in bulk.
- 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.get method and enter Currencies as the reference list name in your request.
- November 2, 2018
-
Crypta segments are available for behavioral targeting of display advertising:
- The RetargetingLists service supports behavioral segments in audience targets based on user profiles.
- The Dictionaries.get method returns behavioral indicators 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 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 service. Learn more about ad types
- October 1, 2018
- Added the KeywordsResearch.deduplicate method to merge duplicates and eliminate overlaps in keyword arrays.
- September 26, 2018
-
The following is now available for display campaigns in the API:
- The Campaigns service now supports campaigns with the CPM_BANNER_CAMPAIGN type.
- The AdGroups service now supports ad groups with the CPM_BANNER_AD_GROUP type.
- The Ads service now supports ads with the CPM_BANNER_AD type.
- Added user profile support to the RetargetingLists service, see Retargeting list (RetargetingList).
- The Dictionaries.get method now allows getting reference lists for Crypta segments:
- list of demographic segments: gender, age, income, family status and profession
- list of demographic characteristics
- list of user interest segments
- 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 and Reports services now support the age groups AGE_45_54 and AGE_55.
- August 8, 2018
-
The Reports service has the new fields AvgTrafficVolume, WeightedCtr, and WeightedImpressions.
- June 8, 2018
-
The Reports 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
- Added the KeywordBids.setAuto method, which is used to set bids for keywords in search results depending on the desired traffic volume.
- May 3, 2018
-
The Reports 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 service for managing bids and priorities of keywords and autotargetings.
- April 9, 2018
-
The Keywords.get method no longer allows getting the Productivity parameter: it always returns null (nil).
The Dictionaries.get method no longer allows getting a 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 service. If you pass this value in the BiddingStrategyType parameter for the Search structure, an error is returned.
- March 19, 2018
-
Added the Leads service for getting data that users enter in forms on turbo pages.
- February 26, 2018
- The BidModifiers service now supports video bid adjustments. More about bid adjustments
- February 8, 2018
- In the Reports service, added the values SMART_MULTIPLE and SMART_SINGLE for the AdFormat field.
- January 29, 2018
-
Added the CriterionType field in the Reports service.
- January 10, 2018
-
The Clients.get method method now allows you to get agency parameters and user settings for the agency's representative.
- December 13, 2017
-
The Ads service now supports image ads that use creatives created in the Ad Builder. Learn more about ad types
- November 27, 2017
- Changed the amount of points deducted for calling the methods Bids.get and Keywords.get. Learn more about points
- November 13, 2017
-
Changed the errors that are returned when the request can't be processed. Instead of error code 53, the following error codes are returned:
If a request on behalf of an agency representative omits the advertiser's username, error code 8000 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 is returned.
If the user doesn't have access to the Yandex Direct API, error code 3000 is returned.
- October 17, 2017
- Added support for autotargeting in the Bids, Keywords, and Reports services. Learn more.
- September 27, 2017
-
The Reports 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 service (for “Text & Image Ads” and “Dynamic ads” campaigns).
- September 11, 2017
-
The Campaigns 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 service.
- August 29, 2017
-
Added the AgencyClients.add method for registering new agency clients and the AgencyClients.update method for editing parameters of agency clients.
Added the Clients.update method for editing advertiser parameters and user settings for an advertiser's representative.
- August 15, 2017
-
In the Ads service, added the Title2 parameter for Text & Image ads.
Changed the restrictions on the number of characters in the Title and Text fields for Text & 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.get 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 field now.
- August 7, 2017
-
The Campaigns 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 service.
For more information about how to assign and unassign video extensions, see the section Ad extensions.
- June 28, 2017
-
Disabled support for the LOWEST_COST, LOWEST_COST_GUARANTEE, and LOWEST_COST_PREMIUM strategies in the Campaigns 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.
-
In the Campaigns service, changes were made in settings 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 service has the new fields MatchedKeyword, Criterion, and CriterionId.
- June 20, 2017
-
Support for the 4th position in premium placement has been added to service Bids: the P14 value in the Position parameter of the AuctionBids array, returned via the Bids.get method, as well as the query parameter Position of the Bids.setAuto method.
- May 3, 2017
-
The BidModifiers service now supports regional bid adjustments. More about bid adjustments
- April 17, 2017
- Added the KeywordsResearch service for getting a forecast of impressions for keywords.
- April 17, 2017
-
The AdGroups.get method now includes the RestrictedRegionIds response parameter.
- March 21, 2017
- Added the Reports service for getting statistics.
- March 6, 2017
-
Added the AgencyClients service for managing agency clients.
- February 28, 2017
-
You can now target mobile app ads by user interests (see Targeting by mobile app interests):
Methods of the AudienceTargets service now have the InterestId parameter.
The Dictionaries.get method returns a reference list of mobile app categories to use as interests.
The Changes.checkDictionaries method now includes the InterestsChanged response parameter.
- February 14, 2017
-
Added support for negative keywords containing up to 7 words:
In the AdGroups service — in the NegativeKeywords ad group parameter.
In the Campaigns service — in the NegativeKeywords campaign parameter.
- January 25, 2017
-
Added support for the “ Rarely served ” status: the methods AdGroups.get, Keywords.get, and Bids.get now have the ServingStatuses request parameter and the ServingStatus response parameter.
The following keyword data is unavailable in groups with the “rarely served” status:
StatisticsSearch and StatisticsNetwork in the Keywords.get method.
CompetitorsBids, SearchPrices, ContextCoverage, AuctionBids, MinSearchPrice, and CurrentSearchPrice in the Bids.get method.
- December 26, 2016
-
The ContextCoverage array in the Bids.get method is unavailable for campaigns with the SERVING_OFF or NETWORK_DEFAULT display strategy.
- November 9, 2016
-
Added the Clients service for getting client information.
- November 1, 2016
-
Added support for a new currency: the Belarusian ruble (BYN).
- October 17, 2016
- Attention.
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, 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 the Help for Yandex Direct: Russian rubles or other currency.
- October 13, 2016
-
The methods for the Ads 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.get 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.
List of deleted regionsDeleted region Replaced by regions in the group settings Statistics moved to the region ID Region name (with higher levels) 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 Deleted region Replaced by regions in the group settings Statistics moved to the region ID Region name (with higher levels) 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 - 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 service for managing audience targets, and the RetargetingLists service for managing retargeting lists. Learn more about audience targeting
- 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.get 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.
List of regions planned for deletionRegion to be deleted To be replaced by regions in the group settings Statistics will be moved to the region ID Region name (with higher levels) 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 Region to be deleted To be replaced by regions in the group settings Statistics will be moved to the region ID Region name (with higher levels) 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 - September 8, 2016
-
The Ads.get method now includes the PROJECT_DECLARATION value for the AdCategories parameter.
- September 6, 2016
-
The AdGroups.get method now supports getting 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 service. Learn more about ad types
Added the AdImages service for managing images. This service supports image sizes for use in image ads. Learn more about images
- August 11, 2016
-
The Keywords.get method now includes the ModifiedSince request parameter.
- June 2, 2016
-
In the BidModifiers 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
- May 10, 2016
-
The AdExtensions.get method now includes the States and ModifiedSince request parameters and the State and Associated response parameters.
- April 18, 2016
-
Added the DisplayUrlPath parameter to the Ads service methods, along with the DisplayUrlPathModeration parameter to the response of the Ads.get method for Text & Image ads.
- April 14, 2016
-
The Dictionaries.get 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 service for managing ad extensions. Only one type of extension, the callout, is available at this time. More about callouts
The Ads service now supports callouts for Text & Image ads and dynamic text ads. More about ads
Added support for images in the Ads service for ads with the “Ads for mobile apps” type.
Added the Dictionaries 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 Campaigns service methods (for all campaign types).
- February 16, 2016
-
Added the OptimizeGoalId campaign parameter to methods of the Campaigns 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
-
The AdGroups.get method now includes the DomainUrlProcessingStatus parameter.
- January 11, 2016
-
In the BidModifiers service, changed the acceptable coefficient values in bid adjustments for gender, age, and website users.
- December 15, 2015
-
Added the DynamicTextAdTargets service for managing targeting conditions for dynamic text ads. Learn more.
In the Campaigns service, added campaign support for dynamic text ads. Learn more about campaigns
In the AdGroups service, added group support for dynamic text ads. Learn more about ad groups
In the Ads service, added support for dynamic text ads. More about ads
- November 9, 2015
-
The Keywords.get method has the added ability to get the number of impressions and keys for a keyword over 28 days.
The Keywords.add method now allows setting the bid or priority for the keyword being created.
- October 26, 2015
-
Added the Campaigns service for campaign management. The service supports campaigns for mobile app advertising. Learn more about campaigns
The AdGroups service now supports groups for mobile app advertising. Learn more about ad groups
The Ads service now supports ads for mobile app advertising. More about ads
The methods Sitelinks.add and Sitelinks.get now include the Description parameter.
- September 30, 2015
-
The Bids.setAuto method now allows calculating bids for search based on the minimum bid for second position in Premium Placement.
- September 8, 2015
-
Added the BidModifiers service for managing bid adjustments. More about bid adjustments
- September 1, 2015
-
The Bids.get 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 is set to AuctionBids, the method returns the AuctionBids array.
- June 26, 2015
- Launched.