modify

objectID*

ID of the campaign whose parameters you want to edit.

name

Campaign name. An entry can contain Russian and Latin letters, numbers, and any special characters.

advertiserID

Advertiser ID.

For a campaign inside a supercampaign, the advertiser ID is ignored.

See also:

• Add an advertiser.
• Get a list of advertisers.

assistantID

ID of the assistant who will be allowed access to the object according to their permissions.

For a campaign inside a supercampaign, the assistant ID is ignored.

See also:

• Create an assistant.

• Get a list of assistants.

kind_id

Defines the campaign type.

Acceptable values:

• 1: The Guarantee type is used for campaigns with guaranteed sales where there are ad running obligations. Includes the dependence of two parameters:

  • The level parameter can only take values from 1 to 10. If the parameter isn't passed, the default value (1) is used.
  • The cpm parameter isn't required. If it's passed, its value is ignored.

• 2: The Dynamic monetization type allows the publisher to receive the highest revenue from impressions, enabling the Yandex Advertising Network to compete for impressions of non-guaranteed campaigns. Campaigns are prioritized by CPM. Includes the dependence of two parameters:

  • The level parameter must be equal to 11. If the parameter isn't passed, the default value 11 is used.
  • The cpm parameter is required and must be > 0.

  If the campaign was created with an external monetizer, you can't change the Campaign type. Its value must be 2.

• 3: The Promo type is used for your custom promotion campaigns and placeholders. Includes the dependence of two parameters:

  • The level parameter can only take values from 12 to 20. If the parameter isn't passed, the default value 12 is used.
  • The cpm parameter isn't required. If it's passed, its value is ignored.

level

Campaign level.

Depending on whether you connect the “Campaign types” module in the account, a different number of levels is available for campaigns.

Acceptable values if the “Campaign types” module is disabled: from 1 to 10 inclusive.

Acceptable values if the “Campaign types” module is enabled:

• From 1 to 10 inclusive: for the Guarantee type campaigns (kind_id=1).
• 11: for the Dynamic monetization type campaigns (kind_id=2).
• From 12 to 20: for the Promo type campaigns (kind_id=3).

Pay attention to the dependence of the kind_id and cpm parameter values.

priority

Priority.

Acceptable values: 1≤N≤1000, where N is a number from 1 to 1000 inclusive.

status

Object status. Only objects with the active status can be displayed.

Acceptable values:

• 0: Active. The object is ready for delivery.
• 1: Paused. The object is assumed to be temporarily disabled. by default, filters in the Adfox web interface show paused objects in the list.
• 2: Completed. The object is assumed to be delivered in full. by default, filters in the Adfox web interface hide completed objects.

sectorID

Industry.

See also:

• Get a list of industries.

rotationMethodID

Campaign rotation method.

Acceptable values:

• 0: by priority. Use the level and priority parameter values to estimate the probability of serving the campaign.
• 1: by % of traffic. Use the traffic percentage parameter value to estimate the probability of serving the campaign. The trafficPercents parameter is required.

trafficPercents

Traffic percentage.

Required if the traffic percentage rotation method is used (rotationMethodID=1).

Acceptable values: from 1 to 100.

targetingProfileID

Targeting profile ID.

You can use a targeting profile to combine the settings of several targeting types. When creating a campaign or banner, you can specify a targeting profile. This way, you don't waste time setting up every targeting type separately.

See also:

• View a list of profile IDs.

sequence

Group.

tracingTypeID

Action tracing.

Acceptable values:

• 0: Don't track user actions on the advertiser's website.
• 1: PostClick. Count the number of action tracing point downloads within 24 hours after an ad click.
• 2: PostClick and PostView. Count the number of action tracing point downloads after a click and after an impression.
• 3: PostView. Count the number of action tracing point downloads after an impression or 24 hours after a click occurred.

isSession

Session impressions.

Acceptable values:

• 0: Disabled.
• 1: Enabled.

outerMarkID

Enable automatic tag substitution for click links.

Acceptable values:

• 0: Disabled.
• 1: Openstat.ru.
• 2: Google Analytics.

isSimplifiedBanners

Simplified banners (additional module).

Acceptable values:

• 0: Disabled.
• 1: Enabled.

