Error handling

If there's an error tag in the response, it means an error occurred when processing the request. You need to correct the request and repeat it.

Sample error response:

  • As a simple structure.

    <response>
     <status>
      <code>-2</code>
      <error>Access denied</error>
     </status>
    </response>
    
  • With additional information about the incorrect parameter.

    <response>
     <status>
      <code>-6</code>
      <error>Incorrect value</error>
      <parameter>encoding</parameter>
      <value>123</value>
     </status>
    </response>
    

A request may be partially executed. In this case, the response contains the <code>0</code> tag and the message tag describing the part of the request that hasn't been executed.

See the error code key in the table:

Code

Error

Key

-1

Authorization failed

Authorization error. Check whether the login and password are correct. The password must be passed as the value of the sha256 hash function from the user's password.

-2

Access denied

Access to the object is denied. You don't have enough access rights.

-2

Change targeting by URL is not allowed

You don't have access to editing targeting by URL.

-3

Invalid object name

Incorrect object. Check the context name.

-4

Invalid action object name

Incorrect actionObject. Check the name of the object that the action is performed on.

-5

Invalid action name

Incorrect action. Check the action name.

-6

Incorrect value

Incorrect parameter value. Check the parameter value.

-6

Type 3 is not allowed

An invalid URL template type is set for the templateType parameter.

-6

Maximum allowed referrers 5

Exceeded the number of template lines for targetingUrlOn or targetingUrlOff. A maximum of 5 lines is allowed.

-6

Value for 'placeId' is required

The placeID, siteID, or zoneID parameter isn't specified or is equal to 0.

-7

Value required

A required parameter isn't set. Check whether the request contains all required parameters.

-8

Account already exists

The account already exists (the error is displayed when you create or rename an account). Try entering a different account name.

-9

Value must be not NULL

The parameter can't be empty. Specify the parameter value.

-10

A warning when you enable or disable a placement:

-10

This object is placed upper

The object is enabled in the placement at a higher level.

-10

This object is unplaced upper

The object is disabled in the placement at a lower level.

-11

Error file uploading

File upload error. Incorrect links to media data transmitted. The tag will contain the URL that the data could not be uploaded for

-12

Value is out of length

The maximum allowed length of the parameter value line has been exceeded.

-14

Duplicate entry

This identifier of the value of an additional characteristic or an action tracing point is already in use. Specify a different value for the userID parameter.

-15

Invalid type

Invalid data type:

  • When the object passed is not an array (for example, a string for OKVED codes instead of an array).
  • Invalid JSON for media data.

The parameter name is added to the <parameter> tag and the parameter value to the <value> tag. The response will also contain the maximum and minimum values.

-16

Type required

The required type parameter isn't specified for the banner placement setting. Add the type parameter: it determines the placement setting logic on the site or the ad network.

-99

Multiple errors

When adding a backup ad for a banner type or placement, no value was specified for the image URL (defaultImageURL) or click URL (defaultHitURL) parameter.

-100

The maximum allowed file size has been exceeded.

-101

Incorrect MIME type.

-102

Internal error.

-103

Internal error.

-200

Couldn't load the file at the specified URL.

-667

Logon errors limit reached

The limit of authorization errors has been reached: 7 incorrect attempts were made in the last 5 minutes. You need to check the authorization data and try again after 10 minutes.

-680

Connection limit reached

The maximum number of concurrent requests was exceeded. Repeat the request later.

-999

Http is not allowed

This type of request can't be executed over the HTTP protocol. Repeat the request over HTTPS.

-1415

Daily amount of views should be set

Set the daily number of impressions.

-1416

Daily amount of clicks should be set

Set the daily number of clicks.

-1420

Cumulative amount of views should be set

Set the total number of clicks.

-1420

Cumulative amount of clicks should be set

Set the total number of impressions.

-1500

Only marked as "For insertion code with context.js" banners can be added in campaign with Impression method "Viewable impression, 2 seconds".

If a campaign uses “Viewable impression, 2 seconds” as the impression count method, only banners with templates that have the [context] tag in their name can be added to the campaign.

-1501

Banners do not match the campaign, or they are deleted

Banners required for copying weren't found in the specified campaign, or they were deleted. Check the values for the objectID and listIDs parameters.

-1502

Only banners with templates marked as "For insertion code with context.js" is allowed to add in this campaign

If a campaign uses “Viewable impression, two seconds” as the impression count method, only banners with templates that have the [context] tag in their name can be copied to the campaign.

-1504

Campaign kind is not dynamic allocation

