--- metadata: - name: generator content: Diplodoc Platform v5.52.0 alternate: - https://yandex.com/dev/direct/doc/en/strategies/update.md - https://yandex.com/dev/direct/doc/ru/strategies/update.md - href: ru/strategies/update.md type: text/markdown title: Markdown version - href: ../llms.txt type: text/markdown title: llms.txt sourcePath: ru/ref-v5/strategies/update.md --- > **Documentation Index:** Fetch the complete configuration index at https://yandex.com/dev/direct/doc/ru/llms.txt # update Обновляет пакетную стратегию. ## Запрос {#input} Структура запроса в формате JSON: ```javascript translate=no "params" : { /* required */ "Strategies" : [{ /* required */ "Id": (long), /* required */ "AttributionModel" : ( "FCCD" | "LC" | "LSCCD" | "AUTO" ), "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") }, "MaxProfit" : { "WeeklySpendLimit" : (long), "CustomPeriodBudget": { "SpendLimit": (long), "StartDate": (string), "EndDate": (string), "AutoContinue": ("YES" | "NO") }, "ExplorationBudget" : { "MinimumExplorationBudget" : (long) /* required */, "IsMinimumExplorationBudgetCustom" : ("YES") /* required */ } } }, "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 */, }, "ManualCpm" : { "WeeklySpendLimit" : (long) /* required */ }, "HighestPosition" : { "WeeklySpendLimit" : (long) } } ] } ``` #| || **Параметр** | **Тип** | **Описание** | **Обязательный** || || **Структура params (для JSON) / AddRequest (для SOAP)** || || Strategies | array of StrategiesUpdateItem | Пакетная стратегия | Да || || **Структура StrategiesUpdateItem** || || `Id` | long | Идентификатор пакетной стратегии. | Да || || `AttributionModel` | AttributionModelEnum | Модель атрибуции, используемая для оптимизации конверсий (см. раздел [Модели атрибуции](https://yandex.ru/support/direct/statistics/attribution-model.html)). {% note alert "Обновление моделей атрибуции в Директе и Яндекс Метрике" %} Активные кампании с устаревшими моделями LSC, FC, LYDC, LYDCCD автоматически перешли на ближайшую действующую кросс-девайс версию или автоматическую атрибуцию. Переобучения стратегий при переходе не происходит. Методы с устаревшими моделями будут конвертироваться в действующие (LSC в LSCCD, FC в FCCD, LYDC/LYDCCD в AUTO) и возвращать предупреждение о том, что используется другая модель. {% endnote %} Возможные значения: - FCCD — первый переход кросс-девайс. - LC — последний переход. - LSCCD — последний значимый переход кросс-девайс. - AUTO — автоматическая атрибуция. Значение по умолчанию — AUTO. | Нет || || `Name` | String | Название пакетной стратегии. | Да || || `CounterIds` | ArrayOfInteger | Идентификаторы счетчиков Яндекс Метрики, установленных на сайте рекламодателя (см. раздел [Яндекс Метрика: оценка эффективности рекламы](https://yandex.ru/support/direct/statistics/metrika.html) Справки Директа). | Нет || || `PriorityGoals` | PriorityGoalsArray | Ключевые цели, на достижение которых направлена автоматическая корректировка ставок. Если массив не задан, автоматическая корректировка направлена на получение максимального количества вовлеченных сессий, см. раздел [Показатели вовлеченных сессий](https://yandex.ru/support/direct/statistics/report-wizard-engagement-rating.html) Справки Директа. Ограничение — 30 ключевых целей. | При передаче параметров `AverageCpaMultipleGoals`, `PayForConversionMultipleGoals` или `MaxProfit`. || || `WbMaximumClicks` | StrategyMaximumClicksUpdate | Параметры стратегии [Оптимизация кликов](https://yandex.ru/support/direct/strategies/weekly-budget.html), ограничивать по недельному бюджету. | Нет || || `WbMaximumConversionRate` | StrategyMaximumConversionRateUpdate | Параметры стратегии [Оптимизация конверсий](https://yandex.ru/support/direct/strategies/average-cpa.html), без указания средней цены конверсии. | Нет || || `AverageCpc` | StrategyAverageCpcUpdate | Параметры стратегии [Оптимизация кликов](https://yandex.ru/support/direct/strategies/average-cpc.html), ограничивать по средней цене клика. | Нет || || `AverageCpa` | StrategyAverageCpaUpdate | Параметры стратегии [Оптимизация конверсий](https://yandex.ru/support/direct/strategies/average-cpa.html), удерживать среднюю цену конверсии. | Нет || || `AverageCpaMultipleGoals` | StrategyAverageCpaMultipleGoalsAdd | Параметры стратегии [Максимум конверсий](https://yandex.ru/support/direct/strategies/average-cpa.html) с оплатой за клики, удерживать среднюю цену конверсии по нескольким целям.Одновременно необходимо передать массив `PriorityGoals` с минимум двумя ключевыми целями, в качестве ценности `Value` указать для каждой цели целевую цену конверсии. | Нет || || `AverageCrr` | StrategyAverageCrrUpdate | Параметры стратегии [Оптимизация доли рекламных расходов](https://yandex.ru/support/direct/strategies/average-crr.html), удерживать среднюю долю расходов. | Нет || || `PayForConversionCrr` | StrategyPayForConversionCrrUpdate | Параметры стратегии [Оптимизация доли рекламных расходов](https://yandex.ru/support/direct/strategies/average-crr.html), оплата за конверсии. | Нет || || `PayForConversion` | StrategyPayForConversionUpdate | Параметры стратегии [Оптимизация конверсий](https://yandex.ru/support/direct/strategies/average-cpa.html), оплата за конверсии. | Нет || || `PayForConversionMultipleGoals` | StrategyPayForConversionMultipleGoalsAdd | Параметры стратегии [Максимум конверсий](https://yandex.ru/support/direct/strategies/average-cpa.html) с оплатой за конверсии по каждой из указанных целей. Одновременно необходимо передать массив `PriorityGoals` с минимум двумя ключевыми целями, в качестве ценности `Value` указать для каждой цели целевую цену конверсии. | Нет || || `MaxProfit` | StrategyMaxProfitAdd | Параметры стратегии Максимум прибыли, на основании данных о марже с конверсии подбирается оптимальная цена конверсии и постоянно актуализируется, что позволяет бизнесу получать максимальную итоговую прибыль. Одновременно необходимо передать массив `PriorityGoals`, в качестве `Value` указать маржу с конверсии. | При значении MAX_PROFIT в параметре `BiddingStrategyType` || || `HighestPosition` {#HighestPosition} | StrategyHighestPositionUpdate | Параметры стратегии [Максимум кликов с ручными ставками](https://yandex.ru/support/direct/ru/strategies/manual-strategy). | Нет || || `ManualCpm` {#ManualCpm} | StrategyManualCpmUpdate | Параметры стратегии [Ручное управление ставками](https://yandex.ru/support/direct/ru/strategies/manual-strategy-branding). | Да || || **Структура PriorityGoalsArray** || || `Items` | array of PriorityGoalsItem | Набор ключевых целей и ценностей конверсий по ним. | Да || || **Структура PriorityGoalsItem** || || `GoalId` | long | Идентификатор цели Яндекс Метрики, на достижение которой будет направлена автоматическая корректировка ставок. Подробнее о целях см. раздел [Цели и конверсии](https://yandex.ru/support/metrika/general/goals.xml) помощи Метрики. Список целей получают с помощью метода [GetStatGoals](https://yandex.ru/dev/direct/doc/dg-v4/live/GetStatGoals) API версии 4 или Live 4. Значение 12 соответствует цели «Вовлеченные сессии». | Да || || `Value` | long | В зависимости от стратегии, это может быть: * Для `MaxProfit` — маржа с конверсии. Средний доход с одной целевой конверсии за вычетом переменных затрат (например, себестоимости товара, оплаты исполнителю, комиссий платежных систем и т. д.), но без учета расходов на продвижение. В валюте рекламодателя, умноженная на 1 000 000. * Для остальных стратегий — ценность конверсии. Денежная оценка выгоды, получаемой рекламодателем при достижении указанной цели, в валюте рекламодателя, умноженная на 1 000 000. Чем больше ценность конверсии, тем выше приоритет достижения указанной цели. | Да || || `IsMetrikaSourceOfValue` | YesNoEnum | Источник ценности ключевой цели — цель Метрики. Значение `YES` используется только для стратегий с долей рекламных расходов. | При значении AVERAGE_CRR или PAY_FOR_CONVERSION_CRR в параметре BiddingStrategyType || || **Структура StrategyMaximumClicksUpdate** || || `WeeklySpendLimit` | long | Недельный бюджет в валюте пользователя, умноженный на 1 000 000. Минимальный недельный бюджет для каждой валюты представлен в справочнике валют. Справочник валют можно получить с помощью метода [Dictionaries](https://yandex.com/dev/direct/doc/ru/dictionaries/dictionaries.md).[get](https://yandex.com/dev/direct/doc/ru/dictionaries/get.md). | Да || || `CustomPeriodBudget` | CustomPeriodBudget | Бюджет на период. Подробнее см. в [Справке Директа](https://yandex.ru/support/direct/strategies/budgets-in-strategies.html). При создании кампании нельзя указать одновременно с `WeeklySpendLimit`. | Нет || || `BudgetType` | BudgetTypeEnum | Тип бюджета: - WEEKLY_BUDGET – недельный бюджет. - CUSTOM_PERIOD_BUDGET – бюджет на период. Если при редактировании кампании тип бюджета изменился, изначальный тип необходимо передать со значением NULL. Например, если тип бюджета поменялся с недельного на периодный, поле WeeklySpendLimit должно быть передано со значением NULL. | Нет || || `BidCeiling` | long | Максимальная ставка в валюте пользователя, умноженная на 1 000 000. Минимальное и максимальное значение ставки для каждой валюты представлены в справочнике валют. Справочник валют можно получить с помощью метода [Dictionaries](https://yandex.com/dev/direct/doc/ru/dictionaries/dictionaries.md).[get](https://yandex.com/dev/direct/doc/ru/dictionaries/get.md). {% note info %} Указывать максимальную ставку не рекомендуется — это может снизить эффективность работы стратегии. {% endnote %} | Нет || || **Структура StrategyMaximumConversionRateUpdate** || || `WeeklySpendLimit` | long | Недельный бюджет в валюте пользователя, умноженный на 1 000 000. Минимальный недельный бюджет для каждой валюты представлен в справочнике валют. Справочник валют можно получить с помощью метода [Dictionaries](https://yandex.com/dev/direct/doc/ru/dictionaries/dictionaries.md).[get](https://yandex.com/dev/direct/doc/ru/dictionaries/get.md). | Да || || `CustomPeriodBudget` | CustomPeriodBudget | Бюджет на период. Подробнее см. в [Справке Директа](https://yandex.ru/support/direct/strategies/budgets-in-strategies.html). При создании кампании нельзя указать одновременно с `WeeklySpendLimit`. | Нет || || `BudgetType` | BudgetTypeEnum | Тип бюджета: - WEEKLY_BUDGET – недельный бюджет. - CUSTOM_PERIOD_BUDGET – бюджет на период. Если при редактировании кампании тип бюджета изменился, изначальный тип необходимо передать со значением NULL. Например, если тип бюджета поменялся с недельного на периодный, поле WeeklySpendLimit должно быть передано со значением NULL. | Нет || || `BidCeiling` | long | Максимальная ставка в валюте пользователя, умноженная на 1 000 000. Минимальное и максимальное значение ставки для каждой валюты представлены в справочнике валют. Справочник валют можно получить с помощью метода [Dictionaries](https://yandex.com/dev/direct/doc/ru/dictionaries/dictionaries.md).[get](https://yandex.com/dev/direct/doc/ru/dictionaries/get.md). {% note info %} Указывать максимальную ставку не рекомендуется — это может снизить эффективность работы стратегии. {% endnote %} | Нет || || `GoalId` | long | Идентификатор цели Яндекс Метрики. Подробнее о целях см. раздел [Цели и конверсии](https://yandex.ru/support/metrika/general/goals.xml) помощи Метрики. Значение 13 — ключевые цели. Допускается, если в массиве PriorityGoals указана хотя бы одна цель, отличная от вовлеченных сессий. Список целей получают с помощью метода [GetStatGoals](https://yandex.ru/dev/direct/doc/dg-v4/live/GetStatGoals) API версии 4 или Live 4. | Да || || **Структура StrategyAverageCpcUpdate** || || `AverageCpc` | long | Средняя цена клика в валюте пользователя, умноженная на 1 000 000. Минимальное значение средней цены для каждой валюты представлено в справочнике валют. Справочник валют можно получить с помощью метода [Dictionaries](https://yandex.com/dev/direct/doc/ru/dictionaries/dictionaries.md).[get](https://yandex.com/dev/direct/doc/ru/dictionaries/get.md). | Да || || `WeeklySpendLimit` | long | Недельный бюджет в валюте пользователя, умноженный на 1 000 000. Минимальный недельный бюджет для каждой валюты представлен в справочнике валют. Справочник валют можно получить с помощью метода [Dictionaries](https://yandex.com/dev/direct/doc/ru/dictionaries/dictionaries.md).[get](https://yandex.com/dev/direct/doc/ru/dictionaries/get.md). | Нет || || `CustomPeriodBudget` | CustomPeriodBudget | Бюджет на период. Подробнее см. в [Справке Директа](https://yandex.ru/support/direct/strategies/budgets-in-strategies.html). При создании кампании нельзя указать одновременно с `WeeklySpendLimit`. | Нет || || `BudgetType` | BudgetTypeEnum | Тип бюджета: - WEEKLY_BUDGET – недельный бюджет. - CUSTOM_PERIOD_BUDGET – бюджет на период. Если при редактировании кампании тип бюджета изменился, изначальный тип необходимо передать со значением NULL. Например, если тип бюджета поменялся с недельного на периодный, поле WeeklySpendLimit должно быть передано со значением NULL. | Нет || || **Структура StrategyAverageCpaUpdate** || || `AverageCpa` | long | Средняя цена достижения цели в валюте пользователя, умноженная на 1 000 000. Минимальное значение средней цены для каждой валюты представлено в справочнике валют. Справочник валют можно получить с помощью метода [Dictionaries](https://yandex.com/dev/direct/doc/ru/dictionaries/dictionaries.md).[get](https://yandex.com/dev/direct/doc/ru/dictionaries/get.md). | Да || || `WeeklySpendLimit` | long | Недельный бюджет в валюте пользователя, умноженный на 1 000 000. Минимальный недельный бюджет для каждой валюты представлен в справочнике валют. Справочник валют можно получить с помощью метода [Dictionaries](https://yandex.com/dev/direct/doc/ru/dictionaries/dictionaries.md).[get](https://yandex.com/dev/direct/doc/ru/dictionaries/get.md). | Нет || || `CustomPeriodBudget` | CustomPeriodBudget | Бюджет на период. Подробнее см. в [Справке Директа](https://yandex.ru/support/direct/strategies/budgets-in-strategies.html). При создании кампании нельзя указать одновременно с `WeeklySpendLimit`. | Нет || || `BudgetType` | BudgetTypeEnum | Тип бюджета: - WEEKLY_BUDGET – недельный бюджет. - CUSTOM_PERIOD_BUDGET – бюджет на период. Если при редактировании кампании тип бюджета изменился, изначальный тип необходимо передать со значением NULL. Например, если тип бюджета поменялся с недельного на периодный, поле WeeklySpendLimit должно быть передано со значением NULL. | Нет || || `CustomPeriodBudget` | CustomPeriodBudget | Бюджет на период. Подробнее см. в [Справке Директа](https://yandex.ru/support/direct/strategies/budgets-in-strategies.html). При создании кампании нельзя указать одновременно с `WeeklySpendLimit`. | Нет || || `BudgetType` | BudgetTypeEnum | Тип бюджета: - WEEKLY_BUDGET – недельный бюджет. - CUSTOM_PERIOD_BUDGET – бюджет на период. Если при редактировании кампании тип бюджета изменился, изначальный тип необходимо передать со значением NULL. Например, если тип бюджета поменялся с недельного на периодный, поле WeeklySpendLimit должно быть передано со значением NULL. | Нет || || `GoalId` | long | Идентификатор цели Яндекс Метрики. Подробнее о целях см. раздел [Цели и конверсии](https://yandex.ru/support/metrika/general/goals.xml) помощи Метрики. Список целей получают с помощью метода [GetStatGoals](https://yandex.ru/dev/direct/doc/dg-v4/live/GetStatGoals) API версии 4 или Live 4. | Да || || `BidCeiling` | long | Максимальная ставка в валюте пользователя, умноженная на 1 000 000. Минимальное и максимальное значение ставки для каждой валюты представлены в справочнике валют. Справочник валют можно получить с помощью метода [Dictionaries](https://yandex.com/dev/direct/doc/ru/dictionaries/dictionaries.md).[get](https://yandex.com/dev/direct/doc/ru/dictionaries/get.md). {% note info %} Указывать максимальную ставку не рекомендуется — это может снизить эффективность работы стратегии. {% endnote %} | Нет || || `ExplorationBudget` | [ExplorationBudget](https://yandex.com/dev/direct/doc/ru/strategies/update.md#ExplorationBudget) | Минимальный бюджет. Подробнее в [Справке Директа](https://yandex.ru/support/direct/strategies/minimal-budget.html). Если поле не задано, значение минимального бюджета не изменится. Чтобы установить значение по умолчанию, передайте `ExplorationBudget=NULL`. Чтобы установить пользовательское значение минимального бюджета, задайте значение в параметре `MinimumExplorationBudget` и укажите `IsMinimumExplorationBudgetCustom="YES"`. Если `IsMinimumExplorationBudgetCustom` установлен в `NO`, операция завершится с ошибкой. | Нет || || **Структура StrategyAverageCpaMultipleGoalsUpdate** || || `WeeklySpendLimit` | long | Недельный бюджет в валюте пользователя, умноженный на 1 000 000. Минимальный недельный бюджет для каждой валюты представлен в справочнике валют. Справочник валют можно получить с помощью метода [Dictionaries](https://yandex.com/dev/direct/doc/ru/dictionaries/dictionaries.md).[get](https://yandex.com/dev/direct/doc/ru/dictionaries/get.md). | Нет || || `CustomPeriodBudget` | CustomPeriodBudget | Бюджет на период. Подробнее см. в [Справке Директа](https://yandex.ru/support/direct/strategies/budgets-in-strategies.html). При создании кампании нельзя указать одновременно с `WeeklySpendLimit`. | Нет || || `BudgetType` | BudgetTypeEnum | Тип бюджета: - WEEKLY_BUDGET – недельный бюджет. - CUSTOM_PERIOD_BUDGET – бюджет на период. Если при редактировании кампании тип бюджета изменился, изначальный тип необходимо передать со значением NULL. Например, если тип бюджета поменялся с недельного на периодный, поле WeeklySpendLimit должно быть передано со значением NULL. | Нет || || `CustomPeriodBudget` | CustomPeriodBudget | Бюджет на период. Подробнее см. в [Справке Директа](https://yandex.ru/support/direct/strategies/budgets-in-strategies.html). При создании кампании нельзя указать одновременно с `WeeklySpendLimit`. | Нет || || `BudgetType` | BudgetTypeEnum | Тип бюджета: - WEEKLY_BUDGET – недельный бюджет. - CUSTOM_PERIOD_BUDGET – бюджет на период. Если при редактировании кампании тип бюджета изменился, изначальный тип необходимо передать со значением NULL. Например, если тип бюджета поменялся с недельного на периодный, поле WeeklySpendLimit должно быть передано со значением NULL. | Нет || || `BidCeiling` | long | Максимальная ставка в валюте пользователя, умноженная на 1 000 000. Минимальное и максимальное значение ставки для каждой валюты представлены в справочнике валют. Справочник валют можно получить с помощью метода [Dictionaries](https://yandex.com/dev/direct/doc/ru/dictionaries/dictionaries.md).[get](https://yandex.com/dev/direct/doc/ru/dictionaries/get.md). {% note info %} Указывать максимальную ставку не рекомендуется — это может снизить эффективность работы стратегии. {% endnote %} | Нет || || `ExplorationBudget` | [ExplorationBudget](https://yandex.com/dev/direct/doc/ru/strategies/update.md#ExplorationBudget) | Минимальный бюджет. Подробнее в [Справке Директа](https://yandex.ru/support/direct/strategies/minimal-budget.html). Если поле не задано, значение минимального бюджета не изменится. Чтобы установить значение по умолчанию, передайте `ExplorationBudget=NULL`. Чтобы установить пользовательское значение минимального бюджета, задайте значение в параметре `MinimumExplorationBudget` и укажите `IsMinimumExplorationBudgetCustom="YES"`. Если `IsMinimumExplorationBudgetCustom` установлен в `NO`, операция завершится с ошибкой. | Нет || || **Структура StrategyAverageCrrUpdate** || || `Crr` | int | Средняя доля расходов. | Да || || `GoalId` | long | Идентификатор цели Яндекс Метрики. Подробнее о целях см. раздел [Цели и конверсии](https://yandex.ru/support/metrika/general/goals.xml) помощи Метрики. Список целей получают с помощью метода [GetStatGoals](https://yandex.ru/dev/direct/doc/dg-v4/live/GetStatGoals) API версии 4 или Live 4. | Да || || `WeeklySpendLimit` | long | Недельный бюджет в валюте пользователя, умноженный на 1 000 000. Минимальный недельный бюджет для каждой валюты представлен в справочнике валют. Справочник валют можно получить с помощью метода [Dictionaries](https://yandex.com/dev/direct/doc/ru/dictionaries/dictionaries.md).[get](https://yandex.com/dev/direct/doc/ru/dictionaries/get.md). | Нет || || `CustomPeriodBudget` | CustomPeriodBudget | Бюджет на период. Подробнее см. в [Справке Директа](https://yandex.ru/support/direct/strategies/budgets-in-strategies.html). При создании кампании нельзя указать одновременно с `WeeklySpendLimit`. | Нет || || `BudgetType` | BudgetTypeEnum | Тип бюджета: - WEEKLY_BUDGET – недельный бюджет. - CUSTOM_PERIOD_BUDGET – бюджет на период. Если при редактировании кампании тип бюджета изменился, изначальный тип необходимо передать со значением NULL. Например, если тип бюджета поменялся с недельного на периодный, поле WeeklySpendLimit должно быть передано со значением NULL. | Нет || || `ExplorationBudget` | [ExplorationBudget](https://yandex.com/dev/direct/doc/ru/strategies/update.md#ExplorationBudget) | Минимальный бюджет. Подробнее в [Справке Директа](https://yandex.ru/support/direct/strategies/minimal-budget.html). Если поле не задано, значение минимального бюджета не изменится. Чтобы установить значение по умолчанию, передайте `ExplorationBudget=NULL`. Чтобы установить пользовательское значение минимального бюджета, задайте значение в параметре `MinimumExplorationBudget` и укажите `IsMinimumExplorationBudgetCustom="YES"`. Если `IsMinimumExplorationBudgetCustom` установлен в `NO`, операция завершится с ошибкой. | Нет || || **Структура StrategyPayForConversionUpdate** || || `Cpa` | long | Цена достижения цели в валюте пользователя, умноженная на 1 000 000. Минимальное и максимальное значение цены для каждой валюты представлено в справочнике валют. Справочник валют можно получить с помощью метода [Dictionaries](https://yandex.com/dev/direct/doc/ru/dictionaries/dictionaries.md).[get](https://yandex.com/dev/direct/doc/ru/dictionaries/get.md). | Да || || `GoalId` | long | Идентификатор цели Яндекс Метрики. Подробнее о целях см. раздел [Цели и конверсии](https://yandex.ru/support/metrika/general/goals.xml) помощи Метрики. Список целей получают с помощью метода [GetStatGoals](https://yandex.ru/dev/direct/doc/dg-v4/live/GetStatGoals) API версии 4 или Live 4. | Да || || `WeeklySpendLimit` | long | Недельный бюджет в валюте пользователя, умноженный на 1 000 000. Минимальный недельный бюджет для каждой валюты должен быть не менее, чем значение параметра `Cpa`, умноженное на 20. Справочник валют можно получить с помощью метода [Dictionaries](https://yandex.com/dev/direct/doc/ru/dictionaries/dictionaries.md).[get](https://yandex.com/dev/direct/doc/ru/dictionaries/get.md). | Нет || || `CustomPeriodBudget` | CustomPeriodBudget | Бюджет на период. Подробнее см. в [Справке Директа](https://yandex.ru/support/direct/strategies/budgets-in-strategies.html). При создании кампании нельзя указать одновременно с `WeeklySpendLimit`. | Нет || || `BudgetType` | BudgetTypeEnum | Тип бюджета: - WEEKLY_BUDGET – недельный бюджет. - CUSTOM_PERIOD_BUDGET – бюджет на период. Если при редактировании кампании тип бюджета изменился, изначальный тип необходимо передать со значением NULL. Например, если тип бюджета поменялся с недельного на периодный, поле WeeklySpendLimit должно быть передано со значением NULL. | Нет || || **Структура StrategyPayForConversionMultipleGoalsUpdate** || || `WeeklySpendLimit` | long | Недельный бюджет в валюте пользователя, умноженный на 1 000 000. Минимальный недельный бюджет для каждой валюты должен быть не менее, чем значение параметра `Cpa`, умноженное на 20. Справочник валют можно получить с помощью метода [Dictionaries](https://yandex.com/dev/direct/doc/ru/dictionaries/dictionaries.md).[get](https://yandex.com/dev/direct/doc/ru/dictionaries/get.md). | Нет || || `CustomPeriodBudget` | CustomPeriodBudget | Бюджет на период. Подробнее см. в [Справке Директа](https://yandex.ru/support/direct/strategies/budgets-in-strategies.html). При создании кампании нельзя указать одновременно с `WeeklySpendLimit`. | Нет || || **Структура StrategyMaxProfitUpdate** || || `WeeklySpendLimit` | long | Недельный бюджет в валюте рекламодателя, умноженный на 1 000 000. Минимальный недельный бюджет для каждой валюты должен быть не менее, чем значение параметра `Cpa`, умноженное на 20. Справочник валют можно получить с помощью метода [Dictionaries](https://yandex.com/dev/direct/doc/ru/dictionaries/dictionaries.md).[get](https://yandex.com/dev/direct/doc/ru/dictionaries/get.md). | Нет || || `CustomPeriodBudget` | CustomPeriodBudget | Бюджет на период. Подробнее см. в [Справке Директа](https://yandex.ru/support/direct/strategies/budgets-in-strategies.html). При создании кампании нельзя указать одновременно с `WeeklySpendLimit`. | Нет || || `ExplorationBudget` | ExplorationBudget | Минимальный бюджет. Подробнее в [Справке Директа](https://yandex.ru/support/direct/strategies/minimal-budget.html). Если поле не задано, для стратегии устанавливается значение по умолчанию (рассчитывается на основе настроек стратегии). Чтобы установить пользовательское значение минимального бюджета, задайте значение в параметре `MinimumExplorationBudget` и укажите `IsMinimumExplorationBudgetCustom="YES"`. Если `IsMinimumExplorationBudgetCustom` установлен в `NO`, операция завершится с ошибкой. | Нет || || `BudgetType` | BudgetTypeEnum | Тип бюджета: - WEEKLY_BUDGET – недельный бюджет. - CUSTOM_PERIOD_BUDGET – бюджет на период. || || **Структура StrategyPayForConversionCrrUpdate** || || `Crr` | int | Средняя доля расходов. | Да || || `GoalId` | long | Идентификатор цели Яндекс Метрики. Подробнее о целях см. раздел [Цели и конверсии](https://yandex.ru/support/metrika/general/goals.xml) помощи Метрики. Список целей получают с помощью метода [GetStatGoals](https://yandex.ru/dev/direct/doc/dg-v4/live/GetStatGoals) API версии 4 или Live 4. | Да || || `WeeklySpendLimit` | long | Недельный бюджет в валюте пользователя, умноженный на 1 000 000. Минимальный недельный бюджет для каждой валюты представлен в справочнике валют. Справочник валют можно получить с помощью метода [Dictionaries](https://yandex.com/dev/direct/doc/ru/dictionaries/dictionaries.md).[get](https://yandex.com/dev/direct/doc/ru/dictionaries/get.md). | Нет || || `CustomPeriodBudget` | CustomPeriodBudget | Бюджет на период. Подробнее см. в [Справке Директа](https://yandex.ru/support/direct/strategies/budgets-in-strategies.html). При создании кампании нельзя указать одновременно с `WeeklySpendLimit`. | Нет || || `BudgetType` | BudgetTypeEnum | Тип бюджета: - WEEKLY_BUDGET – недельный бюджет. - CUSTOM_PERIOD_BUDGET – бюджет на период. Если при редактировании кампании тип бюджета изменился, изначальный тип необходимо передать со значением NULL. Например, если тип бюджета поменялся с недельного на периодный, поле WeeklySpendLimit должно быть передано со значением NULL. | Нет || || **Структура StrategyHighestPositionUpdate** || || `WeeklySpendLimit` | long | Недельный бюджет в валюте пользователя, умноженный на 1 000 000. Минимальный недельный бюджет для каждой валюты представлен в справочнике валют. Справочник валют можно получить с помощью метода [Dictionaries](https://yandex.com/dev/direct/doc/ru/dictionaries/dictionaries.md).[get](https://yandex.com/dev/direct/doc/ru/dictionaries/get.md). | Нет || || **Структура StrategyManualCpmUpdate** || || `WeeklySpendLimit` | long | Недельный бюджет в валюте пользователя, умноженный на 1 000 000. Минимальный недельный бюджет для каждой валюты представлен в справочнике валют. Справочник валют можно получить с помощью метода [Dictionaries](https://yandex.com/dev/direct/doc/ru/dictionaries/dictionaries.md).[get](https://yandex.com/dev/direct/doc/ru/dictionaries/get.md). | Да || || **Структура ExplorationBudget** || || `MinimumExplorationBudget` | long | Значение минимального бюджета. Допустимое значение: от 0 до значения недельного бюджета (если он задан). | Да, если в запросе есть структура `ExplorationBudget`. || || `IsMinimumExplorationBudgetCustom` | YesNoEnum | Признак пользовательского значения минимального бюджета. | Да, если в запросе есть структура `ExplorationBudget`. || || **Структура CustomPeriodBudget** || || `SpendLimit` | long | Значение бюджета на период. | Да || || `StartDate` | string | Начало бюджетного периода. | Да || || `EndDate` | string | Окончание бюджетного периода. | Да || || `AutoContinue` | YesNoEnum | Признак автопродления бюджета. | Да || |# ## Ответ {#output} Структура ответа в формате JSON: ```javascript translate=no { "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)** || || `UpdateResults` | array of ActionResult | Результаты добавления пакетной стратегии. || || **Структура ActionResult** || || `Id` | long | Идентификатор созданной пакетной стратегии. Возвращается в случае отсутствия ошибок, см. раздел [Операции над массивом объектов](https://yandex.ru/dev/direct/doc/dg/best-practice/modify.html). || || `Warnings` | array of [ExceptionNotification](https://yandex.ru/dev/direct/doc/dg/best-practice/modify.html) | Предупреждения, возникшие при выполнении операции. || || `Errors` | array of [ExceptionNotification](https://yandex.ru/dev/direct/doc/dg/best-practice/modify.html) | Ошибки, возникшие при выполнении операции. || |#