add: CpmBannerCampaign parameters

Attention. All monetary campaign parameters (daily budget, weekly budget, and average price for automatic strategies) are passed via the Yandex Direct API as integer numbers. The passed value is a monetary value in the advertiser's currency, multiplied by 1,000,000.

Request structure in JSON format:

{
  "method": "add",
  "params": {
    "Campaigns": [{  /* CampaignAddItem */
      ...
      "CpmBannerCampaign": {  /* CpmBannerCampaignAddItem */
        "BiddingStrategy": {  /* CpmBannerCampaignStrategyAdd */
          "Search": {  /* CpmBannerCampaignSearchStrategyAdd */
            "BiddingStrategyType": ( "SERVING_OFF" ) /* required */
          }, /* required */
          "Network": {  /* CpmBannerCampaignNetworkStrategyAdd */
            "BiddingStrategyType": ( "MANUAL_CPM" | ... | "WB_DECREASED_PRICE_FOR_REPEATED_IMPRESSIONS" ), /* required */
            "WbMaximumImpressions": {  /* StrategyWbMaximumImpressionsAdd */
              "AverageCpm": (long), /* required */
              "SpendLimit": (long) /* required */
            },
            "CpMaximumImpressions": {  /* StrategyCpMaximumImpressionsAdd */
              "AverageCpm": (long), /* required */
              "SpendLimit": (long), /* required */
              "StartDate": (string), /* required */
              "EndDate": (string), /* required */
              "AutoContinue": ( "YES" | "NO" ) /* required */
            },
            "WbDecreasedPriceForRepeatedImpressions": {  /* StrategyWbDecreasedPriceForRepeatedImpressionsAdd */
              "AverageCpm": (long), /* required */
              "SpendLimit": (long) /* required */
            },
            "CpDecreasedPriceForRepeatedImpressions": {  /* StrategyCpDecreasedPriceForRepeatedImpressionsAdd */
              "AverageCpm": (long), /* required */
              "SpendLimit": (long), /* required */
              "StartDate": (string), /* required */
              "EndDate": (string), /* required */
              "AutoContinue": ( "YES" | "NO" ) /* required */
            },
            "WbAverageCpv" : {  /* StrategyWbAverageCpvAdd */
              "AverageCpv" : (long) /* required */,
              "SpendLimit" : (long) /* required */
            },
            "CpAverageCpv" : {  /* StrategyCpAverageCpvAdd */
              "AverageCpv" : (long) /* required */,
              "SpendLimit" : (long) /* required */,
              "StartDate" : (string) /* required */,
              "EndDate" : (string) /* required */,
              "AutoContinue" : ( "YES" | "NO" ) /* required */
            }
          } /* required */
        }, /* required */
        "Settings": [{  /* CpmBannerCampaignSetting */
          "Option": ( "ADD_METRICA_TAG" | ... | "REQUIRE_SERVICING" ), /* required */
          "Value": ( "YES" | "NO" ) /* required */
        }, ... ],
        "CounterIds": {  /* ArrayOfInteger */
          "Items": [(int), ... ] /* required */
        },
        "FrequencyCap": {  /* FrequencyCapSetting */
          "Impressions": (int), /* required */
          "PeriodDays": (int) /* required */ /* nillable */
        },
        "VideoTarget": ("VIEWS"|"CLICKS")
      }
    }, ... ] /* required */
  }
}
Parameter Type Description Required
CpmBannerCampaignAddItem structure
BiddingStrategy CpmBannerCampaignStrategyAdd Display strategy. Yes
Settings array of CpmBannerCampaignSetting Array of settings that only accept the values YES or NO. No
CounterIds ArrayOfInteger The IDs of Yandex Metrica tags installed on the advertiser's site (see Yandex Metrica: evaluate your ad performance in the Help for Yandex Direct). No
FrequencyCap FrequencyCapSetting Limits the frequency of impressions per user. If the structure is omitted, the frequency of impressions is not limited. 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:

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
CpmBannerCampaignStrategyAdd structure
Network CpmBannerCampaignNetworkStrategyAdd Display strategy in ad networks. Yes
CpmBannerCampaignSearchStrategyAdd structure
BiddingStrategyType CpmBannerCampaignSearchStrategyTypeEnum The type of display strategy in search results. The only available value is SERVING_OFF. Yes
CpmBannerCampaignNetworkStrategyAdd structure
BiddingStrategyType CpmBannerCampaignNetworkStrategyTypeEnum

The type of display strategy in ad networks:

