add: параметры SmartCampaign
Структура запроса в формате JSON:
{
"method": "add",
"params": {
"Campaigns": [{ /* CampaignAddItem */
...
"SmartCampaign": { /* SmartCampaignAddItem */
"BiddingStrategy": { /* SmartCampaignStrategyAdd */
"Search": { /* SmartCampaignSearchStrategy */
"BiddingStrategyType": ( "AVERAGE_CPC_PER_CAMPAIGN" | ... | "SERVING_OFF" ), /* required */
"AverageCpcPerCampaign": { /* StrategyAverageCpcPerCampaignAdd */
"AverageCpc": (long), /* required */
"WeeklySpendLimit": (long),
"CustomPeriodBudget": {
"SpendLimit": (long),
"StartDate": (string),
"EndDate": (string),
"AutoContinue": ("YES" | "NO")
},
"BidCeiling": (long),
},
"AverageCpcPerFilter": { /* StrategyAverageCpcPerFilterAdd */
"FilterAverageCpc": (long), /* required */
"WeeklySpendLimit": (long),
"CustomPeriodBudget": {
"SpendLimit": (long),
"StartDate": (string),
"EndDate": (string),
"AutoContinue": ("YES" | "NO")
},
"BidCeiling": (long)
},
"AverageCpaPerCampaign" : { /* StrategyAverageCpaPerCampaignAdd */
"AverageCpa": (long), /* required */
"GoalId": (long), /* required */
"WeeklySpendLimit": (long),
"CustomPeriodBudget": {
"SpendLimit": (long),
"StartDate": (string),
"EndDate": (string),
"AutoContinue": ("YES" | "NO")
},
"BidCeiling": (long),
"ExplorationBudget" : {
"MinimumExplorationBudget" : (long) /* required */,
"IsMinimumExplorationBudgetCustom" : ("YES") /* required */
}
},
"AverageCpaPerFilter": { /* StrategyAverageCpaPerFilterAdd */
"FilterAverageCpa": (long), /* required */
"GoalId": (long), /* required */
"WeeklySpendLimit": (long),
"CustomPeriodBudget": {
"SpendLimit": (long),
"StartDate": (string),
"EndDate": (string),
"AutoContinue": ("YES" | "NO")
},
"BidCeiling": (long),
"ExplorationBudget" : {
"MinimumExplorationBudget" : (long) /* required */,
"IsMinimumExplorationBudgetCustom" : ("YES") /* required */
}
},
"AverageRoi": { /* StrategyAverageRoiAdd */
"ReserveReturn": (int), /* required */
"RoiCoef": (long), /* required */
"GoalId": (long), /* required */
"WeeklySpendLimit": (long),
"CustomPeriodBudget": {
"SpendLimit": (long),
"StartDate": (string),
"EndDate": (string),
"AutoContinue": ("YES" | "NO")
},
"BidCeiling": (long),
"Profitability": (long),
"ExplorationBudget" : {
"MinimumExplorationBudget" : (long) /* required */,
"IsMinimumExplorationBudgetCustom" : ("YES") /* required */
}
},
"AverageCrr": { /* StrategyAverageCrrAdd */
"Crr": (int), /* required */
"GoalId": (long), /* required */
"WeeklySpendLimit": (long),
"CustomPeriodBudget": {
"SpendLimit": (long),
"StartDate": (string),
"EndDate": (string),
"AutoContinue": ("YES" | "NO")
},
"ExplorationBudget" : {
"MinimumExplorationBudget" : (long) /* required */,
"IsMinimumExplorationBudgetCustom" : ("YES") /* required */
}
},
"PayForConversionCrr": { /* StrategyPayForConversionCrrAdd */
"Crr": (int), /* required */
"GoalId": (long), /* required */
"WeeklySpendLimit": (long),
"CustomPeriodBudget": {
"SpendLimit": (long),
"StartDate": (string),
"EndDate": (string),
"AutoContinue": ("YES" | "NO")
}
},
"PayForConversionPerCampaign" : { /* StrategyPayForConversionPerCampaignAdd */
"Cpa" : (long) /* required */,
"GoalId" : (long) /* required */,
"WeeklySpendLimit" : (long),
"CustomPeriodBudget": {
"SpendLimit": (long),
"StartDate": (string),
"EndDate": (string),
"AutoContinue": ("YES" | "NO")
}
},
"PayForConversionPerFilter" : { /* StrategyPayForConversionPerFilterAdd */
"Cpa" : (long) /* required */,
"GoalId" : (long) /* required */,
"WeeklySpendLimit" : (long),
"CustomPeriodBudget": {
"SpendLimit": (long),
"StartDate": (string),
"EndDate": (string),
"AutoContinue": ("YES" | "NO")
}
}
}, /* required */
"Network": { /* SmartCampaignNetworkStrategyAdd */
"BiddingStrategyType": ( "AVERAGE_CPC_PER_CAMPAIGN" | ... | "SERVING_OFF" ), /* required */
"AverageCpcPerCampaign": { /* StrategyAverageCpcPerCampaignAdd */
"AverageCpc": (long), /* required */
"WeeklySpendLimit": (long),
"BidCeiling": (long)
},
"AverageCpcPerFilter": { /* StrategyAverageCpcPerFilterAdd */
"FilterAverageCpc": (long), /* required */
"WeeklySpendLimit": (long),
"CustomPeriodBudget": {
"SpendLimit": (long),
"StartDate": (string),
"EndDate": (string),
"AutoContinue": ("YES" | "NO")
},
"BidCeiling": (long)
},
"AverageCpaPerCampaign" : { /* StrategyAverageCpaPerCampaignAdd */
"AverageCpa": (long), /* required */
"GoalId": (long), /* required */
"WeeklySpendLimit": (long),
"CustomPeriodBudget": {
"SpendLimit": (long),
"StartDate": (string),
"EndDate": (string),
"AutoContinue": ("YES" | "NO")
},
"BidCeiling": (long),
"ExplorationBudget" : {
"MinimumExplorationBudget" : (long) /* required */,
"IsMinimumExplorationBudgetCustom" : ("YES") /* required */
}
},
"AverageCpaPerFilter": { /* StrategyAverageCpaPerFilter */
"FilterAverageCpa": (long), /* required */
"GoalId": (long), /* required */
"WeeklySpendLimit": (long),
"CustomPeriodBudget": {
"SpendLimit": (long),
"StartDate": (string),
"EndDate": (string),
"AutoContinue": ("YES" | "NO")
},
"BidCeiling": (long),
"ExplorationBudget" : {
"MinimumExplorationBudget" : (long) /* required */,
"IsMinimumExplorationBudgetCustom" : ("YES") /* required */
}
},
"AverageRoi": { /* StrategyAverageRoiAdd */
"ReserveReturn": (int), /* required */
"RoiCoef": (long), /* required */
"GoalId": (long), /* required */
"WeeklySpendLimit": (long),
"CustomPeriodBudget": {
"SpendLimit": (long),
"StartDate": (string),
"EndDate": (string),
"AutoContinue": ("YES" | "NO")
},
"BidCeiling": (long),
"Profitability": (long),
"ExplorationBudget" : {
"MinimumExplorationBudget" : (long) /* required */,
"IsMinimumExplorationBudgetCustom" : ("YES") /* required */
}
},
"AverageCrr": { /* StrategyAverageCrrAdd */
"Crr": (int), /* required */
"GoalId": (long), /* required */
"WeeklySpendLimit": (long),
"CustomPeriodBudget": {
"SpendLimit": (long),
"StartDate": (string),
"EndDate": (string),
"AutoContinue": ("YES" | "NO")
},
"ExplorationBudget" : {
"MinimumExplorationBudget" : (long) /* required */,
"IsMinimumExplorationBudgetCustom" : ("YES") /* required */
}
},
"PayForConversionCrr": { /* StrategyPayForConversionCrrAdd */
"Crr": (int), /* required */
"GoalId": (long), /* required */
"WeeklySpendLimit": (long),
"CustomPeriodBudget": {
"SpendLimit": (long),
"StartDate": (string),
"EndDate": (string),
"AutoContinue": ("YES" | "NO")
}
},
"PayForConversionPerCampaign" : { /* StrategyPayForConversionPerCampaignAdd */
"Cpa" : (long) /* required */,
"GoalId" : (long) /* required */,
"WeeklySpendLimit" : (long),
"CustomPeriodBudget": {
"SpendLimit": (long),
"StartDate": (string),
"EndDate": (string),
"AutoContinue": ("YES" | "NO")
}
},
"PayForConversionPerFilter" : { /* StrategyPayForConversionPerFilterAdd */
"Cpa" : (long) /* required */,
"GoalId" : (long) /* required */,
"WeeklySpendLimit" : (long),
"CustomPeriodBudget": {
"SpendLimit": (long),
"StartDate": (string),
"EndDate": (string),
"AutoContinue": ("YES" | "NO")
}
},
"NetworkDefault": { /* StrategyNetworkDefaultAdd */
}
} /* required */
}, /* required */
"Settings": [{ /* SmartCampaignSetting */
"Option": ( "ADD_TO_FAVORITES" | "REQUIRE_SERVICING" ), /* required */
"Value": ( "YES" | "NO" ) /* required */
}, ... ],
"CounterId": (long), /* required */
"PriorityGoals": { /* PriorityGoalsArray */
"Items": [{ /* PriorityGoalsItem */
"GoalId": (long), /* required */
"Value": (long), /* required */
"IsMetrikaSourceOfValue": ( "YES" | "NO" )
}, ... ] /* required */
},
"TrackingParams" : (string),
"AttributionModel": ( "FC" | "LC" | "LSC" | "LYDC" | "FCCD" | "LSCCD" | "LYDCCD" | "AUTO" ),
"PackageBiddingStrategy" : {
"StrategyId": (long),
"StrategyFromCampaignId": (long),
"Platforms" : { /* required */
"Search" : ( "YES" | "NO" ) /* required */,
"Network" : ( "YES"| "NO" ) /* required */
}
}
}
}, ... ] /* required */
}
}
Параметр | Тип | Описание | Обязательный |
Структура SmartCampaignAddItem | |||
---|---|---|---|
BiddingStrategy | SmartCampaignStrategyAdd | Стратегия показа. | Нет, если указан PackageBiddingStrategy |
Settings | array of SmartCampaignSetting | Массив настроек, допускающих только значения YES или NO. | Нет |
CounterId | long | Идентификатор счетчика Яндекс Метрики, установленного на сайте рекламодателя (см. раздел Метрика. Оценка эффективности рекламной кампании помощи Директа). | Да |
PriorityGoals | PriorityGoalsArray | Ключевые цели, на достижение которых направлена автоматическая корректировка ставок. Если массив не задан, автоматическая корректировка направлена на получение максимального количества вовлеченных сессий, см. раздел Показатели вовлеченных сессий помощи Директа. Ограничение — 30 ключевых целей. | Нет |
TrackingParams | string | Параметры URL для шаблонов. | Нет |
AttributionModel | AttributionModelEnum | Модель атрибуции, используемая для оптимизации конверсий (см. раздел Модели атрибуции помощи Директа). Возможные значения:
Значение по умолчанию — LYDC. | Нет |
PackageBiddingStrategy | SmartCampaignPackageBiddingStrategyAdd | Привязывает кампанию к указанной стратегии. При заполнении этого поля нельзя передавать следующие параметры:
Чтобы передавать эти параметры, необходимо отвязать кампанию от пакетной стратегии: укажите новое значение BiddingStrategy и сбросьте значение параметра PackageBiddingStrategy: null. | Нет, если указан BiddingStrategy |
Структура SmartCampaignSetting | |||
Option | SmartCampaignSettingsEnum | Имя настройки: | Да |
Value | YesNoEnum | Значение настройки. | Да |
Структура PackageBiddingStrategyAdd | |||
StrategyId | long | Идентификатор пакетной стратегии. | |
StrategyFromCampaignId | long | Идентификатор кампании, из которой создается пакетная стратегия. | Нет |
Platforms | SmartCampaignpPlatforms | Платформа размещения рекламы. | Да |
Структура SmartCampaignPlatforms | |||
Search | YesNoEnum | Поисковая выдача. | Да |
Network | YesNoEnum | Рекламная сеть Яндекса. | Да |
Структура PriorityGoalsArray | |||
Items | array of PriorityGoalsItem | Набор ключевых целей и ценностей конверсий по ним. | Да |
Структура PriorityGoalsItem | |||
GoalId | long | Идентификатор цели Яндекс Метрики, на достижение которой будет направлена автоматическая корректировка ставок. Подробнее о целях см. раздел Цели и конверсии помощи Метрики. Список целей получают с помощью метода GetStatGoals API версии 4 или Live 4. Значение 12 соответствует цели «Вовлеченные сессии». | Да |
Value | long | Ценность конверсии — денежная оценка выгоды, получаемой рекламодателем при достижении указанной цели, в валюте рекламодателя, умноженная на 1 000 000. Чем больше ценность конверсии, тем выше приоритет достижения указанной цели. | Да |
IsMetrikaSourceOfValue | YesNoEnum | Источник ценности ключевой цели — цель Метрики. Значение YES используется только для стратегий с долей рекламных расходов. | При значении AVERAGE_CRR или PAY_FOR_CONVERSION_CRR в параметре BiddingStrategyType |
Структура SmartCampaignStrategyAdd | |||
Search | SmartCampaignSearchStrategyAdd | Стратегия показа на поиске. | Да |
Network | SmartCampaignNetworkStrategyAdd | Стратегия показа в сетях. | Да |
Структура SmartCampaignSearchStrategyAdd | |||
BiddingStrategyType | SmartCampaignSearchStrategyTypeEnum | Тип стратегии показа на поиске: | Да |
AverageCpaPerCampaign | StrategyAverageCpaPerCampaignAdd | Параметры стратегии Оптимизация количества конверсий, CPA на всю кампанию. | При значении AVERAGE_CPA_PER_CAMPAIGN в параметре BiddingStrategyType |
AverageCpaPerFilter | StrategyAverageCpaPerFilterAdd | Параметры стратегии Оптимизация количества конверсий, CPA на каждый фильтр. | При значении AVERAGE_CPA_PER_FILTER в параметре BiddingStrategyType |
AverageCpcPerCampaign | StrategyAverageCpcPerCampaignAdd | Параметры стратегии Оптимизация количества кликов, CPC на всю кампанию. | При значении AVERAGE_CPC_PER_CAMPAIGN в параметре BiddingStrategyType |
AverageCpcPerFilter | StrategyAverageCpcPerFilterAdd | Параметры стратегии Оптимизация количества кликов, CPC на каждый фильтр. | При значении AVERAGE_CPC_PER_FILTER в параметре BiddingStrategyType |
AverageRoi | StrategyAverageRoiAdd | Параметры стратегии Оптимизация рентабельности. | При значении AVERAGE_ROI в параметре BiddingStrategyType |
AverageCrr | StrategyAverageCrrAdd | Параметры стратегии Оптимизация доли рекламных расходов, удерживать среднюю долю расходов. | При значении AVERAGE_CRR в параметре BiddingStrategyType |
PayForConversionCrr | StrategyPayForConversionCrrAdd | Параметры стратегии Оптимизация доли рекламных расходов, оплата за конверсии. | При значении PAY_FOR_CONVERSION_CRR в параметре BiddingStrategyType |
PayForConversionPerCampaign | StrategyPayForConversionPerCampaignAdd | Параметры стратегии Оптимизация количества конверсий, оплата за конверсии. | При значении PAY_FOR_CONVERSION_PER_CAMPAIGN в параметре BiddingStrategyType |
PayForConversionPerFilter | StrategyPayForConversionPerFilterAdd | Параметры стратегии Оптимизация количества конверсий, оплата за конверсии на каждый фильтр. | При значении PAY_FOR_CONVERSION_PER_FILTER в параметре BiddingStrategyType |
Структура SmartCampaignNetworkStrategyAdd | |||
BiddingStrategyType | SmartCampaignNetworkStrategyTypeEnum | Тип стратегии показа в сетях:
| Да |
AverageCpaPerCampaign | StrategyAverageCpaPerCampaignAdd | Параметры стратегии Оптимизация количества конверсий, CPA на всю кампанию. | При значении AVERAGE_CPA_PER_CAMPAIGN в параметре BiddingStrategyType |
AverageCpaPerFilter | StrategyAverageCpaPerFilterAdd | Параметры стратегии Оптимизация количества конверсий, CPA на каждый фильтр. | При значении AVERAGE_CPA_PER_FILTER в параметре BiddingStrategyType |
AverageCpcPerCampaign | StrategyAverageCpcPerCampaignAdd | Параметры стратегии Оптимизация количества кликов, CPC на всю кампанию. | При значении AVERAGE_CPC_PER_CAMPAIGN в параметре BiddingStrategyType |
AverageCpcPerFilter | StrategyAverageCpcPerFilterAdd | Параметры стратегии Оптимизация количества кликов, CPC на каждый фильтр. | При значении AVERAGE_CPC_PER_FILTER в параметре BiddingStrategyType |
AverageRoi | StrategyAverageRoiAdd | Параметры стратегии Оптимизация рентабельности. | При значении AVERAGE_ROI в параметре BiddingStrategyType |
AverageCrr | StrategyAverageCrrAdd | Параметры стратегии Оптимизация доли рекламных расходов, удерживать среднюю долю расходов. | При значении AVERAGE_CRR в параметре BiddingStrategyType |
PayForConversionCrr | StrategyPayForConversionCrrAdd | Параметры стратегии Оптимизация доли рекламных расходов, оплата за конверсии. | При значении PAY_FOR_CONVERSION_CRR в параметре BiddingStrategyType |
PayForConversionPerCampaign | StrategyPayForConversionPerCampaignAdd | Параметры стратегии Оптимизация количества конверсий, оплата за конверсии. | При значении PAY_FOR_CONVERSION_PER_CAMPAIGN в параметре BiddingStrategyType |
PayForConversionPerFilter | StrategyPayForConversionPerFilterAdd | Параметры стратегии Оптимизация количества конверсий, оплата за конверсии на каждый фильтр. | При значении PAY_FOR_CONVERSION_PER_FILTER в параметре BiddingStrategyType |
NetworkDefault Ограничение. Параметр NETWORK_DEFAULT не поддерживается для ручной стратегии HIGHEST_POSITION. | StrategyNetworkDefaultAdd | Настройки показов в сетях в зависимости от настроек на поиске. Для этой стратегии передайте пустую структуру. | При значении NETWORK_DEFAULT в параметре BiddingStrategyType |
Структура StrategyAverageCpaPerCampaignAdd | |||
AverageCpa | long | Средняя цена достижения цели в валюте рекламодателя, умноженная на 1 000 000. Минимальное значение средней цены для каждой валюты представлено в справочнике валют. Справочник валют можно получить с помощью метода Dictionaries.get. | Да |
GoalId | long | Идентификатор цели Яндекс Метрики. Подробнее о целях см. раздел Цели и конверсии помощи Метрики. Список целей получают с помощью метода GetStatGoals API версии 4 или Live 4. | Да |
WeeklySpendLimit | long | Недельный бюджет в валюте рекламодателя, умноженный на 1 000 000. Минимальный недельный бюджет для каждой валюты представлен в справочнике валют. Справочник валют можно получить с помощью метода Dictionaries.get. | Нет |
CustomPeriodBudget | CustomPeriodBudget | Бюджет на период. Подробнее см. в справке Директа. При создании кампании нельзя указать одновременно с WeeklySpendLimit. | Нет |
BidCeiling | long | Максимальная ставка в валюте рекламодателя, умноженная на 1 000 000. Минимальное и максимальное значение ставки для каждой валюты представлены в справочнике валют. Справочник валют можно получить с помощью метода Dictionaries.get. Примечание. Указывать максимальную ставку не рекомендуется — это может снизить эффективность работы стратегии. | Нет |
ExplorationBudget | ExplorationBudget | Минимальный бюджет. Подробнее в справке Директа. Если поле не задано, для стратегии устанавливается значение по умолчанию (рассчитывается на основе настроек стратегии). Чтобы установить пользовательское значение минимального бюджета, задайте значение в параметре MinimumExplorationBudget и укажите IsMinimumExplorationBudgetCustom="YES". Если IsMinimumExplorationBudgetCustom установлен в NO, операция завершится с ошибкой. | Нет |
Структура StrategyAverageCpaPerFilterAdd | |||
FilterAverageCpa | long | Средняя цена достижения цели по умолчанию на каждый фильтр в валюте рекламодателя, умноженная на 1 000 000. Минимальное значение средней цены для каждой валюты представлено в справочнике валют. Справочник валют можно получить с помощью метода Dictionaries.get. | Да |
GoalId | long | Идентификатор цели Яндекс Метрики. Подробнее о целях см. раздел Цели и конверсии помощи Метрики. Список целей получают с помощью метода GetStatGoals API версии 4 или Live 4. | Да |
WeeklySpendLimit | long | Недельный бюджет в валюте рекламодателя, умноженный на 1 000 000. Минимальный недельный бюджет для каждой валюты представлен в справочнике валют. Справочник валют можно получить с помощью метода Dictionaries.get. | Нет |
CustomPeriodBudget | CustomPeriodBudget | Бюджет на период. Подробнее см. в справке Директа. При создании кампании нельзя указать одновременно с WeeklySpendLimit. | Нет |
BidCeiling | long | Максимальная ставка в валюте рекламодателя, умноженная на 1 000 000. Минимальное и максимальное значение ставки для каждой валюты представлены в справочнике валют. Справочник валют можно получить с помощью метода Dictionaries.get. Примечание. Указывать максимальную ставку не рекомендуется — это может снизить эффективность работы стратегии. | Нет |
ExplorationBudget | ExplorationBudget | Минимальный бюджет. Подробнее в справке Директа. Если поле не задано, для стратегии устанавливается значение по умолчанию (рассчитывается на основе настроек стратегии). Чтобы установить пользовательское значение минимального бюджета, задайте значение в параметре MinimumExplorationBudget и укажите IsMinimumExplorationBudgetCustom="YES". Если IsMinimumExplorationBudgetCustom установлен в NO, операция завершится с ошибкой. | Нет |
Структура StrategyAverageCpcPerCampaignAdd | |||
AverageCpc | long | Средняя цена клика в валюте рекламодателя, умноженная на 1 000 000. Минимальное значение средней цены для каждой валюты представлено в справочнике валют. Справочник валют можно получить с помощью метода Dictionaries.get. | Да |
WeeklySpendLimit | long | Недельный бюджет в валюте рекламодателя, умноженный на 1 000 000. Минимальный недельный бюджет для каждой валюты представлен в справочнике валют. Справочник валют можно получить с помощью метода Dictionaries.get. | Нет |
CustomPeriodBudget | CustomPeriodBudget | Бюджет на период. Подробнее см. в справке Директа. При создании кампании нельзя указать одновременно с WeeklySpendLimit. | Нет |
BidCeiling | long | Максимальная ставка в валюте рекламодателя, умноженная на 1 000 000. Минимальное и максимальное значение ставки для каждой валюты представлены в справочнике валют. Справочник валют можно получить с помощью метода Dictionaries.get. Примечание. Указывать максимальную ставку не рекомендуется — это может снизить эффективность работы стратегии. | Нет |
Структура StrategyAverageCpcPerFilterAdd | |||
FilterAverageCpc | long | Да | |
WeeklySpendLimit | long | Недельный бюджет в валюте рекламодателя, умноженный на 1 000 000. Минимальный недельный бюджет для каждой валюты представлен в справочнике валют. Справочник валют можно получить с помощью метода Dictionaries.get. | Нет |
CustomPeriodBudget | CustomPeriodBudget | Бюджет на период. Подробнее см. в справке Директа. При создании кампании нельзя указать одновременно с WeeklySpendLimit. | Нет |
BidCeiling | long | Максимальная ставка в валюте рекламодателя, умноженная на 1 000 000. Минимальное и максимальное значение ставки для каждой валюты представлены в справочнике валют. Справочник валют можно получить с помощью метода Dictionaries.get. Примечание. Указывать максимальную ставку не рекомендуется — это может снизить эффективность работы стратегии. | Нет |
Структура StrategyAverageRoiAdd | |||
ReserveReturn | int | Максимальный процент сэкономленных средств, который можно возвращать в рекламу (расходовать) в случае, если прогнозируемое значение рентабельности превышает значение параметра RoiCoef. Значение от 0 до 100, кратное десяти: 0, 10, 20... 100. | Да |
RoiCoef | long | Желаемая средняя рентабельность инвестиций за неделю. Значение представляет собой отношение прибыли от продаж к расходам на рекламу, умноженное на 1 000 000. Значение должно быть целым числом. Если значение не кратно 10 000, последние 4 цифры обнуляются (что соответствует отбрасыванию лишних знаков после запятой). | Да |
GoalId | long | Идентификатор цели Яндекс Метрики. Подробнее о целях см. раздел Цели и конверсии помощи Метрики. Значение 13 — ключевые цели. Допускается, если в массиве PriorityGoals указана хотя бы одна цель, отличная от вовлеченных сессий. Список целей получают с помощью метода GetStatGoals API версии 4 или Live 4. | Да |
WeeklySpendLimit | long | Недельный бюджет в валюте рекламодателя, умноженный на 1 000 000. Минимальный недельный бюджет для каждой валюты представлен в справочнике валют. Справочник валют можно получить с помощью метода Dictionaries.get. | Нет |
CustomPeriodBudget | CustomPeriodBudget | Бюджет на период. Подробнее см. в справке Директа. При создании кампании нельзя указать одновременно с WeeklySpendLimit. | Нет |
BidCeiling | long | Максимальная ставка в валюте рекламодателя, умноженная на 1 000 000. Минимальное и максимальное значение ставки для каждой валюты представлены в справочнике валют. Справочник валют можно получить с помощью метода Dictionaries.get. Примечание. Указывать максимальную ставку не рекомендуется — это может снизить эффективность работы стратегии. | Нет |
Profitability | long | Процент выручки, являющийся себестоимостью товаров или услуг. Значение представляет собой процент, умноженный на 1 000 000. Значение должно быть целым числом от 0 до 100 000 000 (что соответствует 100%). Если значение не кратно 10 000, последние 4 цифры обнуляются (что соответствует отбрасыванию лишних знаков после запятой). | Нет |
ExplorationBudget | ExplorationBudget | Минимальный бюджет. Подробнее в справке Директа. Если поле не задано, для стратегии устанавливается значение по умолчанию (рассчитывается на основе настроек стратегии). Чтобы установить пользовательское значение минимального бюджета, задайте значение в параметре MinimumExplorationBudget и укажите IsMinimumExplorationBudgetCustom="YES". Если IsMinimumExplorationBudgetCustom установлен в NO, операция завершится с ошибкой. | Нет |
Структура StrategyAverageCrrAdd | |||
Crr | int | Средняя доля расходов. | Да |
GoalId | long | Идентификатор цели Яндекс Метрики. Подробнее о целях см. раздел Цели и конверсии помощи Метрики. Список целей получают с помощью метода GetStatGoals API версии 4 или Live 4. | Да |
WeeklySpendLimit | long | Недельный бюджет в валюте рекламодателя, умноженный на 1 000 000. Минимальный недельный бюджет для каждой валюты представлен в справочнике валют. Справочник валют можно получить с помощью метода Dictionaries.get. | Нет |
CustomPeriodBudget | CustomPeriodBudget | Бюджет на период. Подробнее см. в справке Директа. При создании кампании нельзя указать одновременно с WeeklySpendLimit. | Нет |
ExplorationBudget | ExplorationBudget | Минимальный бюджет. Подробнее в справке Директа. Если поле не задано, для стратегии устанавливается значение по умолчанию (рассчитывается на основе настроек стратегии). Чтобы установить пользовательское значение минимального бюджета, задайте значение в параметре MinimumExplorationBudget и укажите IsMinimumExplorationBudgetCustom="YES". Если IsMinimumExplorationBudgetCustom установлен в NO, операция завершится с ошибкой. | Нет |
Структура StrategyPayForConversionCrrAdd | |||
Crr | int | Средняя доля расходов. | Да |
GoalId | long | Идентификатор цели Яндекс Метрики. Подробнее о целях см. раздел Цели и конверсии помощи Метрики. Список целей получают с помощью метода GetStatGoals API версии 4 или Live 4. | Да |
WeeklySpendLimit | long | Недельный бюджет в валюте рекламодателя, умноженный на 1 000 000. Минимальный недельный бюджет для каждой валюты представлен в справочнике валют. Справочник валют можно получить с помощью метода Dictionaries.get. | Нет |
CustomPeriodBudget | CustomPeriodBudget | Бюджет на период. Подробнее см. в справке Директа. При создании кампании нельзя указать одновременно с WeeklySpendLimit. | Нет |
Структура StrategyPayForConversionPerCampaignAdd | |||
Cpa | long | Цена достижения цели в валюте рекламодателя, умноженная на 1 000 000. Минимальное и максимальное значение цены для каждой валюты представлено в справочнике валют. Справочник валют можно получить с помощью метода Dictionaries.get. | Да |
GoalId | long | Идентификатор цели Яндекс Метрики. Подробнее о целях см. раздел Цели и конверсии помощи Метрики. Список целей получают с помощью метода GetStatGoals API версии 4 или Live 4. | Да |
WeeklySpendLimit | long | Недельный бюджет в валюте рекламодателя, умноженный на 1 000 000. Минимальный недельный бюджет для каждой валюты должен быть не менее, чем значение параметра Cpa, умноженное на 20. Справочник валют можно получить с помощью метода Dictionaries.get. | Нет |
CustomPeriodBudget | CustomPeriodBudget | Бюджет на период. Подробнее см. в справке Директа. При создании кампании нельзя указать одновременно с WeeklySpendLimit. | Нет |
Структура StrategyPayForConversionPerFilterAdd | |||
Cpa | long | Цена достижения цели в валюте рекламодателя, умноженная на 1 000 000. Минимальное и максимальное значение цены для каждой валюты представлено в справочнике валют. Справочник валют можно получить с помощью метода Dictionaries.get. | Да |
GoalId | long | Идентификатор цели Яндекс Метрики. Подробнее о целях см. раздел Цели и конверсии помощи Метрики. Список целей получают с помощью метода GetStatGoals API версии 4 или Live 4. | Да |
WeeklySpendLimit | long | Недельный бюджет в валюте рекламодателя, умноженный на 1 000 000. Минимальный недельный бюджет для каждой валюты должен быть не менее, чем значение параметра Cpa, умноженное на 20. Справочник валют можно получить с помощью метода Dictionaries.get. | Нет |
CustomPeriodBudget | CustomPeriodBudget | Бюджет на период. Подробнее см. в справке Директа. При создании кампании нельзя указать одновременно с WeeklySpendLimit. | Нет |
Структура ExplorationBudget | |||
MinimumExplorationBudget | long | Значение минимального бюджета. Допустимое значение: от 0 до значения недельного бюджета (если он задан). | Да, если в запросе есть структура ExplorationBudget. |
IsMinimumExplorationBudgetCustom | YesNoEnum | Признак пользовательского значения минимального бюджета. | Да, если в запросе есть структура ExplorationBudget. |
Структура CustomPeriodBudget | |||
SpendLimit | long | Значение бюджета на период. | Да |
StartDate | string | Начало бюджетного периода. | Да |
EndDate | string | Окончание бюджетного периода. | Да |
AutoContinue | YesNoEnum | Признак автопродления бюджета. | Да |
Параметр | Тип | Описание | Обязательный |
Структура SmartCampaignAddItem | |||
---|---|---|---|
BiddingStrategy | SmartCampaignStrategyAdd | Стратегия показа. | Нет, если указан PackageBiddingStrategy |
Settings | array of SmartCampaignSetting | Массив настроек, допускающих только значения YES или NO. | Нет |
CounterId | long | Идентификатор счетчика Яндекс Метрики, установленного на сайте рекламодателя (см. раздел Метрика. Оценка эффективности рекламной кампании помощи Директа). | Да |
PriorityGoals | PriorityGoalsArray | Ключевые цели, на достижение которых направлена автоматическая корректировка ставок. Если массив не задан, автоматическая корректировка направлена на получение максимального количества вовлеченных сессий, см. раздел Показатели вовлеченных сессий помощи Директа. Ограничение — 30 ключевых целей. | Нет |
TrackingParams | string | Параметры URL для шаблонов. | Нет |
AttributionModel | AttributionModelEnum | Модель атрибуции, используемая для оптимизации конверсий (см. раздел Модели атрибуции помощи Директа). Возможные значения:
Значение по умолчанию — LYDC. | Нет |
PackageBiddingStrategy | SmartCampaignPackageBiddingStrategyAdd | Привязывает кампанию к указанной стратегии. При заполнении этого поля нельзя передавать следующие параметры:
Чтобы передавать эти параметры, необходимо отвязать кампанию от пакетной стратегии: укажите новое значение BiddingStrategy и сбросьте значение параметра PackageBiddingStrategy: null. | Нет, если указан BiddingStrategy |
Структура SmartCampaignSetting | |||
Option | SmartCampaignSettingsEnum | Имя настройки: | Да |
Value | YesNoEnum | Значение настройки. | Да |
Структура PackageBiddingStrategyAdd | |||
StrategyId | long | Идентификатор пакетной стратегии. | |
StrategyFromCampaignId | long | Идентификатор кампании, из которой создается пакетная стратегия. | Нет |
Platforms | SmartCampaignpPlatforms | Платформа размещения рекламы. | Да |
Структура SmartCampaignPlatforms | |||
Search | YesNoEnum | Поисковая выдача. | Да |
Network | YesNoEnum | Рекламная сеть Яндекса. | Да |
Структура PriorityGoalsArray | |||
Items | array of PriorityGoalsItem | Набор ключевых целей и ценностей конверсий по ним. | Да |
Структура PriorityGoalsItem | |||
GoalId | long | Идентификатор цели Яндекс Метрики, на достижение которой будет направлена автоматическая корректировка ставок. Подробнее о целях см. раздел Цели и конверсии помощи Метрики. Список целей получают с помощью метода GetStatGoals API версии 4 или Live 4. Значение 12 соответствует цели «Вовлеченные сессии». | Да |
Value | long | Ценность конверсии — денежная оценка выгоды, получаемой рекламодателем при достижении указанной цели, в валюте рекламодателя, умноженная на 1 000 000. Чем больше ценность конверсии, тем выше приоритет достижения указанной цели. | Да |
IsMetrikaSourceOfValue | YesNoEnum | Источник ценности ключевой цели — цель Метрики. Значение YES используется только для стратегий с долей рекламных расходов. | При значении AVERAGE_CRR или PAY_FOR_CONVERSION_CRR в параметре BiddingStrategyType |
Структура SmartCampaignStrategyAdd | |||
Search | SmartCampaignSearchStrategyAdd | Стратегия показа на поиске. | Да |
Network | SmartCampaignNetworkStrategyAdd | Стратегия показа в сетях. | Да |
Структура SmartCampaignSearchStrategyAdd | |||
BiddingStrategyType | SmartCampaignSearchStrategyTypeEnum | Тип стратегии показа на поиске: | Да |
AverageCpaPerCampaign | StrategyAverageCpaPerCampaignAdd | Параметры стратегии Оптимизация количества конверсий, CPA на всю кампанию. | При значении AVERAGE_CPA_PER_CAMPAIGN в параметре BiddingStrategyType |
AverageCpaPerFilter | StrategyAverageCpaPerFilterAdd | Параметры стратегии Оптимизация количества конверсий, CPA на каждый фильтр. | При значении AVERAGE_CPA_PER_FILTER в параметре BiddingStrategyType |
AverageCpcPerCampaign | StrategyAverageCpcPerCampaignAdd | Параметры стратегии Оптимизация количества кликов, CPC на всю кампанию. | При значении AVERAGE_CPC_PER_CAMPAIGN в параметре BiddingStrategyType |
AverageCpcPerFilter | StrategyAverageCpcPerFilterAdd | Параметры стратегии Оптимизация количества кликов, CPC на каждый фильтр. | При значении AVERAGE_CPC_PER_FILTER в параметре BiddingStrategyType |
AverageRoi | StrategyAverageRoiAdd | Параметры стратегии Оптимизация рентабельности. | При значении AVERAGE_ROI в параметре BiddingStrategyType |
AverageCrr | StrategyAverageCrrAdd | Параметры стратегии Оптимизация доли рекламных расходов, удерживать среднюю долю расходов. | При значении AVERAGE_CRR в параметре BiddingStrategyType |
PayForConversionCrr | StrategyPayForConversionCrrAdd | Параметры стратегии Оптимизация доли рекламных расходов, оплата за конверсии. | При значении PAY_FOR_CONVERSION_CRR в параметре BiddingStrategyType |
PayForConversionPerCampaign | StrategyPayForConversionPerCampaignAdd | Параметры стратегии Оптимизация количества конверсий, оплата за конверсии. | При значении PAY_FOR_CONVERSION_PER_CAMPAIGN в параметре BiddingStrategyType |
PayForConversionPerFilter | StrategyPayForConversionPerFilterAdd | Параметры стратегии Оптимизация количества конверсий, оплата за конверсии на каждый фильтр. | При значении PAY_FOR_CONVERSION_PER_FILTER в параметре BiddingStrategyType |
Структура SmartCampaignNetworkStrategyAdd | |||
BiddingStrategyType | SmartCampaignNetworkStrategyTypeEnum | Тип стратегии показа в сетях:
| Да |
AverageCpaPerCampaign | StrategyAverageCpaPerCampaignAdd | Параметры стратегии Оптимизация количества конверсий, CPA на всю кампанию. | При значении AVERAGE_CPA_PER_CAMPAIGN в параметре BiddingStrategyType |
AverageCpaPerFilter | StrategyAverageCpaPerFilterAdd | Параметры стратегии Оптимизация количества конверсий, CPA на каждый фильтр. | При значении AVERAGE_CPA_PER_FILTER в параметре BiddingStrategyType |
AverageCpcPerCampaign | StrategyAverageCpcPerCampaignAdd | Параметры стратегии Оптимизация количества кликов, CPC на всю кампанию. | При значении AVERAGE_CPC_PER_CAMPAIGN в параметре BiddingStrategyType |
AverageCpcPerFilter | StrategyAverageCpcPerFilterAdd | Параметры стратегии Оптимизация количества кликов, CPC на каждый фильтр. | При значении AVERAGE_CPC_PER_FILTER в параметре BiddingStrategyType |
AverageRoi | StrategyAverageRoiAdd | Параметры стратегии Оптимизация рентабельности. | При значении AVERAGE_ROI в параметре BiddingStrategyType |
AverageCrr | StrategyAverageCrrAdd | Параметры стратегии Оптимизация доли рекламных расходов, удерживать среднюю долю расходов. | При значении AVERAGE_CRR в параметре BiddingStrategyType |
PayForConversionCrr | StrategyPayForConversionCrrAdd | Параметры стратегии Оптимизация доли рекламных расходов, оплата за конверсии. | При значении PAY_FOR_CONVERSION_CRR в параметре BiddingStrategyType |
PayForConversionPerCampaign | StrategyPayForConversionPerCampaignAdd | Параметры стратегии Оптимизация количества конверсий, оплата за конверсии. | При значении PAY_FOR_CONVERSION_PER_CAMPAIGN в параметре BiddingStrategyType |
PayForConversionPerFilter | StrategyPayForConversionPerFilterAdd | Параметры стратегии Оптимизация количества конверсий, оплата за конверсии на каждый фильтр. | При значении PAY_FOR_CONVERSION_PER_FILTER в параметре BiddingStrategyType |
NetworkDefault Ограничение. Параметр NETWORK_DEFAULT не поддерживается для ручной стратегии HIGHEST_POSITION. | StrategyNetworkDefaultAdd | Настройки показов в сетях в зависимости от настроек на поиске. Для этой стратегии передайте пустую структуру. | При значении NETWORK_DEFAULT в параметре BiddingStrategyType |
Структура StrategyAverageCpaPerCampaignAdd | |||
AverageCpa | long | Средняя цена достижения цели в валюте рекламодателя, умноженная на 1 000 000. Минимальное значение средней цены для каждой валюты представлено в справочнике валют. Справочник валют можно получить с помощью метода Dictionaries.get. | Да |
GoalId | long | Идентификатор цели Яндекс Метрики. Подробнее о целях см. раздел Цели и конверсии помощи Метрики. Список целей получают с помощью метода GetStatGoals API версии 4 или Live 4. | Да |
WeeklySpendLimit | long | Недельный бюджет в валюте рекламодателя, умноженный на 1 000 000. Минимальный недельный бюджет для каждой валюты представлен в справочнике валют. Справочник валют можно получить с помощью метода Dictionaries.get. | Нет |
CustomPeriodBudget | CustomPeriodBudget | Бюджет на период. Подробнее см. в справке Директа. При создании кампании нельзя указать одновременно с WeeklySpendLimit. | Нет |
BidCeiling | long | Максимальная ставка в валюте рекламодателя, умноженная на 1 000 000. Минимальное и максимальное значение ставки для каждой валюты представлены в справочнике валют. Справочник валют можно получить с помощью метода Dictionaries.get. Примечание. Указывать максимальную ставку не рекомендуется — это может снизить эффективность работы стратегии. | Нет |
ExplorationBudget | ExplorationBudget | Минимальный бюджет. Подробнее в справке Директа. Если поле не задано, для стратегии устанавливается значение по умолчанию (рассчитывается на основе настроек стратегии). Чтобы установить пользовательское значение минимального бюджета, задайте значение в параметре MinimumExplorationBudget и укажите IsMinimumExplorationBudgetCustom="YES". Если IsMinimumExplorationBudgetCustom установлен в NO, операция завершится с ошибкой. | Нет |
Структура StrategyAverageCpaPerFilterAdd | |||
FilterAverageCpa | long | Средняя цена достижения цели по умолчанию на каждый фильтр в валюте рекламодателя, умноженная на 1 000 000. Минимальное значение средней цены для каждой валюты представлено в справочнике валют. Справочник валют можно получить с помощью метода Dictionaries.get. | Да |
GoalId | long | Идентификатор цели Яндекс Метрики. Подробнее о целях см. раздел Цели и конверсии помощи Метрики. Список целей получают с помощью метода GetStatGoals API версии 4 или Live 4. | Да |
WeeklySpendLimit | long | Недельный бюджет в валюте рекламодателя, умноженный на 1 000 000. Минимальный недельный бюджет для каждой валюты представлен в справочнике валют. Справочник валют можно получить с помощью метода Dictionaries.get. | Нет |
CustomPeriodBudget | CustomPeriodBudget | Бюджет на период. Подробнее см. в справке Директа. При создании кампании нельзя указать одновременно с WeeklySpendLimit. | Нет |
BidCeiling | long | Максимальная ставка в валюте рекламодателя, умноженная на 1 000 000. Минимальное и максимальное значение ставки для каждой валюты представлены в справочнике валют. Справочник валют можно получить с помощью метода Dictionaries.get. Примечание. Указывать максимальную ставку не рекомендуется — это может снизить эффективность работы стратегии. | Нет |
ExplorationBudget | ExplorationBudget | Минимальный бюджет. Подробнее в справке Директа. Если поле не задано, для стратегии устанавливается значение по умолчанию (рассчитывается на основе настроек стратегии). Чтобы установить пользовательское значение минимального бюджета, задайте значение в параметре MinimumExplorationBudget и укажите IsMinimumExplorationBudgetCustom="YES". Если IsMinimumExplorationBudgetCustom установлен в NO, операция завершится с ошибкой. | Нет |
Структура StrategyAverageCpcPerCampaignAdd | |||
AverageCpc | long | Средняя цена клика в валюте рекламодателя, умноженная на 1 000 000. Минимальное значение средней цены для каждой валюты представлено в справочнике валют. Справочник валют можно получить с помощью метода Dictionaries.get. | Да |
WeeklySpendLimit | long | Недельный бюджет в валюте рекламодателя, умноженный на 1 000 000. Минимальный недельный бюджет для каждой валюты представлен в справочнике валют. Справочник валют можно получить с помощью метода Dictionaries.get. | Нет |
CustomPeriodBudget | CustomPeriodBudget | Бюджет на период. Подробнее см. в справке Директа. При создании кампании нельзя указать одновременно с WeeklySpendLimit. | Нет |
BidCeiling | long | Максимальная ставка в валюте рекламодателя, умноженная на 1 000 000. Минимальное и максимальное значение ставки для каждой валюты представлены в справочнике валют. Справочник валют можно получить с помощью метода Dictionaries.get. Примечание. Указывать максимальную ставку не рекомендуется — это может снизить эффективность работы стратегии. | Нет |
Структура StrategyAverageCpcPerFilterAdd | |||
FilterAverageCpc | long | Да | |
WeeklySpendLimit | long | Недельный бюджет в валюте рекламодателя, умноженный на 1 000 000. Минимальный недельный бюджет для каждой валюты представлен в справочнике валют. Справочник валют можно получить с помощью метода Dictionaries.get. | Нет |
CustomPeriodBudget | CustomPeriodBudget | Бюджет на период. Подробнее см. в справке Директа. При создании кампании нельзя указать одновременно с WeeklySpendLimit. | Нет |
BidCeiling | long | Максимальная ставка в валюте рекламодателя, умноженная на 1 000 000. Минимальное и максимальное значение ставки для каждой валюты представлены в справочнике валют. Справочник валют можно получить с помощью метода Dictionaries.get. Примечание. Указывать максимальную ставку не рекомендуется — это может снизить эффективность работы стратегии. | Нет |
Структура StrategyAverageRoiAdd | |||
ReserveReturn | int | Максимальный процент сэкономленных средств, который можно возвращать в рекламу (расходовать) в случае, если прогнозируемое значение рентабельности превышает значение параметра RoiCoef. Значение от 0 до 100, кратное десяти: 0, 10, 20... 100. | Да |
RoiCoef | long | Желаемая средняя рентабельность инвестиций за неделю. Значение представляет собой отношение прибыли от продаж к расходам на рекламу, умноженное на 1 000 000. Значение должно быть целым числом. Если значение не кратно 10 000, последние 4 цифры обнуляются (что соответствует отбрасыванию лишних знаков после запятой). | Да |
GoalId | long | Идентификатор цели Яндекс Метрики. Подробнее о целях см. раздел Цели и конверсии помощи Метрики. Значение 13 — ключевые цели. Допускается, если в массиве PriorityGoals указана хотя бы одна цель, отличная от вовлеченных сессий. Список целей получают с помощью метода GetStatGoals API версии 4 или Live 4. | Да |
WeeklySpendLimit | long | Недельный бюджет в валюте рекламодателя, умноженный на 1 000 000. Минимальный недельный бюджет для каждой валюты представлен в справочнике валют. Справочник валют можно получить с помощью метода Dictionaries.get. | Нет |
CustomPeriodBudget | CustomPeriodBudget | Бюджет на период. Подробнее см. в справке Директа. При создании кампании нельзя указать одновременно с WeeklySpendLimit. | Нет |
BidCeiling | long | Максимальная ставка в валюте рекламодателя, умноженная на 1 000 000. Минимальное и максимальное значение ставки для каждой валюты представлены в справочнике валют. Справочник валют можно получить с помощью метода Dictionaries.get. Примечание. Указывать максимальную ставку не рекомендуется — это может снизить эффективность работы стратегии. | Нет |
Profitability | long | Процент выручки, являющийся себестоимостью товаров или услуг. Значение представляет собой процент, умноженный на 1 000 000. Значение должно быть целым числом от 0 до 100 000 000 (что соответствует 100%). Если значение не кратно 10 000, последние 4 цифры обнуляются (что соответствует отбрасыванию лишних знаков после запятой). | Нет |
ExplorationBudget | ExplorationBudget | Минимальный бюджет. Подробнее в справке Директа. Если поле не задано, для стратегии устанавливается значение по умолчанию (рассчитывается на основе настроек стратегии). Чтобы установить пользовательское значение минимального бюджета, задайте значение в параметре MinimumExplorationBudget и укажите IsMinimumExplorationBudgetCustom="YES". Если IsMinimumExplorationBudgetCustom установлен в NO, операция завершится с ошибкой. | Нет |
Структура StrategyAverageCrrAdd | |||
Crr | int | Средняя доля расходов. | Да |
GoalId | long | Идентификатор цели Яндекс Метрики. Подробнее о целях см. раздел Цели и конверсии помощи Метрики. Список целей получают с помощью метода GetStatGoals API версии 4 или Live 4. | Да |
WeeklySpendLimit | long | Недельный бюджет в валюте рекламодателя, умноженный на 1 000 000. Минимальный недельный бюджет для каждой валюты представлен в справочнике валют. Справочник валют можно получить с помощью метода Dictionaries.get. | Нет |
CustomPeriodBudget | CustomPeriodBudget | Бюджет на период. Подробнее см. в справке Директа. При создании кампании нельзя указать одновременно с WeeklySpendLimit. | Нет |
ExplorationBudget | ExplorationBudget | Минимальный бюджет. Подробнее в справке Директа. Если поле не задано, для стратегии устанавливается значение по умолчанию (рассчитывается на основе настроек стратегии). Чтобы установить пользовательское значение минимального бюджета, задайте значение в параметре MinimumExplorationBudget и укажите IsMinimumExplorationBudgetCustom="YES". Если IsMinimumExplorationBudgetCustom установлен в NO, операция завершится с ошибкой. | Нет |
Структура StrategyPayForConversionCrrAdd | |||
Crr | int | Средняя доля расходов. | Да |
GoalId | long | Идентификатор цели Яндекс Метрики. Подробнее о целях см. раздел Цели и конверсии помощи Метрики. Список целей получают с помощью метода GetStatGoals API версии 4 или Live 4. | Да |
WeeklySpendLimit | long | Недельный бюджет в валюте рекламодателя, умноженный на 1 000 000. Минимальный недельный бюджет для каждой валюты представлен в справочнике валют. Справочник валют можно получить с помощью метода Dictionaries.get. | Нет |
CustomPeriodBudget | CustomPeriodBudget | Бюджет на период. Подробнее см. в справке Директа. При создании кампании нельзя указать одновременно с WeeklySpendLimit. | Нет |
Структура StrategyPayForConversionPerCampaignAdd | |||
Cpa | long | Цена достижения цели в валюте рекламодателя, умноженная на 1 000 000. Минимальное и максимальное значение цены для каждой валюты представлено в справочнике валют. Справочник валют можно получить с помощью метода Dictionaries.get. | Да |
GoalId | long | Идентификатор цели Яндекс Метрики. Подробнее о целях см. раздел Цели и конверсии помощи Метрики. Список целей получают с помощью метода GetStatGoals API версии 4 или Live 4. | Да |
WeeklySpendLimit | long | Недельный бюджет в валюте рекламодателя, умноженный на 1 000 000. Минимальный недельный бюджет для каждой валюты должен быть не менее, чем значение параметра Cpa, умноженное на 20. Справочник валют можно получить с помощью метода Dictionaries.get. | Нет |
CustomPeriodBudget | CustomPeriodBudget | Бюджет на период. Подробнее см. в справке Директа. При создании кампании нельзя указать одновременно с WeeklySpendLimit. | Нет |
Структура StrategyPayForConversionPerFilterAdd | |||
Cpa | long | Цена достижения цели в валюте рекламодателя, умноженная на 1 000 000. Минимальное и максимальное значение цены для каждой валюты представлено в справочнике валют. Справочник валют можно получить с помощью метода Dictionaries.get. | Да |
GoalId | long | Идентификатор цели Яндекс Метрики. Подробнее о целях см. раздел Цели и конверсии помощи Метрики. Список целей получают с помощью метода GetStatGoals API версии 4 или Live 4. | Да |
WeeklySpendLimit | long | Недельный бюджет в валюте рекламодателя, умноженный на 1 000 000. Минимальный недельный бюджет для каждой валюты должен быть не менее, чем значение параметра Cpa, умноженное на 20. Справочник валют можно получить с помощью метода Dictionaries.get. | Нет |
CustomPeriodBudget | CustomPeriodBudget | Бюджет на период. Подробнее см. в справке Директа. При создании кампании нельзя указать одновременно с WeeklySpendLimit. | Нет |
Структура ExplorationBudget | |||
MinimumExplorationBudget | long | Значение минимального бюджета. Допустимое значение: от 0 до значения недельного бюджета (если он задан). | Да, если в запросе есть структура ExplorationBudget. |
IsMinimumExplorationBudgetCustom | YesNoEnum | Признак пользовательского значения минимального бюджета. | Да, если в запросе есть структура ExplorationBudget. |
Структура CustomPeriodBudget | |||
SpendLimit | long | Значение бюджета на период. | Да |
StartDate | string | Начало бюджетного периода. | Да |
EndDate | string | Окончание бюджетного периода. | Да |
AutoContinue | YesNoEnum | Признак автопродления бюджета. | Да |