add: параметры CpmBannerCampaign
Структура запроса в формате JSON:
{
"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 */
}
}
Параметр |
Тип |
Описание |
Обязательный |
Структура CpmBannerCampaignAddItem |
|||
|
CpmBannerCampaignStrategyAdd |
Стратегия показа. |
Да |
|
array of CpmBannerCampaignSetting |
Массив настроек, допускающих только значения YES или NO. |
Нет |
|
ArrayOfInteger |
Идентификаторы счетчиков Яндекс Метрики, установленных на сайте рекламодателя (см. раздел Яндекс Метрика: оценка эффективности рекламы помощи Директа). |
Нет |
|
FrequencyCapSetting |
Ограничение частоты показов одному пользователю. Если структура не задана, частота показов не ограничена. |
Нет |
|
VideoTargetEnum |
Цель показов видеоролика. Доступные значения:
При стратегиях AUTOBUDGET_AVG_CPV и AUTOBUDGET_AVG_CPV_CUSTOM_PERIOD значение сбрасывается в null. |
Нет |
Структура CpmBannerCampaignSetting |
|||
|
CpmBannerCampaignSettingsEnum |
Имя настройки:
|
Да |
|
YesNoEnum |
Значение настройки. |
Да |
Структура FrequencyCapSetting |
|||
|
int |
Максимальное количество показов одному пользователю за период. |
Да |
|
int, nillable |
Количество дней от 1 до 30. null (nil) — ограничение действует всё время проведения рекламной кампании. |
Да |
Структура CpmBannerCampaignStrategyAdd |
|||
|
CpmBannerCampaignSearchStrategyAdd |
Стратегия показа на поиске. |
Да |
|
CpmBannerCampaignNetworkStrategyAdd |
Стратегия показа в сетях. |
Да |
Структура CpmBannerCampaignSearchStrategyAdd |
|||
|
CpmBannerCampaignSearchStrategyTypeEnum |
Тип стратегии показа на поиске. Доступно единственное значение: SERVING_OFF. |
Да |
Структура CpmBannerCampaignNetworkStrategyAdd |
|||
|
CpmBannerCampaignNetworkStrategyTypeEnum |
Тип стратегии показа в сетях:
|
Да |
|
StrategyWbMaximumImpressionsAdd |
Параметры стратегии Максимум показов по минимальной цене (еженедельно). |
При значении WB_MAXIMUM_IMPRESSIONS в параметре |
|
StrategyCpMaximumImpressionsAdd |
Параметры стратегии Максимум показов по минимальной цене (за период). |
При значении CP_MAXIMUM_IMPRESSIONS в параметре |
|
StrategyWbDecreasedPriceForRepeatedImpressionsAdd |
Параметры стратегии Снижение цены повторных показов (еженедельно). |
При значении WB_DECREASED_PRICE_FOR_REPEATED_IMPRESSIONS в параметре |
|
StrategyCpDecreasedPriceForRepeatedImpressionsAdd |
Параметры стратегии Снижение цены повторных показов (за период). |
При значении CP_DECREASED_PRICE_FOR_REPEATED_IMPRESSIONS в параметре |
|
StrategyWbAverageCpvAdd |
Параметры стратегии Максимум просмотров видео (еженедельно). |
При значении WB_AVERAGE_CPV в параметре |
|
Параметры стратегии Максимум просмотров видео (за период). |
При значении CP_AVERAGE_CPV в параметре |
|
Структура StrategyWbMaximumImpressionsAdd |
|||
|
long |
Средняя цена за тысячу показов в валюте рекламодателя, умноженная на 1 000 000. Минимальное значение средней цены для каждой валюты представлено в справочнике валют. Справочник валют можно получить с помощью метода Dictionaries.get. |
Да |
|
long |
Недельный бюджет в валюте рекламодателя, умноженный на 1 000 000. Минимальный недельный бюджет для каждой валюты представлен в справочнике валют. Справочник валют можно получить с помощью метода Dictionaries.get. |
Да |
Структура StrategyCpMaximumImpressionsAdd |
|||
|
long |
Средняя цена за тысячу показов в валюте рекламодателя, умноженная на 1 000 000. Минимальное значение средней цены для каждой валюты представлено в справочнике валют. Справочник валют можно получить с помощью метода Dictionaries.get. |
Да |
|
long |
Бюджет на период в валюте рекламодателя, умноженный на 1 000 000. Минимальный бюджет для каждой валюты представлен в справочнике валют. Справочник валют можно получить с помощью метода Dictionaries.get. |
Да |
|
string |
Дата начала периода в формате YYYY-MM-DD. Должна быть не меньше текущей даты и даты начала кампании. |
Да |
|
string |
Дата окончания периода в формате YYYY-MM-DD. Должна быть не больше даты окончания кампании. |
Да |
|
YesNoEnum |
Продлевать период автоматически, чтобы использовать оставшийся бюджет. |
Да |
Структура StrategyWbDecreasedPriceForRepeatedImpressionsAdd |
|||
|
long |
Средняя цена за тысячу показов в валюте рекламодателя, умноженная на 1 000 000. Минимальное значение средней цены для каждой валюты представлено в справочнике валют. Справочник валют можно получить с помощью метода Dictionaries.get. |
Да |
|
long |
Недельный бюджет в валюте рекламодателя, умноженный на 1 000 000. Минимальный недельный бюджет для каждой валюты представлен в справочнике валют. Справочник валют можно получить с помощью метода Dictionaries.get. |
Да |
Структура StrategyCpDecreasedPriceForRepeatedImpressionsAdd |
|||
|
long |
Средняя цена за тысячу показов в валюте рекламодателя, умноженная на 1 000 000. Минимальное значение средней цены для каждой валюты представлено в справочнике валют. Справочник валют можно получить с помощью метода Dictionaries.get. |
Да |
|
long |
Бюджет на период в валюте рекламодателя, умноженный на 1 000 000. Минимальный бюджет для каждой валюты представлен в справочнике валют. Справочник валют можно получить с помощью метода Dictionaries.get. |
Да |
|
string |
Дата начала периода в формате YYYY-MM-DD. Должна быть не меньше текущей даты и даты начала кампании. |
Да |
|
string |
Дата окончания периода в формате YYYY-MM-DD. Должна быть не больше даты окончания кампании. |
Да |
|
YesNoEnum |
Продлевать период автоматически, чтобы использовать оставшийся бюджет. |
Да |
Структура StrategyWbAverageCpvAdd |
|||
|
long |
Средняя цена за просмотр видео в валюте рекламодателя, умноженная на 1 000 000. Минимальное значение средней цены для каждой валюты представлено в справочнике валют. Справочник валют можно получить с помощью метода Dictionaries.get. |
Да |
|
long |
Недельный бюджет в валюте рекламодателя, умноженный на 1 000 000. Минимальный недельный бюджет для каждой валюты представлен в справочнике валют. Справочник валют можно получить с помощью метода Dictionaries.get. |
Да |
Структура StrategyCpAverageCpvAdd |
|||
|
long |
Средняя цена за просмотр видео в валюте рекламодателя, умноженная на 1 000 000. Минимальное значение средней цены для каждой валюты представлено в справочнике валют. Справочник валют можно получить с помощью метода Dictionaries.get. |
Да |
|
long |
Бюджет на период в валюте рекламодателя, умноженный на 1 000 000. Минимальный бюджет для каждой валюты представлен в справочнике валют. Справочник валют можно получить с помощью метода Dictionaries.get. |
Да |
|
string |
Дата начала периода в формате YYYY-MM-DD. Должна быть не меньше текущей даты и даты начала кампании. |
Да |
|
string |
Дата окончания периода в формате YYYY-MM-DD. Должна быть не больше даты окончания кампании. |
Да |
|
YesNoEnum |
Продлевать период автоматически, чтобы использовать оставшийся бюджет. |
Да |