update: CpmBannerCampaign parameters

Request structure in JSON format:

{
  "method": "update",
  "params": {
    "Campaigns": [{  /* CampaignUpdateItem */
      ...
      "CpmBannerCampaign": {  /* CpmBannerCampaignUpdateItem */
        "BiddingStrategy": {  /* CpmBannerCampaignStrategy */
          "Search": {  /* CpmBannerCampaignSearchStrategy */
            "BiddingStrategyType": ( "SERVING_OFF" ) /* required */
          },
          "Network": {  /* CpmBannerCampaignNetworkStrategy */
            "BiddingStrategyType": ( "MANUAL_CPM" | ... | "WB_DECREASED_PRICE_FOR_REPEATED_IMPRESSIONS" ), /* required */
            "WbMaximumImpressions": {  /* StrategyWbMaximumImpressions */
              "AverageCpm": (long), /* required */
              "SpendLimit": (long) /* required */
            },
            "CpMaximumImpressions": {  /* StrategyCpMaximumImpressions */
              "AverageCpm": (long), /* required */
              "SpendLimit": (long), /* required */
              "StartDate": (string), /* required */
              "EndDate": (string), /* required */
              "AutoContinue": ( "YES" | "NO" ) /* required */
            },
            "WbDecreasedPriceForRepeatedImpressions": {  /* StrategyWbDecreasedPriceForRepeatedImpressions */
              "AverageCpm": (long), /* required */
              "SpendLimit": (long) /* required */
            },
            "CpDecreasedPriceForRepeatedImpressions": {  /* StrategyCpDecreasedPriceForRepeatedImpressions */
              "AverageCpm": (long), /* required */
              "SpendLimit": (long), /* required */
              "StartDate": (string), /* required */
              "EndDate": (string), /* required */
              "AutoContinue": ( "YES" | "NO" ) /* required */
            },
            "WbAverageCpv" : {  /* StrategyWbAverageCpv */
              "AverageCpv" : (long) /* required */,
              "SpendLimit" : (long) /* required */
            },
            "CpAverageCpv" : {  /* StrategyCpAverageCpv */
              "AverageCpv" : (long) /* required */,
              "SpendLimit" : (long) /* required */,
              "StartDate" : (string) /* required */,
              "EndDate" : (string) /* required */,
              "AutoContinue" : ( "YES" | "NO" ) /* required */
            }
          }
        },
        "Settings": [{  /* CpmBannerCampaignSetting */
          "Option": ( "ADD_METRICA_TAG" | ... | "REQUIRE_SERVICING" ), /* required */
          "Value": ( "YES" | "NO" ) /* required */
        }, ... ],
        "CounterIds": {  /* ArrayOfInteger */
          "Items": [(int), ... ] /* required */
        }, /* nillable */
        "FrequencyCap": {  /* FrequencyCapSetting */
          "Impressions": (int), /* required */
          "PeriodDays": (int) /* required */ /* nillable */
        }, /* nillable */
        "VideoTarget": ("VIEWS"|"CLICKS")
      }
    }, ... ] /* required */
  }
}