Yes
WbMaximumImpressions StrategyWbMaximumImpressionsAdd Parameters of the Maximize impressions for lowest price weekly strategy. When the BiddingStrategyType parameter has the value WB_MAXIMUM_IMPRESSIONS
CpMaximumImpressions StrategyCpMaximumImpressionsAdd Parameters of the Maximize impressions for lowest price strategy for a period. When the BiddingStrategyType parameter has the value WB_MAXIMUM_IMPRESSIONS
WbDecreasedPriceForRepeatedImpressions StrategyWbDecreasedPriceForRepeatedImpressionsAdd Parameters of the Decrease price for repeat impressions weekly strategy. When the BiddingStrategyType parameter has the value WB_DECREASED_PRICE_FOR_REPEATED_IMPRESSIONS
CpDecreasedPriceForRepeatedImpressions StrategyCpDecreasedPriceForRepeatedImpressionsAdd Parameters of the Decrease price for repeat impressions strategy for a period. When the BiddingStrategyType parameter has the value CP_DECREASED_PRICE_FOR_REPEATED_IMPRESSIONS
WbAverageCpv StrategyWbAverageCpvAdd Parameters of the Maximum video views (weekly) strategy. When the BiddingStrategyType parameter has the value WB_AVERAGE_CPV
CpAverageCpv StrategyCpAverageCpvAdd Parameters of the Maximum video views (for the period) strategy. When the BiddingStrategyType parameter has the value CP_AVERAGE_CPV
StrategyWbMaximumImpressionsAdd 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
StrategyCpMaximumImpressionsAdd 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
StrategyWbDecreasedPriceForRepeatedImpressionsAdd 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
StrategyCpDecreasedPriceForRepeatedimpressionsAdd 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
StrategyWbAverageCpvAdd 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
StrategyCpAverageCpvAdd 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
Parameter Type Description Required
CpmBannerCampaignAddItem structure
BiddingStrategy CpmBannerCampaignStrategyAdd Display strategy. Yes
Settings array of CpmBannerCampaignSetting Array of settings that only accept the values YES or NO. No
CounterIds ArrayOfInteger The IDs of Yandex Metrica tags installed on the advertiser's site (see Yandex Metrica: evaluate your ad performance in the Help for Yandex Direct). No
FrequencyCap FrequencyCapSetting Limits the frequency of impressions per user. If the structure is omitted, the frequency of impressions is not limited. 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:

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
CpmBannerCampaignStrategyAdd structure
Search CpmBannerCampaignSearchStrategyAdd Display strategy in search results. Yes
Network CpmBannerCampaignNetworkStrategyAdd Display strategy in ad networks. Yes
CpmBannerCampaignSearchStrategyAdd structure
BiddingStrategyType CpmBannerCampaignSearchStrategyTypeEnum The type of display strategy in search results. The only available value is SERVING_OFF. Yes
CpmBannerCampaignNetworkStrategyAdd structure
BiddingStrategyType CpmBannerCampaignNetworkStrategyTypeEnum

The type of display strategy in ad networks:

Yes
WbMaximumImpressions StrategyWbMaximumImpressionsAdd Parameters of the Maximize impressions for lowest price weekly strategy. When the BiddingStrategyType parameter has the value WB_MAXIMUM_IMPRESSIONS
CpMaximumImpressions StrategyCpMaximumImpressionsAdd Parameters of the Maximize impressions for lowest price strategy for a period. When the BiddingStrategyType parameter has the value WB_MAXIMUM_IMPRESSIONS
WbDecreasedPriceForRepeatedImpressions StrategyWbDecreasedPriceForRepeatedImpressionsAdd Parameters of the Decrease price for repeat impressions weekly strategy. When the BiddingStrategyType parameter has the value WB_DECREASED_PRICE_FOR_REPEATED_IMPRESSIONS
CpDecreasedPriceForRepeatedImpressions StrategyCpDecreasedPriceForRepeatedImpressionsAdd Parameters of the Decrease price for repeat impressions strategy for a period. When the BiddingStrategyType parameter has the value CP_DECREASED_PRICE_FOR_REPEATED_IMPRESSIONS
WbAverageCpv StrategyWbAverageCpvAdd Parameters of the Maximum video views (weekly) strategy. When the BiddingStrategyType parameter has the value WB_AVERAGE_CPV
CpAverageCpv StrategyCpAverageCpvAdd Parameters of the Maximum video views (for the period) strategy. When the BiddingStrategyType parameter has the value CP_AVERAGE_CPV
StrategyWbMaximumImpressionsAdd 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
StrategyCpMaximumImpressionsAdd 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
StrategyWbDecreasedPriceForRepeatedImpressionsAdd 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
StrategyCpDecreasedPriceForRepeatedimpressionsAdd 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
StrategyWbAverageCpvAdd 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
StrategyCpAverageCpvAdd 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