impressionsSmoothTypeID

Impression running speed.

Acceptable values:

• 0: As fast as possible. Campaign banners are served at the maximum possible speed until the impression limits are reached (if specified). The maximum running speed doesn't require that you specify any limits and start/end dates of the campaign.

• 1: Spread evenly throughout the day. Impressions are uniformly distributed throughout the day. Make sure to specify the maximum number of impressions per day (maxImpressionsPerDay).

• 2: Spread evenly throughout the entire period. The campaign impressions are distributed evenly over the entire period based on account statistics. Make sure to specify the maximum number of impressions (maxImpressions) and the campaign end date (dateEnd).

• 3: Spread evenly throughout the entire period (automatic prolongation). The campaign impressions are distributed evenly over the entire period based on account statistics. If the campaign doesn't reach the impression limit in the allocated time, it's automatically extended for one day and runs at the maximum speed on that day. Make sure to specify the maximum number of impressions (maxImpressions) and the campaign end date (dateEnd).

clicksSmoothTypeID

Click delivery speed.

Acceptable values:

• 0: As fast as possible. Campaign banners are served at the maximum possible speed until the click limits are reached (if specified). The maximum running speed doesn't require that you specify any limits and start/end dates of the campaign.

• 1: Spread evenly throughout the day. Impressions are uniformly distributed throughout the day. Make sure to specify the maximum number of clicks per day (maxClicksPerDay).

• 2: Spread evenly throughout the entire period. The campaign impressions are distributed evenly over the entire period based on account statistics. Make sure to specify the maximum number of clicks (maxClicks) and the campaign end date (dateEnd).

• 3: Spread evenly throughout the entire period (automatic prolongation). The campaign impressions are distributed evenly over the entire period based on account statistics. If the campaign doesn't reach the click limit in the allocated time, it's automatically extended for one day and runs at the maximum speed on that day. Make sure to specify the maximum number of clicks (maxClicks) and the campaign end date (dateEnd).

isTrafficSmooth

Spread evenly throughout the day.

Acceptable values:

• 0: Disable.
• 1: Enable.

maxImpressions

Maximum number of banner impressions.

Acceptable values: integers from 1 to 2,147,483,647.

maxImpressionsPerDay

Maximum number of impressions per day.

Acceptable values: integers from 1 to 2,147,483,647.

maxClicks

Maximum total number of clicks.

Acceptable values: integers from 1 to 2,147,483,647.

maxClicksPerDay

Maximum number of clicks per day.

Acceptable values: integers from 1 to 2,147,483,647.

dateStart

Delivery start date.

Date and time format: YYYY-MM-DD HH:mm.

dateEnd

Delivery end date.

Date and time format: YYYY-MM-DD HH:mm.

logicType

Campaign type. Not required for a campaign inside a supercampaign.

Acceptable values:

• 0: Commercial.
• 1: Measuring.

cpm

CPM floor value for a campaign of the Dynamic monetization type.

For kind_id=2, the parameter is required.

For kind_id=1\|3, the parameter is optional. But if it's passed, its value is ignored.

Acceptable values: integers from 1 to 99,999.

If CPM is passed, don't pass CPC.

cpc

CPC floor value for a campaign of the Dynamic monetization type.

For kind_id=2, the parameter is required.

For kind_id=1\|3, the parameter is optional. But if it's passed, its value is ignored.

Acceptable values: an integer > 0.

If CPC is passed, don't pass CPM.

sendToErir

Submit data to the Russian state register.

Acceptable values:

• 0: Don't submit data to the Russian state register.
• 1: Submit data to the Russian state register (ad register is enabled).

contractID

Contract identifier. This parameter is required if sendToErir=1. Learn more about getting a list of contracts.

costType

Campaign type.

Acceptable values:

• 0: Other.
• 1: CPM.
• 2: CPC.
• 3: CPA.

okveds[]

List of OKVED codes of advertised products. If there are multiple codes, submit them using a new parameter, for example: &okveds[]=88.33&okveds[]=77.54.

markingAdvertiserInfo

Information about the advertiser in the banner menu. Displayed if the Show ad menu option is enabled for the banner. by default, this string is empty.

code

Request processing status. For the key, see Error handling.