Can't determine CPM because the campaign type isn't Dynamic monetization. Change the campaign type and repeat the CPM change.

-1505

Dynamic allocation is not enabled

The “Dynamic monetization” module isn't enabled in the account. Contact support to enable the module.

-1506

CPM is blocked in system campaigns

Can't change the CPM for a system campaign. Check the ID of the campaign that you want to modify.

-1507

To change the CPM, you need to wait 5 minutes. Please wait 5 minutes.

Repeat the CPM change request after 5 minutes.

-1508

Incorrect JSON format in "blocks" field

The JSON value is described incorrectly, or there's no blocks parameter in the logical targeting. Check the syntax and repeat the request.

-1516

Can not copy campaigns or banners with external monetization

Campaigns and banners created for external monetizers (such as criteo, Soloway, mytarget, and others) can't be copied. Copying banners from campaigns for monetizers is also prohibited.

-2000

Advertiser is not assigned for current assistant

The assistant can't work with this advertiser. You need to either manage the assistant's permissions, or create a campaign with an advertiser that's available to the assistant.

-2500

You should use IMS template in IMS campaign

When you create a banner in a campaign with the IMS impression count method, you have to use IMS templates. Get a list of templates for the banner type and make sure that IMS is enabled in the template (isIms=1).

-10101

File size limit reached

by default, the maximum file size is 300 KB. The maximum video size is 1 MB.

-10103

Wrong file type

Invalid file type in the archive. Allowed file types: CSS, JS, HTML, GIF, PNG, JPG, JPEG, SVG, JSON, FLV, MP4, OGV, OGG, WEBM, AVI, SWF, OTF, TTF, ABF, ACFM, GDR, ETX, EOT, FNT, FON, MF, TTC, and WOFF.

-10104

Wrong file name

File names must only contain numbers, Latin letters, or an underscore. You can't use Cyrillic letters, spaces, quotation marks, dashes, and special characters in the file name.

-10105

Too long html field

The HTML code can't be more than 65,000 characters.

-10105

Unsupported archive type

The archive type is unsupported. You can only use a ZIP archive.

-10106

Must be one html file in archive

The project can contain only one file with the HTML extension.

-10108

Files depth limit reached

The file nesting depth has been exceeded. The maximum nesting level is 2.

-20000

You need to specify the creative data

Data about creatives was not transmitted or data could not be obtained from the transmitted parameters (for example, template creatives with no data are specified).

-20001

The advertising campaign is not marked

Can't enable the ad register for the banner, since it is disabled for the campaign.

-20002

The contract not found

The contract wasn't found.

-20003

The customer not found

The customer wasn't found.

-20004

The executor not found

The contractor wasn't found.

-20005

The intermediary contract not found

The parent contract wasn't found.

-20006

The customer and the executor cannot be the same contractor

The customer and the contractor cannot be the same counterparty.

-20007

Intermediary contract id can not be empty

The parent contract ID must be specified for this contract.

-20008

The contract can not be deleted because it is linked to a campaign

Can't delete the contract because it is linked to a campaign.

-20009

The contract can not be deleted because it is linked to a supercampaign

Can't delete the contract because it is linked to a supercampaign.

-20010

The contract can not be deleted, because it has an additional agreement associated with it

Can't delete the contract because there is an additional agreement associated with it.

-20011

Can not delete role "Executor". There are sites associated with this executor

The "Executor" role cannot be deleted. There are websites associated with this contractor.

-20012

Can not delete role "Executor". There are contracts associated with this executor

The "Executor" role cannot be deleted. There are contracts associated with the counterparty.

-20013

Can not delete role "Customer". There are contracts associated with this customer

The "Customer" role cannot be deleted. There are contracts associated with the counterparty.

-20014

The contractor can not be deleted because it is linked to a contracts

You cannot delete a contractor that there are valid contracts with.

-20015

The contractor can not be deleted because it is linked to a sites

You cannot delete the counterparty. There are websites associated with it.

-20040

INN is duplicated

A contractor with this INN already exists.

-20042

Incorrect conclusion date (the date must be greater than 1991.01.01 and not older than the current date)

A date of a contract/additional agreement is incorrect. The date must be greater than 1991.01.01 and not older than the current date.

-20050

Token field is not allowed when sendToErir=1

You can pass a third-party token only when data submitting to the Russian state register is turned off. If the parameter issendToErir=1, own token is generated in the creative.

-20051

Invalid third-party token (letters and numbers only allowed)

Incorrect third-party token (only Latin letters and numbers are allowed).