--- metadata: - name: generator content: Diplodoc Platform v5.52.0 alternate: - https://yandex.com/dev/direct/doc/en/campaigns/get-mobile-app-campaign.md - https://yandex.com/dev/direct/doc/ru/campaigns/get-mobile-app-campaign.md - href: ru/campaigns/get-mobile-app-campaign.md type: text/markdown title: Markdown version - href: ../llms.txt type: text/markdown title: llms.txt sourcePath: ru/ref-v5/campaigns/get-mobile-app-campaign.md --- > **Documentation Index:** Fetch the complete configuration index at https://yandex.com/dev/direct/doc/ru/llms.txt # get: параметры MobileAppCampaign Структура ответа в формате JSON: ```javascript translate=no { "result": { "Campaigns": [{ /* CampaignGetItem */ ... "MobileAppCampaign": { /* MobileAppCampaignGetItem */ "BiddingStrategy": { /* MobileAppCampaignStrategy */ "Search": { /* MobileAppCampaignSearchStrategy */ "BiddingStrategyType": ( "AVERAGE_CPC" | ... | "WEEKLY_CLICK_PACKAGE" ), /* required */ "WbMaximumClicks": { /* StrategyMaximumClicks */ "WeeklySpendLimit": (long), "BidCeiling": (long) /* nillable */ }, "WbMaximumAppInstalls": { /* StrategyMaximumAppInstalls */ "WeeklySpendLimit": (long), "BidCeiling": (long) /* nillable */ }, "AverageCpc": { /* StrategyAverageCpc */ "AverageCpc": (long), "WeeklySpendLimit": (long), /* nillable */ "CustomPeriodBudget": { "SpendLimit": (long), "StartDate": (string), "EndDate": (string), "AutoContinue": ("YES" | "NO") }, "BudgetType": ("WEEKLY_BUDGET" | "CUSTOM_PERIOD_BUDGET") /* nillable */ }, "AverageCpi": { /* StrategyAverageCpi */ "AverageCpi": (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 */ }, "WeeklyClickPackage": { /* StrategyWeeklyClickPackage */ "ClicksPerWeek": (long), "AverageCpc": (long), /* nillable */ "BidCeiling": (long) /* nillable */ }, "PayForInstall" : { /* StrategyPayForInstall */ "AverageCpi" : (long), "WeeklySpendLimit" : (long), /* nillable */ "CustomPeriodBudget": { /* nillable */ "SpendLimit": (long), "StartDate": (string), "EndDate": (string), "AutoContinue": ("YES" | "NO") }, "BudgetType": ("WEEKLY_BUDGET" | "CUSTOM_PERIOD_BUDGET") /* nillable */ }, "HighestPosition" : { "WeeklySpendLimit" : (long) } }, "Network": { /* MobileAppCampaignNetworkStrategy */ "BiddingStrategyType": ( "AVERAGE_CPC" | ... | "WEEKLY_CLICK_PACKAGE" ), /* required */ "NetworkDefault": { /* StrategyNetworkDefault */ "LimitPercent": (int) }, "WbMaximumClicks": { /* StrategyMaximumClicks */ "WeeklySpendLimit": (long), "BidCeiling": (long) /* nillable */ }, "WbMaximumAppInstalls": { /* StrategyMaximumAppInstalls */ "WeeklySpendLimit": (long), "BidCeiling": (long) /* nillable */ }, "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 */ }, "AverageCpi": { /* StrategyAverageCpi */ "AverageCpi": (long), "WeeklySpendLimit": (long), /* nillable */ "BidCeiling": (long) /* nillable */ }, "WeeklyClickPackage": { /* StrategyWeeklyClickPackage */ "ClicksPerWeek": (long), "AverageCpc": (long), /* nillable */ "BidCeiling": (long) /* nillable */ }, "PayForInstall" : { /* StrategyPayForInstall */ "AverageCpi" : (long), "WeeklySpendLimit" : (long), /* nillable */ "CustomPeriodBudget": { /* nillable */ "SpendLimit": (long), "StartDate": (string), "EndDate": (string), "AutoContinue": ("YES" | "NO") }, "BudgetType": ("WEEKLY_BUDGET" | "CUSTOM_PERIOD_BUDGET") /* nillable */ } }, "Settings": [{ /* MobileAppCampaignSettingGet */ "Option": ( "ADD_TO_FAVORITES" | ... | "SHARED_ACCOUNT_ENABLED" ), /* required */ "Value": ( "YES" | "NO" ) /* required */ }, ... ], "PackageBiddingStrategy" : { /* nillable */ "StrategyId" : (long), /* required */ }, "CanBeUsedAsPackageBiddingStrategySource" : ( "YES" | "NO" ), "NegativeKeywordSharedSetIds" : { /* nillable */ "Items" : [ (long) ] /* required */ }, } } }, ... ], "LimitedBy": (long) } } ``` #| || **Параметр** | **Тип** | **Описание** || || **Структура MobileAppCampaignGetItem** || || `Settings` | array of MobileAppCampaignSettingGet | Массив настроек, допускающих только значения YES или NO. || || `BiddingStrategy` | MobileAppCampaignStrategy | Стратегия показа. || || `PackageBiddingStrategy` | MobileAppCampaignPackageBiddingStrategyGet, nillable, deprecated | Информация о пакетной стратегии. Null (nil) – кампания не находится в составе пакетной стратегии. || || `CanBeUsedAsPackageBiddingStrategySource` | string, deprecated | Показывает, может ли стратегия этой кампании быть пакетной. || || `NegativeKeywordSharedSetIds` | ArrayOfLong, nillable | Идентификаторы наборов минус-фраз. Не более 3 элементов в массиве. || || **Структура MobileAppCampaignSettingGet** || || `Option` | MobileAppCampaignSettingsEnum | Имя настройки: - ADD_TO_FAVORITES - ENABLE_AREA_OF_INTEREST_TARGETING - MAINTAIN_NETWORK_CPC - REQUIRE_SERVICING - SHARED_ACCOUNT_ENABLED - DAILY_BUDGET_ALLOWED - CAMPAIGN_EXACT_PHRASE_MATCHING_ENABLED || || `Value` | YesNoEnum | Значение настройки. || || **Структура MobileAppCampaignPackageBiddingStrategyGet** || || `StrategyId` | long | Идентификатор пакетной стратегии. || || **Структура MobileAppCampaignStrategy** || || `Search` | [MobileAppCampaignSearchStrategy](#MobileAppCampaignSearchStrategy) | Стратегия показа на поиске. || || `Network` | [MobileAppCampaignNetworkStrategy](#MobileAppCampaignNetworkStrategy) | Стратегия показа в сетях. || || **Структура MobileAppCampaignSearchStrategy** || || `BiddingStrategyType` | MobileAppCampaignSearchStrategyTypeEnum | Тип стратегии показа на поиске: - HIGHEST_POSITION - WB_MAXIMUM_CLICKS - WB_MAXIMUM_APP_INSTALLS - AVERAGE_CPC - AVERAGE_CPI - WEEKLY_CLICK_PACKAGE - PAY_FOR_INSTALL - SERVING_OFF - UNKNOWN || || `WbMaximumClicks` | StrategyMaximumClicks | Параметры стратегии [Оптимизация кликов](https://yandex.ru/support/direct/strategies/weekly-budget.html), ограничивать по недельному бюджету. || || `WbMaximumAppInstalls` | StrategyMaximumAppInstalls | Параметры стратегии [Оптимизация количества установок приложения](https://yandex.ru/support/direct/strategies/weekly-budget.html), без указания средней цены установки. || || `AverageCpc` | StrategyAverageCpc | Параметры стратегии [Оптимизация кликов](https://yandex.ru/support/direct/strategies/average-cpc.html), ограничивать по средней цене клика. || || `WeeklyClickPackage` | StrategyWeeklyClickPackage | Параметры стратегии [Оптимизация кликов](https://yandex.ru/support/direct/strategies/weekly-package.html), ограничивать по пакету кликов. || || `AverageCpi` | StrategyAverageCpi | Параметры стратегии [Оптимизация количества установок приложения](https://yandex.ru/support/direct/strategies/average-cpi.html), удерживать среднюю цену установки. || || `PayForInstall` | StrategyPayForInstall | Параметры стратегии [Оптимизация конверсий](https://yandex.ru/support/direct/strategies/average-cpa-mobile-apps.html#average-cpa-mobile-apps__fix-cpi), оплата за установки. || || `HighestPosition` | StrategyHighestPosition | Параметры стратегии [Максимум кликов с ручными ставками](https://yandex.ru/support/direct/ru/strategies/manual-strategy). || || **Структура MobileAppCampaignNetworkStrategy** || || `BiddingStrategyType` | MobileAppCampaignNetworkStrategyTypeEnum | Тип стратегии показа в сетях: - NETWORK_DEFAULT - MAXIMUM_COVERAGE - WB_MAXIMUM_CLICKS - WB_MAXIMUM_APP_INSTALLS - AVERAGE_CPC - AVERAGE_CPI - WEEKLY_CLICK_PACKAGE - PAY_FOR_INSTALL - SERVING_OFF - UNKNOWN || || `NetworkDefault` | StrategyNetworkDefault | Настройки показов в сетях в зависимости от настроек на поиске. Если выбрана стратегия на поиске, отличная от HIGHEST_POSITION, структура не возвращается. || || `WbMaximumClicks` | StrategyMaximumClicks | Параметры стратегии [Оптимизация кликов](https://yandex.ru/support/direct/strategies/weekly-budget.html), ограничивать по недельному бюджету. || || `WbMaximumAppInstalls` | StrategyMaximumAppInstalls | Параметры стратегии [Оптимизация количества установок приложения](https://yandex.ru/support/direct/strategies/weekly-budget.html), без указания средней цены установки. || || `AverageCpc` | StrategyAverageCpc | Параметры стратегии [Оптимизация кликов](https://yandex.ru/support/direct/strategies/average-cpc.html), ограничивать по средней цене клика. || || `WeeklyClickPackage` | StrategyWeeklyClickPackage | Параметры стратегии [Оптимизация кликов](https://yandex.ru/support/direct/strategies/weekly-package.html), ограничивать по пакету кликов. || || `AverageCpi` | StrategyAverageCpi | Параметры стратегии [Оптимизация количества установок приложения](https://yandex.ru/support/direct/strategies/average-cpi.html), удерживать среднюю цену установки. || || `PayForInstall` | StrategyPayForInstall | Параметры стратегии [Оптимизация конверсий](https://yandex.ru/support/direct/strategies/average-cpa-mobile-apps.html#average-cpa-mobile-apps__fix-cpi), оплата за установки. || || **Структура 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 %} || || **Структура StrategyMaximumAppInstalls** || || `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 %} || || **Структура 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 – бюджет на период. || || **Структура StrategyAverageCpi** || || `AverageCpi` | long | Средняя цена установки приложения в валюте пользователя, умноженная на 1 000 000. Минимальное допустимое значение представлено в разделе [Валютные параметры и ограничения](https://yandex.ru/dev/direct/doc/dg/objects/campaign.html). || || `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 %} || || **Структура 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 %} || || **Структура StrategyPayForInstall** || || `AverageCpi` | long | Цена за установку приложения в валюте пользователя, умноженная на 1 000 000. Минимальные и максимальные допустимые значения представлены в разделе [Валютные параметры и ограничения](https://yandex.ru/dev/direct/doc/dg/objects/campaign.html). || || `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 – бюджет на период. || || **Структура StrategyNetworkDefault** || || `LimitPercent` | int | Максимальный процент бюджета, расходуемый на показы в сетях. Значение кратно десяти: 10, 20, ..., 100. || || **Структура CustomPeriodBudget** || || `SpendLimit` | long | Значение бюджета на период. || || `StartDate` | string | Начало бюджетного периода. || || `EndDate` | string | Окончание бюджетного периода. || || `AutoContinue` | YesNoEnum | Признак автопродления бюджета. || |#