--- metadata: - name: generator content: Diplodoc Platform v5.52.0 alternate: - https://yandex.com/dev/direct/doc/en/campaigns/update-mobile-app-campaign.md - https://yandex.com/dev/direct/doc/ru/campaigns/update-mobile-app-campaign.md - href: en/campaigns/update-mobile-app-campaign.md type: text/markdown title: Markdown version - href: ../llms.txt type: text/markdown title: llms.txt sourcePath: en/ref-v5/campaigns/update-mobile-app-campaign.md --- > **Documentation Index:** Fetch the complete configuration index at https://yandex.com/dev/direct/doc/en/llms.txt # update: MobileAppCampaign parameters Request structure in JSON format: ```javascript translate=no { "method": "update", "params": { "Campaigns": [{ /* CampaignUpdateItem */ ... "MobileAppCampaign": { /* MobileAppCampaignUpdateItem */ "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": { /* nillable */ "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 */, } }, "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 */ "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 */, } } }, "Settings": [{ /* MobileAppCampaignSetting */ "Option": ( "ADD_TO_FAVORITES" | ... | "REQUIRE_SERVICING" ), /* required */ "Value": ( "YES" | "NO" ) /* required */ }, ... ], "NegativeKeywordSharedSetIds" : { /* nillable */ "Items" : [ (long) ] /* required */ } } }, ....] /* required */ } } ``` #| || **Parameter** | **Type** | **Description** | **Required** || || **MobileAppCampaignUpdateItem structure** || || `Settings` | array of MobileAppCampaignSetting | Array of settings that only accept the values YES or NO. | No || || `BiddingStrategy` | MobileAppCampaignStrategy | Display strategy. | No || || `NegativeKeywordSharedSetIds` | ArrayOfLong, nillable | IDs of sets of negative keywords. Maximum of 3 items in the array. To get the IDs of sets, use the [NegativeKeywordSharedSets](https://yandex.com/dev/direct/doc/en/negativekeywordsharedsets/negativekeywordsharedsets.md).[get](https://yandex.com/dev/direct/doc/en/negativekeywordsharedsets/get.md) method. | No || || **MobileAppCampaignSetting structure** || || `Option` | MobileAppCampaignSettingsEnum | Setting name: - ADD_TO_FAVORITES - ENABLE_AREA_OF_INTEREST_TARGETING - MAINTAIN_NETWORK_CPC - REQUIRE_SERVICING | Yes || || `Value` | YesNoEnum | Setting value. | Yes || || **MobileAppCampaignStrategy structure** || || `Search` | [MobileAppCampaignSearchStrategy](#MobileAppCampaignSearchStrategy) | Display strategy in search results. | No || || `Network` | [MobileAppCampaignNetworkStrategy](#MobileAppCampaignNetworkStrategy) | Display strategy in ad networks. | No || || **MobileAppCampaignSearchStrategy structure** || || `BiddingStrategyType` | MobileAppCampaignSearchStrategyTypeEnum | The type of display strategy in search results: - HIGHEST_POSITION - WB_MAXIMUM_CLICKS - WB_MAXIMUM_APP_INSTALLS - AVERAGE_CPC - AVERAGE_CPI - WEEKLY_CLICK_PACKAGE - PAY_FOR_INSTALL - SERVING_OFF For information about the compatibility of strategies in search results and ad networks, see the section [Display strategies](https://yandex.com/dev/direct/doc/objects/campaign-strategies.html). | Yes || || `WbMaximumClicks` | StrategyMaximumClicks | Parameters of the [Optimize clicks](https://yandex.com/support/direct/en/strategies/weekly-budget.html) strategy. Limited by weekly budget. | When the `BiddingStrategyType` parameter is set to WB_MAXIMUM_CLICKS || || `WbMaximumAppInstalls` | StrategyMaximumAppInstalls | Parameters of the [Optimize number of app installations](https://yandex.com/support/direct/en/strategies/weekly-budget.html) strategy, without specifying the average CPI. | When the `BiddingStrategyType` parameter is set to WB_MAXIMUM_APP_INSTALLS || || `AverageCpc` | StrategyAverageCpc | Parameters of the [Optimize clicks](https://yandex.com/support/direct/en/strategies/average-cpc.html) strategy. Limited by average CPC. | When the `BiddingStrategyType` parameter is set to AVERAGE_CPC || || `WeeklyClickPackage` | StrategyWeeklyClickPackage | Parameters of the [Optimize clicks](https://yandex.com/support/direct/en/strategies/weekly-package.html) strategy. Limited by click package. | When the `BiddingStrategyType` parameter is set to WEEKLY_CLICK_PACKAGE || || `AverageCpi` | StrategyAverageCpi | Parameters of the [Optimize number of app installations](https://yandex.com/support/direct/en/strategies/average-cpi.html) strategy. Maintain the average CPI. | When the `BiddingStrategyType` parameter is set to AVERAGE_CPI || || `PayForInstall` | StrategyPayForInstall | Parameters of the [Optimize conversions](https://yandex.com/support/direct/en/strategies/average-cpa-mobile-apps.html#average-cpa-mobile-apps__fix-cpi) strategy. Pay per install. | When the `BiddingStrategyType` parameter is set to PAY_FOR_INSTALL || || **MobileAppCampaignNetworkStrategy structure** || || `BiddingStrategyType` | MobileAppCampaignNetworkStrategyTypeEnum | The type of display strategy in ad networks: - NETWORK_DEFAULT - MAXIMUM_COVERAGE - WB_MAXIMUM_CLICKS - WB_MAXIMUM_APP_INSTALLS - AVERAGE_CPC - AVERAGE_CPI - WEEKLY_CLICK_PACKAGE - PAY_FOR_INSTALL - SERVING_OFF For information about the compatibility of strategies in search results and ad networks, see the section [Display strategies](https://yandex.com/dev/direct/doc/objects/campaign-strategies.html) | Yes || || `NetworkDefault` | StrategyNetworkDefault | Settings for impressions in ad networks based on the settings for search. If a search strategy other than HIGHEST_POSITION is selected, pass an empty structure. | When the `BiddingStrategyType` parameter is set to NETWORK_DEFAULT || || `WbMaximumClicks` | StrategyMaximumClicks | Parameters of the [Optimize clicks](https://yandex.com/support/direct/en/strategies/weekly-budget.html) strategy. Limited by weekly budget. | When the `BiddingStrategyType` parameter is set to WB_MAXIMUM_CLICKS || || `WbMaximumAppInstalls` | StrategyMaximumAppInstalls | Parameters of the [Optimize number of app installations](https://yandex.com/support/direct/en/strategies/weekly-budget.html) strategy, without specifying the average CPI. | When the `BiddingStrategyType` parameter is set to WB_MAXIMUM_APP_INSTALLS || || `AverageCpc` | StrategyAverageCpc | Parameters of the [Optimize clicks](https://yandex.com/support/direct/en/strategies/average-cpc.html) strategy. Limited by average CPC. | When the `BiddingStrategyType` parameter is set to AVERAGE_CPC || || `WeeklyClickPackage` | StrategyWeeklyClickPackage | Parameters of the [Optimize clicks](https://yandex.com/support/direct/en/strategies/weekly-package.html) strategy. Limited by click package. | When the `BiddingStrategyType` parameter is set to WEEKLY_CLICK_PACKAGE || || `AverageCpi` | StrategyAverageCpi | Parameters of the [Optimize number of app installations](https://yandex.com/support/direct/en/strategies/average-cpi.html) strategy. Maintain the average CPI. | When the `BiddingStrategyType` parameter is set to AVERAGE_CPI || || `PayForInstall` | StrategyPayForInstall | Parameters of the [Optimize conversions](https://yandex.com/support/direct/en/strategies/average-cpa-mobile-apps.html#average-cpa-mobile-apps__fix-cpi) strategy. Pay per install. | When the `BiddingStrategyType` parameter is set to PAY_FOR_INSTALL || || **StrategyMaximumClicks structure** || || `WeeklySpendLimit` | long | The weekly budget in the user's currency, multiplied by 1,000,000. The minimum weekly budget for each currency is listed in the currency reference. To get the list of currencies, use the [Dictionaries](https://yandex.com/dev/direct/doc/en/dictionaries/dictionaries.md).[get](https://yandex.com/dev/direct/doc/en/dictionaries/get.md) method. | No || || `BidCeiling` | long, nillable | The maximum bid in the user's currency, multiplied by 1,000,000. The minimum and maximum bid for each currency is listed in the currency reference. To get the list of currencies, use the [Dictionaries](https://yandex.com/dev/direct/doc/en/dictionaries/dictionaries.md).[get](https://yandex.com/dev/direct/doc/en/dictionaries/get.md) method. {% note info %} We don't recommend setting the maximum bid, as this may reduce the effectiveness of the strategy. {% endnote %} | No || || **StrategyMaximumAppInstalls structure** || || `WeeklySpendLimit` | long | The weekly budget in the user's currency, multiplied by 1,000,000. The minimum weekly budget for each currency is listed in the currency reference. To get the list of currencies, use the [Dictionaries](https://yandex.com/dev/direct/doc/en/dictionaries/dictionaries.md).[get](https://yandex.com/dev/direct/doc/en/dictionaries/get.md) method. | No || || `CustomPeriodBudget` | CustomPeriodBudget | Budget for a custom period. For more information, see [Yandex Direct Help](https://yandex.com/support/direct/en/strategies/budgets-in-strategies.html). When creating a campaign, you can't specify both this parameter and `WeeklySpendLimit`. | No || || `BudgetType` | BudgetTypeEnum | Type of budget: - WEEKLY_BUDGET — Weekly budget. - CUSTOM_PERIOD_BUDGET — Budget for a custom period. If the budget type is changed while editing the campaign, the original type must be passed with a NULL value. For example, if you change the budget type from weekly to custom period, make sure to pass NULL in the "WeeklySpendLimit" field. | No || || `BidCeiling` | long, nillable | The maximum bid in the user's currency, multiplied by 1,000,000. The minimum and maximum bid for each currency is listed in the currency reference. To get the list of currencies, use the [Dictionaries](https://yandex.com/dev/direct/doc/en/dictionaries/dictionaries.md).[get](https://yandex.com/dev/direct/doc/en/dictionaries/get.md) method. {% note info %} We don't recommend setting the maximum bid, as this may reduce the effectiveness of the strategy. {% endnote %} | No || || **StrategyAverageCpc structure** || || `AverageCpc` | long | The average CPC in the user's currency, multiplied by 1,000,000. The minimum value for the average cost is listed by currency in the currency reference. To get the list of currencies, use the [Dictionaries](https://yandex.com/dev/direct/doc/en/dictionaries/dictionaries.md).[get](https://yandex.com/dev/direct/doc/en/dictionaries/get.md) method. | No || || `WeeklySpendLimit` | long, nillable | The weekly budget in the user's currency, multiplied by 1,000,000. The minimum weekly budget for each currency is listed in the currency reference. To get the list of currencies, use the [Dictionaries](https://yandex.com/dev/direct/doc/en/dictionaries/dictionaries.md).[get](https://yandex.com/dev/direct/doc/en/dictionaries/get.md) method. | No || || `CustomPeriodBudget` | CustomPeriodBudget | Budget for a custom period. For more information, see [Yandex Direct Help](https://yandex.com/support/direct/en/strategies/budgets-in-strategies.html). When creating a campaign, you can't specify both this parameter and `WeeklySpendLimit`. | No || || `BudgetType` | BudgetTypeEnum | Type of budget: - WEEKLY_BUDGET — Weekly budget. - CUSTOM_PERIOD_BUDGET — Budget for a custom period. If the budget type is changed while editing the campaign, the original type must be passed with a NULL value. For example, if you change the budget type from weekly to custom period, make sure to pass NULL in the "WeeklySpendLimit" field. | No || || **StrategyAverageCpi structure** || || `AverageCpi` | long | The average cost per app install in the user's currency, multiplied by 1,000,000. The minimum acceptable value is shown in the section [Currency parameters and limits](https://yandex.com/dev/direct/doc/objects/campaign.html). | No || || `WeeklySpendLimit` | long, nillable | The weekly budget in the user's currency, multiplied by 1,000,000. The minimum weekly budget for each currency is listed in the currency reference. To get the list of currencies, use the [Dictionaries](https://yandex.com/dev/direct/doc/en/dictionaries/dictionaries.md).[get](https://yandex.com/dev/direct/doc/en/dictionaries/get.md) method. | No || || `CustomPeriodBudget` | CustomPeriodBudget | Budget for a custom period. For more information, see [Yandex Direct Help](https://yandex.com/support/direct/en/strategies/budgets-in-strategies.html). When creating a campaign, you can't specify both this parameter and `WeeklySpendLimit`. | No || || `BudgetType` | BudgetTypeEnum | Type of budget: - WEEKLY_BUDGET — Weekly budget. - CUSTOM_PERIOD_BUDGET — Budget for a custom period. If the budget type is changed while editing the campaign, the original type must be passed with a NULL value. For example, if you change the budget type from weekly to custom period, make sure to pass NULL in the "WeeklySpendLimit" field. | No || || `BidCeiling` | long, nillable | The maximum bid in the user's currency, multiplied by 1,000,000. The minimum and maximum bid for each currency is listed in the currency reference. To get the list of currencies, use the [Dictionaries](https://yandex.com/dev/direct/doc/en/dictionaries/dictionaries.md).[get](https://yandex.com/dev/direct/doc/en/dictionaries/get.md) method. {% note info %} We don't recommend setting the maximum bid, as this may reduce the effectiveness of the strategy. {% endnote %} | No || || **StrategyPayForInstall structure** || || `AverageCpi` | long | Cost per app install in the user's currency, multiplied by 1,000,000. The minimum and maximum acceptable values are shown in [Currency parameters and restrictions](https://yandex.com/dev/direct/doc/objects/campaign.html). | No || || `WeeklySpendLimit` | long, nillable | The weekly budget in the user's currency, multiplied by 1,000,000. The minimum weekly budget for each currency is listed in the currency reference. To get the list of currencies, use the [Dictionaries](https://yandex.com/dev/direct/doc/en/dictionaries/dictionaries.md).[get](https://yandex.com/dev/direct/doc/en/dictionaries/get.md) method. | No || || `CustomPeriodBudget` | CustomPeriodBudget | Budget for a custom period. For more information, see [Yandex Direct Help](https://yandex.com/support/direct/en/strategies/budgets-in-strategies.html). When creating a campaign, you can't specify both this parameter and `WeeklySpendLimit`. | No || || `BudgetType` | BudgetTypeEnum | Type of budget: - WEEKLY_BUDGET — Weekly budget. - CUSTOM_PERIOD_BUDGET — Budget for a custom period. If the budget type is changed while editing the campaign, the original type must be passed with a NULL value. For example, if you change the budget type from weekly to custom period, make sure to pass NULL in the "WeeklySpendLimit" field. | No || || **StrategyWeeklyClickPackage structure** || || `ClicksPerWeek` | long | Desired number of clicks per week. | No || || `AverageCpc` | long, nillable | The average CPC in the user's currency, multiplied by 1,000,000. The minimum value for the average cost is listed by currency in the currency reference. To get the list of currencies, use the [Dictionaries](https://yandex.com/dev/direct/doc/en/dictionaries/dictionaries.md).[get](https://yandex.com/dev/direct/doc/en/dictionaries/get.md) method. {% note info %} The `AverageCpc` and `BidCeiling` parameters are mutually exclusive. If you've previously specified the `BidCeiling` parameter and now you want to set `AverageCpc`, simultaneously pass null (nil) for `BidCeiling`. {% endnote %} | No || || `BidCeiling` | long, nillable | The maximum bid in the user's currency, multiplied by 1,000,000. The minimum and maximum bid for each currency is listed in the currency reference. To get the list of currencies, use the [Dictionaries](https://yandex.com/dev/direct/doc/en/dictionaries/dictionaries.md).[get](https://yandex.com/dev/direct/doc/en/dictionaries/get.md) method. {% note info %} The `AverageCpc` and `BidCeiling` parameters are mutually exclusive. If you've previously specified the `AverageCpc` parameter and now you want to set `BidCeiling`, simultaneously pass null (nil) for `AverageCpc`. {% endnote %} | No || || **StrategyNetworkDefault structure** || || `LimitPercent` | int | The maximum percentage of the budget to spend on displays in ad networks. The value is a multiple of ten: 10, 20, ..., 100. If the strategy changes and this parameter if not specified, the default value is used — 100. If a search strategy other than HIGHEST_POSITION is selected, the parameter is not used and the passed value is ignored. | No || || **CustomPeriodBudget structure** || || `SpendLimit` | long | Budget size for a custom period. | Yes || || `StartDate` | string | Start of the budget period. | Yes || || `EndDate` | string | End of the budget period. | Yes || || `AutoContinue` | YesNoEnum | Flag to autocontinue the budget period. | Yes || |#