Parameter	Type	Description	Required
CpmBannerCampaignUpdateItem structure
`BiddingStrategy`	CpmBannerCampaignStrategy	Display strategy.	No
`Settings`	array of CpmBannerCampaignSetting	Array of settings that only accept the values YES or NO.	No
`CounterIds`	ArrayOfInteger, nillable	The IDs of Yandex Metrica tags installed on the advertiser's website (see Yandex Metrica: evaluate your ad performance in the Yandex Direct Help).	No
`FrequencyCap`	FrequencyCapSetting, nillable	Limits the frequency of impressions per user. To reset the limit, pass null (nil).	No
`VideoTarget`	VideoTargetEnum	Goal for video ads. Available values: VIEWS: Full views. CLICKS: Site traffic. In the AUTOBUDGET_AVG_CPV and AUTOBUDGET_AVG_CPV_CUSTOM_PERIOD strategies, the value is reset to null.	No
CpmBannerCampaignSetting structure
`Option`	CpmBannerCampaignSettingsEnum	Setting name: ADD_METRICA_TAG ADD_OPENSTAT_TAG ADD_TO_FAVORITES ENABLE_AREA_OF_INTEREST_TARGETING ENABLE_SITE_MONITORING REQUIRE_SERVICING	Yes
`Value`	YesNoEnum	Setting value.	Yes
FrequencyCapSetting structure
`Impressions`	int	Maximum number of impressions per user during a period.	Yes
`PeriodDays`	int, nillable	Number of days from 1 to 30. null (nil) — The limit applies to the entire time the advertising campaign is running.	Yes
CpmBannerCampaignStrategy structure
`Search`	CpmBannerCampaignSearchStrategy	Display strategy in search results.	No
`Network`	CpmBannerCampaignNetworkStrategy	Display strategy in ad networks.	No
CpmBannerCampaignSearchStrategy structure
`BiddingStrategyType`	CpmBannerCampaignSearchStrategyTypeEnum	The type of display strategy in search results. Only one value is available: SERVING_OFF	Yes
CpmBannerCampaignNetworkStrategy structure
`BiddingStrategyType`	CpmBannerCampaignNetworkStrategyTypeEnum	The type of display strategy in ad networks: MANUAL_CPM CP_DECREASED_PRICE_FOR_REPEATED_IMPRESSIONS WB_DECREASED_PRICE_FOR_REPEATED_IMPRESSIONS CP_MAXIMUM_IMPRESSIONS WB_MAXIMUM_IMPRESSIONS CP_AVERAGE_CPV WB_AVERAGE_CPV	Yes
`WbMaximumImpressions`	StrategyWbMaximumImpressions	Parameters of the strategy Maximum impressions at minimal cost (weekly).	When the `BiddingStrategyType` parameter is set to WB_MAXIMUM_IMPRESSIONS
`CpMaximumImpressions`	StrategyCpMaximumImpressions	Parameters of the strategy Maximum impressions at minimal cost (over a period).	When the `BiddingStrategyType` parameter is set to CP_MAXIMUM_IMPRESSIONS
`WbDecreasedPriceForRepeatedImpressions`	StrategyWbDecreasedPriceForRepeatedImpressions	Parameters of the strategy Decrease cost for repeat impressions (weekly).	When the `BiddingStrategyType` parameter is set to WB_DECREASED_PRICE_FOR_REPEATED_IMPRESSIONS
`CpDecreasedPriceForRepeatedImpressions`	StrategyCpDecreasedPriceForRepeatedImpressions	Parameters of the strategy Decrease cost for repeat impressions (over a period).	When the `BiddingStrategyType` parameter is set to CP_DECREASED_PRICE_FOR_REPEATED_IMPRESSIONS
`WbAverageCpv`	StrategyWbAverageCpv	Parameters of the strategy Maximum video views (weekly).	When the `BiddingStrategyType` parameter is set to WB_AVERAGE_CPV
`CpAverageCpv`	StrategyCpAverageCpv	Parameters of the strategy Maximum video views (for the period).	When the `BiddingStrategyType` parameter is set to CP_AVERAGE_CPV
StrategyWbMaximumImpressions structure
`AverageCpm`	long	The average CPM in the advertiser's currency, multiplied by 1,000,000. The minimum value for the average cost is listed by currency in the currency reference. To get the list of currencies, use the Dictionaries.get method.	Yes
`SpendLimit`	long	The weekly budget in the advertiser's currency, multiplied by 1,000,000. The minimum weekly budget for each currency is listed in the currency reference. To get the list of currencies, use the Dictionaries.get method.	Yes
StrategyCpMaximumImpressions structure
`AverageCpm`	long	The average CPM in the advertiser's currency, multiplied by 1,000,000. The minimum value for the average cost is listed by currency in the currency reference. To get the list of currencies, use the Dictionaries.get method.	Yes
`SpendLimit`	long	The budget for the period in the advertiser's currency, multiplied by 1,000,000. The minimum budget for each currency is listed in the currency reference. To get the list of currencies, use the Dictionaries.get method.	Yes
`StartDate`	string	Date of the start of the period, in the format YYYY-MM-DD. Can't be earlier than the current date or the campaign start date.	Yes
`EndDate`	string	Date of the end of the period, in the format YYYY-MM-DD. Can't be later than the campaign end date.	Yes
`AutoContinue`	YesNoEnum	Extend the campaign period automatically in order to use the remaining budget.	Yes
StrategyWbDecreasedPriceForRepeatedImpressions structure
`AverageCpm`	long	The average CPM in the advertiser's currency, multiplied by 1,000,000. The minimum value for the average cost is listed by currency in the currency reference. To get the list of currencies, use the Dictionaries.get method.	Yes
`SpendLimit`	long	The weekly budget in the advertiser's currency, multiplied by 1,000,000. The minimum weekly budget for each currency is listed in the currency reference. To get the list of currencies, use the Dictionaries.get method.	Yes
StrategyCpDecreasedPriceForRepeatedImpressions structure
`AverageCpm`	long	The average CPM in the advertiser's currency, multiplied by 1,000,000. The minimum value for the average cost is listed by currency in the currency reference. To get the list of currencies, use the Dictionaries.get method.	Yes
`SpendLimit`	long	The budget for the period in the advertiser's currency, multiplied by 1,000,000. The minimum budget for each currency is listed in the currency reference. To get the list of currencies, use the Dictionaries.get method.	Yes
`StartDate`	string	Date of the start of the period, in the format YYYY-MM-DD. Can't be earlier than the current date or the campaign start date.	Yes
`EndDate`	string	Date of the end of the period, in the format YYYY-MM-DD. Can't be later than the campaign end date.	Yes
`AutoContinue`	YesNoEnum	Extend the campaign period automatically in order to use the remaining budget.	Yes
StrategyWbAverageCpv structure
`AverageCpv`	long	The average CPV in the advertiser's currency, multiplied by 1,000,000. The minimum value for the average cost is listed by currency in the currency reference. To get the list of currencies, use the Dictionaries.get method.	Yes
`SpendLimit`	long	The weekly budget in the advertiser's currency, multiplied by 1,000,000. The minimum weekly budget for each currency is listed in the currency reference. To get the list of currencies, use the Dictionaries.get method.	Yes
StrategyCpAverageCpv structure
`AverageCpv`	long	The average CPV in the advertiser's currency, multiplied by 1,000,000. The minimum value for the average cost is listed by currency in the currency reference. To get the list of currencies, use the Dictionaries.get method.	Yes
`SpendLimit`	long	The budget for the period in the advertiser's currency, multiplied by 1,000,000. The minimum budget for each currency is listed in the currency reference. To get the list of currencies, use the Dictionaries.get method.	Yes
`StartDate`	string	Date of the start of the period, in the format YYYY-MM-DD. Can't be earlier than the current date or the campaign start date.	Yes
`EndDate`	string	Date of the end of the period, in the format YYYY-MM-DD. Can't be later than the campaign end date.	Yes
`AutoContinue`	YesNoEnum	Extend the campaign period automatically in order to use the remaining budget.	Yes

Was the article helpful?

update: MobileAppCampaign parameters

Changes: checking for changes