Yandex.Direct API

October 2016
API News
4 October 2016, 12:39

In statistics provided by the GetBannersStat (Live) and CreateNewReport (Live) methods, the time range of available data has changed for an ad's average position and the device type. Data is now available beginning from November 1, 2014.

Coming Soon: Structural Changes to Geotargeting Tree for Ukraine and Baltic Countries
5 October 2016, 18:09

In about a week, the structure of the geotargeting tree in Yandex.Direct will undergo some important changes.

Updates to the geotargeting tree involve changes to the geobase, sent using the get method of the Dictionaries service or the GetRegions method. If your app does not support automatic updates to the geotargeting tree, you’ll have to make these changes manually as soon as the new data become openly available. We will notify you when these updates are ready.

For more information about the changes and new region's IDs, have a look at the documentation.

What’s changing?

1. The region tree for Ukraine will be simplified by removing one nesting level: Center, West, East, South, North.
As a result, the geotargeting tree settings will change from “Ukraine -> East -> Kharkiv Region” to “Ukraine -> Kharkiv Region”.

Please note that statistics linked to this additional nesting level will “jump” one level higher when these changes come into effect. To continue using our example, data for the region “East” will move up to the “Ukraine” level. Statistics of other nesting levels (sublevels) will remain unchanged.

2. Recent official changes to the names of several cities in Ukraine will be reflected in the interface.

3. The region tree for the Baltic countries will also be simplified, removing the “Baltic” nesting level:
As a result, the settings will change from “Europe -> Baltic -> Latvia, Lithuania, Estonia” to “Europe -> Latvia, Lithuania, Estonia”.

4. Romania and Portugal will be added to the geotargeting tree.

Please note when these changes take effect, the parent region ID of some cities in the API will also change. For example, the city of Kharkiv will have “Ukraine” as its ParentID instead of “East” as in the current version.

News Digest
17 October 2016, 13:40
  • The reference list of regions has been changed. We recommend calling the GetRegions (Live) method or the get method of the Dictionaries service to get an updated list of regions.
  • The methods for the Ads service have an extended set of possible values for the Action parameter for mobile app ads. The list of the button label: DOWNLOAD — “Download, GET — “Get”, INSTALL — “Install”, MORE — “More”, OPEN — “Open”, UPDATE — “Update”, PLAY — “Play”, BUY_AUTODETECT — “Buy”.
  • In a week, there will be added a restriction for keywords: the maximum length of each word or negative keyword in a keyword is 35 characters.
  • As of October 10, 2016, advertising agencies can only register clients who are using a real currency. Registration of clients who use Yandex units has been disabled. Accordingly, the logic of the CreateNewSubclient (Live) method has changed.
Switchover from conventional units to payment currency
18 October 2016, 12:34

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.