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 */
            }
          } /* 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 */
        }
      }
    }, ... ] /* required */
  }
}
ParameterTypeDescriptionRequired
CpmBannerCampaignAddItem structure
BiddingStrategyCpmBannerCampaignStrategyAddDisplay strategy.Yes
Settingsarray of CpmBannerCampaignSettingArray of settings that only accept the values YES or NO.No
CounterIdsArrayOfIntegerIDs of Yandex.Metrica tags installed on the advertiser's website (see Yandex.Metrica: advertising campaign efficiency evaluation in the Help for Direct). Maximum of 5 items in the array.No
FrequencyCapFrequencyCapSettingLimits the frequency of impressions per user. If the structure is omitted, the frequency of impressions is not limited.No
CpmBannerCampaignSetting structure
OptionCpmBannerCampaignSettingsEnum

Setting name:

Yes
ValueYesNoEnumSetting value.Yes
FrequencyCapSetting structure
ImpressionsintMaximum number of impressions per user during a period.Yes
PeriodDaysint, 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
NetworkCpmBannerCampaignNetworkStrategyAddDisplay strategy in ad networks.Yes
CpmBannerCampaignSearchStrategyAdd structure
BiddingStrategyTypeCpmBannerCampaignSearchStrategyTypeEnumThe type of display strategy in search results. Only one value is available: SERVING_OFF.Yes
CpmBannerCampaignNetworkStrategyAdd structure
BiddingStrategyTypeCpmBannerCampaignNetworkStrategyTypeEnum

The type of display strategy in ad networks:

Yes
WbMaximumImpressionsStrategyWbMaximumImpressionsAddParameters of the Maximize impressions for lowest price weekly strategy.When the BiddingStrategyType parameter has the value WB_MAXIMUM_IMPRESSIONS
CpMaximumImpressionsStrategyCpMaximumImpressionsAddParameters of the Maximize impressions for lowest price strategy for a period.When the BiddingStrategyType parameter has the value WB_MAXIMUM_IMPRESSIONS
WbDecreasedPriceForRepeatedImpressionsStrategyWbDecreasedPriceForRepeatedImpressionsAddParameters of the Decrease price for repeat impressions weekly strategy.When the BiddingStrategyType parameter has the value WB_DECREASED_PRICE_FOR_REPEATED_IMPRESSIONS
CpDecreasedPriceForRepeatedImpressionsStrategyCpDecreasedPriceForRepeatedImpressionsAddParameters of the Decrease price for repeat impressions strategy for a period.When the BiddingStrategyType parameter has the value CP_DECREASED_PRICE_FOR_REPEATED_IMPRESSIONS
StrategyWbMaximumImpressionsAdd structure
AverageCpmlong

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
SpendLimitlong

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
AverageCpmlong

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
SpendLimitlong

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
StartDatestringDate 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
EndDatestringDate of the end of the period, in the format YYYY-MM-DD. Can't be later than the campaign end date.Yes
AutoContinueYesNoEnumExtend the campaign period automatically in order to use the remaining budget.Yes
StrategyWbDecreasedPriceForRepeatedImpressionsAdd structure
AverageCpmlong

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
SpendLimitlong

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
AverageCpmlong

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
SpendLimitlong

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
StartDatestringDate 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
EndDatestringDate of the end of the period, in the format YYYY-MM-DD. Can't be later than the campaign end date.Yes
AutoContinueYesNoEnumExtend the campaign period automatically in order to use the remaining budget.Yes