update: MobileAppCampaign parameters

Attention. All monetary campaign parameters (daily budget, weekly budget, and average price for automatic strategies) are passed via the Yandex.Direct API as integer numbers. The passed value is a monetary value in the advertiser's currency, multiplied by 1,000,000.

Request structure in JSON format:

{
  "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 */
            },
            "AverageCpi": {  /* StrategyAverageCpi */
              "AverageCpi": (long),
              "WeeklySpendLimit": (long), /* nillable */
              "BidCeiling": (long) /* nillable */
            },
            "WeeklyClickPackage": {  /* StrategyWeeklyClickPackage */
              "ClicksPerWeek": (long),
              "AverageCpc": (long), /* nillable */
              "BidCeiling": (long) /* nillable */
            }
          }, 
          "Network": {  /* MobileAppCampaignNetworkStrategy */
            "BiddingStrategyType": ( "AVERAGE_CPC" | ... | "WEEKLY_CLICK_PACKAGE" ), /* required */
            "NetworkDefault": {  /* StrategyNetworkDefault */
              "LimitPercent": (int),
              "BidPercent": (int)
            },
            "WbMaximumClicks": {  /* StrategyMaximumClicks */
              "WeeklySpendLimit": (long),
              "BidCeiling": (long) /* nillable */
            },
            "WbMaximumAppInstalls": {  /* StrategyMaximumAppInstalls */
              "WeeklySpendLimit": (long),
              "BidCeiling": (long) /* nillable */
            },
            "AverageCpc": {  /* StrategyAverageCpc */
              "AverageCpc": (long),
              "WeeklySpendLimit": (long) /* nillable */
            },
            "AverageCpi": {  /* StrategyAverageCpi */
              "AverageCpi": (long),
              "WeeklySpendLimit": (long), /* nillable */
              "BidCeiling": (long) /* nillable */
            },
            "WeeklyClickPackage": {  /* StrategyWeeklyClickPackage */
              "ClicksPerWeek": (long),
              "AverageCpc": (long), /* nillable */
              "BidCeiling": (long) /* nillable */
            }
          } 
        },
        "Settings": [{  /* MobileAppCampaignSetting */
          "Option": ( "ADD_TO_FAVORITES" | ... | "REQUIRE_SERVICING" ), /* required */
          "Value": ( "YES" | "NO" ) /* required */
        }, ... ]
      }
    }, ....] /* required */
  }
}
ParameterTypeDescriptionRequired
MobileAppCampaignUpdateItem structure
Settingsarray of MobileAppCampaignSettingArray of settings that only accept the values YES or NO.No
BiddingStrategyMobileAppCampaignStrategyDisplay strategy.No
MobileAppCampaignSetting structure
OptionMobileAppCampaignSettingsEnum

Setting name:

Yes
ValueYesNoEnumSetting value.Yes
MobileAppCampaignStrategy structure
NetworkMobileAppCampaignNetworkStrategyDisplay strategy in ad networks.No
MobileAppCampaignSearchStrategy structure
BiddingStrategyTypeMobileAppCampaignSearchStrategyTypeEnum

The type of display strategy in search results:

For information about the compatibility of strategies in search results and ad networks, see the section Display strategies.

Yes
WbMaximumClicksStrategyMaximumClicksParameters for the Weekly budget strategy (maximum clicks).When the BiddingStrategyType parameter has the value WB_MAXIMUM_CLICKS
WbMaximumAppInstallsStrategyMaximumAppInstallsParameters for the Weekly budget strategy (maximum number of installations).When the BiddingStrategyType parameter has the value WB_MAXIMUM_APP_INSTALLS
AverageCpcStrategyAverageCpcParameters for the Average CPC strategy.When the BiddingStrategyType parameter has the value AVERAGE_CPC
WeeklyClickPackageStrategyWeeklyClickPackageParameters for the Weekly click package strategy.When the BiddingStrategyType parameter has the value WEEKLY_CLICK_PACKAGE
AverageCpiStrategyAverageCpiParameters for the Average price per app install strategy.When the BiddingStrategyType parameter has the value AVERAGE_CPI
MobileAppCampaignNetworkStrategy structure
BiddingStrategyTypeMobileAppCampaignNetworkStrategyTypeEnum

