update
Обновляет пакетную стратегию.
Запрос
Структура запроса в формате JSON:
"params" : { /* required */
"Strategies" : [{ /* required */
"Id": (long), /* required */
"AttributionModel" : ("LC"|"LSC"|"FC"|"LYDC"|"LSCCD"|"FCCD"|"LYDCCD"),
"Name" : (string) /* required */,
"CounterIds" : {
"Items" : [ (long) ] /* required */
},
"PriorityGoals" : {
"Items" : [{ /* required */
"GoalId" : (long) /* required */,
"Value" : (long) /* required */,
"IsMetrikaSourceOfValue" : ("YES"|"NO")
} ]
},
"WbMaximumClicks" : {
"WeeklySpendLimit" : (long) /* required */,
"CustomPeriodBudget": { /* nillable */
"SpendLimit": (long),
"StartDate": (string),
"EndDate": (string),
"AutoContinue": ("YES" | "NO")
},
"BudgetType": ("WEEKLY_BUDGET" | "CUSTOM_PERIOD_BUDGET") /* nillable */,
"BidCeiling" : (long)
},
"WbMaximumConversionRate" : {
"WeeklySpendLimit" : (long) /* required */,
"CustomPeriodBudget": { /* nillable */
"SpendLimit": (long),
"StartDate": (string),
"EndDate": (string),
"AutoContinue": ("YES" | "NO")
},
"BudgetType": ("WEEKLY_BUDGET" | "CUSTOM_PERIOD_BUDGET") /* nillable */,
"BidCeiling" : (long),
"GoalId" : (long) /* required */
},
"AverageCpc" : {
"AverageCpc" : (long) /* required */,
"WeeklySpendLimit" : (long), /* nillable */
"CustomPeriodBudget": { /* nillable */
"SpendLimit": (long),
"StartDate": (string),
"EndDate": (string),
"AutoContinue": ("YES" | "NO")
},
"BudgetType": ("WEEKLY_BUDGET" | "CUSTOM_PERIOD_BUDGET") /* nillable */,
},
"AverageCpa" : {
"AverageCpa" : (long) /* required */,
"GoalId" : (long) /* required */,
"WeeklySpendLimit" : (long), /* nillable */
"CustomPeriodBudget": { /* nillable */
"SpendLimit": (long),
"StartDate": (string),
"EndDate": (string),
"AutoContinue": ("YES" | "NO")
},
"BudgetType": ("WEEKLY_BUDGET" | "CUSTOM_PERIOD_BUDGET") /* nillable */,
"BidCeiling" : (long),
"ExplorationBudget" : { /* nillable */
"MinimumExplorationBudget" : (long) /* required */,
"IsMinimumExplorationBudgetCustom" : ("YES") /* required */
}
},
"AverageCpaMultipleGoals" : {
"WeeklySpendLimit" : (long),
"CustomPeriodBudget": {
"SpendLimit": (long),
"StartDate": (string),
"EndDate": (string),
"AutoContinue": ("YES" | "NO")
},
"BidCeiling" : (long),
"ExplorationBudget" : {
"MinimumExplorationBudget" : (long) /* required */,
"IsMinimumExplorationBudgetCustom" : ("YES") /* required */
}
},
"PayForConversion" : {
"Cpa" : (long) /* required */,
"GoalId" : (long) /* required */,
"WeeklySpendLimit" : (long), /* nillable */
"CustomPeriodBudget": { /* nillable */
"SpendLimit": (long),
"StartDate": (string),
"EndDate": (string),
"AutoContinue": ("YES" | "NO")
},
"BudgetType": ("WEEKLY_BUDGET" | "CUSTOM_PERIOD_BUDGET") /* nillable */,
},
"PayForConversionMultipleGoals" : {,
"WeeklySpendLimit" : (long),
"CustomPeriodBudget": {
"SpendLimit": (long),
"StartDate": (string),
"EndDate": (string),
"AutoContinue": ("YES" | "NO")
},
},
"AverageCpaPerCampaign" : {
"AverageCpa" : (long) /* required */,
"GoalId" : (long) /* required */,
"WeeklySpendLimit" : (long), /* nillable */
"CustomPeriodBudget": { /* nillable */
"SpendLimit": (long),
"StartDate": (string),
"EndDate": (string),
"AutoContinue": ("YES" | "NO")
},
"BudgetType": ("WEEKLY_BUDGET" | "CUSTOM_PERIOD_BUDGET") /* nillable */,
"BidCeiling" : (long),
"ExplorationBudget" : { /* nillable */
"MinimumExplorationBudget" : (long) /* required */,
"IsMinimumExplorationBudgetCustom" : ("YES") /* required */
}
},
"PayForConversionPerCampaign" : {
"Cpa" : (long) /* required */,
"GoalId" : (long) /* required */,
"WeeklySpendLimit" : (long), /* nillable */
"CustomPeriodBudget": { /* nillable */
"SpendLimit": (long),
"StartDate": (string),
"EndDate": (string),
"AutoContinue": ("YES" | "NO")
},
"BudgetType": ("WEEKLY_BUDGET" | "CUSTOM_PERIOD_BUDGET") /* nillable */,
},
"PayForConversionPerFilter" : {
"Cpa" : (long) /* required */,
"GoalId" : (long) /* required */,
"WeeklySpendLimit" : (long), /* nillable */
"CustomPeriodBudget": { /* nillable */
"SpendLimit": (long),
"StartDate": (string),
"EndDate": (string),
"AutoContinue": ("YES" | "NO")
},
"BudgetType": ("WEEKLY_BUDGET" | "CUSTOM_PERIOD_BUDGET") /* nillable */,
},
"AverageCpaPerFilter" : {
"FilterAverageCpa" : (long) /* required */,
"GoalId" : (long) /* required */,
"WeeklySpendLimit" : (long), /* nillable */
"CustomPeriodBudget": { /* nillable */
"SpendLimit": (long),
"StartDate": (string),
"EndDate": (string),
"AutoContinue": ("YES" | "NO")
},
"BudgetType": ("WEEKLY_BUDGET" | "CUSTOM_PERIOD_BUDGET") /* nillable */,
"BidCeiling" : (long),
"ExplorationBudget" : { /* nillable */
"MinimumExplorationBudget" : (long) /* required */,
"IsMinimumExplorationBudgetCustom" : ("YES") /* required */
}
},
"AverageCpcPerCampaign" : {
"AverageCpc" : (long) /* required */,
"WeeklySpendLimit" : (long), /* nillable */
"CustomPeriodBudget": { /* nillable */
"SpendLimit": (long),
"StartDate": (string),
"EndDate": (string),
"AutoContinue": ("YES" | "NO")
},
"BudgetType": ("WEEKLY_BUDGET" | "CUSTOM_PERIOD_BUDGET") /* nillable */,
"BidCeiling" : (long)
},
"AverageCpcPerFilter" : {
"FilterAverageCpc" : (long),
"WeeklySpendLimit" : (long), /* nillable */
"CustomPeriodBudget": { /* nillable */
"SpendLimit": (long),
"StartDate": (string),
"EndDate": (string),
"AutoContinue": ("YES" | "NO")
},
"BudgetType": ("WEEKLY_BUDGET" | "CUSTOM_PERIOD_BUDGET") /* nillable */,
"BidCeiling" : (long)
},
"AverageCrr" : {
"Crr" : (integer) /* required */,
"GoalId" : (long) /* required */,
"WeeklySpendLimit" : (long), /* nillable */
"CustomPeriodBudget": { /* nillable */
"SpendLimit": (long),
"StartDate": (string),
"EndDate": (string),
"AutoContinue": ("YES" | "NO")
},
"BudgetType": ("WEEKLY_BUDGET" | "CUSTOM_PERIOD_BUDGET") /* nillable */,
"ExplorationBudget" : { /* nillable */
"MinimumExplorationBudget" : (long) /* required */,
"IsMinimumExplorationBudgetCustom" : ("YES") /* required */
}
},
"PayForConversionCrr" : {
"Crr" : (integer) /* required */,
"GoalId" : (long) /* required */,
"WeeklySpendLimit" : (long), /* nillable */
"CustomPeriodBudget": { /* nillable */
"SpendLimit": (long),
"StartDate": (string),
"EndDate": (string),
"AutoContinue": ("YES" | "NO")
},
"BudgetType": ("WEEKLY_BUDGET" | "CUSTOM_PERIOD_BUDGET") /* nillable */,
}
} ]
}
|
Параметр |
Тип |
Описание |
Обязательный |
|
Структура params (для JSON) / AddRequest (для SOAP) |
|||
|
Strategies |
array of StrategiesUpdateItem |
Пакетная стратегия |
Да |
|
Структура StrategiesUpdateItem |
|||
|
|
long |
Идентификатор пакетной стратегии. |
Да |
|
|
AttributionModelEnum |
Модель атрибуции, используемая для оптимизации конверсий (см. раздел Модели атрибуции). Возможные значения:
Значение по умолчанию — LYDC. |
Нет |
|
|
String |
Название пакетной стратегии. |
Да |
|
|
ArrayOfInteger |
Идентификаторы счетчиков Яндекс Метрики, установленных на сайте рекламодателя (см. раздел Яндекс Метрика: оценка эффективности рекламы помощи Директа). |
Нет |
|
|
PriorityGoalsArray |
Ключевые цели, на достижение которых направлена автоматическая корректировка ставок. Если массив не задан, автоматическая корректировка направлена на получение максимального количества вовлеченных сессий, см. раздел Показатели вовлеченных сессий помощи Директа. Ограничение — 30 ключевых целей. |
При передаче параметров |
|
|
StrategyMaximumClicksUpdate |
Параметры стратегии Оптимизация кликов, ограничивать по недельному бюджету. |
Нет |
|
|
StrategyMaximumConversionRateUpdate |
Параметры стратегии Оптимизация конверсий, без указания средней цены конверсии. |
Нет |
|
|
StrategyAverageCpcUpdate |
Параметры стратегии Оптимизация кликов, ограничивать по средней цене клика. |
Нет |
|
|
StrategyAverageCpaUpdate |
Параметры стратегии Оптимизация конверсий, удерживать среднюю цену конверсии. |
Нет |
|
|
StrategyAverageCpaMultipleGoalsAdd |
Параметры стратегии Максимум конверсий с оплатой за клики, удерживать среднюю цену конверсии по нескольким целям.Одновременно необходимо передать массив |
Нет |
|
|
StrategyAverageCrrUpdate |
Параметры стратегии Оптимизация доли рекламных расходов, удерживать среднюю долю расходов. |
Нет |
|
|
StrategyPayForConversionCrrUpdate |
Параметры стратегии Оптимизация доли рекламных расходов, оплата за конверсии. |
Нет |
|
|
StrategyPayForConversionUpdate |
Параметры стратегии Оптимизация конверсий, оплата за конверсии. |
Нет |
|
|
StrategyPayForConversionMultipleGoalsAdd |
Параметры стратегии Максимум конверсий с оплатой за конверсии по каждой из указанных целей. |
Нет |
|
|
StrategyAverageCpaPerCampaignUpdate |
Параметры стратегии Оптимизация количества конверсий, CPA на всю кампанию. |
Нет |
|
|
StrategyPayForConversionPerCampaignUpdate |
Параметры стратегии Оптимизация количества конверсий, оплата за конверсии. |
Нет |
|
|
StrategyPayForConversionPerFilterUpdate |
Параметры стратегии Оптимизация количества конверсий, оплата за конверсии. |
Нет |
|
|
StrategyAverageCpaPerFilterUpdate |
Параметры стратегии Оптимизация количества конверсий, CPA на каждый фильтр. |
Нет |
|
|
StrategyAverageCpcPerCampaignUpdate |
Параметры стратегии Оптимизация количества кликов, CPC на всю кампанию. |
Нет |
|
|
StrategyAverageCpcPerFilterUpdate |
Параметры стратегии Оптимизация количества кликов, CPC на каждый фильтр. |
Нет |
|
Структура PriorityGoalsArray |
|||
|
|
array of PriorityGoalsItem |
Набор ключевых целей и ценностей конверсий по ним. |
Да |
|
Структура PriorityGoalsItem |
|||
|
|
long |
Идентификатор цели Яндекс Метрики, на достижение которой будет направлена автоматическая корректировка ставок. Подробнее о целях см. раздел Цели и конверсии помощи Метрики. Список целей получают с помощью метода GetStatGoals API версии 4 или Live 4. Значение 12 соответствует цели “Вовлеченные сессии”. |
Да |
|
|
long |
Ценность конверсии — денежная оценка выгоды, получаемой рекламодателем при достижении указанной цели, в валюте рекламодателя, умноженная на 1 000 000. Чем больше ценность конверсии, тем выше приоритет достижения указанной цели. |
Да |
|
|
YesNoEnum |
Источник ценности ключевой цели — цель Метрики. Значение |
При значении AVERAGE_CRR или PAY_FOR_CONVERSION_CRR в параметре BiddingStrategyType |
|
Структура StrategyMaximumClicksUpdate |
|||
|
|
long |
Недельный бюджет в валюте рекламодателя, умноженный на 1 000 000. Минимальный недельный бюджет для каждой валюты представлен в справочнике валют. Справочник валют можно получить с помощью метода Dictionaries.get. |
Да |
|
|
CustomPeriodBudget |
Бюджет на период. Подробнее см. в справке Директа. При создании кампании нельзя указать одновременно с |
Нет |
|
|
BudgetTypeEnum |
Тип бюджета:
Если при редактировании кампании тип бюджета изменился, изначальный тип необходимо передать со значеним NULL. Например, если тип бюджета поменялся с недельного на периодный, поле WeeklySpendLimit должно быть передано со значением NULL. |
Нет |
|
|
long |
Максимальная ставка в валюте рекламодателя, умноженная на 1 000 000. Минимальное и максимальное значение ставки для каждой валюты представлены в справочнике валют. Справочник валют можно получить с помощью метода Dictionaries.get. Примечание Указывать максимальную ставку не рекомендуется — это может снизить эффективность работы стратегии. |
Нет |
|
Структура StrategyMaximumConversionRateUpdate |
|||
|
|
long |
Недельный бюджет в валюте рекламодателя, умноженный на 1 000 000. Минимальный недельный бюджет для каждой валюты представлен в справочнике валют. Справочник валют можно получить с помощью метода Dictionaries.get. |
Да |
|
|
CustomPeriodBudget |
Бюджет на период. Подробнее см. в справке Директа. При создании кампании нельзя указать одновременно с |
Нет |
|
|
BudgetTypeEnum |
Тип бюджета:
Если при редактировании кампании тип бюджета изменился, изначальный тип необходимо передать со значеним NULL. Например, если тип бюджета поменялся с недельного на периодный, поле WeeklySpendLimit должно быть передано со значением NULL. |
Нет |
|
|
long |
Максимальная ставка в валюте рекламодателя, умноженная на 1 000 000. Минимальное и максимальное значение ставки для каждой валюты представлены в справочнике валют. Справочник валют можно получить с помощью метода Dictionaries.get. Примечание Указывать максимальную ставку не рекомендуется — это может снизить эффективность работы стратегии. |
Нет |
|
|
long |
Идентификатор цели Яндекс Метрики. Подробнее о целях см. раздел Цели и конверсии помощи Метрики. Значение 13 — ключевые цели. Допускается, если в массиве PriorityGoals указана хотя бы одна цель, отличная от вовлеченных сессий. Список целей получают с помощью метода GetStatGoals API версии 4 или Live 4. |
Да |
|
Структура StrategyAverageCpcUpdate |
|||
|
|
long |
Средняя цена клика в валюте рекламодателя, умноженная на 1 000 000. Минимальное значение средней цены для каждой валюты представлено в справочнике валют. Справочник валют можно получить с помощью метода Dictionaries.get. |
Да |
|
|
long |
Недельный бюджет в валюте рекламодателя, умноженный на 1 000 000. Минимальный недельный бюджет для каждой валюты представлен в справочнике валют. Справочник валют можно получить с помощью метода Dictionaries.get. |
Нет |
|
|
CustomPeriodBudget |
Бюджет на период. Подробнее см. в справке Директа. При создании кампании нельзя указать одновременно с |
Нет |
|
|
BudgetTypeEnum |
Тип бюджета:
Если при редактировании кампании тип бюджета изменился, изначальный тип необходимо передать со значеним NULL. Например, если тип бюджета поменялся с недельного на периодный, поле WeeklySpendLimit должно быть передано со значением NULL. |
Нет |
|
Структура StrategyAverageCpaUpdate |
|||
|
|
long |
Средняя цена достижения цели в валюте рекламодателя, умноженная на 1 000 000. Минимальное значение средней цены для каждой валюты представлено в справочнике валют. Справочник валют можно получить с помощью метода Dictionaries.get. |
Да |
|
|
long |
Недельный бюджет в валюте рекламодателя, умноженный на 1 000 000. Минимальный недельный бюджет для каждой валюты представлен в справочнике валют. Справочник валют можно получить с помощью метода Dictionaries.get. |
Нет |
|
|
CustomPeriodBudget |
Бюджет на период. Подробнее см. в справке Директа. При создании кампании нельзя указать одновременно с |
Нет |
|
|
BudgetTypeEnum |
Тип бюджета:
Если при редактировании кампании тип бюджета изменился, изначальный тип необходимо передать со значеним NULL. Например, если тип бюджета поменялся с недельного на периодный, поле WeeklySpendLimit должно быть передано со значением NULL. |
Нет |
|
|
CustomPeriodBudget |
Бюджет на период. Подробнее см. в справке Директа. При создании кампании нельзя указать одновременно с |
Нет |
|
|
BudgetTypeEnum |
Тип бюджета:
Если при редактировании кампании тип бюджета изменился, изначальный тип необходимо передать со значеним NULL. Например, если тип бюджета поменялся с недельного на периодный, поле WeeklySpendLimit должно быть передано со значением NULL. |
Нет |
|
|
long |
Идентификатор цели Яндекс Метрики. Подробнее о целях см. раздел Цели и конверсии помощи Метрики. Список целей получают с помощью метода GetStatGoals API версии 4 или Live 4. |
Да |
|
|
long |
Максимальная ставка в валюте рекламодателя, умноженная на 1 000 000. Минимальное и максимальное значение ставки для каждой валюты представлены в справочнике валют. Справочник валют можно получить с помощью метода Dictionaries.get. Примечание Указывать максимальную ставку не рекомендуется — это может снизить эффективность работы стратегии. |
Нет |
|
|
Минимальный бюджет. Подробнее в справке Директа. Если поле не задано, значение миниального бюджета не изменится. Чтобы установить значение по умолчанию, передайте Чтобы установить пользовательское значение минимального бюджета, задайте значение в параметре Если |
Нет |
|
|
Структура StrategyAverageCpaMultipleGoalsUpdate |
|||
|
|
long |
Недельный бюджет в валюте рекламодателя, умноженный на 1 000 000. Минимальный недельный бюджет для каждой валюты представлен в справочнике валют. Справочник валют можно получить с помощью метода Dictionaries.get. |
Нет |
|
|
CustomPeriodBudget |
Бюджет на период. Подробнее см. в справке Директа. При создании кампании нельзя указать одновременно с |
Нет |
|
|
BudgetTypeEnum |
Тип бюджета:
Если при редактировании кампании тип бюджета изменился, изначальный тип необходимо передать со значеним NULL. Например, если тип бюджета поменялся с недельного на периодный, поле WeeklySpendLimit должно быть передано со значением NULL. |
Нет |
|
|
CustomPeriodBudget |
Бюджет на период. Подробнее см. в справке Директа. При создании кампании нельзя указать одновременно с |
Нет |
|
|
BudgetTypeEnum |
Тип бюджета:
Если при редактировании кампании тип бюджета изменился, изначальный тип необходимо передать со значеним NULL. Например, если тип бюджета поменялся с недельного на периодный, поле WeeklySpendLimit должно быть передано со значением NULL. |
Нет |
|
|
long |
Максимальная ставка в валюте рекламодателя, умноженная на 1 000 000. Минимальное и максимальное значение ставки для каждой валюты представлены в справочнике валют. Справочник валют можно получить с помощью метода Dictionaries.get. Примечание Указывать максимальную ставку не рекомендуется — это может снизить эффективность работы стратегии. |
Нет |
|
|
Минимальный бюджет. Подробнее в справке Директа. Если поле не задано, значение миниального бюджета не изменится. Чтобы установить значение по умолчанию, передайте Чтобы установить пользовательское значение минимального бюджета, задайте значение в параметре Если |
Нет |
|
|
Структура StrategyAverageCrrUpdate |
|||
|
|
int |
Средняя доля расходов. |
Да |
|
|
long |
Идентификатор цели Яндекс Метрики. Подробнее о целях см. раздел Цели и конверсии помощи Метрики. Список целей получают с помощью метода GetStatGoals API версии 4 или Live 4. |
Да |
|
|
long |
Недельный бюджет в валюте рекламодателя, умноженный на 1 000 000. Минимальный недельный бюджет для каждой валюты представлен в справочнике валют. Справочник валют можно получить с помощью метода Dictionaries.get. |
Нет |
|
|
CustomPeriodBudget |
Бюджет на период. Подробнее см. в справке Директа. При создании кампании нельзя указать одновременно с |
Нет |
|
|
BudgetTypeEnum |
Тип бюджета:
Если при редактировании кампании тип бюджета изменился, изначальный тип необходимо передать со значеним NULL. Например, если тип бюджета поменялся с недельного на периодный, поле WeeklySpendLimit должно быть передано со значением NULL. |
Нет |
|
|
Минимальный бюджет. Подробнее в справке Директа. Если поле не задано, значение миниального бюджета не изменится. Чтобы установить значение по умолчанию, передайте Чтобы установить пользовательское значение минимального бюджета, задайте значение в параметре Если |
Нет |
|
|
Структура StrategyPayForConversionUpdate |
|||
|
|
long |
Цена достижения цели в валюте рекламодателя, умноженная на 1 000 000. Минимальное и максимальное значение цены для каждой валюты представлено в справочнике валют. Справочник валют можно получить с помощью метода Dictionaries.get. |
Да |
|
|
long |
Идентификатор цели Яндекс Метрики. Подробнее о целях см. раздел Цели и конверсии помощи Метрики. Список целей получают с помощью метода GetStatGoals API версии 4 или Live 4. |
Да |
|
|
long |
Недельный бюджет в валюте рекламодателя, умноженный на 1 000 000. Минимальный недельный бюджет для каждой валюты должен быть не менее, чем значение параметра |
Нет |
|
|
CustomPeriodBudget |
Бюджет на период. Подробнее см. в справке Директа. При создании кампании нельзя указать одновременно с |
Нет |
|
|
BudgetTypeEnum |
Тип бюджета:
Если при редактировании кампании тип бюджета изменился, изначальный тип необходимо передать со значеним NULL. Например, если тип бюджета поменялся с недельного на периодный, поле WeeklySpendLimit должно быть передано со значением NULL. |
Нет |
|
Структура StrategyPayForConversionMultipleGoalsUpdate |
|||
|
|
long |
Недельный бюджет в валюте рекламодателя, умноженный на 1 000 000. Минимальный недельный бюджет для каждой валюты должен быть не менее, чем значение параметра |
Нет |
|
|
CustomPeriodBudget |
Бюджет на период. Подробнее см. в справке Директа. При создании кампании нельзя указать одновременно с |
Нет |
|
Структура StrategyAverageCpaPerCampaignUpdate |
|||
|
|
long |
Средняя цена достижения цели в валюте рекламодателя, умноженная на 1 000 000. Минимальное значение средней цены для каждой валюты представлено в справочнике валют. Справочник валют можно получить с помощью метода Dictionaries.get. |
Да |
|
|
long |
Идентификатор цели Яндекс Метрики. Подробнее о целях см. раздел Цели и конверсии помощи Метрики. Список целей получают с помощью метода GetStatGoals API версии 4 или Live 4. |
Да |
|
|
long |
Недельный бюджет в валюте рекламодателя, умноженный на 1 000 000. Минимальный недельный бюджет для каждой валюты представлен в справочнике валют. Справочник валют можно получить с помощью метода Dictionaries.get. |
Нет |
|
|
CustomPeriodBudget |
Бюджет на период. Подробнее см. в справке Директа. При создании кампании нельзя указать одновременно с |
Нет |
|
|
BudgetTypeEnum |
Тип бюджета:
Если при редактировании кампании тип бюджета изменился, изначальный тип необходимо передать со значеним NULL. Например, если тип бюджета поменялся с недельного на периодный, поле WeeklySpendLimit должно быть передано со значением NULL. |
Нет |
|
|
long |
Максимальная ставка в валюте рекламодателя, умноженная на 1 000 000. Минимальное и максимальное значение ставки для каждой валюты представлены в справочнике валют. Справочник валют можно получить с помощью метода Dictionaries.get. Примечание Указывать максимальную ставку не рекомендуется — это может снизить эффективность работы стратегии. |
Нет |
|
|
Минимальный бюджет. Подробнее в справке Директа. Если поле не задано, значение миниального бюджета не изменится. Чтобы установить значение по умолчанию, передайте Чтобы установить пользовательское значение минимального бюджета, задайте значение в параметре Если |
Нет |
|
|
Структура StrategyPayForConversionPerCampaignUpdate |
|||
|
|
long |
Цена достижения цели в валюте рекламодателя, умноженная на 1 000 000. Минимальное и максимальное значение цены для каждой валюты представлено в справочнике валют. Справочник валют можно получить с помощью метода Dictionaries.get. |
Да |
|
|
long |
Идентификатор цели Яндекс Метрики. Подробнее о целях см. раздел Цели и конверсии помощи Метрики. Список целей получают с помощью метода GetStatGoals API версии 4 или Live 4. |
Да |
|
|
long |
Недельный бюджет в валюте рекламодателя, умноженный на 1 000 000. Минимальный недельный бюджет для каждой валюты должен быть не менее, чем значение параметра |
Нет |
|
|
CustomPeriodBudget |
Бюджет на период. Подробнее см. в справке Директа. При создании кампании нельзя указать одновременно с |
Нет |
|
|
BudgetTypeEnum |
Тип бюджета:
Если при редактировании кампании тип бюджета изменился, изначальный тип необходимо передать со значеним NULL. Например, если тип бюджета поменялся с недельного на периодный, поле WeeklySpendLimit должно быть передано со значением NULL. |
Нет |
|
Структура StrategyPayForConversionPerFilterUpdate |
|||
|
|
long |
Цена достижения цели в валюте рекламодателя, умноженная на 1 000 000. Минимальное и максимальное значение цены для каждой валюты представлено в справочнике валют. Справочник валют можно получить с помощью метода Dictionaries.get. |
Да |
|
|
long |
Идентификатор цели Яндекс Метрики. Подробнее о целях см. раздел Цели и конверсии помощи Метрики. Список целей получают с помощью метода GetStatGoals API версии 4 или Live 4. |
Да |
|
|
long |
Недельный бюджет в валюте рекламодателя, умноженный на 1 000 000. Минимальный недельный бюджет для каждой валюты должен быть не менее, чем значение параметра |
Нет |
|
|
CustomPeriodBudget |
Бюджет на период. Подробнее см. в справке Директа. При создании кампании нельзя указать одновременно с |
Нет |
|
|
BudgetTypeEnum |
Тип бюджета:
Если при редактировании кампании тип бюджета изменился, изначальный тип необходимо передать со значеним NULL. Например, если тип бюджета поменялся с недельного на периодный, поле WeeklySpendLimit должно быть передано со значением NULL. |
Нет |
|
Структура StrategyAverageCpaPerFilterUpdate |
|||
|
|
long |
Средняя цена достижения цели по умолчанию на каждый фильтр в валюте рекламодателя, умноженная на 1 000 000. Минимальное значение средней цены для каждой валюты представлено в справочнике валют. Справочник валют можно получить с помощью метода Dictionaries.get. |
Да |
|
|
long |
Идентификатор цели Яндекс Метрики. Подробнее о целях см. раздел Цели и конверсии помощи Метрики. Список целей получают с помощью метода GetStatGoals API версии 4 или Live 4. |
Да |
|
|
long |
Недельный бюджет в валюте рекламодателя, умноженный на 1 000 000. Минимальный недельный бюджет для каждой валюты представлен в справочнике валют. Справочник валют можно получить с помощью метода Dictionaries.get. |
Нет |
|
|
CustomPeriodBudget |
Бюджет на период. Подробнее см. в справке Директа. При создании кампании нельзя указать одновременно с |
Нет |
|
|
BudgetTypeEnum |
Тип бюджета:
Если при редактировании кампании тип бюджета изменился, изначальный тип необходимо передать со значеним NULL. Например, если тип бюджета поменялся с недельного на периодный, поле WeeklySpendLimit должно быть передано со значением NULL. |
Нет |
|
|
long |
Максимальная ставка в валюте рекламодателя, умноженная на 1 000 000. Минимальное и максимальное значение ставки для каждой валюты представлены в справочнике валют. Справочник валют можно получить с помощью метода Dictionaries.get. Примечание Указывать максимальную ставку не рекомендуется — это может снизить эффективность работы стратегии. |
Нет |
|
|
Минимальный бюджет. Подробнее в справке Директа. Если поле не задано, значение миниального бюджета не изменится. Чтобы установить значение по умолчанию, передайте Чтобы установить пользовательское значение минимального бюджета, задайте значение в параметре Если |
Нет |
|
|
Структура StrategyAverageCpcPerCampaignUpdate |
|||
|
|
long |
Средняя цена клика в валюте рекламодателя, умноженная на 1 000 000. Минимальное значение средней цены для каждой валюты представлено в справочнике валют. Справочник валют можно получить с помощью метода Dictionaries.get. |
Да |
|
|
long |
Недельный бюджет в валюте рекламодателя, умноженный на 1 000 000. Минимальный недельный бюджет для каждой валюты представлен в справочнике валют. Справочник валют можно получить с помощью метода Dictionaries.get. |
Нет |
|
|
CustomPeriodBudget |
Бюджет на период. Подробнее см. в справке Директа. При создании кампании нельзя указать одновременно с |
Нет |
|
|
BudgetTypeEnum |
Тип бюджета:
Если при редактировании кампании тип бюджета изменился, изначальный тип необходимо передать со значеним NULL. Например, если тип бюджета поменялся с недельного на периодный, поле WeeklySpendLimit должно быть передано со значением NULL. |
Нет |
|
|
long |
Максимальная ставка в валюте рекламодателя, умноженная на 1 000 000. Минимальное и максимальное значение ставки для каждой валюты представлены в справочнике валют. Справочник валют можно получить с помощью метода Dictionaries.get. Примечание Указывать максимальную ставку не рекомендуется — это может снизить эффективность работы стратегии. |
Нет |
|
Структура StrategyAverageCpcPerFilterUpdate |
|||
|
|
long |
Да |
|
|
|
long |
Недельный бюджет в валюте рекламодателя, умноженный на 1 000 000. Минимальный недельный бюджет для каждой валюты представлен в справочнике валют. Справочник валют можно получить с помощью метода Dictionaries.get. |
Нет |
|
|
CustomPeriodBudget |
Бюджет на период. Подробнее см. в справке Директа. При создании кампании нельзя указать одновременно с |
Нет |
|
|
BudgetTypeEnum |
Тип бюджета:
Если при редактировании кампании тип бюджета изменился, изначальный тип необходимо передать со значеним NULL. Например, если тип бюджета поменялся с недельного на периодный, поле WeeklySpendLimit должно быть передано со значением NULL. |
Нет |
|
|
long |
Максимальная ставка в валюте рекламодателя, умноженная на 1 000 000. Минимальное и максимальное значение ставки для каждой валюты представлены в справочнике валют. Справочник валют можно получить с помощью метода Dictionaries.get. Примечание Указывать максимальную ставку не рекомендуется — это может снизить эффективность работы стратегии. |
Нет |
|
Структура StrategyPayForConversionCrrUpdate |
|||
|
|
int |
Средняя доля расходов. |
Да |
|
|
long |
Идентификатор цели Яндекс Метрики. Подробнее о целях см. раздел Цели и конверсии помощи Метрики. Список целей получают с помощью метода GetStatGoals API версии 4 или Live 4. |
Да |
|
|
long |
Недельный бюджет в валюте рекламодателя, умноженный на 1 000 000. Минимальный недельный бюджет для каждой валюты представлен в справочнике валют. Справочник валют можно получить с помощью метода Dictionaries.get. |
Нет |
|
|
CustomPeriodBudget |
Бюджет на период. Подробнее см. в справке Директа. При создании кампании нельзя указать одновременно с |
Нет |
|
|
BudgetTypeEnum |
Тип бюджета:
Если при редактировании кампании тип бюджета изменился, изначальный тип необходимо передать со значеним NULL. Например, если тип бюджета поменялся с недельного на периодный, поле WeeklySpendLimit должно быть передано со значением NULL. |
Нет |
|
Структура ExplorationBudget |
|||
|
|
long |
Значение минимального бюджета. Допустимое значение: от 0 до значения недельного бюджета (если он задан). |
Да, если в запросе есть структура |
|
|
YesNoEnum |
Признак пользовательского значения минимального бюджета. |
Да, если в запросе есть структура |
|
Структура CustomPeriodBudget |
|||
|
|
long |
Значение бюджета на период. |
Да |
|
|
string |
Начало бюджетного периода. |
Да |
|
|
string |
Окончание бюджетного периода. |
Да |
|
|
YesNoEnum |
Признак автопродления бюджета. |
Да |
Ответ
Структура ответа в формате JSON:
{
"result" : { /* required */
"UpdateResults" : [{
"Warnings" : [{
"Code" : (integer) /* required */,
"Message" : (string) /* required */,
"Details" : (string)
} ],
"Errors" : [{
"Code" : (integer) /* required */,
"Message" : (string) /* required */,
"Details" : (string)
} ],
"Id" : (long)
} ]
}
}
|
Параметр |
Тип |
Описание |
|
Структура result (для JSON) / UpdateResponse (для SOAP) |
||
|
|
array of ActionResult |
Результаты добавления пакетной стратегии. |
|
Структура ActionResult |
||
|
|
long |
Идентификатор созданной пакетной стратегии. Возвращается в случае отсутствия ошибок, см. раздел Операции над массивом объектов. |
|
|
array of ExceptionNotification |
Предупреждения, возникшие при выполнении операции. |
|
|
array of ExceptionNotification |
Ошибки, возникшие при выполнении операции. |