--- metadata: - name: generator content: Diplodoc Platform v5.52.0 alternate: - https://yandex.com/dev/direct/doc/en/campaigns/get-text-campaign.md - https://yandex.com/dev/direct/doc/ru/campaigns/get-text-campaign.md - href: ru/campaigns/get-text-campaign.md type: text/markdown title: Markdown version - href: ../llms.txt type: text/markdown title: llms.txt sourcePath: ru/ref-v5/campaigns/get-text-campaign.md --- > **Documentation Index:** Fetch the complete configuration index at https://yandex.com/dev/direct/doc/ru/llms.txt # get: параметры TextCampaign Структура ответа в формате JSON: ```javascript translate=no { "result": { "Campaigns": [{ /* CampaignGetItem */ ... "TextCampaign": { /* TextCampaignGetItem */ "BiddingStrategy": { /* TextCampaignStrategy */ "Search": { /* TextCampaignSearchStrategy */ "BiddingStrategyType": ( "AVERAGE_CPA" | ... | "WEEKLY_CLICK_PACKAGE" ), /* required */ "PlacementTypes" : { "SearchResults" : ( "YES" | "NO" ), "ProductGallery" : ( "YES" | "NO" ), "DynamicPlaces" : ( "YES" | "NO" ) }, "WbMaximumClicks": { /* StrategyMaximumClicks */ "WeeklySpendLimit": (long), "BidCeiling": (long), /* nillable */ "CustomPeriodBudget": { /* nillable */ "SpendLimit": (long), "StartDate": (string), "EndDate": (string), "AutoContinue": ("YES" | "NO") } }, "WbMaximumConversionRate": { /* StrategyMaximumConversionRate */ "WeeklySpendLimit": (long), "BidCeiling": (long), /* nillable */ "GoalId": (long), "CustomPeriodBudget": { /* nillable */ "SpendLimit": (long), "StartDate": (string), "EndDate": (string), "AutoContinue": ("YES" | "NO") } }, "AverageCpc": { /* StrategyAverageCpc */ "AverageCpc": (long), "WeeklySpendLimit": (long), /* nillable */ "CustomPeriodBudget": { /* nillable */ "SpendLimit": (long), "StartDate": (string), "EndDate": (string), "AutoContinue": ("YES" | "NO") }, "BudgetType": ("WEEKLY_BUDGET" | "CUSTOM_PERIOD_BUDGET") /* nillable */ }, "AverageCpa": { /* StrategyAverageCpa */ "AverageCpa": (long), "GoalId": (long), "WeeklySpendLimit": (long), /* nillable */ "BidCeiling": (long), /* nillable */ "CustomPeriodBudget": { /* nillable */ "SpendLimit": (long), "StartDate": (string), "EndDate": (string), "AutoContinue": ("YES" | "NO") }, "BudgetType": ("WEEKLY_BUDGET" | "CUSTOM_PERIOD_BUDGET") /* nillable */, "ExplorationBudget" : { "MinimumExplorationBudget" : (long) /* required */, "IsMinimumExplorationBudgetCustom" : ("YES"| "NO") /* required */ } }, "AverageCpaMultipleGoals": { /* StrategyAverageCpaMultipleGoals */ "WeeklySpendLimit": (long), /* nillable */ "BidCeiling": (long), /* nillable */ "CustomPeriodBudget": { /* nillable */ "SpendLimit": (long), "StartDate": (string), "EndDate": (string), "AutoContinue": ("YES" | "NO") }, "ExplorationBudget" : { "MinimumExplorationBudget" : (long) /* required */, "IsMinimumExplorationBudgetCustom" : ("YES"| "NO") /* required */ } }, "WeeklyClickPackage": { /* StrategyWeeklyClickPackage */ "ClicksPerWeek": (long), "AverageCpc": (long), /* nillable */ "BidCeiling": (long) /* nillable */ }, "AverageCrr": { /* StrategyAverageCrr */ "Crr": (int), "GoalId": (long), "WeeklySpendLimit": (long), /* nillable */ "CustomPeriodBudget": { /* nillable */ "SpendLimit": (long), "StartDate": (string), "EndDate": (string), "AutoContinue": ("YES" | "NO") }, "BudgetType": ("WEEKLY_BUDGET" | "CUSTOM_PERIOD_BUDGET") /* nillable */ "ExplorationBudget" : { "MinimumExplorationBudget" : (long) /* required */, "IsMinimumExplorationBudgetCustom" : ("YES"| "NO") /* required */ } }, "PayForConversionCrr": { /* StrategyPayForConversionCrr */ "Crr": (int), "GoalId": (long), "WeeklySpendLimit": (long), /* nillable */ "CustomPeriodBudget": { /* nillable */ "SpendLimit": (long), "StartDate": (string), "EndDate": (string), "AutoContinue": ("YES" | "NO") }, "BudgetType": ("WEEKLY_BUDGET" | "CUSTOM_PERIOD_BUDGET") /* nillable */ }, "PayForConversion" : { /* StrategyPayForConversion */ "Cpa" : (long), "GoalId" : (long), "WeeklySpendLimit" : (long) /* nillable */ "CustomPeriodBudget": { /* nillable */ "SpendLimit": (long), "StartDate": (string), "EndDate": (string), "AutoContinue": ("YES" | "NO") }, "BudgetType": ("WEEKLY_BUDGET" | "CUSTOM_PERIOD_BUDGET") /* nillable */ }, "PayForConversionMultipleGoals" : { /* StrategyPayForConversionMultipleGoals */ "WeeklySpendLimit" : (long) /* nillable */ "CustomPeriodBudget": { /* nillable */ "SpendLimit": (long), "StartDate": (string), "EndDate": (string), "AutoContinue": ("YES" | "NO") }, "BudgetType": ("WEEKLY_BUDGET" | "CUSTOM_PERIOD_BUDGET") /* nillable */ }, "MaxProfit" : { /* StrategyMaxProfit */ "WeeklySpendLimit" : (long), "CustomPeriodBudget": { "SpendLimit": (long), "StartDate": (string), "EndDate": (string), "AutoContinue": ("YES" | "NO") }, "ExplorationBudget" : { "MinimumExplorationBudget" : (long) /* required */, "IsMinimumExplorationBudgetCustom" : ("YES") /* required */ }, "BudgetType": ("WEEKLY_BUDGET" | "CUSTOM_PERIOD_BUDGET") /* nillable */ } }, "Network": { /* TextCampaignNetworkStrategy */ "BiddingStrategyType": ( "AVERAGE_CPA" | ... | "WEEKLY_CLICK_PACKAGE" ), /* required */ "NetworkDefault": { /* StrategyNetworkDefault */ "LimitPercent": (int) }, "WbMaximumClicks": { /* StrategyMaximumClicks */ "WeeklySpendLimit": (long), "BidCeiling": (long), /* nillable */ "CustomPeriodBudget": { /* nillable */ "SpendLimit": (long), "StartDate": (string), "EndDate": (string), "AutoContinue": ("YES" | "NO") }, }, "WbMaximumConversionRate": { /* StrategyMaximumConversionRate */ "WeeklySpendLimit": (long), "BidCeiling": (long), /* nillable */ "GoalId": (long), "CustomPeriodBudget": { /* nillable */ "SpendLimit": (long), "StartDate": (string), "EndDate": (string), "AutoContinue": ("YES" | "NO") }, }, "AverageCpc": { /* StrategyAverageCpc */ "AverageCpc": (long), "WeeklySpendLimit": (long) /* nillable */ "CustomPeriodBudget": { /* nillable */ "SpendLimit": (long), "StartDate": (string), "EndDate": (string), "AutoContinue": ("YES" | "NO") }, "BudgetType": ("WEEKLY_BUDGET" | "CUSTOM_PERIOD_BUDGET") /* nillable */ }, "AverageCpa": { /* StrategyAverageCpa */ "AverageCpa": (long), "GoalId": (long), "WeeklySpendLimit": (long), /* nillable */ "CustomPeriodBudget": { /* nillable */ "SpendLimit": (long), "StartDate": (string), "EndDate": (string), "AutoContinue": ("YES" | "NO") }, "BudgetType": ("WEEKLY_BUDGET" | "CUSTOM_PERIOD_BUDGET") /* nillable */, "BidCeiling": (long), /* nillable */ "ExplorationBudget" : { "MinimumExplorationBudget" : (long) /* required */, "IsMinimumExplorationBudgetCustom" : ("YES"| "NO") /* required */ } }, "AverageCpaMultipleGoals": { /* StrategyAverageCpaMultipleGoals */ "WeeklySpendLimit": (long), /* nillable */ "BidCeiling": (long), /* nillable */ "CustomPeriodBudget": { /* nillable */ "SpendLimit": (long), "StartDate": (string), "EndDate": (string), "AutoContinue": ("YES" | "NO") }, "ExplorationBudget" : { "MinimumExplorationBudget" : (long) /* required */, "IsMinimumExplorationBudgetCustom" : ("YES"| "NO") /* required */ } } "WeeklyClickPackage": { /* StrategyWeeklyClickPackage */ "ClicksPerWeek": (long), "AverageCpc": (long), /* nillable */ "BidCeiling": (long) /* nillable */ }, "BudgetType": ("WEEKLY_BUDGET" | "CUSTOM_PERIOD_BUDGET") /* nillable */, "BidCeiling": (long), /* nillable */ "Profitability": (long), /* nillable */ "ExplorationBudget" : { "MinimumExplorationBudget" : (long) /* required */, "IsMinimumExplorationBudgetCustom" : ("YES"| "NO") /* required */ } }, "AverageCrr": { /* StrategyAverageCrr */ "Crr": (int), "GoalId": (long), "WeeklySpendLimit": (long), /* nillable */ "CustomPeriodBudget": { /* nillable */ "SpendLimit": (long), "StartDate": (string), "EndDate": (string), "AutoContinue": ("YES" | "NO") }, "BudgetType": ("WEEKLY_BUDGET" | "CUSTOM_PERIOD_BUDGET") /* nillable */, "ExplorationBudget" : { "MinimumExplorationBudget" : (long) /* required */, "IsMinimumExplorationBudgetCustom" : ("YES"| "NO") /* required */ } }, "PayForConversionCrr": { /* StrategyPayForConversionCrr */ "Crr": (int), "GoalId": (long), "WeeklySpendLimit": (long), /* nillable */ "CustomPeriodBudget": { /* nillable */ "SpendLimit": (long), "StartDate": (string), "EndDate": (string), "AutoContinue": ("YES" | "NO") }, "BudgetType": ("WEEKLY_BUDGET" | "CUSTOM_PERIOD_BUDGET") /* nillable */ }, "PayForConversion" : { /* StrategyPayForConversion */ "Cpa" : (long), "GoalId" : (long), "WeeklySpendLimit" : (long) /* nillable */ "CustomPeriodBudget": { /* nillable */ "SpendLimit": (long), "StartDate": (string), "EndDate": (string), "AutoContinue": ("YES" | "NO") }, "BudgetType": ("WEEKLY_BUDGET" | "CUSTOM_PERIOD_BUDGET") /* nillable */ }, "PayForConversionMultipleGoals" : { /* StrategyPayForConversionMultipleGoals */ "WeeklySpendLimit" : (long) /* nillable */ "CustomPeriodBudget": { /* nillable */ "SpendLimit": (long), "StartDate": (string), "EndDate": (string), "AutoContinue": ("YES" | "NO") }, }, "MaxProfit" : { /* StrategyMaxProfit */ "WeeklySpendLimit" : (long), "CustomPeriodBudget": { "SpendLimit": (long), "StartDate": (string), "EndDate": (string), "AutoContinue": ("YES" | "NO") }, "ExplorationBudget" : { "MinimumExplorationBudget" : (long) /* required */, "IsMinimumExplorationBudgetCustom" : ("YES") /* required */ }, "BudgetType": ("WEEKLY_BUDGET" | "CUSTOM_PERIOD_BUDGET") /* nillable */ } } }, "Settings": [{ /* TextCampaignSettingGet */ "Option": ( "ADD_METRICA_TAG" | ... | "SHARED_ACCOUNT_ENABLED" ), /* required */ "Value": ( "YES" | "NO" ) /* required */ }, ... ], "CounterIds": { /* ArrayOfInteger */ "Items": [(int), ... ] /* required */ }, /* nillable */ "RelevantKeywords": { /* RelevantKeywordsSetting */ "BudgetPercent": (int), "OptimizeGoalId": (long) /* nillable */ }, /* nillable */ "PriorityGoals": { /* PriorityGoalsArray */ "Items": [{ /* PriorityGoalsItem */ "GoalId": (long), /* required */ "Value": (long), /* required */ "IsMetrikaSourceOfValue": ( "YES" | "NO" ) }, ... ] /* required */ }, /* nillable */ "TrackingParams": (string), "AttributionModel": ( "FCCD" | "LC" | "LSCCD" | "AUTO" ), "PackageBiddingStrategy" : { /* nillable */ "StrategyId" : (long), /* required */ "Platforms" : { /* required */ "SearchResult" : ( "YES" | "NO" ) /* required */, "ProductGallery" : ( "YES" | "NO" ) /* required */, "Network" : ( "YES" | "NO" ) /* required */, "DynamicPlaces" : ( "YES" | "NO" ) } }, "CanBeUsedAsPackageBiddingStrategySource" : ( "YES" | "NO" ), "NegativeKeywordSharedSetIds" : { /* nillable */ "Items" : [ (long) ] /* required */ }, "WeeklyBudgetRollover": (long) /* nillable */ } }, ... ], "LimitedBy": (long) } } ``` #| || **Параметр** | **Тип** | **Описание** || || **Структура TextCampaignGetItem** || || `Settings` | array of TextCampaignSettingGet | Массив настроек, допускающих только значения YES или NO. || || `CounterIds` | ArrayOfInteger, nillable | Идентификаторы счетчиков Яндекс Метрики, установленных на сайте пользователя (см. раздел [Яндекс Метрика: оценка эффективности продвижения](https://yandex.ru/support/direct/statistics/metrika.html) Справки Директа). || || `RelevantKeywords` | RelevantKeywordsSetting, nillable | Настройки показов по дополнительным релевантным фразам (см. раздел [Показы по дополнительным релевантным фразам](https://yandex.ru/support/direct/keywords/related-keywords.html)). Если структура не задана, показы по дополнительным релевантным фразам отключены. || || `BiddingStrategy` | TextCampaignStrategy | Стратегия показа. || || `PriorityGoals` | PriorityGoalsArray, nillable | Ключевые цели, на достижение которых направлена автоматическая корректировка ставок. Если массив не задан, автоматическая корректировка направлена на получение максимального количества вовлеченных сессий, см. раздел [Показатели вовлеченных сессий](https://yandex.ru/support/direct/statistics/report-wizard-engagement-rating.html) Справки Директа. Ограничение — 30 ключевых целей. || || `TrackingParams` | string | Параметры URL для шаблонов. || || `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 — автоматическая атрибуция. || || `PackageBiddingStrategy` | TextCampaignPackageBiddingStrategyGet, nillable | Информация о пакетной стратегии. Null (nil) – кампания не находится в составе пакетной стратегии. || || `CanBeUsedAsPackageBiddingStrategySource` | YesNoEnum | Показывает, может ли стратегия этой кампании быть пакетной. || || `NegativeKeywordSharedSetIds` | ArrayOfLong, nillable | Идентификаторы наборов минус-фраз. Не более 3 элементов в массиве. || || `WeeklyBudgetRollover` | long, nillable | Величина недельного бюджета, которая добавлена за счет переноса неиспользованного бюджета с предыдущей недели (см. раздел [Перенос части неиспользованного бюджета](https://yandex.ru/support/direct/ru/strategies/week-budget#transfer) Справки Директа). В валюте рекламодателя, умноженная на 1 000 000. Null – перенос не применяется или нет данных. || || **Структура TextCampaignSettingGet** || || `Option` | TextCampaignSettingsGetEnum | Имя настройки: - ADD_METRICA_TAG - ADD_OPENSTAT_TAG - ADD_TO_FAVORITES - ENABLE_AREA_OF_INTEREST_TARGETING - ENABLE_COMPANY_INFO - ENABLE_EXTENDED_AD_TITLE - ENABLE_SITE_MONITORING - EXCLUDE_PAUSED_COMPETING_ADS - MAINTAIN_NETWORK_CPC - REQUIRE_SERVICING - SHARED_ACCOUNT_ENABLED - DAILY_BUDGET_ALLOWED - CAMPAIGN_EXACT_PHRASE_MATCHING_ENABLED || || `Value` | YesNoEnum | Значение настройки. || || **Структура RelevantKeywordsSetting** || || `BudgetPercent` | int | Максимальный процент бюджета, расходуемый на клики по дополнительным релевантным фразам (от 1 до 100). || || `OptimizeGoalId` | long, nillable | Идентификатор цели Яндекс Метрики. Статистика конверсий по этой цели используется для оптимизации дополнительных релевантных фраз. Подходят все цели, доступные для кампании, в том числе составные. Подробнее о целях см. раздел [Цели и конверсии](https://yandex.ru/support/metrika/general/goals.xml) помощи Метрики. Список целей получают с помощью метода [GetStatGoals](https://yandex.ru/dev/direct/doc/dg-v4/live/GetStatGoals) API версии 4 или Live 4. Допустимы также следующие значения: - 0 — оптимизация дополнительных релевантных фраз осуществляется по всем целям, доступным для кампании; - null (nil) — оптимизация не осуществляется. {% note alert %} Если в кампании выбрана стратегия WB_MAXIMUM_CONVERSION_RATE или AVERAGE_CPA, то независимо от значения параметра `OptimizeGoalId` оптимизация осуществляется по цели (или всем целям), указанной в параметре `GoalId` в настройках стратегии. {% endnote %} || || **Структура PriorityGoalsArray** || || `Items` | array of PriorityGoalsItem | Набор ключевых целей и ценностей конверсий по ним. || || **Структура TextCampaignPackageBiddingStrategyGet** || || `StrategyId` | long | Идентификатор пакетной стратегии. || || `Platforms` | TextCampaignPlatforms | Платформа размещения продвижения. || || **Структура 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` используется только для стратегий с долей расходов на продвижение. || || **Структура TextCampaignPlatforms** || || `SearchResult` | YesNoEnum | Поисковая выдача. || || `ProductGallery` | YesNoEnum | Товарная галерея. || || `Network` | YesNoEnum | Рекламная сеть Яндекса. || || `DynamicPlaces` | YesNoEnum | Динамические места на поиске. || || **Структура TextCampaignStrategy** || || `Search` | TextCampaignSearchStrategy | Стратегия показа на поиске. || || `Network` | TextCampaignNetworkStrategy | Стратегия показа в сетях. || || **Структура TextCampaignSearchStrategy** || || `BiddingStrategyType` | TextCampaignSearchStrategyTypeEnum | Тип стратегии показа на поиске: - HIGHEST_POSITION - WB_MAXIMUM_CLICKS - WB_MAXIMUM_CONVERSION_RATE - AVERAGE_CPC - AVERAGE_CPA - AVERAGE_CRR - PAY_FOR_CONVERSION - PAY_FOR_CONVERSION_CRR - WEEKLY_CLICK_PACKAGE - SERVING_OFF - UNKNOWN || || `PlacementTypes` | TextCampaignSearchStrategyPlacementTypes | Места показов на поиске. || || `WbMaximumClicks` | StrategyMaximumClicks | Параметры стратегии [Оптимизация кликов](https://yandex.ru/support/direct/strategies/weekly-budget.html), ограничивать по недельному бюджету. || || `WbMaximumConversionRate` | StrategyMaximumConversionRate | Параметры стратегии [Оптимизация конверсий](https://yandex.ru/support/direct/strategies/average-cpa.html), без указания средней цены конверсии. || || `AverageCpc` | StrategyAverageCpc | Параметры стратегии [Оптимизация кликов](https://yandex.ru/support/direct/strategies/average-cpc.html), ограничивать по средней цене клика. || || `AverageCpa` | StrategyAverageCpa | Параметры стратегии [Оптимизация конверсий](https://yandex.ru/support/direct/strategies/average-cpa.html), удерживать среднюю цену конверсии. || || `AverageCpaMultipleGoals` | StrategyAverageCpaMultipleGoals | Параметры стратегии [Максимум конверсий](https://yandex.ru/support/direct/strategies/average-cpa.html) с оплатой за клики, удерживать среднюю цену конверсии по нескольким целям. Одновременно необходимо передать массив `PriorityGoals` с минимум двумя ключевыми целями, в качестве ценности `Value` указать для каждой цели целевую цену конверсии. || || `AverageCrr` | StrategyAverageCrr | Параметры стратегии [Оптимизация доли рекламных расходов](https://yandex.ru/support/direct/strategies/average-crr.html), удерживать среднюю долю расходов. || || `PayForConversionCrr` | StrategyPayForConversionCrr | Параметры стратегии [Оптимизация доли рекламных расходов](https://yandex.ru/support/direct/strategies/average-crr.html), оплата за конверсии. || || `PayForConversion` | StrategyPayForConversion | Параметры стратегии [Оптимизация конверсий](https://yandex.ru/support/direct/strategies/average-cpa.html), оплата за конверсии. || || `PayForConversionMultipleGoals` | StrategyPayForConversionMultipleGoals | Параметры стратегии [Максимум конверсий](https://yandex.ru/support/direct/strategies/average-cpa.html) с оплатой за конверсии по каждой из указанных целей. Одновременно необходимо передать массив `PriorityGoals` с минимум двумя ключевыми целями, в качестве ценности `Value` указать для каждой цели целевую цену конверсии. || || `MaxProfit` | StrategyMaxProfit | Параметры стратегии Максимум прибыли, на основании данных о марже с конверсии подбирается оптимальная цена конверсии и постоянно актуализируется, что позволяет бизнесу получать максимальную итоговую прибыль. Одновременно необходимо передать массив `PriorityGoals`, в качестве `Value` указать маржу с конверсии. || || `WeeklyClickPackage` | StrategyWeeklyClickPackage | Параметры стратегии [Оптимизация кликов](https://yandex.ru/support/direct/strategies/weekly-package.html), ограничивать по пакету кликов. || || **Структура TextCampaignNetworkStrategy** || || `BiddingStrategyType` | TextCampaignNetworkStrategyTypeEnum | Тип стратегии показа в сетях: - NETWORK_DEFAULT - MAXIMUM_COVERAGE - WB_MAXIMUM_CLICKS - WB_MAXIMUM_CONVERSION_RATE - AVERAGE_CPC - AVERAGE_CPA - AVERAGE_CRR - PAY_FOR_CONVERSION - PAY_FOR_CONVERSION_CRR - WEEKLY_CLICK_PACKAGE - SERVING_OFF - UNKNOWN || || `NetworkDefault` | StrategyNetworkDefault | Настройки показов в сетях в зависимости от настроек на поиске. Если выбрана стратегия на поиске, отличная от HIGHEST_POSITION, структура не возвращается. || || `WbMaximumClicks` | StrategyMaximumClicks | Параметры стратегии [Оптимизация кликов](https://yandex.ru/support/direct/strategies/weekly-budget.html), ограничивать по недельному бюджету. || || `WbMaximumConversionRate` | StrategyMaximumConversionRate | Параметры стратегии [Оптимизация конверсий](https://yandex.ru/support/direct/strategies/average-cpa.html), без указания средней цены конверсии. || || `AverageCpc` | StrategyAverageCpc | Параметры стратегии [Оптимизация кликов](https://yandex.ru/support/direct/strategies/average-cpc.html), ограничивать по средней цене клика. || || `AverageCpa` | StrategyAverageCpa | Параметры стратегии [Оптимизация конверсий](https://yandex.ru/support/direct/strategies/average-cpa.html), удерживать среднюю цену конверсии. || || `AverageCpaMultipleGoals` | StrategyAverageCpaMultipleGoals | Параметры стратегии [Максимум конверсий](https://yandex.ru/support/direct/strategies/average-cpa.html) с оплатой за клики, удерживать среднюю цену конверсии по нескольким целям. Одновременно необходимо передать массив `PriorityGoals` с минимум двумя ключевыми целями, в качестве ценности `Value` указать для каждой цели целевую цену конверсии. || || `AverageCrr` | StrategyAverageCrr | Параметры стратегии [Оптимизация доли рекламных расходов](https://yandex.ru/support/direct/strategies/average-crr.html), удерживать среднюю долю расходов. || || `PayForConversionCrr` | StrategyPayForConversionCrr | Параметры стратегии [Оптимизация доли рекламных расходов](https://yandex.ru/support/direct/strategies/average-crr.html), оплата за конверсии. || || `PayForConversion` | StrategyPayForConversion | Параметры стратегии [Оптимизация конверсий](https://yandex.ru/support/direct/strategies/average-cpa.html), оплата за конверсии. || || `PayForConversionMultipleGoals` | StrategyPayForConversionMultipleGoals | Параметры стратегии [Максимум конверсий](https://yandex.ru/support/direct/strategies/average-cpa.html) с оплатой за конверсии по каждой из указанных целей. Одновременно необходимо передать массив `PriorityGoals` с минимум двумя ключевыми целями, в качестве ценности `Value` указать для каждой цели целевую цену конверсии. || || `MaxProfit` | StrategyMaxProfit | Параметры стратегии Максимум прибыли, на основании данных о марже с конверсии подбирается оптимальная цена конверсии и постоянно актуализируется, что позволяет бизнесу получать максимальную итоговую прибыль. Одновременно необходимо передать массив `PriorityGoals`, в качестве `Value` указать маржу с конверсии. || || `WeeklyClickPackage` | StrategyWeeklyClickPackage | Параметры стратегии [Оптимизация кликов](https://yandex.ru/support/direct/strategies/weekly-package.html), ограничивать по пакету кликов. || || **Структура TextCampaignSearchStrategyPlacementTypes** || || `SearchResults` | YesNoEnum | Поисковая выдача. || || `ProductGallery` | YesNoEnum | Товарная галерея. || || `DynamicPlaces` | YesNoEnum | Динамические места на поиске. || || **Структура StrategyMaximumClicks** || || `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). || || `BidCeiling` | long, nillable | Максимальная ставка в валюте пользователя, умноженная на 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 %} || || `CustomPeriodBudget` | CustomPeriodBudget | Бюджет на период. Подробнее см. в [Справке Директа](https://yandex.ru/support/direct/strategies/budgets-in-strategies.html). При создании кампании нельзя указать одновременно с `WeeklySpendLimit`. || || **Структура StrategyMaximumConversionRate** || || `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). || || `BidCeiling` | long, nillable | Максимальная ставка в валюте пользователя, умноженная на 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 — ключевые цели. Допускается, если в массиве указана хотя бы одна цель, отличная от вовлеченных сессий. Список целей получают с помощью метода [GetStatGoals](https://yandex.ru/dev/direct/doc/dg-v4/live/GetStatGoals) API версии 4 или Live 4. || || `CustomPeriodBudget` | CustomPeriodBudget | Бюджет на период. Подробнее см. в [Справке Директа](https://yandex.ru/support/direct/strategies/budgets-in-strategies.html). При создании кампании нельзя указать одновременно с `WeeklySpendLimit`. || || **Структура StrategyAverageCpc** || || `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, nillable | Недельный бюджет в валюте пользователя, умноженный на 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 – бюджет на период. || || **Структура StrategyAverageCpa** || || `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). || || `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, nillable | Недельный бюджет в валюте пользователя, умноженный на 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 – бюджет на период. || || `BidCeiling` | long, nillable | Максимальная ставка в валюте пользователя, умноженная на 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.ru/support/direct/strategies/minimal-budget.html). || || **Структура StrategyAverageCpaMultipleGoals** || || `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`. || || `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.ru/support/direct/strategies/minimal-budget.html). Если поле не задано, для стратегии устанавливается значение по умолчанию (рассчитывается на основе настроек стратегии). Чтобы установить пользовательское значение минимального бюджета, задайте значение в параметре `MinimumExplorationBudget` и укажите `IsMinimumExplorationBudgetCustom="YES"`. Если `IsMinimumExplorationBudgetCustom` установлен в `NO`, операция завершится с ошибкой. || || **Структура StrategyAverageCrr** || || `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 – бюджет на период. || || `ExplorationBudget` | ExplorationBudget | Минимальный бюджет. Подробнее в [Справке Директа](https://yandex.ru/support/direct/strategies/minimal-budget.html). || || **Структура StrategyPayForConversionCrr** || || `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 – бюджет на период. || || **Структура StrategyPayForConversion** || || `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, nillable | Недельный бюджет в валюте пользователя, умноженный на 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 – бюджет на период. || || **Структура PayForConversionMultipleGoals** || || `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`. || || **Структура MaxProfit** || || `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 – бюджет на период. || || **Структура StrategyWeeklyClickPackage** || || `ClicksPerWeek` | long | Требуемое количество кликов в неделю. || || `AverageCpc` | long, nillable | Средняя цена клика в валюте пользователя, умноженная на 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 %} Параметры `AverageCpc` и `BidCeiling` являются взаимоисключающими: нельзя указывать оба. {% endnote %} || || `BidCeiling` | long, nillable | Максимальная ставка в валюте пользователя, умноженная на 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 %} Параметры `AverageCpc` и `BidCeiling` являются взаимоисключающими: нельзя указывать оба. {% endnote %} || || **Структура StrategyNetworkDefault** || || `LimitPercent` | int | Максимальный процент бюджета, расходуемый на показы в сетях. Значение кратно десяти: 10, 20, ..., 100. || || **Структура ExplorationBudget** || || `MinimumExplorationBudget` | long | Значение минимального бюджета. Допустимое значение: от 0 до значения недельного бюджета (если он задан). || || `IsMinimumExplorationBudgetCustom` | YesNoEnum | Признак пользовательского значения минимального бюджета. || || **Структура CustomPeriodBudget** || || `SpendLimit` | long | Значение бюджета на период. || || `StartDate` | string | Начало бюджетного периода. || || `EndDate` | string | Окончание бюджетного периода. || || `AutoContinue` | YesNoEnum | Признак автопродления бюджета. || |#