The type of display strategy in ad networks:

For information about the compatibility of strategies in search results and ad networks, see the section Display strategies

Yes
NetworkDefaultStrategyNetworkDefaultParameters for the “Manual bid management with optimization in ad networks” strategy (the bid is set relative to the bid in search results).When the BiddingStrategyType parameter has the value NETWORK_DEFAULT
WbMaximumClicksStrategyMaximumClicksParameters for the Weekly budget strategy (maximum clicks).When the BiddingStrategyType parameter has the value WB_MAXIMUM_CLICKS
WbMaximumAppInstallsStrategyMaximumAppInstallsParameters for the Weekly budget strategy (maximum number of installations).When the BiddingStrategyType parameter has the value WB_MAXIMUM_APP_INSTALLS
AverageCpcStrategyAverageCpcParameters for the Average CPC strategy.When the BiddingStrategyType parameter has the value AVERAGE_CPC
WeeklyClickPackageStrategyWeeklyClickPackageParameters for the Weekly click package strategy.When the BiddingStrategyType parameter has the value WEEKLY_CLICK_PACKAGE
AverageCpiStrategyAverageCpiParameters for the Average price per app install strategy.When the BiddingStrategyType parameter has the value AVERAGE_CPI
StrategyMaximumClicks structure
WeeklySpendLimitlong

The weekly budget in the advertiser'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.get method.

No
BidCeilinglong, nillable

The maximum bid in the advertiser'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.get method.

Note. We don't recommend setting the maximum bid, as this may reduce the effectiveness of the strategy.
No
StrategyMaximumAppInstalls structure
WeeklySpendLimitlong

The weekly budget in the advertiser'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.get method.

No
BidCeilinglong, nillable

The maximum bid in the advertiser'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.get method.

Note. We don't recommend setting the maximum bid, as this may reduce the effectiveness of the strategy.
No
StrategyAverageCpc structure
AverageCpclong

The average CPC in the advertiser'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.get method.

No
WeeklySpendLimitlong, nillable

The weekly budget in the advertiser'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.get method.

No
StrategyAverageCpi structure
AverageCpilong

The average cost of an app installation in the advertiser's currency, multiplied by 1,000,000.

The minimum acceptable value is shown in the section Currency parameters and limits.

No
WeeklySpendLimitlong, nillable

The weekly budget in the advertiser'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.get method.

No
BidCeilinglong, nillable

The maximum bid in the advertiser'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.get method.

Note. We don't recommend setting the maximum bid, as this may reduce the effectiveness of the strategy.
No
StrategyWeeklyClickPackage structure
ClicksPerWeeklongDesired number of clicks per week.No
AverageCpclong, nillable

The average CPC in the advertiser'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.get method.

Note. The AverageCpc and BidCeiling parameters are mutually exclusive. If the BidCeiling parameter was set previously and now you want to set AverageCpc, simultaneously pass null (nil) for BidCeiling.
No
BidCeilinglong, nillable

The maximum bid in the advertiser'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.get method.

Note. The AverageCpc and BidCeiling parameters are mutually exclusive. If the AverageCpc parameter was set previously and now you want to set BidCeiling, simultaneously pass null (nil) for AverageCpc.
No
StrategyNetworkDefault structure
LimitPercentintThe maximum percentage of the budget to spend on displays in ad networks. The value is a multiple of ten: 10, 20, ..., 100. The default value is 100.No
BidPercentintThe limit on the bid in ad networks. Set as a percentage of the bid in search results. The value is a multiple of ten: 10, 20, ..., 100. The value 100 makes the bid in ad networks equal to the price in search results. The default value is 100.No